docs: 新增系统配置模块PRD及数据模型文档，更新TASK.md

- 新增 PRD/系统配置/系统配置模块PRD.md（v0.1 Draft）
  - MVP 范围：US-SETTING-001-A（Lookup Items）、B（房源字段必填规则）、C（客源录入规则）
- 新增 PRD/系统配置/系统配置数据模型设计说明_for_Atlas.md
- 新增 PRD/系统配置/系统配置参数数据.md（竞品参数数据）
- 删除旧版 PRD/系统配置/系统配置.md（已被新PRD替代）
- 新增 DATA_MODEL/DATA_MODEL_SETTING.md（系统配置数据模型）
- 新增 DATA_MODEL/ENUMS.md（枚举定义与约定）
- 新增 AGENTS.md（AI Agent 开发规范）
- 更新 PRD/TASK.md：US-SETTING-001 拆分为 A/B/C 三个子任务，修正参考文档路径与验收标准
- 新增 VIBE_CODING_开工前缺失清单.md
- 新增 TECH_STACK/房源管理技术方案.md
- 更新 DATA_MODEL/DATA_MODEL.md、DATA_MODEL_CLIENT.md、DATA_MODEL_LOGIN.md
- 更新 PRD/PRD_MVP.md、PRD/权限管理/权限管理模块PRD.md
- 更新 TECH_STACK/TECH_STACK.md、权限管理系统技术方案.md
- 更新 UI_DESIGN/preview.html、UI_SYSTEM/UI_SYSTEM.md
- 新增 prompt/PRD - 为系统设置生成PRD设计文档.md、更新 prompt 模板

Project/fonrey/DATA_MODEL/ENUMS.md

@@ -0,0 +1,762 @@
+> **For AI assistants**: Read this entire file before writing any code. All decisions here are final. Do not suggest alternatives unless asked.
+
+# Fonrey — 统一枚举字典（ENUMS）
+
+> **定位**：本文件是 Fonrey 全局枚举标准（Public + Tenant）的统一实现基线。  
+> **版本**：v2.1  
+> **日期**：2026-04-27  
+> **适用范围**：`DATA_MODEL_PUBLIC.md`、`DATA_MODEL_LOGIN.md`、`DATA_MODEL_ORG.md`、`DATA_MODEL_COMPLEX.md`、`DATA_MODEL_PROPERTY.md`、`DATA_MODEL_CLIENT.md`、`DATA_MODEL_PERMISSION.md`、`DATA_MODEL_SETTING.md`
+
+---
+
+## 一、枚举分层标准（必须遵守）
+
+Fonrey 采用两层枚举体系：
+
+1. **固定枚举（Fixed Enum）**
+   - 值域固定，受 `CHECK` 或强业务约束保护
+   - 作为系统契约，不能随意改值
+   - 可落地到 `public.enum_labels`（用于统一标签）
+
+2. **可配置枚举（Configurable Enum）**
+   - 值域由租户自行维护
+   - 存储在 Tenant Schema：`lookup_groups` + `lookup_items`
+   - **禁止**对业务表字段加固定 `CHECK IN (...)`
+
+---
+
+## 二、全局固定枚举（Public / 平台级）
+
+### 2.1 tenant 生命周期
+
+**domain**: `public.tenant.plan`  
+- `basic`：基础版
+- `professional`：专业版
+- `enterprise`：企业版
+
+**domain**: `public.tenant.status`
+- `creating`：创建中
+- `active`：正常
+- `suspended`：已挂起
+- `pending_delete`：待删除
+- `deleted`：已删除
+- `failed`：创建/初始化失败
+
+**domain**: `public.tenant.suspended_reason`
+- `overdue`：欠费
+- `violation`：违规
+- `requested`：客户申请
+- `other`：其他
+
+### 2.2 平台管理员
+
+**domain**: `public.platform_admin.role`
+- `super_admin`：超级管理员
+- `ops_operator`：运营管理员
+- `read_only_auditor`：只读审计员
+
+### 2.3 平台审计与备份导出
+
+**domain**: `public.platform_audit.result`
+- `SUCCESS`：成功
+- `FAILED`：失败
+
+**domain**: `public.backup_schedule.frequency`
+- `hourly`：每小时
+- `daily`：每日
+- `weekly`：每周
+
+**domain**: `public.backup_schedule.storage_target`
+- `local`：本地存储
+- `s3`：Amazon S3
+- `r2`：Cloudflare R2
+- `gcs`：Google Cloud Storage
+
+**domain**: `public.backup_record.trigger_type`
+- `auto`：自动触发
+- `manual`：手动触发
+- `pre_upgrade`：升级前触发
+- `pre_restore`：恢复前触发
+
+**domain**: `public.backup_record.status`
+- `pending`：待执行
+- `in_progress`：执行中
+- `success`：成功
+- `failed`：失败
+
+**domain**: `public.export_task.format`
+- `csv`：CSV
+- `json`：JSON
+- `sql_dump`：SQL 导出
+
+**domain**: `public.export_task.status`
+- `pending`：待执行
+- `in_progress`：执行中
+- `done`：已完成
+- `failed`：失败
+
+### 2.4 升级与发布（Public）
+
+**domain**: `public.upgrade_event.event_type`
+- `upgrade`：升级
+- `rollback`：回滚
+
+**domain**: `public.upgrade_event.upgrade_type`
+- `A_app`：A类应用升级
+- `B_schema`：B类数据库结构升级
+- `C_feature`：C类功能开关升级
+
+**domain**: `public.upgrade_event.strategy`
+- `full`：全量发布
+- `canary`：灰度发布
+
+**domain**: `public.upgrade_event.status`
+- `draft`：草稿
+- `pre_check`：预检查
+- `pre_backup`：预备份
+- `batch_running`：批次执行中
+- `batch_done`：批次完成
+- `halted`：已暂停
+- `succeeded`：已成功
+- `failed`：失败
+- `rollback_running`：回滚中
+- `rolled_back`：已回滚
+
+**domain**: `public.upgrade_event.failure_policy`
+- `halt_batch`：失败即停止批次
+- `continue`：失败继续
+
+**domain**: `public.client_release.platform`
+- `win32`：Windows 客户端
+
+**domain**: `public.client_release.arch`
+- `x64`：x64 架构
+- `arm64`：ARM64 架构
+
+**domain**: `public.client_release.release_type`
+- `normal`：普通更新
+- `force`：强制更新
+
+**domain**: `public.client_release.status`
+- `draft`：草稿
+- `published`：已发布
+- `archived`：已归档
+
+---
+
+## 三、Tenant 固定枚举（模块级，值域统一）
+
+> 说明：以下字段在 Tenant Schema 中存储，但值域为系统统一标准，属于“全局实现标准”。
+
+## 3.1 登录认证（account/login）
+
+**domain**: `login.user_account.status`
+- `active`：启用
+- `disabled`：停用
+- `locked`：锁定
+
+**domain**: `login.login_attempt.failure_reason`
+- `wrong_password`：用户名或密码错误
+- `wrong_captcha`：验证码错误
+- `account_locked`：账号锁定
+- `account_disabled`：账号停用
+- `tenant_not_found`：租户不存在
+
+---
+
+## 3.2 组织人事（org）
+
+**domain**: `org.org_unit.type`
+- `company`：公司
+- `division`：事业部
+- `region`：大区
+- `area`：区域
+- `district`：片区
+- `store`：门店
+- `group`：店组
+- `functional`：职能部门
+
+**domain**: `org.org_unit.attribute`
+- `direct`：直营
+- `franchise`：加盟
+
+**domain**: `org.staff.role`
+- `agent`：经纪人
+- `store_manager`：店长
+- `area_manager`：区域经理
+- `admin`：系统管理员
+- `operator`：运营/行政
+- `system`：系统账号
+
+**domain**: `org.staff.status`
+- `active`：在职
+- `probation`：试用
+- `resigned`：离职
+- `frozen`：冻结
+
+**domain**: `org.staff_personal_info.gender`
+- `male`：男
+- `female`：女
+- `unknown`：未知
+
+**domain**: `org.staff_personal_info.id_type`
+- `id_card`：身份证
+- `passport`：护照
+- `other`：其他
+
+**domain**: `org.staff_transfer.transfer_type`
+- `onboard`：入职
+- `transfer`：调动
+- `resign`：离职
+- `rejoin`：复职
+- `supervisor_change`：上级变更
+- `role_change`：角色变更
+- `freeze`：冻结账号
+- `unfreeze`：恢复账号
+
+**domain**: `org.staff_account.platform`
+- `fonrey`：房睿主账号
+- `58anjuke`：58安居客
+- `cnreic`：中国网络经纪人
+- `wechat_mp`：微信公众号
+
+---
+
+## 3.3 权限系统（permission）
+
+**domain**: `permission.module`
+- `home`：首页
+- `property`：房源
+- `new_house`：新房
+- `client`：客源
+- `transaction`：交易
+- `data`：数据
+- `marketing`：营销
+- `hr`：人事OA
+- `contract`：合同
+- `trinet`：三网
+- `system`：系统
+- `mobile`：移动端
+- `smart_store`：智能门店
+- `recharge`：在线充值
+
+**domain**: `permission.value_type`
+- `BOOLEAN`：开关型
+- `SCOPE`：范围型
+- `INTEGER`：数值型
+
+**domain**: `permission.role_category`
+- `agent`：置业顾问
+- `store_manager`：店管
+- `director`：总经
+- `operator`：运营/行政
+- `custom`：自定义
+
+**domain**: `permission.scope_level`
+- `none`：无
+- `self`：本人
+- `group`：本组
+- `store`：本门店
+- `area`：本区域
+- `region`：本大区
+- `company`：全公司
+
+**domain**: `permission.override_mode`
+- `REPLACE`：覆盖
+- `RESTRICT`：限制
+- `GRANT`：授予
+
+**domain**: `permission.data_scope_type`
+- `self`：本人
+- `group`：本组
+- `store`：本门店
+- `area`：本区域
+- `region`：本大区
+- `company`：全公司
+- `custom_unit`：自定义组织单元
+
+**domain**: `permission.change_log.target_type`
+- `role`：角色
+- `role_permission`：角色权限
+- `staff_role`：员工角色
+- `staff_override`：员工权限覆盖
+- `staff_scope`：员工数据范围
+
+**domain**: `permission.change_log.action`
+- `create`：创建
+- `update`：更新
+- `delete`：删除
+- `assign`：分配
+- `revoke`：撤销
+
+---
+
+## 3.4 楼盘区域（complex）
+
+**domain**: `complex.school.type`
+- `primary`：小学
+- `middle`：初中
+- `high`：高中
+- `k9`：九年一贯制
+- `k12`：十二年一贯制
+
+**domain**: `complex.school.nature`
+- `public`：公立
+- `private`：私立
+- `international`：国际
+
+**domain**: `complex.school.level`
+- `normal`：普通
+- `key`：重点
+- `top`：名校
+
+**domain**: `complex.building_type`
+- `slab`：板楼
+- `tower`：塔楼
+- `slab_tower`：板塔结合
+
+**domain**: `complex.water_type`
+- `civil`：民水
+- `commercial`：商水
+
+**domain**: `complex.electricity_type`
+- `civil`：民电
+- `commercial`：商电
+
+**domain**: `complex.school_zone_type`
+- `guaranteed`：对口
+- `reference`：参考
+- `lottery`：摇号
+
+**domain**: `complex.photo.category`
+- `complex`：楼盘图
+- `layout`：户型图
+- `vr`：VR图
+- `other`：其他
+
+---
+
+## 3.5 房源（property）
+
+**domain**: `property.property_type`
+- `residential`：住宅
+- `villa`：别墅
+- `commercial_residential`：商住
+- `shop`：商铺
+- `office`：写字楼
+- `other`：其他
+
+**domain**: `property.status`
+- `for_sale`：出售
+- `for_rent`：出租
+- `for_sale_rent`：租售
+- `suspended`：暂缓
+- `sold_elsewhere`：他售
+- `rented_elsewhere`：他租
+- `sold`：成交
+- `unlisted`：未挂牌
+
+**domain**: `property.attribute`
+- `public`：公盘
+- `private`：私盘
+- `special`：特盘
+- `sealed`：封盘
+
+**domain**: `property.orientation`
+- `east`：东
+- `south`：南
+- `west`：西
+- `north`：北
+- `southeast`：东南
+- `northeast`：东北
+- `east_west`：东西
+- `south_north`：南北
+- `northwest`：西北
+- `southwest`：西南
+
+**domain**: `property.decoration`
+- `rough`：毛坯
+- `plain`：清水
+- `simple`：简装
+- `medium`：中装
+- `fine`：精装
+- `luxury`：豪装
+
+**domain**: `property.house_status`
+- `owner_occupied`：业主自住
+- `vacant`：空置
+- `tenant_occupied`：租客在住
+- `unknown`：未知
+
+**domain**: `property.viewing_time`
+- `anytime`：随时看房
+- `by_appointment`：预约看房
+- `inconvenient`：不便看房
+
+**domain**: `property.grade`
+- `A_urgent`：A（急迫）
+- `A`：A
+- `B`：B（较强）
+- `C`：C（一般）
+- `D`：D（较弱）
+
+**domain**: `property.contact.gender`
+- `male`：先生
+- `female`：女士
+
+**domain**: `property.contact.identity`
+- `owner`：业主
+- `contact`：联系人
+- `subletter`：转租人
+- `tenant`：租客
+- `agent`：代理人
+- `corporate`：企业法人
+
+**domain**: `property.listing_history.listing_type`
+- `for_sale`：出售挂牌
+- `for_rent`：出租挂牌
+
+**domain**: `property.listing_history.status`
+- `active`：生效中
+- `ended`：已结束
+
+**domain**: `property.follow_log.log_type`
+- `written`：手写跟进
+- `modified`：修改跟进
+- `sensitive_op`：敏感操作
+- `sensitive_view`：敏感查看
+- `other`：其他
+- `system`：系统
+
+**domain**: `property.follow_log.ai_tag`
+- `ai_for_sale`：AI判断可售
+- `ai_not_for_sale`：AI判断不可售
+
+**domain**: `property.follow_attachment.file_type`
+- `bmp`：BMP
+- `jpg`：JPG
+- `png`：PNG
+- `svg`：SVG
+- `gif`：GIF
+
+**domain**: `property.key.key_type`
+- `mechanical`：机械钥匙
+- `password`：密码钥匙
+
+**domain**: `property.commission.owner_type`
+- `owner`：产权人本人
+- `authorized_third`：授权第三方
+
+**domain**: `property.commission.status`
+- `active`：有效
+- `expired`：过期
+- `cancelled`：取消
+
+**domain**: `property.commission_attachment.category`
+- `id_card`：身份证件
+- `property_cert`：产权证明
+- `commission_letter`：委托书
+- `other`：其他
+
+**domain**: `property.field_survey.status`
+- `draft`：草稿
+- `submitted`：已提交
+
+**domain**: `property.survey_photo.category`
+- `layout`：户型图
+- `living_room`：客厅
+- `dining_room`：餐厅
+- `bedroom`：卧室
+- `bathroom`：卫生间
+- `kitchen`：厨房
+- `entrance`：入户
+- `balcony`：阳台
+- `study`：书房
+- `indoor_other`：室内其他
+- `outdoor`：室外
+
+**domain**: `property.photo.category`
+- `cover`：封面
+- `entrance`：入户
+- `living_room`：客厅
+- `dining_room`：餐厅
+- `bedroom`：卧室
+- `bathroom`：卫生间
+- `kitchen`：厨房
+- `balcony`：阳台
+- `study`：书房
+- `indoor_other`：室内其他
+- `outdoor`：室外
+- `panorama`：全景
+
+**domain**: `property.attachment.category`
+- `id_card`：身份证件
+- `property_cert`：产权证明
+- `commission_letter`：委托书
+- `other`：其他
+
+**domain**: `property.number_holder_approval.status`
+- `pending`：待审批
+- `approved`：已通过
+- `rejected`：已驳回
+
+---
+
+## 3.6 客源（client）
+
+**domain**: `client.client_type`
+- `private`：私客
+- `public`：公客
+- `transacted`：成交客
+
+**domain**: `client.status`
+- `buying`：求购
+- `renting`：求租
+- `buy_or_rent`：租购
+- `suspended`：暂缓
+- `bought`：已购
+- `rented_done`：已租
+- `public`：公客
+- `invalid`：无效
+
+**domain**: `client.grade`
+- `A`：A（急迫）
+- `B`：B（较强）
+- `C`：C（一般）
+- `D`：D（较弱）
+- `E`：E（暂不关注）
+
+**domain**: `client.property_usage`
+- `residential`：住宅
+- `villa`：别墅
+- `commercial_residential`：商住
+- `shop`：商铺
+- `office`：写字楼
+- `other`：其他
+
+**domain**: `client.buying_purpose`
+- `rigid`：刚需
+- `investment`：投资
+- `school_district`：学区
+- `upgrade`：改善
+- `commercial`：商用
+- `other`：其他
+
+**domain**: `client.payment_method`
+- `full`：全额
+- `mortgage`：商业贷款
+- `mortgage_fund`：商贷+公积金
+- `fund`：公积金
+
+**domain**: `client.properties_owned`
+- `none`：无
+- `local_none`：本地无/外地有
+- `local_has`：本地有
+
+**domain**: `client.id_type`
+- `id_card`：身份证
+- `passport`：护照
+- `hk_macao`：港澳通行证
+- `other`：其他
+
+**domain**: `client.transfer_to_public_type`
+- `manual`：手动转公
+- `auto`：自动转公
+- `marketing_jump`：营销客跳公
+- `resource_public`：资料客素公
+
+**domain**: `client.invalid_reason`
+- `invalid_phone`：号码无效
+- `peer_agent`：同行
+- `ad`：广告推销
+- `no_intent`：无意向
+- `other`：其他
+
+**domain**: `client.transacted_type`
+- `bought`：我购
+- `rented`：我租
+
+**domain**: `client.transacted_property_type`
+- `second_hand`：二手
+- `new_house`：新房
+
+**domain**: `client.activity_level`
+- `new_matched`：新配对
+- `active_7d`：7日活跃
+- `active_30d`：30日活跃
+- `active_90d`：90日活跃
+- `expiring`：即将过期
+- `frozen`：暂缓中
+- `invalid`：无效
+
+**domain**: `client.contact.gender`
+- `male`：先生
+- `female`：女士
+
+**domain**: `client.requirement_type`
+- `second_hand`：二手
+- `new_house`：新房
+- `rental`：租房
+
+**domain**: `client.floor_preference`
+- `no_first`：不要一楼
+- `low`：低楼层
+- `mid`：中楼层
+- `high`：高楼层
+- `no_top`：不要顶楼
+
+**domain**: `client.orientation`
+- `east`：东
+- `south`：南
+- `west`：西
+- `north`：北
+
+**domain**: `client.decoration`
+- `rough`：毛坯
+- `plain`：清水
+- `simple`：简装
+- `medium`：中装
+- `fine`：精装
+- `luxury`：豪装
+
+**domain**: `client.building_age_range`
+- `within_5y`：5年内
+- `5_10y`：5-10年
+- `10_15y`：10-15年
+- `15_20y`：15-20年
+- `over_20y`：20年以上
+
+**domain**: `client.follow_log.log_type`
+- `written`：写入跟进
+- `modified`：修改跟进
+- `sensitive_view`：敏感查看
+- `other`：其他
+- `system`：系统
+
+**domain**: `client.viewing.viewing_type`
+- `appointment`：预约
+- `viewing`：带看
+- `revisit`：复看
+- `empty`：空看
+
+**domain**: `client.viewing.client_intent`
+- `interested`：感兴趣
+- `not_interested`：不感兴趣
+- `negotiating`：谈判中
+- `cancelled`：取消
+
+**domain**: `client.property_match.match_source`
+- `recorded`：录客配房
+- `system`：系统配房
+
+**domain**: `client.property_match.match_group`
+- `quality_layout`：优质户型
+- `price_reduced`：降价
+- `hot`：热门
+- `newly_listed`：新上
+
+**domain**: `client.property_match.status`
+- `suggested`：待推送
+- `shared`：已分享
+- `rejected`：已反馈不合适
+- `viewed`：客户已查看
+
+**domain**: `client.status_log.change_type`
+- `status_change`：改状态
+- `grade_change`：改等级
+- `to_public`：转公客
+- `to_transacted`：转成交
+- `to_invalid`：转无效
+- `owner_change`：改归属人
+- `source_change`：改来源
+- `merge`：合并客源
+
+---
+
+## 3.7 系统配置（setting）
+
+**domain**: `setting.tenant_setting.value_type`
+- `bool`：布尔
+- `int`：整数
+- `string`：字符串
+- `enum`：枚举
+
+**domain**: `setting.field_rule.module`
+- `property`：房源
+- `client`：客源（预留）
+
+**domain**: `setting.field_rule.entity_type`（与 `property.property_type` 对齐）
+- `residential`：住宅
+- `villa`：别墅
+- `commercial_residential`：商住
+- `shop`：商铺
+- `office`：写字楼
+- `other`：其他
+
+**domain**: `setting.field_rule.trade_status`
+- `sale`：出售
+- `rent`：出租
+- `sale_rent`：租售
+- `*`：全部
+
+**domain**: `setting.field_rule.requirement`
+- `required`：必填
+- `optional`：选填
+- `hidden`：隐藏
+
+---
+
+## 四、Tenant 可配置枚举字段清单（lookup_items 权威）
+
+> 以下字段值域由 `lookup_items` 维护，属于租户级配置，不在业务表中写死 `CHECK`。
+
+| domain（统一命名） | 对应字段 | 当前状态 | 说明 |
+|---|---|---|---|
+| `client.source` | `clients.source` | ✅ 已落地 | 客源来源 |
+| `client.follow_purpose` | `client_follow_logs.purpose` | ✅ 已落地 | 客源跟进目的 |
+| `property.source` | `properties.source` | ✅ 已落地 | 房源来源 |
+| `property.follow_purpose` | `follow_logs.purpose` | 🔄 建议统一 | 房源跟进目的（建议与 `client.follow_purpose` 共享或独立分组） |
+| `property.commission_type` | `commissions.commission_type` | 🔄 待入组 | 委托类型（独家/非独家等） |
+| `client.match_feedback` | `client_property_matches.feedback` | 🔄 待入组 | 配房反馈原因 |
+| `org.reward_punish_category` | `staff_reward_punish.category` | 🔄 待入组 | 人事奖惩类别 |
+
+### 4.1 lookup_groups 规范（Tenant Schema）
+
+- `module`: 业务模块标识（如 `client` / `property` / `org`）
+- `key`: 领域键（如 `source` / `follow_purpose`）
+- 同一组内 `value` 不可重复（`UNIQUE(group_id, value)`）
+- `is_system = TRUE` 的项禁止物理删除（仅可停用）
+
+---
+
+## 五、统一实现约束
+
+1. **固定枚举值不可改名**：只能新增或停用，禁止修改既有 value。  
+2. **中文展示从字典取值**：前端/UI 不得硬编码中文。  
+3. **可配置枚举不得加固定 CHECK**：防止租户自定义被数据库约束阻断。  
+4. **跨模块同名枚举必须复用语义**：如 `status` 在不同领域必须使用 domain 区分，不允许混用。  
+5. **缓存规范**：
+   - 固定枚举：`public:enum_labels:{domain}`（建议 TTL 24h）
+   - 可配置枚举：`{schema}:setting:lookup:{module}.{key}`（TTL 300s）
+
+---
+
+## 六、变更流程（必须同步）
+
+新增或修改任一枚举时，必须同时更新：
+
+1. 本文档 `ENUMS.md`
+2. 对应 `DATA_MODEL_*.md` 字段定义（CHECK / 注释 / 业务规则）
+3. `enum_labels` 种子数据（若为固定枚举）或 `lookup_groups/items` fixture（若为可配置枚举）
+4. 服务层缓存失效逻辑（Redis key）
+
+---
+
+## 七、与 ADR 的一致性说明
+
+本文件已对齐以下冻结决策：
+
+- 固定枚举与可配置枚举双轨并存
+- 状态机和值域以文档为权威来源
+- Tenant 级可配置枚举统一由 `setting` 模块托管
+- Agent 编码前先读枚举标准，禁止各模块自行定义“影子枚举”