Developergovernance

命名与版本规范

Naming & Versioning

标识符、URL 与版本的治理规则。稳定优先,破坏性变更必须有迁移路径。

01

概览

标识符、URL 与版本的治理规则。稳定优先,破坏性变更必须有迁移路径。

02

要点

URL 规则:/measurement/{id}、/technology/{id}、/algorithm/{id}、/threshold/{id}、/tool/{id};全部小写、连字符。

03

要点 2

语义化版本:MAJOR(破坏性)、MINOR(向后兼容新增)、PATCH(纠错与文案)。

04

要点 3

废弃流程:标记 deprecated → 给出 replaced_by → 保留至少 12 个月后移除,且旧 URL 保留跳转。

05

结构定义

场景处理方式
新增测量量新增 id,MINOR 版本
更正阈值数值PATCH 版本 + 更新 last_reviewed
变更标识符禁止;只能新开 id 并标记 replaced_by
单位定义变更MAJOR 版本,必须提供换算与迁移说明
删除对象不删除;标记 deprecated 并保留跳转
CLOSE

把 命名与版本规范 用起来

需要把技术判断落到项目?

进入行业应用与智能选型中心,获取场景设计、选型与实施参考。