Appearance
字段权威与映射原则
概述
字段定义、枚举取值以及金额/积分口径必须遵循统一权威来源,确保接口、页面与数据对象之间语义一致、口径一致、映射清晰。
权威来源
1. 字段语义/口径权威
- 以
7. 数据对象设计为准。 - 接口返回字段属于对数据对象的投影。
- 接口可增加展示字段,但不得改变原有字段口径。
2. 枚举值域权威
- 以本小节中的**“枚举冻结”**集中定义为准。
- 各接口、页面在引用枚举时,不得私自扩展取值。
3. 金额与积分口径权威
- 以本小节中的**“口径冻结”**定义为准。
- 页面字段(如“结算金额”“消耗积分”)必须能够映射到已冻结口径中的某一项。
- 不允许页面或接口自行定义新的金额/积分统计口径。
约束原则
- 所有字段必须有明确权威来源。
- 展示层可做字段投影和补充展示,但不得修改业务语义。
- 枚举与金额/积分口径必须统一收口管理。
- 页面、接口、数据对象之间应建立可追溯的字段映射关系。
