Files
chisup/README.md
T

48 lines
3.1 KiB
Markdown
Raw Normal View History

2026-07-04 22:13:02 +08:00
# chisup
2026-07-04 22:17:05 +08:00
基卫 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) | 每轮结束前的收尾检查 |
## 当前事实
2026-07-04 22:46:26 +08:00
- Python 版本目标:当前系统 Python 3.8,不创建虚拟环境。
2026-07-04 22:17:05 +08:00
- Web 框架目标:Flask 3.0.3。
- Flask 结构:使用 application factory 模式,T-001 实现 `create_app(config_object=None)`。
2026-07-04 22:46:26 +08:00
- 依赖管理:T-001 创建 `requirements.txt`,使用 `python -m pip install -r requirements.txt` 安装到当前系统 Python 3.8 环境。
2026-07-04 22:17:05 +08:00
- 计划使用 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 登录与会话验证,随后跑通只读体检详情查询,最后再做保存上报。