用途:在 Wode 项目中设计、创建或修改 PostgreSQL 表结构时必须遵循的模式,涵盖命名、ID 策略、多租户隔离、字段命名与扩展数据等规则。
主要能力与规则:表名用 PostgreSQL schema 隔离,不用表名前缀,业务表偏单数(如 user、order),系统表可用复数;数据类型限定 text、bigint、jsonb、bool、timestamptz,标签类数组用 text[],禁止 varchar(n),改由业务层加 check 约束校验;主键使用 K-Sortable 随机 ID(ULID 或 UUIDv7)并加类型前缀(user_、order_),禁止自增;字段命名:时间戳用 _at,外键用 _id,判别字段用 _type,枚举值用 PascalCase。
标准字段模板包含 id、tid、uid、sid 等标识,created_at/updated_at/deleted_at 时间戳,state/status 状态机,attributes/properties/extensions/metadata 四类 jsonb 扩展数据,以及 owner_id/owner_type 多态关联,主键为 (tid, id),唯一约束含 tid。扩展数据访问策略:attributes 客户端读写,properties 服务端写客户端只读,extensions 仅内部使用,metadata 为补充描述。多租户要求每个业务表含 tid bigint not null default current_tenant_id(),主键为组合键,唯一约束必须包含 tid。更完整的字段目录(外部 ID、审计轨迹、归属模式、生成列、索引命名、schema 组织)见 references/db-schema-design.md。
限制:该资料为强制规范,具体表结构细节需查阅引用文件;未提供安装命令、平台、收费或价格信息。