36 lines
2.4 KiB
Markdown
36 lines
2.4 KiB
Markdown
# 项目文档导航
|
||
|
||
## 一句话定位
|
||
|
||
`chisup` 是一个面向第三方业务系统的基卫 CHIS 体检数据上报中间服务，第一版先跑通“第三方提交体检数据 -> 校验与幂等 -> 获取有效 CHIS 会话 -> 转换为 CHIS 体检保存格式 -> 提交 CHIS -> 返回统一结果”的闭环。
|
||
|
||
## 文档导航
|
||
|
||
- [../AGENTS.md](../AGENTS.md)：Codex / 通用 AI coding agent 的仓库级入口。
|
||
- [../CLAUDE.md](../CLAUDE.md)：Claude Code 薄入口，具体规则以 `AGENTS.md` 为准。
|
||
- [../tasks.md](../tasks.md)：根目录任务总览。
|
||
- [../progress.md](../progress.md)：执行历史流水，只追加记录任务执行、验证、阻塞和决策。
|
||
- [AI 开发入口](00-ai-start-here.md)：agent 每次开始工作的入口、阅读顺序和任务领取规则。
|
||
- [项目愿景](01-vision.md)：为什么做、为谁做、产品原则、非目标。
|
||
- [需求](02-requirements.md)：MVP 要什么、用户故事、验收标准。
|
||
- [技术栈](03-tech-stack.md)：Python / Flask / Redis 等选型与命令。
|
||
- [架构设计](04-architecture.md)：系统结构、模块职责、数据流和关键风险。
|
||
- [编码规则](05-coding-rules.md)：AI 写代码前必须遵守的硬约束。
|
||
- [任务看板](06-tasks.md)：按依赖拆分的小任务，agent 每轮只做一个。
|
||
- [API 合约](api.md)：第三方接口、错误格式、内部模块合约。
|
||
- [当前实现状态](current-state.md)：当前代码现实、可运行命令和下一步。
|
||
- [收尾检查清单](clean-state-checklist.md)：会话结束前逐项检查。
|
||
|
||
## 事实来源
|
||
|
||
当前可用事实来源：
|
||
|
||
- `reverse_file/20260702_442525195910165439_create_health_check.har`：CHIS 登录、查询、体检保存相关请求样例。
|
||
- `reverse_file/20260704_query_health_check.har`：体检详情只读查询 HAR，包含 `getHMNIListOfHTML` 和 `getCheckInfoDetail`，Phase 2 只读验证的主要事实来源。
|
||
- `reverse_file/20260704_sm2s.js`：CHIS 前端 SM2 加密脚本，做 T-101 登录与密码/时间戳加密时对照参考（当前 SM2 另参考 `hans_chis.sm2.sm2_encrypt`）。
|
||
- `reverse_file/chis.application.hc.script.HealthCheckHtmlForm.js`：CHIS 前端体检表单保存逻辑。
|
||
- `reverse_file/chis.application.hc.schemas.*.sc`：体检相关 schema 逆向资料。
|
||
- 后续用户提供的其他项目 CHIS 登录代码和账号信息查询代码。
|
||
|
||
不要把未验证的猜测写入实现。
|