Career Agent Open Skeleton

这是从一个私有就业规划系统中白名单提取的开源种子代码骨架。它保留四条真实业务链路的领域模型与编排代码，但不携带原项目数据、密钥、账号体系、内部管理功能、私有规则文件或伪造的模型/搜索结果。

本项目采用 MIT License。部署方仍需确保其自行接入的课程资料、方法论目录、岗位数据和评分策略具有合法使用权。

保留的模块

• Course RAG：课程/框架检索、引用核验、回答与流式输出。
• PEST：外部目录驱动的指标选择、真实搜索、证据审计与结构化综合。
• Resume × JD：简历解析、JD 要求拆解和逐项匹配。
• Offer：证据核验、硬约束审计和外部策略驱动的评分聚合。
• Next.js 前端：上述四条链路的最小交互界面和 BFF 路由。

所有外部能力默认均为 not_configured。未配置时 API 返回明确的 503 CAPABILITY_NOT_CONFIGURED，不会回退到假模型、假搜索或演示数据。

未包含的内容

• 原仓库 Git 历史、环境变量、密钥、日志、上传文件、评测结果与构建产物。
• 真实学生、咨询、就业、课程和教师私有数据。
• 用户认证、后台管理、内部技能运行时、Offer 咨询会话和内部 taxonomy 服务。
• PEST 指标/来源/关键词/taxonomy JSON 与 Offer 权重策略。
• 数据库迁移与生产部署配置。

本地启动

要求 Python 3.11+、Node.js 20+、PostgreSQL + pgvector，以及你自行提供的模型、Embedding、搜索与目录文件。

cp .env.example .env
uv sync --group dev
uv run uvicorn app.main:app --reload

另一个终端：

cd frontend
npm ci
cp .env.local.example .env.local
npm run dev

后端默认 http://localhost:8000，前端默认 http://localhost:3000。GET /health 只表示进程存活；GET /ready 会列出尚未配置的能力。

外部数据契约

PEST 运行时要求四个部署方文件：指标目录、来源目录、关键词目录和行业/岗位 taxonomy。Pydantic 模型位于 app/modules/pest/methodology_catalog.py 与 catalog.py，加载器只读取配置路径，不提供仓库内默认数据或内嵌方法论。

配置文件路径可以是绝对路径，也可以是相对仓库根目录的跨平台路径；不要在提交中写入开发机本地绝对路径。

Offer 评分策略由 OFFER_SCORING_POLICY_PATH 指向，结构见 app/modules/offer/scoring_policy.py。策略必须覆盖公开 schema 中的所有维度，且权重为 1–5。

Course RAG 目前只装配 pgvector。部署方负责创建与 app/db/models.py 一致的表、启用 pgvector，并自行导入有权使用的资料。

开发检查

uv run ruff check .
uv run pytest
cd frontend && npm run typecheck && npm run build

当前仓库是种子计划，不承诺开箱即用的生产部署。已知缺口见 docs/TODO.md，提取范围和排除项见 docs/MIGRATION_MANIFEST.md。

MetaX 适配边界

未来适配器应位于独立的 app/integrations/metax/，只实现现有 BaseLLMProvider、BaseEmbeddingProvider 或新增的明确协议。当前没有公开、稳定且已验证的 MetaX 协议，因此本仓库不包含猜测性实现。详见 docs/METAX_ADAPTER.md。