Files

Shen Wei 712a33fbac 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 模板

2026-04-27 15:33:12 +08:00

18 KiB

Raw Blame History

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 采用两层枚举体系：

固定枚举（Fixed Enum）
- 值域固定，受 CHECK 或强业务约束保护
- 作为系统契约，不能随意改值
- 可落地到 public.enum_labels（用于统一标签）
可配置枚举（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 的项禁止物理删除（仅可停用）

五、统一实现约束

固定枚举值不可改名：只能新增或停用，禁止修改既有 value。
中文展示从字典取值：前端/UI 不得硬编码中文。
可配置枚举不得加固定 CHECK：防止租户自定义被数据库约束阻断。
跨模块同名枚举必须复用语义：如 status 在不同领域必须使用 domain 区分，不允许混用。
缓存规范：
- 固定枚举：public:enum_labels:{domain}（建议 TTL 24h）
- 可配置枚举：{schema}:setting:lookup:{module}.{key}（TTL 300s）

六、变更流程（必须同步）

新增或修改任一枚举时，必须同时更新：

本文档 ENUMS.md
对应 DATA_MODEL_*.md 字段定义（CHECK / 注释 / 业务规则）
enum_labels 种子数据（若为固定枚举）或 lookup_groups/items fixture（若为可配置枚举）
服务层缓存失效逻辑（Redis key）

七、与 ADR 的一致性说明

本文件已对齐以下冻结决策：

固定枚举与可配置枚举双轨并存
状态机和值域以文档为权威来源
Tenant 级可配置枚举统一由 setting 模块托管
Agent 编码前先读枚举标准，禁止各模块自行定义“影子枚举”

18 KiB Raw Blame History Unescape Escape