flowchart TD
    subgraph Clients["AI 客户端层 (AI Clients)"]
        C1["Claude Desktop"]
        C2["Cursor IDE"]
        C3["Cline / Roo Code"]
    end

    subgraph MCP["MCP 协议接口层 (17 Standardized Tools)"]
        T1["只读与检索 (6)"]
        T2["状态机与反馈 (5)"]
        T3["可观测与诊断 (3)"]
        T4["公开看板管理 (3)"]
    end

    subgraph Security["安全沙箱与防护网 (Security Sandbox)"]
        S1["PinnedAsyncHTTPTransport<br/>(防 SSRF & DNS 劫持)"]
        S2["PromptInjectionGuard<br/>(越狱拦截与文本清洗)"]
        S3["PrivacyGuard<br/>(PII 自动脱敏 & Canary 探针)"]
        S4["GDPRComplianceService<br/>(跨 5 大服务级联物理销毁)"]
    end

    subgraph Core["领域服务核心 (Domain Services)"]
        D1["SourceCatalogService<br/>(看板注册中心)"]
        D2["Greenhouse / Lever Adapters<br/>(ATS 摄入适配器)"]
        D3["ProfileService & Recommendation<br/>(画像归因匹配引擎)"]
        D4["ApplicationService<br/>(乐观锁状态机)"]
        D5["DisasterRecoveryManager<br/>(两阶段原子灾备)"]
    end

    Clients -->|stdio / SSE| MCP
    MCP --> Security
    Security --> Core
    Core -->|公网安全绑定| ExtATS["公开招聘看板<br/>(GitLab, Cloudflare, Palantir...)"]

{
  "mcpServers": {
    "job-intelligence": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Job_Intelligence_Mcp",
        "run",
        "python",
        "-m",
        "job_intelligence.mcp"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

{
  "mcpServers": {
    "job-intelligence": {
      "command": "uv",
      "args": [
        "--directory",
        "${workspaceFolder}",
        "run",
        "python",
        "-m",
        "job_intelligence.mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "job-intelligence": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Job_Intelligence_Mcp",
        "run",
        "python",
        "-m",
        "job_intelligence.mcp"
      ],
      "disabled": false,
      "autoApprove": [
        "search_jobs",
        "recommend_jobs",
        "get_recommendation",
        "get_job_explanation",
        "list_registered_boards"
      ]
    }
  }
}

# 克隆仓库
git clone https://github.com/your-org/job-intelligence-mcp.git
cd job-intelligence-mcp

# 极速同步依赖（含开发与测试工具）
uv sync --extra dev

# 运行演示脚本
uv run python scripts/sync_real_board_demo.py

# 方式 A：通过 uv 启动模块
uv run python -m job_intelligence.mcp

# 方式 B：通过包命令行直接启动
uv run job-intelligence-mcp

# 启动 MCP Server 与管道 Worker
docker-compose up -d

# 查看服务日志与健康状态
docker-compose logs -f

# 1. 运行全量 404 项自动化测试（含契约测试、安全攻防与红队演练）
uv run pytest

# 2. 运行静态代码风格检查（严格遵守 Ruff 规范，单行 <= 100 字符）
uv run ruff check .

# 3. 运行强类型静态分析（110+ 文件 0 类型错误）
uv run mypy src tests evals scripts

# 4. 执行灾备恢复演练验证
uv run python scripts/backup_restore_drill.py --drill