## Purpose 定义服务机构端 C0 的数据模型字段字典——机构/人员/服务目录四层/字典/属地配置的实体、字段、枚举与多租户键约定,作为前后端字段命名的唯一锚点。 ## ADDED Requirements ### Requirement: 多租户键约定 服务机构端所有业务实体 MUST 携带 `tenant_code` 字段作为多租户隔离键,其值为机构唯一标识(= 脚手架租户 code)。 #### Scenario: 跨机构隔离 - **WHEN** 业务表写入一条记录 - **THEN** 该记录 MUST 带 `tenant_code`,且读操作按当前租户自动过滤,不返回其他租户数据 ### Requirement: 机构实体 org `org` 表 MUST 存在,主键为机构 code(与 `tenant_code` 同值),承载机构业务字段:org_name、org_type、credit_code、loc_code、loc_name、svc_source、license_no、address、contact_name、contact_phone、bed_count、sign_date。 #### Scenario: 机构唯一标识 - **WHEN** 创建一个机构 - **THEN** 其 code 与脚手架的 tenant code 一致且全局唯一 ### Requirement: 人员实体 staff `staff` 表 MUST 存在,承载人员/资质字段(name、id_card_no、phone、job_type、work_type、employ_status、cert_type/cert_no/cert_level/cert_expire/cert_status、group_leader_id),并 MUST 带 `user_id` 关联脚手架 `user.id`(可空、1:1)。 #### Scenario: 账号关联人员 - **WHEN** 护理员登录并定位本人 staff - **THEN** 通过 `staff.user_id = user.id` 唯一定位到一条 staff 记录 ### Requirement: 软删约定 服务机构端业务实体 MUST 采用脚手架 `deleted_at`(时间戳)软删,不物理删除。 #### Scenario: 软删保留 - **WHEN** 删除一条业务记录 - **THEN** 记录置 `deleted_at`,读操作默认排除,物理数据保留 ### Requirement: 主键约定 业务实体主键 MUST 采用脚手架 UUID v7;业务码(机构 code、项目代码)MUST 建唯一索引。 #### Scenario: 主键唯一 - **WHEN** 新增业务记录 - **THEN** 生成 UUID v7 主键,业务码唯一索引防重复 ### Requirement: 目录四层实体 `svc_national`(L1)、`svc_local`(L2)、`svc_mapping`(L3)、`svc_org`(L4) 四表 MUST 存在,字段按 PRD §7.2 定义;L3 映射表不提供机构侧接口。 #### Scenario: 目录分层 - **WHEN** 加载某机构属地目录 - **THEN** 按 L1/L2 取目录、L4 取机构勾选与配价、L3 仅内部映射 ### Requirement: 字典与属地配置实体 `dict_abnormal_type`、`dict_photo_tier`、`loc_config` 三表 MUST 存在,承载异常分类、拍照分档、属地目录来源与项数规则配置。 #### Scenario: 属地配置驱动目录 - **WHEN** 新增一个州市 - **THEN** 插入一条 `loc_config` + 一批 `svc_local` 即生效,无需改代码