文档
核心服务Core 实施计划

CORE-01 工程、存储与公共约定

在现有 Go/Gin 工程上补齐后续领域扩展的公共基础

在现有 Go/Gin 工程上补齐后续领域扩展的公共基础。已通过验证的启动、配置和 0001 新库迁移直接复用。

数据与代码边界

现有 cmd/servercmd/migratecmd/account-createconfigdatabaserouter 为落点;已存在 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 开工基线和本机工作台;完成一个步骤不自动完成整个阶段。

Core 总计划 · 接口覆盖与实施顺序

On this page