下面是完整可落地的 《Claude 模块执行任务清单（Task Tracker）.md》，
它衔接 Claude 高质量代码生成执行手册.md 与 Service-Registry.md，
可直接放入项目的：
docs/Claude-Task-Tracker.md
此文档的目标是让你或团队在 Claude 调用、任务分配、进度追踪 时完全可控，
并能保证每个模块严格依照 ADR / Blueprint / AsyncAPI 落地。
⸻
🧭 Claude 模块执行任务清单（Task Tracker）
版本： v1.0
日期： 2025-10-12
维护人： 架构组
适用范围： 光明科学城科技成果转化平台全体微服务
说明：
本清单用于追踪 Claude 的模块生成与测试任务，
确保各服务代码实现与 Architecture-Blueprint、Service-Registry、asyncapi.yaml、ADR-* 保持一致。
🧩 目录结构
| 阶段 |
内容 |
输出目录 |
| Phase 1 |
基础骨架生成 |
/services/<name>/ |
| Phase 2 |
数据与持久层实现 |
/services/<name>/repository/ |
| Phase 3 |
事件发布与监听 |
/services/<name>/listener/ |
| Phase 4 |
单元与集成测试 |
/services/<name>/test/ |
| Phase 5 |
部署与配置 |
/deploy/, /docker/, /k8s/ |
🧱 一、后端服务（Spring Boot）
1. gateway 服务
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Controller |
生成统一入口与路由配置 |
“生成 gateway 路由配置与安全过滤器（Spring Cloud Gateway）” |
☐ |
架构组 |
| Filter |
JWT 解析、限流、traceId 注入 |
“生成 GatewayFilter：鉴权、限流、traceId 注入” |
☐ |
安全组 |
| Config |
集成 Keycloak + OTel + Redis 缓存 |
“生成 gateway 的配置类，包含 Keycloak 集成与 trace 拦截” |
☐ |
架构组 |
| Test |
健康检查与限流单测 |
“为 Gateway 生成 JUnit5 单元测试样例” |
☐ |
QA组 |
2. auth 服务
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Controller |
登录、注册、刷新Token |
“生成 auth 模块的 Controller，包括 login/register/refresh 接口” |
☐ |
架构组 |
| Service |
用户认证逻辑、权限分配 |
“生成 AuthService 与 RoleService，实现用户认证与权限绑定” |
☐ |
架构组 |
| Repository |
sys_user/sys_role 持久层 |
“生成 MyBatis Mapper: UserMapper, RoleMapper” |
☐ |
架构组 |
| Event |
发布 UserRegistered, UserVerified 事件 |
“实现事件发布器，符合 asyncapi.yaml” |
☐ |
架构组 |
| Test |
JWT验证与用户注册单测 |
“生成 AuthService 测试样例” |
☐ |
QA组 |
3. market 服务
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Controller |
/demands, /achievements REST接口 |
“生成 market 的 Controller 层：DemandController + AchievementController” |
☐ |
架构组 |
| Service |
需求创建、查询、智能匹配触发 |
“生成 DemandService 与 AchievementService，含幂等处理与状态管理” |
☐ |
架构组 |
| Repository |
MyBatis 映射层 |
“生成 DemandMapper 与 AchievementMapper，关联 DM8 表结构” |
☐ |
数据组 |
| Listener |
订阅 MatchingCompleted 事件 |
“生成 DemandEventListener 订阅 ai.events 的 MatchingCompleted 消息” |
☐ |
架构组 |
| Publisher |
发布 DemandCreated, AchievementUpdated |
“实现 EventPublisher，符合 ADR-002 事件格式” |
☐ |
架构组 |
| Test |
Controller + Service 单测 |
“生成 JUnit5 测试覆盖需求创建/查询流程” |
☐ |
QA组 |
4. contract 服务
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Controller |
合同创建与签署接口 |
“生成 ContractController 实现 /contracts 与 /contracts/{id}/sign” |
☐ |
架构组 |
| Service |
签署状态回流 + 幂等验证 |
“生成 ContractService 实现幂等签署与状态同步” |
☐ |
架构组 |
| Event |
发布 ContractCreated, ContractSigned |
“实现 RabbitMQ 事件发布器，契合 asyncapi.yaml” |
☐ |
架构组 |
| Test |
签署与状态变更单测 |
“生成 ContractService JUnit5 测试样例” |
☐ |
QA组 |
5. ai 服务（Python）
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| API |
/ai/match, /ai/recommend |
“生成 FastAPI 应用 main.py，实现 /ai/match 与 /ai/recommend 接口” |
☐ |
架构组 |
| Celery |
异步匹配任务 |
“实现 Celery worker 与 RabbitMQ 连接，符合 asyncapi.yaml 的 MatchingCompleted” |
☐ |
架构组 |
| Algorithm |
匹配算法 mock 与推荐逻辑 |
“实现 mock 匹配算法模块，输出置信度与原因” |
☐ |
架构组 |
| Event |
发布 MatchingCompleted, RecommendationGenerated |
“生成事件发布模块，使用 pika 或 aio-pika 连接 MQ” |
☐ |
架构组 |
| Test |
pytest 单元测试样例 |
“生成 pytest 测试文件 test_match.py 覆盖匹配任务” |
☐ |
QA组 |
| Dockerfile |
构建镜像 |
“生成 ai 服务 Dockerfile，基于 Python 3.10 + Uvicorn + Celery” |
☐ |
DevOps |
6. notification 服务
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Controller |
/emails /sms /wechat |
“生成 NotificationController 实现多渠道推送接口” |
☐ |
架构组 |
| Service |
调度与状态持久化 |
“生成 NotificationService 支持异步消息发送与状态记录” |
☐ |
架构组 |
| Listener |
订阅 ContractSigned 事件 |
“生成 ContractSignedListener，触发通知发送” |
☐ |
架构组 |
| Test |
发送成功率验证单测 |
“生成 NotificationService 测试类” |
☐ |
QA组 |
🎨 二、前端模块
1. admin-ui
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| View |
需求管理页面 |
“生成 Vue3 + Vben 组件：DemandList.vue + DemandForm.vue” |
☐ |
前端组 |
| Store |
Pinia 状态管理 |
“生成 useDemandStore.ts 管理需求列表状态” |
☐ |
前端组 |
| API |
封装 Axios 请求 |
“生成 api/market.ts 调用 /market/demands 接口” |
☐ |
前端组 |
| Test |
单元测试 |
“生成 Vitest 测试覆盖需求模块操作” |
☐ |
QA组 |
2. bigscreen
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Dashboard |
大屏首页布局 |
“生成 Flask 模板与 ECharts 视图，实时显示匹配与合同统计” |
☐ |
前端组 |
| WebSocket |
实时事件流渲染 |
“生成 WebSocket 客户端，订阅 ai.events 与 contract.events” |
☐ |
前端组 |
| Config |
数据拉取配置 |
“生成 bigscreen/settings.py 支持多租户切换” |
☐ |
架构组 |
⚙️ 三、DevOps 与环境
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| Dockerfile |
各服务镜像构建 |
“为所有服务生成 Dockerfile（Java/Python 区分）” |
☐ |
DevOps |
| docker-compose.yml |
本地环境 |
“生成包含 DM8、Redis、RabbitMQ、MinIO 的 docker-compose.yml” |
☐ |
DevOps |
| CI/CD |
构建流水线 |
“生成 GitHub Actions Workflow：ci-build.yml, ci-deploy.yml” |
☐ |
DevOps |
| K8s Manifests |
多环境部署 |
“生成 market, ai, contract 等服务的 Deployment 与 Service YAML” |
☐ |
DevOps |
| Observability |
Prometheus + Grafana |
“生成 Prometheus scrape 配置与 Grafana dashboard 模板” |
☐ |
运维组 |
📊 四、AI Agent 协作任务（选配）
| 模块 |
任务描述 |
Claude Prompt |
状态 |
审核 |
| 任务自治 |
设计 AI Agent 调度框架 |
“生成 task_agent.py 实现 AI 匹配任务自治调度” |
☐ |
AI组 |
| 协作协议 |
多 Agent 任务编排 |
“生成 agent_orchestrator.py 实现 RAG/Agent 协作” |
☐ |
架构组 |
| 事件响应 |
结合 ADR-031 安全响应 |
“生成 security_agent.py 实现 AI 安全事件响应机制” |
☐ |
安全组 |
🧾 五、任务状态标识说明
| 状态符号 |
含义 |
| ☐ |
未开始 |
| 🏗 |
进行中 |
| ✅ |
已完成（Claude 输出通过编译） |
| 🔍 |
审核中（人类审阅） |
| 🧩 |
已合并入主干 |
📅 六、执行节奏与交付里程碑
| 阶段 |
内容 |
时间范围 |
负责人 |
| Sprint-01 |
生成 market + auth + gateway + ai 骨架 |
2025/10/13 - 2025/10/20 |
架构组 |
| Sprint-02 |
实现 event、repository、测试层 |
2025/10/21 - 2025/10/31 |
开发组 |
| Sprint-03 |
完善前端模块与通知服务 |
2025/11/01 - 2025/11/10 |
前端组 |
| Sprint-04 |
集成部署与灰度验证 |
2025/11/11 - 2025/11/20 |
DevOps |
| Sprint-05 |
AI 模型与智能体扩展 |
2025/11/21 - 2025/12/05 |
AI组 |
🧠 七、Claude 调用策略（团队协作提示）
- 每个任务一条 Claude 会话，避免上下文污染。
- Claude 输出代码 → 人工审阅 → 提交至
feature/<module> 分支。
- 每合并前需通过：
mvn test / pytestsonar-scannerdocker build 本地验证
- Claude 在生成完成后执行验证 Prompt：
验证清单：
• 是否符合 ADR 约束？
• 是否符合 asyncapi.yaml？
• 是否具备幂等机制？
• 是否包含单测？
• 是否可直接构建？
请逐项检查并输出验证结果。
- 所有合并请求由架构组最终审查，记录在
CHANGELOG.md。
✅ 八、完成标准
- 所有服务均可独立启动；
- 所有事件可被成功消费；
- 单元测试覆盖率 ≥ 85%；
- 所有表写入均符合所有权规范；
- 所有 API 文档由 Swagger 自动生成；
- 所有配置文件支持三环境（dev / staging / prod）；
- 所有日志包含 traceId、tenantId、userId。
本文件为 Claude 模块执行总表，更新节奏与版本号同步项目蓝图。
任何模块完成或修改，必须同步勾选状态并提交至版本控制。
