46 lines
2.8 KiB
Markdown
46 lines
2.8 KiB
Markdown
# chisup
|
||
|
||
基卫 CHIS 上报数据项目。项目目标是提供稳定的后端 API，供第三方系统提交体检数据；`chisup` 负责校验、转换、维护 CHIS 登录会话，并把符合 CHIS 接口格式的数据提交到基卫 CHIS。
|
||
|
||
当前仓库处于 MVP 起步阶段：已有 `reverse_file/` 中的 CHIS 逆向资料，还未初始化 Flask 生产代码。当前已确认可参考 `D:\hans\chupd\chis\login_client_v2.py` 迁移 CHIS 登录链路，public key 由配置提供；保存上报前先实现只读体检详情查询来验证登录、会话、加密和通用请求。
|
||
|
||
## 文档入口
|
||
|
||
| 文档 | 作用 |
|
||
| --- | --- |
|
||
| [AGENTS.md](AGENTS.md) | Codex / AI coding agent 的仓库级入口 |
|
||
| [CLAUDE.md](CLAUDE.md) | Claude Code 薄入口，指向 `AGENTS.md` |
|
||
| [tasks.md](tasks.md) | 根目录任务总览，详细任务以 `docs/06-tasks.md` 为准 |
|
||
| [progress.md](progress.md) | 执行历史流水，只追加记录 |
|
||
| [docs/README.md](docs/README.md) | 项目文档导航 |
|
||
| [docs/00-ai-start-here.md](docs/00-ai-start-here.md) | AI 开发入口、阅读顺序和任务领取规则 |
|
||
| [docs/01-vision.md](docs/01-vision.md) | 项目愿景、价值和非目标 |
|
||
| [docs/02-requirements.md](docs/02-requirements.md) | MVP 需求和验收标准 |
|
||
| [docs/03-tech-stack.md](docs/03-tech-stack.md) | 技术栈、运行命令和待定项 |
|
||
| [docs/04-architecture.md](docs/04-architecture.md) | 架构设计、模块职责、数据流和风险 |
|
||
| [docs/05-coding-rules.md](docs/05-coding-rules.md) | 编码纪律和验证规则 |
|
||
| [docs/06-tasks.md](docs/06-tasks.md) | 可逐步交付的任务看板 |
|
||
| [docs/api.md](docs/api.md) | 对第三方 API 与内部模块合约 |
|
||
| [docs/current-state.md](docs/current-state.md) | 当前代码现实、可运行命令和下一步 |
|
||
| [docs/clean-state-checklist.md](docs/clean-state-checklist.md) | 每轮结束前的收尾检查 |
|
||
|
||
## 当前事实
|
||
|
||
- Python 版本目标：Python 3.8。
|
||
- Web 框架目标：Flask 3.0.3。
|
||
- 计划使用 Redis 保存 CHIS 会话缓存。
|
||
- 当前已有资料：`reverse_file/` 下的 CHIS 前端脚本、schema 和 HAR。
|
||
- 当前已有查询 HAR：`reverse_file/20260704_query_health_check.har`，包含 `getHMNIListOfHTML` 和 `getCheckInfoDetail`。
|
||
- 当前尚未确认：最终项目目录、依赖文件、数据库、部署方式、第三方鉴权方式、仅凭 `healthCheck` 反查查询详情所需参数的链路。
|
||
|
||
## 推荐开工方式
|
||
|
||
新一轮开发先读：
|
||
|
||
1. [AGENTS.md](AGENTS.md)
|
||
2. [docs/00-ai-start-here.md](docs/00-ai-start-here.md)
|
||
3. [docs/current-state.md](docs/current-state.md)
|
||
4. [docs/06-tasks.md](docs/06-tasks.md)
|
||
|
||
编码前优先完成任务看板中的 Phase 0，先建立最小可运行 Flask 地基，再接入 CHIS 登录与会话验证，随后跑通只读体检详情查询，最后再做保存上报。
|