当前系统版本号链路(已上线):
根目录 VERSION.md →(vite.config.ts 用 Node readFileSync 读取)→ define __APP_VERSION_FILE__
→(src/utils/version.ts 解析标记区)→ APP_VERSION / VERSION_LOGS
→(src/App.tsx 左侧导航底部 + 顶部 Header)→ 界面显示
VERSION.md 有两个标记区:<!-- CURRENT_VERSION_START --> ~ <!-- CURRENT_VERSION_END -->(当前版本三行)与 <!-- CHANGELOG_START --> ~ <!-- CHANGELOG_END -->(历史版本段落,最新在最上)。
痛点:维护者必须手工记住版本规则与标记区位置,易写错格式或漏改「当前版本信息」区,造成导航栏版本号与更新内容不一致。
约束:
VERSION.md 在构建期由 Node 注入,浏览器运行期无法写回磁盘;Option 已废弃需用 options、Divider 用 titlePlacement、日期组件需中文本地化);keyToPath / menuTitleMap / MENU_RENDERERS 必须齐全,否则 dev 启动时 validateMenuRoutes() 告警。Goals:
utils/version.ts),保证界面显示与维护内容同源。Non-Goals:
VERSION.md 原文做解析与重新拼接,产出新文件文本供复制/下载。BS_DRGVersionRecord 表与查询/保存/删除接口,页面可真正增删改查;但会出现"文件与库两份版本数据",且导航栏仍读文件,二者易不一致。v + YYYY.MM.DD + 当日序列号(2 位)。01 开始;若历史为空则 v<今天>.01。v<所选日期>.01 或当日 +1)。在 utils/version.ts 增加 buildVersionFile({ version, date, desc, groups }):
CURRENT_VERSION_START/END 之间的内容(保留标记行本身);<!-- CHANGELOG_START --> 之后插入新版本段落(## vX(date) + ### 分类 + - 条目);三类(新增/优化/修复)各自一组可增删的输入项;提交时过滤空行与"无"。日期控件统一使用中文(import 'dayjs/locale/zh-cn'; dayjs.locale('zh-cn') + locale={zhCN},格式 YYYY年MM月DD日),与项目既有规范一致。
表示形式:写在每个版本段落标题下、### 分类 之前,形如两行列表项,便于解析与人工阅读:
```markdown
### 新增
xxx
- 「发布人」默认取当前登录用户(`localStorage.userInfo.userName`),可手工修改;
- 「影响模块」用 `Select mode="tags"`:预置常用模块(DRG分组 / DIP付费 / 医保控费预警 / 盈亏分析 / 基础数据 / HIS数据 / 特例单议 / 系统管理 / 接口服务 / 其它),同时允许自由输入新模块名;存储为顿号分隔的字符串,解析时按 `、/,/,` 切分;
- 两个字段均可选:为空时不写入 Markdown,页面也不展示空字段。
### 决策 6:页面只读展示历史,不支持在线改历史
历史版本列表为只读,如需修正历史内容请在 `VERSION.md` 手工编辑——保证"生成逻辑"单一方向(只追加),避免解析/重写历史导致结构损坏。
## 页面与数据流
VersionMaintenance.tsx ├─ 当前版本卡片 ← utils/version.ts: APP_VERSION / APP_VERSION_DATE / APP_VERSION_DESC ├─ 历史版本时间轴 ← VERSION_LOGS(倒序,展开显示 新增/优化/修复) └─ 「新增版本」Modal(Form)
├─ 版本号(自动推算,可编辑)
├─ 更新日期(DatePicker 中文)
├─ 版本说明(Input)
├─ 发布人(默认当前登录用户,可改)
├─ 影响模块(Select tags,预置 + 自由输入)
└─ 新增/优化/修复(Form.List 动态条目)
→ 提交 → buildVersionFile() 生成全文
→ 结果展示:只读预览 + [复制全文] [下载 VERSION.md] [下载新增片段]
```
| 文件 | 变更 |
|---|---|
frontend/src/utils/version.ts |
新增 VERSION_FILE_RAW、buildVersionFile()、suggestNextVersion();保留既有导出 |
frontend/src/pages/System/VersionMaintenance.tsx |
新增页面(函数组件 + Hooks) |
frontend/src/routes/menuRouteRegistry.tsx |
导入页面;MENU_RENDERERS 新增 'system-version' |
frontend/src/routes/menuRoutes.ts |
keyToPath['system-version'] = '/system/version';menuTitleMap['system-version'] = '版本更新维护' |
BS_DrgSystemMenu(菜单配置页面) |
新增菜单记录(详见 tasks) |
VERSION.md 并重新打包 → 页面明确提示"下载后替换项目根目录 VERSION.md,并执行 npm run build";提供一键复制降低操作成本。buildVersionFile 会失败 → 函数内做标记存在性校验,缺失时给出明确中文提示并回退为"仅生成新增片段"。VERSION.md 增大后预览区较长 → 预览区固定高度 + 滚动,默认展示新增段落。npm run dev 验证菜单可打开;system-version 菜单并授权给对应角色;npm run build 打包,部署 dist 到生产(E:\DRG\dist);new Date().toISOString())。