CORE-01 工程、存储与公共约定
在现有 Go/Gin 工程上补齐后续领域扩展的公共基础
在现有 Go/Gin 工程上补齐后续领域扩展的公共基础。已通过验证的启动、配置和 0001 新库迁移直接复用。
数据与代码边界
现有 cmd/server、cmd/migrate、cmd/account-create、config、database、router 为落点;已存在 users、user_sessions、tokens、auth_audits。0001 不改写,新增领域另加版本迁移。保持 Go/Gin/GORM 及按需依赖与固定 new-api 一致。
接口与文档输入
本阶段没有新增客户领域 API。约定 /healthz、/readyz、身份模式能力范围和接口包络;对外已有方法、字段与状态码按精确切片保留。参考复用规则。
下列路径中“拟新增”是建议落点,实际命名随代码评审确定;不表示文件、表或接口已经存在。每项交付同时包含对应 Schema、请求/响应及错误样例。
可执行任务
CORE-01.01 · 固定运行与来源基线
前置:现有工程和固定源码。
实施范围:核对配置、依赖版本、来源哈希与启动模式;文档只指向 references/new-api。以现有命令验证新工作路径,不重复搭建工程。
交付物:依赖/源码清单、运行配置说明与 CLI 使用入口。
验收场景:缺少 DSN/密钥不启动身份服务;探针不冒充业务就绪;配置错误不回显秘密。
CORE-01.02 · 定义增量迁移规则
前置:CORE-01.01。
实施范围:在 database 层固定版本、校验和、发布顺序及兼容窗口;后续价格、账务、任务按领域新增迁移,不用 AutoMigrate 改生产表。
交付物:迁移设计表:实体、字段/索引、回填、锁影响与恢复方式;SQLite/PostgreSQL 的支持范围。
验收场景:空库初始化、重复执行、校验和不匹配、已有旧表无标记均符合现行行为;后续迁移在快照上复验。
CORE-01.03 · 统一 DTO 与错误约定
前置:CORE-01.01。
实施范围:明确 ID/时间/分页、人民币与积分单位、可写字段和 no-store;沿用上游 success/message 与实际 HTTP 语义,新增错误仅在差异契约定义。
交付物:公共 DTO/错误约定及对外兼容样例;敏感字段清单。
验收场景:金额不经浮点隐式舍入;客户端 owner/role/实际扣费字段不能直接写权威事实;未知与空结果不混淆。
CORE-01.04 · 观测与维护接口边界
前置:CORE-01.01、CORE-01.03。
实施范围:按 request_id/operation_id 建日志关联;核对性能、实例和系统任务接口,明确哪些是 Core 运行诊断、哪些不应直接开放。拟新增诊断适配与指标注册。
交付物:日志脱敏/审计区别、诊断接口启用清单与依赖故障指标。
验收场景:普通客户无法读取实例或执行 GC/清理;指标不出现完整 Key/凭据;诊断关闭不影响业务请求。
本阶段退出条件
工程与迁移可复现,后续任务明确公共格式和数据库演进方式。运行诊断按实际维护需求启用,不把所有上游性能 API 设为文本闭环前置。
具体步骤的运行状态查Core 开工基线和本机工作台;完成一个步骤不自动完成整个阶段。