统一文档版本号与更新日期

This commit is contained in:
2026-04-02 07:38:58 +08:00
parent 5236719035
commit af43beadb0
90 changed files with 411 additions and 45 deletions

View File

@@ -1,4 +1,7 @@
# Backend
> 文档版本v1.0
> 最后更新2026-04-02
这套后端现在已经能支撑一条完整主链:
@@ -42,3 +45,4 @@ go run .\cmd\api
- 局生命周期:`start / finish / detail`
- 局后结果:`/sessions/{id}/result``/me/results`
- 开发工作台:`/dev/workbench`

View File

@@ -1,4 +1,7 @@
# Backend Docs
> 文档版本v1.0
> 最后更新2026-04-02
这套文档服务两个目的:
@@ -54,3 +57,4 @@
- 应用装配:[app.go](D:/dev/cmr-mini/backend/internal/app/app.go)
- 路由注册:[router.go](D:/dev/cmr-mini/backend/internal/httpapi/router.go)
- migration[migrations](D:/dev/cmr-mini/backend/migrations)

View File

@@ -1,4 +1,7 @@
# Backend TodoList
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 目标
@@ -330,3 +333,4 @@ backend 现在最值得先做的,不是扩接口,而是先确认下面 3 条
当前 backend 最重要的任务不是“再加更多接口”,而是:
> 先把 session 运行态语义、放弃恢复语义和 ongoing session 口径定稳,再继续扩后台配置系统。

View File

@@ -1,4 +1,7 @@
# 前后端联调清单
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 目的
@@ -367,3 +370,4 @@ backend 文档里也规划了:
当前最真实的进度判断是:
> backend 业务后端主链已经进入可联调阶段;小程序地图运行内核也已经具备承接能力;下一步最值钱的是补小程序业务 API 层和 launch/finish 两个适配器。

View File

@@ -1,4 +1,7 @@
# 开发说明
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 环境变量
@@ -192,3 +195,4 @@ Redis 后面只在需要性能优化、限流或短期票据缓存时再接。
4. 再考虑实时网关票据
不要跳回去把玩法规则塞进 backend。

View File

@@ -1,4 +1,7 @@
# API 清单
> 文档版本v1.0
> 最后更新2026-04-02
本文档只记录当前 backend 已实现接口,不写未来规划接口。
@@ -423,3 +426,4 @@
- `release.releaseId`
- `release.manifestUrl`
- `release.configLabel`

View File

@@ -1,4 +1,7 @@
# 数据模型
> 文档版本v1.0
> 最后更新2026-04-02
当前 migration 共 5 版。
@@ -169,3 +172,4 @@
- 实时票据 / 网关票据
这些后面要按真正业务需要补 migration不要先拍脑袋建大而全表。

View File

@@ -1,4 +1,7 @@
# 核心流程
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 总流程
@@ -226,3 +229,4 @@ APP 当前主链是手机号验证码:
`app event -> app launch -> app game`
业务接口必须保持统一,终端差异只进入上下文,不进入对象模型分叉。

View File

@@ -1,4 +1,7 @@
# 系统架构
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 目标
@@ -231,3 +234,4 @@
- 网关只认 backend 签发的运行态票据
不要把微信身份或业务 token 直接暴露给实时网关。

View File

@@ -1,4 +1,7 @@
# 资源对象与目录方案
> 文档版本v1.0
> 最后更新2026-04-02
本文档用于把“地图复用、KML 复用、内容资源复用、配置发布”统一收成一套后端可执行方案。
@@ -587,3 +590,4 @@ gotomars/event-releases/{eventPublicID}/{releasePublicID}/asset-index.json
只有这样地图复用、KML 复用、资源包复用、多活动发布才能长期稳定。
并且这套模型必须从一开始就兼顾未来 APP而不是做成“小程序跑通后再重构”的临时结构。

View File

@@ -1,4 +1,7 @@
# 配置管理方案
> 文档版本v1.0
> 最后更新2026-04-02
## 1. 目标
@@ -410,3 +413,4 @@
> 源配置管理 + 构建产物管理 + release 发布管理 + session 绑定 release
这样以后无论你配置项怎么继续长,主架构都还能撑住。