M4-08 Release & Decision Module #42

New Issue

wangdl · 2026-05-22T21:09:51+08:00

wangdl commented

2026-05-22 21:09:51 +08:00

目标

设计知习版本发布与决策记录模块，管理 Release Note、版本发布流程、架构决策记录和研究报告沉淀。

本 Issue 只做模块架构设计，不直接实现代码。

模块职责

本模块负责：
- Release Note 撰写和管理
- 版本发布流程（关联 Milestone/Issue/PR）
- 决策记录（ADR）撰写和归档
- 研究报告沉淀
- 回归清单管理
- 发布风险评估

候选数据对象

DecisionRecord（决策记录/ADR）
ADRDraft
ReleaseDraft
ReleaseItem（关联的 Issue/PR）
ReleaseChecklist

禁止事项

禁止发布流程跳过回归清单
禁止决策记录不留档

不建议当前阶段实现

自动化发布流水线
CI/CD 对接

## 目标设计知习版本发布与决策记录模块，管理 Release Note、版本发布流程、架构决策记录和研究报告沉淀。本 Issue 只做模块架构设计，不直接实现代码。 ## 模块职责 1. 本模块负责： - Release Note 撰写和管理 - 版本发布流程（关联 Milestone/Issue/PR） - 决策记录（ADR）撰写和归档 - 研究报告沉淀 - 回归清单管理 - 发布风险评估 ## 候选数据对象 - DecisionRecord（决策记录/ADR） - ADRDraft - ReleaseDraft - ReleaseItem（关联的 Issue/PR） - ReleaseChecklist ## 禁止事项 - 禁止发布流程跳过回归清单 - 禁止决策记录不留档 ## 不建议当前阶段实现 - 自动化发布流水线 - CI/CD 对接

wangdl added this to the M4：Admin 生产级运维深化（P3） milestone 2026-05-22 21:09:51 +08:00

wangdl self-assigned this 2026-05-22 21:09:51 +08:00

wangdl commented

2026-05-24 18:15:52 +08:00

✅ M4-08 实施完成

已有基础

AppChangelog Prisma 模型此前已有。

本 Issue 新增

模块	说明
DecisionRecord Prisma 模型	ADR 架构决策记录（title/context/decision/rationale/status）
ReleaseChecklist Prisma 模型	版本回归清单（version/item/checked）
ReleaseController	版本日志 CRUD + 决策记录 CRUD + 回归清单管理
ReleaseAdmin 页面	3 个 Tab：版本日志、架构决策 (ADR)、回归清单（支持勾选）

AAPI 端点

端点	方法	说明
/admin-api/release/changelogs	GET/POST	版本日志列表/创建
/admin-api/release/changelogs/:id	PATCH/DELETE	版本日志更新/删除
/admin-api/release/decisions	GET/POST	决策记录列表/创建
/admin-api/release/decisions/:id	PATCH	决策记录更新
/admin-api/release/checklists/:version	GET	版本回归清单
/admin-api/release/checklists	POST	添加检查项
/admin-api/release/checklists/:id	PATCH	标记检查项完成

菜单

新增「发布决策」菜单项

## ✅ M4-08 实施完成 ### 已有基础 AppChangelog Prisma 模型此前已有。 ### 本 Issue 新增 | 模块 | 说明 | |------|------| | DecisionRecord Prisma 模型 | ADR 架构决策记录（title/context/decision/rationale/status） | | ReleaseChecklist Prisma 模型 | 版本回归清单（version/item/checked） | | ReleaseController | 版本日志 CRUD + 决策记录 CRUD + 回归清单管理 | | ReleaseAdmin 页面 | 3 个 Tab：版本日志、架构决策 (ADR)、回归清单（支持勾选） | ### AAPI 端点 | 端点 | 方法 | 说明 | |------|------|------| | /admin-api/release/changelogs | GET/POST | 版本日志列表/创建 | | /admin-api/release/changelogs/:id | PATCH/DELETE | 版本日志更新/删除 | | /admin-api/release/decisions | GET/POST | 决策记录列表/创建 | | /admin-api/release/decisions/:id | PATCH | 决策记录更新 | | /admin-api/release/checklists/:version | GET | 版本回归清单 | | /admin-api/release/checklists | POST | 添加检查项 | | /admin-api/release/checklists/:id | PATCH | 标记检查项完成 | ### 菜单新增「发布决策」菜单项

wangdl closed this issue

2026-06-05 20:17:12 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#42