3.3 KiB
3.3 KiB
chisup
基卫 CHIS 上报数据项目。项目目标是提供稳定的后端 API，供第三方系统提交体检数据；chisup 负责校验、转换、维护 CHIS 登录会话，并把符合 CHIS 接口格式的数据提交到基卫 CHIS。
当前仓库处于 MVP 起步阶段：已有 Flask application factory 地基、health check、基础配置、pytest 测试入口和架构包目录。当前已确认可参考 D:\hans\chupd\chis\login_client_v2.py 迁移 CHIS 登录链路，public key 由配置提供；访问 CHIS 支持可选 CHIS_PROXY SOCKS5 代理；保存上报前先实现只读体检详情查询来验证登录、会话、加密和通用请求。
文档入口
| 文档 | 作用 |
|---|---|
| AGENTS.md | Codex / AI coding agent 的仓库级入口 |
| CLAUDE.md | Claude Code 薄入口，指向 AGENTS.md |
| tasks.md | 根目录任务总览，详细任务以 docs/06-tasks.md 为准 |
| progress.md | 执行历史流水，只追加记录 |
| docs/README.md | 项目文档导航 |
| docs/00-ai-start-here.md | AI 开发入口、阅读顺序和任务领取规则 |
| docs/01-vision.md | 项目愿景、价值和非目标 |
| docs/02-requirements.md | MVP 需求和验收标准 |
| docs/03-tech-stack.md | 技术栈、运行命令和待定项 |
| docs/04-architecture.md | 架构设计、模块职责、数据流和风险 |
| docs/05-coding-rules.md | 编码纪律和验证规则 |
| docs/06-tasks.md | 可逐步交付的任务看板 |
| docs/api.md | 对第三方 API 与内部模块合约 |
| docs/current-state.md | 当前代码现实、可运行命令和下一步 |
| docs/clean-state-checklist.md | 每轮结束前的收尾检查 |
当前事实
- Python 版本目标：当前系统 Python 3.8，不创建虚拟环境。
- Web 框架目标：Flask 3.0.3。
- Flask 结构：使用 application factory 模式，T-001 实现
create_app(config_object=None)。 - 依赖管理：T-001 创建
requirements.txt，使用python -m pip install -r requirements.txt安装到当前系统 Python 3.8 环境。 - 测试入口：T-003 固定
pytest==8.3.5，使用python -m pytest。 - 计划使用 Redis 保存 CHIS 会话缓存。
- 访问 CHIS 支持可选
CHIS_PROXY：为空直连，有值时 CHIS 登录、查询和保存请求走 SOCKS5 代理。 - 当前已有资料：
reverse_file/下的 CHIS 前端脚本、schema 和 HAR。 - 当前已有查询 HAR：
reverse_file/20260704_query_health_check.har，包含getHMNIListOfHTML和getCheckInfoDetail。 - 当前尚未确认：数据库、部署方式、第三方鉴权方式、仅凭
healthCheck反查查询详情所需参数的链路。
推荐开工方式
新一轮开发先读：
编码前从任务看板领取第一个依赖已完成的 TODO。当前 Phase 0 已完成，下一步进入 CHIS 登录与会话验证，随后跑通只读体检详情查询，最后再做保存上报。