版本中心 V1.0.0
复制版本链接版本定位
V1.0.0 是「版本管理（DOMIDODO 版本中心）」首个正式登记版本。系统以产品版本为统一组织入口，面向公司内部成员与外部使用者：外部使用者无需登录即可浏览各产品的正式版本与更新说明，内部成员登录后可管理分类、产品、版本，并围绕版本进行评论与附件协作。
核心能力
1. 版本中心与版本浏览
- 首页按分类分组展示产品，产品卡片带图标、版本数量与最新版本号；未归类产品单独成组置于末尾。
- 产品详情页左侧列出该产品的版本，支持「内部版本 / 外部版本」切换；未登录用户仅可见外部版本。
- 支持
?v=<版本ID>深链直达指定版本，切换版本时地址栏同步，可收藏与回溯。 - 版本正文为 Markdown 渲染，含版本标题、摘要、版本号、发布时间、发布通道、状态与致谢区块。
- 版本中心产品列表走 Redis 缓存（默认 300 秒），产品或版本增删改后自动失效。
2. 版本号与发布规则
- 正式（外部）版本采用三位版本号
V X.X.X，新建时默认「已发布」。 - 内部版本采用两位版本号
v X.X，新建时默认「未发布」。 - 内部版本发布时必须关联一个同产品下已发布的正式版本，未选择不予提交；关联关系在版本详情与管理列表中可见。
- 同一产品下版本号唯一；版本号位数、前缀与默认状态由前后端同一套规则校验。
- 新增版本时可基于当前最大版本号「主 +1 / 次 +1 / 修订 +1」快捷递增，内部版本无修订位。
- 版本置为已发布且未填发布时间时，自动以当前时间作为发布时间。
- 删除产品将级联逻辑删除其下全部版本。
3. 版本内容就地编辑
- 登录后在版本详情页直接点击即可编辑标题、摘要、发布通道、发布时间、状态与致谢内容，保存即时生效，无需跳转表单页。
- 更新说明与致谢支持 Markdown 编辑与实时预览，渲染经 DOMPurify 消毒后输出。
- 致谢区块可整体开关，关闭后对外不展示。
- 版本号作为版本标识，创建后不可修改。
- 未登录时在详情页可就地唤起登录弹窗，登录成功后停留在当前版本继续编辑。
4. 评论与附件协作
- 版本详情右侧为功能栏，含评论、附件两类信息流（任务标签页为后续能力预留）。
- 评论支持二级回复：对回复的再回复统一挂到同一顶级评论下，并记录「回复 某某」关系。
- 文字与文件在同一次 multipart 请求中提交，保证一条帖子及其文件的原子落库。
- 附件页按上传批次聚合成帖，每条展示作者、时间与该批文件。
- 图片类文件显示缩略图并可新窗打开原图；PDF、DOC/DOCX、XLS/XLSX、PPT/PPTX 等按类型显示图标卡片与文件名。
- 删除顶级评论时，其下回复与全部关联附件一并清除。
5. 产品与分类管理
- 产品管理页以网格展示全部产品，支持新增、编辑、删除，以及产品 logo 上传与即时预览。
- 分类管理页展示分类名称、描述、分类下产品数量与排序，支持新增、编辑、删除。
- 分类名称唯一；删除分类前在确认框中明示影响范围，其下产品将转为「未分类」而非被删除。
- 产品与分类均支持排序值控制展示次序，数值越小越靠前。
6. 文件上传与存储
- 统一上传接口，文件落至
app.upload.dir指定目录，经/uploads/**提供静态访问。 - 产品 logo 限图片类型（jpg/png/gif/webp/svg）；评论附件额外支持文档与压缩包类型。
- 单文件与单次请求上限均为 5MB。
- 数据库统一存储
/uploads/xxx相对路径，前端按打包环境变量拼接后端域名，同一份数据可在开发、测试、生产之间迁移。
7. 认证与访问控制
- 采用 JWT 认证，令牌通过
Authorization: Bearer传递，有效期可配置（默认 7 天）。 - 拦截器仅守卫
/api/admin/**与/api/auth/me，版本中心与版本详情等读取接口对外公开。 - 前端路由守卫拦截管理类页面，登录后按
redirect参数回到原目标页。 - 首次启动自动初始化默认管理员账号（
admin），已存在则跳过。 - 密码使用 BCrypt 加密存储。
8. 部署与运行治理
- 支持多环境打包：前端按
--mode区分开发、预发布、生产三套配置，后端按 Maven Profile 区分 dev / prod 并内置对应配置文件。 - 后端地址、上传目录、数据库、Redis、JWT 密钥等均可由环境变量覆盖，无需改代码切换环境。
- 提供 Docker / docker-compose 一键启动（MySQL 8 + Redis 7 + 后端 + 前端 Nginx），并附可直接使用的站点 Nginx 配置。
- 内置 Knife4j 接口文档，生产环境默认关闭。
- 统一响应结构与全局异常处理，业务错误码集中定义；数据表统一逻辑删除与创建/更新时间自动填充。
发布与验收
- 版本号：V1.0.0
- 发布通道：稳定版
- 发布日期：2026年7月29日