Skip to content

字段权威与映射原则

概述

字段定义、枚举取值以及金额/积分口径必须遵循统一权威来源,确保接口、页面与数据对象之间语义一致、口径一致、映射清晰。

权威来源

1. 字段语义/口径权威

  • 7. 数据对象设计 为准。
  • 接口返回字段属于对数据对象的投影
  • 接口可增加展示字段,但不得改变原有字段口径

2. 枚举值域权威

  • 以本小节中的**“枚举冻结”**集中定义为准。
  • 各接口、页面在引用枚举时,不得私自扩展取值

3. 金额与积分口径权威

  • 以本小节中的**“口径冻结”**定义为准。
  • 页面字段(如“结算金额”“消耗积分”)必须能够映射到已冻结口径中的某一项。
  • 不允许页面或接口自行定义新的金额/积分统计口径。

约束原则

  • 所有字段必须有明确权威来源。
  • 展示层可做字段投影和补充展示,但不得修改业务语义。
  • 枚举与金额/积分口径必须统一收口管理。
  • 页面、接口、数据对象之间应建立可追溯的字段映射关系。

谷子科技知识库平台 - 多格式摄入、受控编译、岗位隔离问答