50 lines
2.7 KiB
Markdown
50 lines
2.7 KiB
Markdown
# 项目协作说明
|
||
|
||
## 项目定位
|
||
|
||
- 项目名称：JobRadar（职途雷达）
|
||
- 项目用途：面向个人求职者，以 Agent 编排岗位采集、企业调查、规则筛选、评分和结果管理，形成可追溯的岗位发现与决策流程。
|
||
- 项目类型：Django Web 应用，目前处于工程基线阶段。
|
||
|
||
## 技术与代码边界
|
||
|
||
技术栈、源码根、模块和依赖以 `.craftkit/project.json` 为结构化入口。未确认的信息不得自行补全。
|
||
|
||
- 当前语言为 Python 3.13，Web 框架为 Django 6.0.8。
|
||
- Django 配置位于 `JobRadar/settings/`，开发、测试、集成和生产环境必须使用对应配置。
|
||
- 业务模块按 `docs/architecture.md` 的边界增量建立，不提前创建尚不能验证的空业务模块。
|
||
- 框架记录精确版本和已存在的公共 profile；普通开发只使用当前 profile，升级或版本比较任务才读取源、目标两个版本。
|
||
|
||
## 项目资料
|
||
|
||
- 项目说明：`README.md`
|
||
- 架构设计：`docs/architecture.md`
|
||
- Agent 契约：`docs/agent-contract.md`
|
||
- 实施路线图：`docs/roadmap.md`
|
||
- AI 开发约定：`docs/development-guide.md`
|
||
- Agent 补充说明：`.craftkit/agents/index.md`
|
||
- 项目规范：`.craftkit/standards/index.md`
|
||
- 可复用知识：`.craftkit/knowledge/index.md`
|
||
- 共享设计文档：`.craftkit/designs/`；开发中过程文档使用 `.craftkit/project.json` 配置的 `documents.workRoot`。
|
||
- 文档维护规则：`.craftkit/standards/document-maintenance.md`；修改实现时检查并同步受影响的长期文档。
|
||
|
||
## 工作约束
|
||
|
||
- 所有回答、项目文档和代码注释使用中文。
|
||
- 修改前先说明方案；复杂改动取得确认后执行，简单改动可以直接处理，但必须说明调整内容。
|
||
- 新增或修改代码时沿用相邻代码的注释格式，并为关键边界、失败路径和不直观逻辑提供详尽注释。
|
||
- 修改前先阅读与目标目录和任务主题相关的项目资料。
|
||
- 区分明确项目规则、公共建议和从代码观察到的现状。
|
||
- 不提交凭据、个人机器路径、本地状态或可重新生成缓存。
|
||
- 外部采集必须遵守授权范围、站点条款和频率限制，不绕过验证码、登录保护或访问控制。
|
||
- 第一版不自动投递简历或联系招聘人员；高风险或不可逆操作必须经过人工确认。
|
||
- 发现规范冲突、信息缺失或多种并存风格时先向用户说明。
|
||
|
||
## 验证要求
|
||
|
||
- Django 配置检查：`python manage.py check`
|
||
- 自动化测试：`python manage.py test`
|
||
- 迁移完整性：`python manage.py makemigrations --check --dry-run`
|
||
- 静态检查：`ruff check .`
|
||
- 项目依赖默认在名为 `JobRadar` 的 Conda 环境中运行；若当前解释器缺少依赖，应先确认环境是否已同步。
|