变更历史
两个应用各自维护 changelog,通过 /api/version 端点暴露,前端自动检测新版提示刷新。
版本号规则(SemVer)
MAJOR— 架构级 / 不兼容改动(预留 1.0.0 给 SSO 完成里程碑)MINOR— 新模块 / 大功能 / 安全大改 / 跨库改造PATCH— bug 修复 / 加固 / 体验调整 / 文案微调
文档分层(SSO Phase A3 起)
notes— 面向运营,简洁客观陈述(不写实现细节)detail— 面向工程师 / 超管,SQL / 路由 / 中间件实现细节- 客户视角(NEMPOI customer)只看非 internal 的 changes