命名与版本规范
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
把 命名与版本规范 用起来
相关技术
下一步
实际项目如何应用?
场景设计、设备选型与工程实施,见 xmsiyb.cn 行业应用与智能选型中心。
场景设计、设备选型与工程实施,见 xmsiyb.cn 行业应用与智能选型中心。
相关 SIYB 产品
正式参数、方案与商务资料以 xmsiyb.com 官网为准。
需要把技术判断落到项目?
进入行业应用与智能选型中心,获取场景设计、选型与实施参考。