chore: 初始化 T-001 Go 骨架
This commit is contained in:
+26
-18
@@ -6,25 +6,28 @@
|
||||
## 当前快照
|
||||
|
||||
- 日期:2026-07-06
|
||||
- 阶段:**pre-code**(设计完成、Go 骨架未建立;路线图阶段 0 未开始)
|
||||
- 技术栈:目标 Go 1.24 单二进制(未落地);当前仅有 Python 联调脚本(requests,本地不入库)
|
||||
- 生产代码:**无**。`go.mod` 不存在,`osi/ contract/ mapping/` 等目录均待建
|
||||
- 阶段:**Phase 0 已起步**;T-001 已完成,Go module 与 CLI/config 骨架已建立
|
||||
- 技术栈:Go 1.24 单二进制;`main.go -mode server|deliver`;配置读取使用 viper
|
||||
- 生产代码:已有 `main.go`、`config/`、`go.mod`/`go.sum`;`osi/ contract/ mapping/` 等业务目录仍待后续任务建立
|
||||
- 联调现实:**JKDA00002 个人档案查询已用 Python 脚本打通真实沙箱**(`code="01"`),实测契约沉淀在 `docs/04 §8`
|
||||
- 测试:`tests/test_query_health_record.py` **已失效**(测的是被重写前的脚本 API,import 报错)
|
||||
- 标准启动路径:`./init.sh`(阶段 0 未完成前会提示先做 T-001,属预期行为)
|
||||
- 标准验证路径:`go test ./...`(骨架建立后生效)
|
||||
- 测试:`go test ./...` 通过;当前测试覆盖 mode 解析与 `config.yaml.example` 加载
|
||||
- 标准启动路径:`./init.sh`(需要 bash/WSL 环境;当前 Windows 环境未安装 WSL,直接运行会失败)
|
||||
- 标准验证路径:`go test ./...`、`go build ./...`
|
||||
- 当前 blocker:无硬 blocker。软阻塞:厂家侧 B1/B2/B4/B5 契约缺口(见 `docs/06`),只影响阶段 4,不阻塞阶段 0~3
|
||||
|
||||
## 当前目录要点
|
||||
|
||||
| 路径 | 状态 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `main.go` | 已有 | 单入口,解析 `-mode server|deliver` 与 `-config` |
|
||||
| `config/` | 已有 | viper 配置加载,含最小单测 |
|
||||
| `config.yaml.example` | 已有 | 占位配置,不含真实凭据 |
|
||||
| `go.mod` `go.sum` | 已有 | module `chis_osi`,依赖 viper |
|
||||
| `docs/` | 已有 | 设计文档集 01~06 + 本快照;`账号.txt` 本地留存不入库 |
|
||||
| `tasks.md` `progress.md` | 已有 | 任务看板 / 执行流水(根目录) |
|
||||
| `scripts/` | 已有·不入库 | Python 联调脚本(硬编码真实凭据与身份证,已 gitignore) |
|
||||
| `tests/` | 已有·失效 | 旧脚本测试,待 T-000 处理 |
|
||||
| `config.yaml` | 已有·不入库 | 真实凭据;`config.yaml.example` 待 T-001 建立 |
|
||||
| `main.go` `osi/` `contract/` `mapping/` 等 | 待建 | 路线图阶段 0~2 |
|
||||
| `scripts/` | 已有·不入库 | Python 联调脚本(硬编码真实凭据与身份证,勿提交) |
|
||||
| `config.yaml` | 已有·不入库 | 真实凭据;不要提交 |
|
||||
| `osi/` `contract/` `mapping/` 等 | 待建 | 路线图阶段 0~2 后续任务 |
|
||||
|
||||
## 已验证事实(写代码时直接依赖)
|
||||
|
||||
@@ -37,19 +40,24 @@
|
||||
## 当前可运行内容
|
||||
|
||||
```bash
|
||||
# 本地联调查询(唯一可运行路径;脚本硬编码凭据,勿提交)
|
||||
python3 scripts/query_health_record.py
|
||||
|
||||
# Go 侧(阶段 0 后)
|
||||
./init.sh
|
||||
# Go 骨架验证
|
||||
go test ./...
|
||||
go build ./...
|
||||
go run . -mode server -config config.yaml.example
|
||||
go run . -mode deliver -config config.yaml.example
|
||||
|
||||
# 统一入口(需要 bash/WSL)
|
||||
./init.sh
|
||||
|
||||
# 本地联调查询(脚本硬编码凭据,勿提交)
|
||||
python3 scripts/query_health_record.py
|
||||
```
|
||||
|
||||
## 下一步
|
||||
|
||||
1. T-000:处理失效测试(`tasks.md` Phase B)。
|
||||
2. T-001:go module + 双子命令骨架,进入路线图阶段 0。
|
||||
1. T-002:`osi/sign.go` MD5 头签名 + 单测。
|
||||
2. T-003:`osi/transport.go` 传输层骨架。
|
||||
|
||||
## 维护规则
|
||||
|
||||
发生以下变化时覆盖更新本文:入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照,不留历史。
|
||||
发生以下变化时覆盖更新本文:入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照,不留历史。
|
||||
|
||||
Reference in New Issue
Block a user