cds-modeling

CDS Modeling 是一份面向 CAP 的 CDS 建模最佳实践参考，用于定义或审查 CDS 数据模型，涉及实体、aspect、关联、组合、投影、视图、注解、cuid 与 managed 等主题。主要能力与约定包括：始终从 @sap/cds/common 复用类型出发，使用 cuid 作为 UUID 主键 aspect，用 managed 自动获得审计字段，用 temporal 表达时变数据，用 localized 自动生成 _texts 表与 i18n 支持；区分 Association（跨实体引用、无级联删除）与 Composition（子项随父级存在、支持级联删除与深度插入）；通过 aspect 复用可复用模式，用 projection 或 select 定义投影与只读视图，并建议在服务定义中使用投影而非直接暴露基础实体。还给出命名规范、枚举类型、UI 注解与 ODM 对齐、@assert 声明式约束等做法，并列出常见错误，如手写 UUID 主键、cuid() 当作函数、手动定义 createdAt 等审计字段、服务中直接暴露 db 实体、HANA 部署中 String 不带长度、组合经服务暴露时忘记 on 条件。文中给出 CDS 片段示例与官方参考链接 https://cap.cloud.sap/docs/cds/cdl、https://cap.cloud.sap/docs/guides/domain-modeling、https://cap.cloud.sap/docs/cds/common。适用场景为 CAP 项目的数据建模、模型评审与规范统一；限制方面，具体安装、命令、版本与价格等资料未提供。