注释补全
This commit is contained in:
Shen Wei
@@ -184,136 +184,136 @@
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE properties (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
|
||||
-- ── 基础分类 ──
|
||||
property_type VARCHAR(20) NOT NULL
|
||||
property_type VARCHAR(20) NOT NULL -- 房源类型：residential=住宅 / villa=别墅 / commercial_residential=商住 / shop=商铺 / office=写字楼 / other=其他（详见 ENUMS.md §property_type）
|
||||
CHECK (property_type IN ('residential','villa','commercial_residential',
|
||||
'shop','office','other')),
|
||||
|
||||
-- ── 交易状态 ──
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'for_sale'
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'for_sale' -- 房源交易状态：for_sale=出售 / for_rent=出租 / for_sale_rent=租售 / suspended=暂缓 / sold_elsewhere=他售 / rented_elsewhere=他租 / sold=成交 / unlisted=未挂牌（详见 ENUMS.md §status）
|
||||
CHECK (status IN ('for_sale','for_rent','for_sale_rent',
|
||||
'suspended','sold_elsewhere','rented_elsewhere',
|
||||
'sold','unlisted')),
|
||||
|
||||
-- ── 流通属性 ──
|
||||
attribute VARCHAR(20) NOT NULL DEFAULT 'public'
|
||||
attribute VARCHAR(20) NOT NULL DEFAULT 'public' -- 房源流通属性：public=公盘 / private=私盘 / special=特盘 / sealed=封盘；控制可见范围（详见 ENUMS.md §attribute）
|
||||
CHECK (attribute IN ('public','private','special','sealed')),
|
||||
private_reason TEXT, -- 私盘/封盘必填说明
|
||||
private_reason TEXT, -- 私盘/封盘必填说明（attribute 为 private/sealed 时必填，最多200字）
|
||||
|
||||
-- ── 位置信息 ──
|
||||
complex_id UUID NOT NULL REFERENCES complexes(id) ON DELETE RESTRICT,
|
||||
building_id UUID REFERENCES buildings(id) ON DELETE SET NULL,
|
||||
block_no VARCHAR(30), -- 栋/幢/弄号
|
||||
unit_no VARCHAR(30), -- 单元号
|
||||
room_no VARCHAR(30), -- 房号/门牌号
|
||||
floor SMALLINT NOT NULL, -- 所在楼层
|
||||
total_floors SMALLINT NOT NULL, -- 总楼层
|
||||
CONSTRAINT chk_floor CHECK (floor > 0 AND floor <= total_floors),
|
||||
complex_id UUID NOT NULL REFERENCES complexes(id) ON DELETE RESTRICT, -- 所属楼盘（关联 complexes 表，房源必须挂在楼盘下，禁止级联删除）
|
||||
building_id UUID REFERENCES buildings(id) ON DELETE SET NULL, -- 所属楼栋（关联 buildings 表；楼栋被删除时置 NULL）
|
||||
block_no VARCHAR(30), -- 栋/幢/弄号（如"3栋"、"A幢"；与 unit_no 组合定位具体位置）
|
||||
unit_no VARCHAR(30), -- 单元号（如"1单元"、"055"）
|
||||
room_no VARCHAR(30), -- 房号/门牌号（如"0301"、"1502"）
|
||||
floor SMALLINT NOT NULL, -- 所在楼层（正整数，不超过 total_floors；CheckConstraint 校验）
|
||||
total_floors SMALLINT NOT NULL, -- 楼栋总层数（正整数）
|
||||
CONSTRAINT chk_floor CHECK (floor > 0 AND floor <= total_floors), -- 楼层合法性约束：所在楼层必须 > 0 且 ≤ 总楼层
|
||||
|
||||
-- ── 户型 ──
|
||||
bedroom_count SMALLINT NOT NULL DEFAULT 0, -- 室
|
||||
living_room_count SMALLINT NOT NULL DEFAULT 0, -- 厅
|
||||
bathroom_count SMALLINT NOT NULL DEFAULT 0, -- 卫
|
||||
kitchen_count SMALLINT NOT NULL DEFAULT 0, -- 厨
|
||||
balcony_count SMALLINT NOT NULL DEFAULT 0, -- 阳台数
|
||||
bedroom_count SMALLINT NOT NULL DEFAULT 0, -- 卧室数（室）
|
||||
living_room_count SMALLINT NOT NULL DEFAULT 0, -- 客厅/餐厅数（厅）
|
||||
bathroom_count SMALLINT NOT NULL DEFAULT 0, -- 卫生间数（卫）
|
||||
kitchen_count SMALLINT NOT NULL DEFAULT 0, -- 厨房数（厨）
|
||||
balcony_count SMALLINT NOT NULL DEFAULT 0, -- 阳台数（0=无阳台）
|
||||
|
||||
-- ── 面积 ──
|
||||
area NUMERIC(8,2) NOT NULL, -- 建筑面积 m²
|
||||
inner_area NUMERIC(8,2), -- 套内面积 m²
|
||||
area NUMERIC(8,2) NOT NULL, -- 建筑面积（m²，含公摊；录入必填）
|
||||
inner_area NUMERIC(8,2), -- 套内面积（m²，不含公摊；选填，编辑页专属字段）
|
||||
|
||||
-- ── 价格 ──
|
||||
sale_price NUMERIC(12,2), -- 挂牌售价（万元）
|
||||
sale_bottom_price NUMERIC(12,2), -- 售底价（万元，内部可见）
|
||||
sale_record_price NUMERIC(12,2), -- 备案/核验价（万元）
|
||||
rent_price NUMERIC(10,2), -- 挂牌租价（元/月）
|
||||
sale_price NUMERIC(12,2), -- 挂牌售价（万元；出售类房源必填，出租类可为 NULL）
|
||||
sale_bottom_price NUMERIC(12,2), -- 售底价（万元；业主心理底价，仅内部可见，不对外展示）
|
||||
sale_record_price NUMERIC(12,2), -- 备案/核验价（万元；填写后同步至营销库）
|
||||
rent_price NUMERIC(10,2), -- 挂牌租价（元/月；出租类房源使用）
|
||||
|
||||
-- ── 基础物理属性 ──
|
||||
orientation VARCHAR(10)
|
||||
orientation VARCHAR(10) -- 朝向：east=东 / south=南 / west=西 / north=北 / southeast=东南 / northeast=东北 / east_west=东西 / south_north=南北 / northwest=西北 / southwest=西南（详见 ENUMS.md §orientation）
|
||||
CHECK (orientation IN ('east','south','west','north',
|
||||
'southeast','northeast','east_west',
|
||||
'south_north','northwest','southwest')),
|
||||
decoration VARCHAR(10)
|
||||
decoration VARCHAR(10) -- 装修情况：rough=毛坯 / plain=清水 / simple=简装 / medium=中装 / fine=精装 / luxury=豪装（详见 ENUMS.md §decoration）
|
||||
CHECK (decoration IN ('rough','plain','simple','medium',
|
||||
'fine','luxury')),
|
||||
has_elevator BOOLEAN,
|
||||
built_year SMALLINT,
|
||||
has_elevator BOOLEAN, -- 是否有电梯：true=有 / false=无 / NULL=未确认
|
||||
built_year SMALLINT, -- 建成年份（如 2018；可空，老房源无记录；建成年代为空可能影响营销发房）
|
||||
|
||||
-- ── 用途 ──
|
||||
usage_type VARCHAR(30), -- 住宅/商住/商业/普通住宅/花园洋房 等
|
||||
usage_subtype VARCHAR(30), -- 细分用途
|
||||
usage_type VARCHAR(30), -- 房屋用途大类（如：住宅 / 商住 / 商业；对应更改用途浮窗第一级下拉）
|
||||
usage_subtype VARCHAR(30), -- 房屋用途细分小类（如：普通住宅 / 花园洋房；对应更改用途浮窗第二级下拉）
|
||||
|
||||
-- ── 商铺专属 ──
|
||||
shop_frontage NUMERIC(6,2), -- 开间（米）
|
||||
shop_depth NUMERIC(6,2), -- 进深（米）
|
||||
shop_height NUMERIC(6,2), -- 层高（米）
|
||||
shop_location VARCHAR(20)
|
||||
shop_frontage NUMERIC(6,2), -- 开间（米；商铺专属，住宅类为 NULL）
|
||||
shop_depth NUMERIC(6,2), -- 进深（米；商铺专属）
|
||||
shop_height NUMERIC(6,2), -- 层高（米；商铺专属）
|
||||
shop_location VARCHAR(20) -- 商铺位置类型：street=沿街 / mall=商场内 / residential=住宅底商 / ground_floor=楼栋底层 / complex=综合体（商铺专属）
|
||||
CHECK (shop_location IS NULL OR
|
||||
shop_location IN ('street','mall','residential',
|
||||
'ground_floor','complex')),
|
||||
|
||||
-- ── 房屋状态 ──
|
||||
house_status VARCHAR(20)
|
||||
house_status VARCHAR(20) -- 房屋现状：owner_occupied=业主自住 / vacant=空置 / tenant_occupied=租客租住 / unknown=未知；影响带看安排
|
||||
CHECK (house_status IN ('owner_occupied','vacant',
|
||||
'tenant_occupied','unknown')),
|
||||
viewing_time VARCHAR(20)
|
||||
viewing_time VARCHAR(20) -- 看房时间安排：anytime=随时可看 / by_appointment=提前预约 / inconvenient=不方便看
|
||||
CHECK (viewing_time IN ('anytime','by_appointment','inconvenient')),
|
||||
|
||||
-- ── 等级与标签 ──
|
||||
grade VARCHAR(10)
|
||||
grade VARCHAR(10) -- 房源等级（业主出售意向）：A=急迫 / B=较强 / C=一般 / D=较弱（详见 ENUMS.md §grade）
|
||||
CHECK (grade IN ('A','B','C','D')),
|
||||
|
||||
-- ── 交易属性 ──
|
||||
ownership_years VARCHAR(30), -- 房本年限：不满2年/满2年/满5年 等
|
||||
ownership_years_detail VARCHAR(20), -- 满五/不满五
|
||||
ownership_nature VARCHAR(20)
|
||||
ownership_years VARCHAR(30), -- 房本年限：不满2年/满2年/满5年 等（影响交易税费）
|
||||
ownership_years_detail VARCHAR(20), -- 房本年限辅助说明：满五/不满五（与 ownership_years 组合使用）
|
||||
ownership_nature VARCHAR(20) -- 产权性质：commercial=商品房 / reform_housing=房改房 / collective=集资房 / economic=经济活用房
|
||||
CHECK (ownership_nature IS NULL OR
|
||||
ownership_nature IN ('commercial','reform_housing',
|
||||
'collective','economic')),
|
||||
is_only_house BOOLEAN, -- 唯一住房
|
||||
payment_method VARCHAR(30)
|
||||
is_only_house BOOLEAN, -- 是否唯一住房：true=唯一 / false=非唯一 / NULL=未确认；影响交易税费计算
|
||||
payment_method VARCHAR(30) -- 购房付款方式：full=一次付清 / mortgage=按揭付款 / installment=分批次付款 / advance=垫资解按
|
||||
CHECK (payment_method IS NULL OR
|
||||
payment_method IN ('full','mortgage','installment','advance')),
|
||||
tax_included VARCHAR(10)
|
||||
tax_included VARCHAR(10) -- 包税费方式：each_party=各付 / net=到手 / inclusive=包税
|
||||
CHECK (tax_included IS NULL OR
|
||||
tax_included IN ('each_party','net','inclusive')),
|
||||
has_mortgage BOOLEAN,
|
||||
has_loan BOOLEAN,
|
||||
has_seal BOOLEAN,
|
||||
has_restriction BOOLEAN,
|
||||
original_price NUMERIC(12,2), -- 原购价（万元）
|
||||
sale_reason TEXT, -- 售房原因（最多200字）
|
||||
has_mortgage BOOLEAN, -- 是否有抵押：true=有抵押 / false=无 / NULL=未确认
|
||||
has_loan BOOLEAN, -- 是否有贷款（未还清）：true=有 / false=无 / NULL=未确认
|
||||
has_seal BOOLEAN, -- 是否被查封：true=有查封 / false=无 / NULL=未确认
|
||||
has_restriction BOOLEAN, -- 是否有限制（其他限制）：true=有 / false=无 / NULL=未确认
|
||||
original_price NUMERIC(12,2), -- 原购价（万元；业主当年购入价，用于计算增值）
|
||||
sale_reason TEXT, -- 售房原因（业主出售理由，最多200字；如"置换"）
|
||||
|
||||
-- ── 营销备注 ──
|
||||
remarks TEXT, -- 房源备注（最多500字）
|
||||
remarks TEXT, -- 房源备注（经纪人内部备注，最多500字，不对外展示）
|
||||
|
||||
-- ── 相关方 ──
|
||||
first_recorder_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 首录方
|
||||
number_holder_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 号码方
|
||||
seller_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 出售方
|
||||
buyer_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 实买方
|
||||
first_recorder_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 首录方（最初录入该房源的经纪人；人员离职后置 NULL）
|
||||
number_holder_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 号码方（持有业主联系号码的经纪人；变更需走审批流）
|
||||
seller_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 出售方（负责出售跟进的经纪人）
|
||||
buyer_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 实买方（促成成交的买方经纪人）
|
||||
|
||||
-- ── 来源 ──
|
||||
source VARCHAR(50), -- 房源来源渠道（lookup_items 维护）
|
||||
source VARCHAR(50), -- 房源来源渠道（枚举值由 lookup_items 维护，如：门店拓客/转介绍/网络等）
|
||||
|
||||
-- ── 维护完成度（冗余缓存，Celery 定期重算）──
|
||||
completeness_score SMALLINT NOT NULL DEFAULT 0, -- 0-100
|
||||
completeness_score SMALLINT NOT NULL DEFAULT 0, -- 房源维护完成度评分（0-100；由 Celery 异步计算，非实时；前端列表页展示徽章）
|
||||
|
||||
-- ── 时间轨迹 ──
|
||||
listed_at TIMESTAMPTZ, -- 最近一次挂牌时间
|
||||
last_followed_at TIMESTAMPTZ, -- 最后跟进时间（冗余，加速排序）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
deleted_at TIMESTAMPTZ,
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
listed_at TIMESTAMPTZ, -- 最近一次挂牌时间（每次重新挂牌时更新）
|
||||
last_followed_at TIMESTAMPTZ, -- 最后跟进时间（冗余字段，由触发器自动维护，加速超时未跟进排序）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（系统自动）
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录最后更新时间（系统自动）
|
||||
deleted_at TIMESTAMPTZ, -- 软删除时间戳；NULL=未删除，非 NULL=已软删除
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL, -- 创建人（操作员工）
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL, -- 最后修改人（操作员工）
|
||||
|
||||
-- ── 全文检索向量 ──
|
||||
search_vector TSVECTOR,
|
||||
search_vector TSVECTOR, -- 全文检索向量（由触发器 trg_property_search_vector 自动维护，覆盖栋号/单元/房号/备注）
|
||||
|
||||
-- ── 乐观锁 ──
|
||||
version INTEGER NOT NULL DEFAULT 1 -- 每次 UPDATE 必须 +1；应用层检测 0 行受影响时抛 ConflictError
|
||||
version INTEGER NOT NULL DEFAULT 1 -- 乐观锁版本号（每次 UPDATE 必须 +1；应用层检测 0 行受影响时抛 ConflictError）
|
||||
);
|
||||
|
||||
-- ── 索引策略 ──
|
||||
@@ -389,38 +389,38 @@ CREATE INDEX idx_properties_my_properties ON properties
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE property_contacts (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表；房源删除时联级删除）
|
||||
|
||||
name VARCHAR(50) NOT NULL,
|
||||
gender VARCHAR(10) NOT NULL DEFAULT 'male'
|
||||
name VARCHAR(50) NOT NULL, -- 联系人姓名（如"张先生"；业主或其代理人的真实姓名）
|
||||
gender VARCHAR(10) NOT NULL DEFAULT 'male' -- 性别：male=先生 / female=女士；默认先生
|
||||
CHECK (gender IN ('male','female')),
|
||||
identity VARCHAR(20) NOT NULL DEFAULT 'contact'
|
||||
identity VARCHAR(20) NOT NULL DEFAULT 'contact' -- 联系人身份：owner=业主 / contact=联系人 / subletter=二房东 / tenant=租客 / agent=代理人 / corporate=企业法人；默认联系人
|
||||
CHECK (identity IN ('owner','contact','subletter',
|
||||
'tenant','agent','corporate')),
|
||||
-- owner=业主, contact=联系人, subletter=二房东, tenant=租客,
|
||||
-- agent=代理人, corporate=企业法人
|
||||
|
||||
-- 手机号：加密存储 + 哈希索引
|
||||
phone_enc BYTEA NOT NULL, -- AES-256-GCM 加密
|
||||
phone_hash VARCHAR(64) NOT NULL, -- SHA-256(phone)，去重查询
|
||||
phone2_enc BYTEA,
|
||||
phone2_hash VARCHAR(64),
|
||||
phone_enc BYTEA NOT NULL, -- 手机号1密文（AES-256-GCM 加密，不可直接查询）
|
||||
phone_hash VARCHAR(64) NOT NULL, -- 手机号1哈希（SHA-256，用于重复房源检测和精确查询）
|
||||
phone2_enc BYTEA, -- 手机号2密文（AES-256-GCM 加密；选填）
|
||||
phone2_hash VARCHAR(64), -- 手机号2哈希（SHA-256；phone2_enc 存在时必填）
|
||||
|
||||
wechat VARCHAR(100),
|
||||
qq VARCHAR(20),
|
||||
remarks TEXT,
|
||||
wechat VARCHAR(100), -- 微信号（选填；无数据时前端展示"-"）
|
||||
qq VARCHAR(20), -- QQ号（选填；无数据时前端展示"-"）
|
||||
remarks TEXT, -- 备注（最多200字；补充说明联系人情况）
|
||||
|
||||
-- 号码方标记（关联审批流）
|
||||
is_number_holder BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
number_holder_approved_at TIMESTAMPTZ,
|
||||
is_number_holder BOOLEAN NOT NULL DEFAULT FALSE, -- 是否为号码方：true=是号码方（审批通过）/ false=否；号码方变更须走审批流
|
||||
number_holder_approved_at TIMESTAMPTZ, -- 号码方审批通过时间；NULL=尚未成为号码方
|
||||
|
||||
sort_order INTEGER NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
deleted_at TIMESTAMPTZ,
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
sort_order INTEGER NOT NULL DEFAULT 0, -- 排序权重（数值越小越靠前；控制联系人在面板中的显示顺序）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（系统自动）
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录最后更新时间（系统自动）
|
||||
deleted_at TIMESTAMPTZ, -- 软删除时间戳；NULL=未删除，非 NULL=已软删除
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL, -- 创建人（操作员工）
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 最后修改人（操作员工）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_contacts_property ON property_contacts(property_id)
|
||||
@@ -444,33 +444,33 @@ CREATE INDEX idx_contacts_phone2_hash ON property_contacts(phone2_hash)
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE listing_histories (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE RESTRICT,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE RESTRICT, -- 所属房源（关联 properties 表；禁止级联删除，保留历史）
|
||||
|
||||
listing_type VARCHAR(20) NOT NULL
|
||||
listing_type VARCHAR(20) NOT NULL -- 挂牌类型：for_sale=出售挂牌 / for_rent=出租挂牌
|
||||
CHECK (listing_type IN ('for_sale','for_rent')),
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'active'
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'active' -- 挂牌状态：active=挂牌中 / ended=已结束
|
||||
CHECK (status IN ('active','ended')),
|
||||
|
||||
-- 价格快照
|
||||
sale_price NUMERIC(12,2),
|
||||
rent_price NUMERIC(10,2),
|
||||
sale_unit_price NUMERIC(10,2), -- 元/m²，计算字段
|
||||
sale_price NUMERIC(12,2), -- 本次挂牌售价快照（万元；出售挂牌时记录）
|
||||
rent_price NUMERIC(10,2), -- 本次挂牌租价快照（元/月；出租挂牌时记录）
|
||||
sale_unit_price NUMERIC(10,2), -- 本次挂牌售价单价（元/m²；由 sale_price ÷ area 计算后存储）
|
||||
|
||||
-- 交易信息快照
|
||||
ownership_years VARCHAR(30),
|
||||
is_only_house BOOLEAN,
|
||||
tax_included VARCHAR(10),
|
||||
sale_reason TEXT,
|
||||
ownership_years VARCHAR(30), -- 本次挂牌时的房本年限快照（如"满2年"）
|
||||
is_only_house BOOLEAN, -- 本次挂牌时的唯一住房状态快照
|
||||
tax_included VARCHAR(10), -- 本次挂牌时的包税费方式快照（each_party=各付 / net=到手 / inclusive=包税）
|
||||
sale_reason TEXT, -- 本次挂牌时的售房原因快照
|
||||
|
||||
-- 经纪人快照（防止人员变动后丢失历史数据）
|
||||
seller_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
seller_agent_snapshot JSONB, -- {name, store_group, org_unit_name}
|
||||
seller_agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 本次挂牌的出售经纪人（人员离职后置 NULL，但 snapshot 保留）
|
||||
seller_agent_snapshot JSONB, -- 出售经纪人快照（{name, store_group, org_unit_name}；防止人员变动后数据丢失）
|
||||
|
||||
started_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
ended_at TIMESTAMPTZ,
|
||||
started_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 本次挂牌开始时间
|
||||
ended_at TIMESTAMPTZ, -- 本次挂牌结束时间；NULL=当前仍在挂牌中
|
||||
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 记录创建时间（系统自动）
|
||||
-- 无 deleted_at：此表记录不可删除
|
||||
);
|
||||
|
||||
@@ -489,21 +489,21 @@ CREATE INDEX idx_listing_histories_active ON listing_histories(property_id)
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE price_changes (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE RESTRICT,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE RESTRICT, -- 所属房源（关联 properties 表；禁止级联删除，保留调价历史）
|
||||
|
||||
old_sale_price NUMERIC(12,2),
|
||||
new_sale_price NUMERIC(12,2),
|
||||
old_bottom_price NUMERIC(12,2),
|
||||
new_bottom_price NUMERIC(12,2),
|
||||
old_record_price NUMERIC(12,2),
|
||||
new_record_price NUMERIC(12,2),
|
||||
old_rent_price NUMERIC(10,2),
|
||||
new_rent_price NUMERIC(10,2),
|
||||
old_sale_price NUMERIC(12,2), -- 调价前挂牌售价（万元；NULL=首次定价）
|
||||
new_sale_price NUMERIC(12,2), -- 调价后挂牌售价（万元）
|
||||
old_bottom_price NUMERIC(12,2), -- 调价前售底价（万元；NULL=未设置）
|
||||
new_bottom_price NUMERIC(12,2), -- 调价后售底价（万元；NULL=本次不变更底价）
|
||||
old_record_price NUMERIC(12,2), -- 调价前备案/核验价（万元；NULL=未设置）
|
||||
new_record_price NUMERIC(12,2), -- 调价后备案/核验价（万元；NULL=本次不变更）
|
||||
old_rent_price NUMERIC(10,2), -- 调价前挂牌租价（元/月；NULL=非出租类或未设置）
|
||||
new_rent_price NUMERIC(10,2), -- 调价后挂牌租价（元/月）
|
||||
|
||||
change_reason TEXT NOT NULL, -- 最多200字
|
||||
changed_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
changed_by UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT
|
||||
change_reason TEXT NOT NULL, -- 调价原因（必填，最多200字；如"业主主动降价"）
|
||||
changed_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 调价操作时间
|
||||
changed_by UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT -- 操作人（关联 staff 表；禁止置 NULL，保留审计追溯）
|
||||
-- 无 deleted_at：不可删除
|
||||
);
|
||||
|
||||
@@ -523,42 +523,42 @@ CREATE INDEX idx_price_changes_time ON price_changes(property_id, changed_at DES
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE follow_logs (
|
||||
id UUID NOT NULL DEFAULT gen_random_uuid(),
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 分区键，必须在最前声明
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID NOT NULL DEFAULT gen_random_uuid(), -- 主键（与 created_at 组成复合主键，分区表要求）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（分区键，必须在最前声明；系统自动）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
log_type VARCHAR(30) NOT NULL
|
||||
log_type VARCHAR(30) NOT NULL -- 跟进日志类型：written=经纪人主动写入 / modified=字段变更自动生成 / sensitive_op=敏感操作跟进 / sensitive_view=敏感信息查看（不可删）/ other=其他 / system=系统日志
|
||||
CHECK (log_type IN ('written','modified','sensitive_op',
|
||||
'sensitive_view','other','system')),
|
||||
|
||||
-- 写入跟进专用字段
|
||||
purpose VARCHAR(50), -- 跟进目的（lookup_items 维护）
|
||||
content TEXT, -- 最少6字，最多500字
|
||||
purpose VARCHAR(50), -- 跟进目的（枚举值由 lookup_items 维护，如：电话/业主跟进/议价/带看；仅 written 类型使用）
|
||||
content TEXT, -- 跟进内容（最少6字，最多500字；仅 written 类型必填）
|
||||
|
||||
-- AI 辅助判断标签
|
||||
ai_tag VARCHAR(20)
|
||||
ai_tag VARCHAR(20) -- AI 辅助标签：ai_for_sale=AI判断业主在售 / ai_not_for_sale=AI判断业主不售；由系统根据跟进内容智能分析后打标
|
||||
CHECK (ai_tag IS NULL OR ai_tag IN ('ai_for_sale','ai_not_for_sale')),
|
||||
|
||||
-- 修改跟进专用字段
|
||||
change_detail JSONB,
|
||||
change_detail JSONB, -- 字段变更明细（格式：{\"field\": \"sale_price\", \"old\": 850, \"new\": 800, \"label\": \"售价\"}；modified 类型使用）
|
||||
-- 格式：{"field": "sale_price", "old": 850, "new": 800, "label": "售价"}
|
||||
|
||||
-- 系统显示标签
|
||||
log_tag VARCHAR(50),
|
||||
log_tag VARCHAR(50), -- 前端展示标签（如：查看号码/图片下载/改状态/改价格/改等级/修改相关方；对应跟进日志时间线显示的【方括号标签】）
|
||||
-- 如：查看号码/图片下载/改状态/改价格/改等级/修改相关方
|
||||
|
||||
-- 可见性控制
|
||||
is_public BOOLEAN NOT NULL DEFAULT TRUE,
|
||||
is_public BOOLEAN NOT NULL DEFAULT TRUE, -- 是否公开：true=全员可见 / false=仅本人及上级可见
|
||||
-- FALSE = 仅本人及上级可见
|
||||
|
||||
-- 操作人
|
||||
operator_id UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
operator_snapshot JSONB, -- {name, role, org_unit_name, store_group}
|
||||
operator_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 操作人（关联 staff 表；人员离职后置 NULL，但 snapshot 保留）
|
||||
operator_snapshot JSONB, -- 操作人快照（{name, role, org_unit_name, store_group}；防止人员离职后丢失显示信息）
|
||||
|
||||
-- 是否可删除（sensitive_view = FALSE，合规强制）
|
||||
is_deletable BOOLEAN NOT NULL DEFAULT TRUE,
|
||||
is_deletable BOOLEAN NOT NULL DEFAULT TRUE, -- 是否可软删除：false=敏感信息查看类型，合规要求不可删除
|
||||
|
||||
deleted_at TIMESTAMPTZ, -- 仅 is_deletable=TRUE 时可软删
|
||||
deleted_at TIMESTAMPTZ, -- 软删除时间戳；仅 is_deletable=TRUE 时可软删；NULL=未删除
|
||||
|
||||
PRIMARY KEY (id, created_at) -- 分区表主键必须包含分区键
|
||||
) PARTITION BY RANGE (created_at);
|
||||
@@ -595,16 +595,16 @@ CREATE INDEX idx_follow_logs_sensitive ON follow_logs(property_id, created_at DE
|
||||
|
||||
```sql
|
||||
CREATE TABLE follow_log_attachments (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
follow_log_id UUID NOT NULL REFERENCES follow_logs(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
follow_log_id UUID NOT NULL REFERENCES follow_logs(id) ON DELETE CASCADE, -- 所属跟进日志（关联 follow_logs 表；日志删除时联级删除）
|
||||
|
||||
file_key TEXT NOT NULL, -- Cloudflare R2 存储路径
|
||||
file_name VARCHAR(255) NOT NULL,
|
||||
file_size INTEGER NOT NULL, -- bytes
|
||||
file_type VARCHAR(10)
|
||||
file_key TEXT NOT NULL, -- 图片存储路径（Cloudflare R2 对象路径）
|
||||
file_name VARCHAR(255) NOT NULL, -- 原始文件名（用户上传时的文件名）
|
||||
file_size INTEGER NOT NULL, -- 文件大小（bytes；最大 20MB = 20971520）
|
||||
file_type VARCHAR(10) -- 文件格式：bmp / jpg / png / svg / gif（PRD 限定格式）
|
||||
CHECK (file_type IN ('bmp','jpg','png','svg','gif')),
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0, -- 排序权重（控制同一跟进附件的显示顺序）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 上传时间（系统自动）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_follow_attachments_log ON follow_log_attachments(follow_log_id);
|
||||
@@ -616,12 +616,12 @@ CREATE INDEX idx_follow_attachments_log ON follow_log_attachments(follow_log_id)
|
||||
|
||||
```sql
|
||||
CREATE TABLE follow_log_recordings (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
follow_log_id UUID NOT NULL REFERENCES follow_logs(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
follow_log_id UUID NOT NULL REFERENCES follow_logs(id) ON DELETE CASCADE, -- 所属跟进日志（关联 follow_logs 表；日志删除时联级删除）
|
||||
|
||||
file_key TEXT NOT NULL, -- Cloudflare R2 存储路径
|
||||
duration_seconds INTEGER, -- 录音时长（秒）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
file_key TEXT NOT NULL, -- 录音文件存储路径（Cloudflare R2 对象路径）
|
||||
duration_seconds INTEGER, -- 录音时长（秒；可空，上传时若能解析则填写）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 上传时间（系统自动）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_follow_recordings_log ON follow_log_recordings(follow_log_id);
|
||||
@@ -633,27 +633,27 @@ CREATE INDEX idx_follow_recordings_log ON follow_log_recordings(follow_log_id);
|
||||
|
||||
```sql
|
||||
CREATE TABLE property_keys (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
key_type VARCHAR(20) NOT NULL
|
||||
key_type VARCHAR(20) NOT NULL -- 钥匙类型：mechanical=机械钥匙 / password=密码（如密码门锁）
|
||||
CHECK (key_type IN ('mechanical','password')),
|
||||
|
||||
-- 钥匙持有方
|
||||
holder_id UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
holder_snapshot JSONB, -- {name, store_group}
|
||||
storage_unit_id UUID REFERENCES org_units(id) ON DELETE SET NULL, -- 保管部门
|
||||
holder_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 持有人（关联 staff 表；人员离职后置 NULL）
|
||||
holder_snapshot JSONB, -- 持有人快照（{name, store_group}；防止人员离职后丢失显示信息）
|
||||
storage_unit_id UUID REFERENCES org_units(id) ON DELETE SET NULL, -- 保管部门（关联 org_units 表；钥匙存放在哪个部门）
|
||||
|
||||
-- 他司钥匙标记
|
||||
is_other_agency BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
other_agency_info VARCHAR(30), -- 最多30字
|
||||
is_other_agency BOOLEAN NOT NULL DEFAULT FALSE, -- 是否为他中介公司的钥匙：true=是他司钥匙 / false=本司钥匙
|
||||
other_agency_info VARCHAR(30), -- 他司中介信息（最多30字；is_other_agency=true 时填写，如"链家"）
|
||||
|
||||
remarks TEXT, -- 最多200字
|
||||
remarks TEXT, -- 备注（最多200字；如密码内容等补充说明）
|
||||
|
||||
is_active BOOLEAN NOT NULL DEFAULT TRUE, -- FALSE=已归还/失效
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
is_active BOOLEAN NOT NULL DEFAULT TRUE, -- 是否有效：true=在管中 / false=已归还或失效
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（系统自动）
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录最后更新时间（系统自动）
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 创建人（操作员工）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_property_keys_property ON property_keys(property_id)
|
||||
@@ -666,12 +666,12 @@ CREATE INDEX idx_property_keys_property ON property_keys(property_id)
|
||||
|
||||
```sql
|
||||
CREATE TABLE key_attachments (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
key_id UUID NOT NULL REFERENCES property_keys(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
key_id UUID NOT NULL REFERENCES property_keys(id) ON DELETE CASCADE, -- 所属钥匙记录（关联 property_keys 表；钥匙删除时联级删除）
|
||||
|
||||
file_key TEXT NOT NULL,
|
||||
file_name VARCHAR(255) NOT NULL,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
file_key TEXT NOT NULL, -- 附件存储路径（Cloudflare R2 对象路径）
|
||||
file_name VARCHAR(255) NOT NULL, -- 原始文件名
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 上传时间（系统自动）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_key_attachments_key ON key_attachments(key_id);
|
||||
@@ -683,37 +683,37 @@ CREATE INDEX idx_key_attachments_key ON key_attachments(key_id);
|
||||
|
||||
```sql
|
||||
CREATE TABLE commissions (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
commission_type VARCHAR(50) NOT NULL, -- 独家委托/非独家委托（lookup_items 维护）
|
||||
period_start DATE NOT NULL,
|
||||
period_end DATE,
|
||||
is_open_ended BOOLEAN NOT NULL DEFAULT FALSE, -- 无固定结束日期
|
||||
commission_type VARCHAR(50) NOT NULL, -- 委托类型（独家委托/非独家委托；由 lookup_items 维护）
|
||||
period_start DATE NOT NULL, -- 委托开始日期
|
||||
period_end DATE, -- 委托结束日期（is_open_ended=true 时为 NULL）
|
||||
is_open_ended BOOLEAN NOT NULL DEFAULT FALSE, -- 是否无固定结束日期：true=长期委托 / false=有截止日期
|
||||
|
||||
-- 委托经纪人
|
||||
agent_id UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
agent_snapshot JSONB, -- {name, store_group}
|
||||
agent_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 委托经纪人（关联 staff 表；人员离职后置 NULL）
|
||||
agent_snapshot JSONB, -- 经纪人快照（{name, store_group}；防止人员变动后数据丢失）
|
||||
|
||||
signing_method VARCHAR(50), -- 签约方式（选择后动态展示委托书模板）
|
||||
|
||||
-- 委托人（产权人）信息
|
||||
owner_type VARCHAR(20) NOT NULL DEFAULT 'owner'
|
||||
owner_type VARCHAR(20) NOT NULL DEFAULT 'owner' -- 委托人类型：owner=产权人本人 / authorized_third=被授权第三方
|
||||
CHECK (owner_type IN ('owner','authorized_third')),
|
||||
property_owner_contact_id UUID REFERENCES property_contacts(id) ON DELETE SET NULL,
|
||||
owner_name VARCHAR(50),
|
||||
owner_id_type VARCHAR(20), -- 身份证/护照 等
|
||||
owner_id_number VARCHAR(50), -- 证件号（明文，仅供参考）
|
||||
owner_id_number_enc BYTEA, -- 证件号 AES-256-GCM 加密
|
||||
property_owner_contact_id UUID REFERENCES property_contacts(id) ON DELETE SET NULL, -- 关联联系人（property_contacts 表；若委托人已录入联系人）
|
||||
owner_name VARCHAR(50), -- 委托人姓名
|
||||
owner_id_type VARCHAR(20), -- 委托人证件类型（如：身份证/护照）
|
||||
owner_id_number VARCHAR(50), -- 委托人证件号明文（仅供参考，加密版本见下方）
|
||||
owner_id_number_enc BYTEA, -- 委托人证件号密文（AES-256-GCM 加密）
|
||||
|
||||
remarks TEXT, -- 最多200字
|
||||
remarks TEXT, -- 备注（最多200字）
|
||||
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'active'
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'active' -- 委托状态：active=有效 / expired=已过期 / cancelled=已取消
|
||||
CHECK (status IN ('active','expired','cancelled')),
|
||||
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（系统自动）
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录最后更新时间（系统自动）
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 创建人（操作员工）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_commissions_property ON commissions(property_id);
|
||||
@@ -727,17 +727,17 @@ CREATE INDEX idx_commissions_active ON commissions(property_id)
|
||||
|
||||
```sql
|
||||
CREATE TABLE commission_attachments (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
commission_id UUID NOT NULL REFERENCES commissions(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
commission_id UUID NOT NULL REFERENCES commissions(id) ON DELETE CASCADE, -- 所属委托（关联 commissions 表；委托删除时联级删除）
|
||||
|
||||
category VARCHAR(20) NOT NULL
|
||||
category VARCHAR(20) NOT NULL -- 附件分类：id_card=身份证 / property_cert=产权证书 / commission_letter=委托书 / other=其他材料
|
||||
CHECK (category IN ('id_card','property_cert',
|
||||
'commission_letter','other')),
|
||||
file_key TEXT NOT NULL,
|
||||
file_name VARCHAR(255) NOT NULL,
|
||||
file_size INTEGER,
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
file_key TEXT NOT NULL, -- 附件存储路径（Cloudflare R2 对象路径）
|
||||
file_name VARCHAR(255) NOT NULL, -- 原始文件名
|
||||
file_size INTEGER, -- 文件大小（bytes）
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0, -- 排序权重（数值越小越靠前）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 上传时间（系统自动）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_commission_attachments_commission ON commission_attachments(commission_id);
|
||||
@@ -749,23 +749,23 @@ CREATE INDEX idx_commission_attachments_commission ON commission_attachments(com
|
||||
|
||||
```sql
|
||||
CREATE TABLE field_surveys (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
status VARCHAR(10) NOT NULL DEFAULT 'draft'
|
||||
status VARCHAR(10) NOT NULL DEFAULT 'draft' -- 实勘状态：draft=草稿（未提交）/ submitted=已提交（已完成）
|
||||
CHECK (status IN ('draft','submitted')),
|
||||
|
||||
-- GPS 定位（实勘打卡）
|
||||
gps_latitude NUMERIC(10,7),
|
||||
gps_longitude NUMERIC(10,7),
|
||||
gps_accuracy NUMERIC(6,2), -- 精度（米）
|
||||
gps_latitude NUMERIC(10,7), -- GPS 纬度（实勘打卡位置；精度7位小数）
|
||||
gps_longitude NUMERIC(10,7), -- GPS 经度（实勘打卡位置；精度7位小数）
|
||||
gps_accuracy NUMERIC(6,2), -- GPS 精度（米；标注定位误差）
|
||||
|
||||
description TEXT, -- 实勘说明，最多200字
|
||||
description TEXT, -- 实勘说明（最多200字；经纪人现场情况描述）
|
||||
|
||||
submitted_at TIMESTAMPTZ,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
created_by UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT
|
||||
submitted_at TIMESTAMPTZ, -- 提交时间（status 变为 submitted 时记录；NULL=尚未提交）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录创建时间（系统自动）
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 记录最后更新时间（系统自动）
|
||||
created_by UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT -- 实勘人（操作员工；禁止置 NULL 保留审计）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_field_surveys_property ON field_surveys(property_id);
|
||||
@@ -779,22 +779,22 @@ CREATE INDEX idx_field_surveys_submitted ON field_surveys(property_id)
|
||||
|
||||
```sql
|
||||
CREATE TABLE survey_photos (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
survey_id UUID NOT NULL REFERENCES field_surveys(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
survey_id UUID NOT NULL REFERENCES field_surveys(id) ON DELETE CASCADE, -- 所属实勘（关联 field_surveys 表；实勘删除时联级删除）
|
||||
|
||||
category VARCHAR(20) NOT NULL
|
||||
category VARCHAR(20) NOT NULL -- 照片空间分类：layout=户型图 / living_room=客厅 / dining_room=餐厅 / bedroom=卧室 / bathroom=卫生间 / kitchen=厨房 / entrance=门厅 / balcony=阳台 / study=书房 / indoor_other=室内其他 / outdoor=外景
|
||||
CHECK (category IN ('layout','living_room','dining_room',
|
||||
'bedroom','bathroom','kitchen',
|
||||
'entrance','balcony','study',
|
||||
'indoor_other','outdoor')),
|
||||
file_key TEXT NOT NULL, -- Cloudflare R2 路径
|
||||
thumbnail_key TEXT, -- 缩略图路径
|
||||
file_size INTEGER,
|
||||
width INTEGER,
|
||||
height INTEGER,
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0,
|
||||
is_vr_screenshot BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
file_key TEXT NOT NULL, -- 原图存储路径（Cloudflare R2 对象路径）
|
||||
thumbnail_key TEXT, -- 缩略图路径（Cloudflare Images 自动生成）
|
||||
file_size INTEGER, -- 文件大小（bytes）
|
||||
width INTEGER, -- 图片宽度（像素；上传时解析）
|
||||
height INTEGER, -- 图片高度（像素；上传时解析）
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0, -- 排序权重（同一空间分类内，数值越小越靠前）
|
||||
is_vr_screenshot BOOLEAN NOT NULL DEFAULT FALSE, -- 是否为VR截图：true=全景/VR截图（区别于普通实拍照片）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 上传时间（系统自动）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_survey_photos_survey ON survey_photos(survey_id);
|
||||
@@ -812,28 +812,28 @@ CREATE INDEX idx_survey_photos_category ON survey_photos(survey_id, category);
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE property_photos (
|
||||
id UUID NOT NULL DEFAULT gen_random_uuid(),
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 分区键
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID NOT NULL DEFAULT gen_random_uuid(), -- 主键（与 created_at 组成复合主键，分区表要求）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 上传时间（分区键；系统自动）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
category VARCHAR(20) NOT NULL
|
||||
category VARCHAR(20) NOT NULL -- 照片分类：cover=封面 / entrance=门厅 / living_room=客厅 / dining_room=餐厅 / bedroom=卧室 / bathroom=卫生间 / kitchen=厨房 / balcony=阳台 / study=书房 / indoor_other=室内其他 / outdoor=外景 / panorama=全景
|
||||
CHECK (category IN ('cover','entrance','living_room',
|
||||
'dining_room','bedroom','bathroom',
|
||||
'kitchen','balcony','study',
|
||||
'indoor_other','outdoor','panorama')),
|
||||
|
||||
file_key TEXT NOT NULL, -- R2/S3 原图路径
|
||||
thumbnail_key TEXT, -- Cloudflare Images 生成的缩略图
|
||||
file_name VARCHAR(255),
|
||||
file_size INTEGER,
|
||||
width INTEGER,
|
||||
height INTEGER,
|
||||
file_key TEXT NOT NULL, -- 原图存储路径（Cloudflare R2/S3 对象路径）
|
||||
thumbnail_key TEXT, -- 缩略图路径（Cloudflare Images 自动生成）
|
||||
file_name VARCHAR(255), -- 原始文件名
|
||||
file_size INTEGER, -- 文件大小（bytes）
|
||||
width INTEGER, -- 图片宽度（像素；上传时解析）
|
||||
height INTEGER, -- 图片高度（像素；上传时解析）
|
||||
|
||||
is_cover BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0,
|
||||
is_cover BOOLEAN NOT NULL DEFAULT FALSE, -- 是否为封面图：true=封面；每套房源只能有一张封面（唯一约束保证）
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0, -- 排序权重（同一房源内，数值越小越靠前）
|
||||
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 最后更新时间（系统自动）
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL, -- 上传人（操作员工）
|
||||
|
||||
PRIMARY KEY (id, created_at) -- 分区表主键必须包含分区键
|
||||
) PARTITION BY RANGE (created_at);
|
||||
@@ -861,21 +861,21 @@ CREATE UNIQUE INDEX idx_property_photos_unique_cover
|
||||
|
||||
```sql
|
||||
CREATE TABLE property_attachments (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
|
||||
category VARCHAR(20) NOT NULL DEFAULT 'other'
|
||||
category VARCHAR(20) NOT NULL DEFAULT 'other' -- 附件分类：id_card=身份证 / property_cert=产权证书 / commission_letter=委托书 / other=其他材料
|
||||
CHECK (category IN ('id_card','property_cert',
|
||||
'commission_letter','other')),
|
||||
|
||||
file_key TEXT NOT NULL,
|
||||
file_name VARCHAR(255) NOT NULL,
|
||||
file_size INTEGER NOT NULL,
|
||||
file_type VARCHAR(50), -- MIME type
|
||||
file_key TEXT NOT NULL, -- 附件存储路径（Cloudflare R2 对象路径）
|
||||
file_name VARCHAR(255) NOT NULL, -- 原始文件名
|
||||
file_size INTEGER NOT NULL, -- 文件大小（bytes）
|
||||
file_type VARCHAR(50), -- MIME 类型（如 application/pdf、image/jpeg）
|
||||
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
sort_order SMALLINT NOT NULL DEFAULT 0, -- 排序权重（控制同一房源附件的显示顺序）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 上传时间（系统自动）
|
||||
created_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 上传人（操作员工）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_property_attachments_property ON property_attachments(property_id);
|
||||
@@ -889,21 +889,21 @@ CREATE INDEX idx_property_attachments_category ON property_attachments(property_
|
||||
```sql
|
||||
-- 1:1 扩展表，营销标题/核心卖点/业主心态/户型介绍/小区介绍
|
||||
CREATE TABLE property_marketing (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（1:1 关联 properties 表）
|
||||
|
||||
marketing_title VARCHAR(30), -- 营销标题，0-30字
|
||||
core_selling_points TEXT, -- 核心卖点，最多200字
|
||||
owner_attitude TEXT, -- 业主心态，最多200字
|
||||
layout_description TEXT, -- 户型介绍，最多200字
|
||||
complex_description TEXT, -- 小区介绍，最多200字
|
||||
marketing_title VARCHAR(30), -- 营销标题（0-30字；前端发房时展示给买家的吸睛标题）
|
||||
core_selling_points TEXT, -- 核心卖点（最多200字；展示给买家的重点卖点说明）
|
||||
owner_attitude TEXT, -- 业主心态（最多200字；仅内部可见，描述业主议价空间和心理状态）
|
||||
layout_description TEXT, -- 户型介绍（最多200字；房源户型特点描述，面向买家展示）
|
||||
complex_description TEXT, -- 小区介绍（最多200字；楼盘/小区周边配套描述）
|
||||
|
||||
-- AI 生成标记
|
||||
ai_generated_points BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
ai_generated_attitude BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
ai_generated_points BOOLEAN NOT NULL DEFAULT FALSE, -- 核心卖点是否由 AI 生成：true=AI辅助生成（经纪人确认后使用）
|
||||
ai_generated_attitude BOOLEAN NOT NULL DEFAULT FALSE, -- 业主心态是否由 AI 生成：true=AI辅助生成
|
||||
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 最后更新时间（系统自动）
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 最后修改人（操作员工）
|
||||
);
|
||||
```
|
||||
|
||||
@@ -914,22 +914,22 @@ CREATE TABLE property_marketing (
|
||||
```sql
|
||||
-- 1:1 扩展表，存储产权证相关信息
|
||||
CREATE TABLE property_certificates (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（1:1 关联 properties 表）
|
||||
|
||||
owner_name VARCHAR(100),
|
||||
owner_id_number VARCHAR(50), -- 身份证号/统一社会信用代码
|
||||
owner_cert_type VARCHAR(20), -- 身份证/护照/营业执照
|
||||
property_location VARCHAR(500), -- 房屋坐落（产权证书上的地址），最多50字
|
||||
owner_name VARCHAR(100), -- 产权人姓名（产权证书上登记的所有权人）
|
||||
owner_id_number VARCHAR(50), -- 证件号码（身份证号/统一社会信用代码等）
|
||||
owner_cert_type VARCHAR(20), -- 证件类型（如：身份证/护照/营业执照）
|
||||
property_location VARCHAR(500), -- 房屋坐落（产权证书上的完整地址，最多500字）
|
||||
|
||||
cert_status VARCHAR(30), -- 产证状态
|
||||
cert_no VARCHAR(100), -- 产证号
|
||||
first_registered_at DATE, -- 首次登记时间
|
||||
ownership_nature VARCHAR(30), -- 权属性质
|
||||
land_nature VARCHAR(30), -- 土地性质
|
||||
cert_status VARCHAR(30), -- 产证状态（如：已过户/抵押中/查封/正常）
|
||||
cert_no VARCHAR(100), -- 产权证号（不动产权证书编号）
|
||||
first_registered_at DATE, -- 首次登记时间（产权证上的初始登记日期）
|
||||
ownership_nature VARCHAR(30), -- 权属性质（如：商品房/经济适用房/回迁房）
|
||||
land_nature VARCHAR(30), -- 土地性质（如：国有/集体/划拨/出让）
|
||||
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL
|
||||
updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 最后更新时间（系统自动）
|
||||
updated_by UUID REFERENCES staff(id) ON DELETE SET NULL -- 最后修改人（操作员工）
|
||||
);
|
||||
```
|
||||
|
||||
@@ -945,22 +945,22 @@ CREATE TABLE property_certificates (
|
||||
-- ============================================================
|
||||
|
||||
CREATE TABLE property_completeness (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（1:1 关联 properties 表）
|
||||
|
||||
score_core_info SMALLINT NOT NULL DEFAULT 0, -- 重点信息 满分8
|
||||
score_attachment SMALLINT NOT NULL DEFAULT 0, -- 附件 满分8
|
||||
score_survey SMALLINT NOT NULL DEFAULT 0, -- 实勘 满分16
|
||||
score_vr SMALLINT NOT NULL DEFAULT 0, -- VR 满分8
|
||||
score_key SMALLINT NOT NULL DEFAULT 0, -- 钥匙 满分10
|
||||
score_commission SMALLINT NOT NULL DEFAULT 0, -- 委托 满分10
|
||||
score_verification SMALLINT NOT NULL DEFAULT 0, -- 验证 满分7
|
||||
score_follow_up SMALLINT NOT NULL DEFAULT 0, -- 跟进 满分8
|
||||
score_viewing SMALLINT NOT NULL DEFAULT 0, -- 带看 满分8
|
||||
score_other SMALLINT NOT NULL DEFAULT 0, -- 其他 满分7
|
||||
total_score SMALLINT NOT NULL DEFAULT 0, -- 总分 0-100
|
||||
score_core_info SMALLINT NOT NULL DEFAULT 0, -- 重点信息得分（满分8；包含房源核心字段完整度）
|
||||
score_attachment SMALLINT NOT NULL DEFAULT 0, -- 附件得分（满分8；身份证/产权证/委托书等材料上传情况）
|
||||
score_survey SMALLINT NOT NULL DEFAULT 0, -- 实勘得分（满分16；实勘照片和报告完整度）
|
||||
score_vr SMALLINT NOT NULL DEFAULT 0, -- VR得分（满分8；VR/全景照片上传情况）
|
||||
score_key SMALLINT NOT NULL DEFAULT 0, -- 钥匙得分（满分10；钥匙托管情况）
|
||||
score_commission SMALLINT NOT NULL DEFAULT 0, -- 委托得分（满分10；独家/普通委托书情况）
|
||||
score_verification SMALLINT NOT NULL DEFAULT 0, -- 验证得分（满分7；房源信息核实情况）
|
||||
score_follow_up SMALLINT NOT NULL DEFAULT 0, -- 跟进得分（满分8；近期跟进记录情况）
|
||||
score_viewing SMALLINT NOT NULL DEFAULT 0, -- 带看得分（满分8；带看记录完整度）
|
||||
score_other SMALLINT NOT NULL DEFAULT 0, -- 其他得分（满分7；其他加分项）
|
||||
total_score SMALLINT NOT NULL DEFAULT 0, -- 维护完成度总分（0-100；供列表排序用，与 properties.completeness_score 冗余）
|
||||
|
||||
calculated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
calculated_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 最近一次异步计算完成时间
|
||||
);
|
||||
```
|
||||
|
||||
@@ -971,18 +971,18 @@ CREATE TABLE property_completeness (
|
||||
```sql
|
||||
-- 标签字典（系统预置 + 运营自定义）
|
||||
CREATE TABLE property_tags (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
name VARCHAR(50) NOT NULL,
|
||||
color VARCHAR(7), -- HEX 颜色，如 #FF5733
|
||||
is_system BOOLEAN NOT NULL DEFAULT FALSE, -- 系统预置标签不可删除
|
||||
sort_order INTEGER NOT NULL DEFAULT 0,
|
||||
is_active BOOLEAN NOT NULL DEFAULT TRUE
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
name VARCHAR(50) NOT NULL, -- 标签名称（最多50字；如：学区/地铁口/满五唯一）
|
||||
color VARCHAR(7), -- 显示颜色（HEX 色值，如 #FF5733；前端标签徽章颜色）
|
||||
is_system BOOLEAN NOT NULL DEFAULT FALSE, -- 是否系统预置：true=系统内置标签不可删除；false=运营自定义标签可删
|
||||
sort_order INTEGER NOT NULL DEFAULT 0, -- 排序权重（数值越小越靠前）
|
||||
is_active BOOLEAN NOT NULL DEFAULT TRUE -- 是否启用：false=已停用不再展示
|
||||
);
|
||||
|
||||
-- 房源 ↔ 标签 多对多
|
||||
CREATE TABLE property_tag_relations (
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
tag_id UUID NOT NULL REFERENCES property_tags(id) ON DELETE CASCADE,
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
tag_id UUID NOT NULL REFERENCES property_tags(id) ON DELETE CASCADE, -- 所属标签（关联 property_tags 表）
|
||||
PRIMARY KEY (property_id, tag_id)
|
||||
);
|
||||
|
||||
@@ -997,9 +997,9 @@ CREATE INDEX idx_property_tags_tag ON property_tag_relations(tag_id);
|
||||
```sql
|
||||
-- 经纪人收藏房源（快速访问）
|
||||
CREATE TABLE property_favorites (
|
||||
staff_id UUID NOT NULL REFERENCES staff(id) ON DELETE CASCADE,
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
staff_id UUID NOT NULL REFERENCES staff(id) ON DELETE CASCADE, -- 收藏人（关联 staff 表；员工注销时删除收藏记录）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 收藏的房源（关联 properties 表）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 收藏时间（系统自动）
|
||||
PRIMARY KEY (staff_id, property_id)
|
||||
);
|
||||
|
||||
@@ -1013,15 +1013,15 @@ CREATE INDEX idx_property_favorites_staff ON property_favorites(staff_id);
|
||||
```sql
|
||||
-- 1:1，标记某套房源是否受保护（防止被他人抢单/公盘化）
|
||||
CREATE TABLE property_protections (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL UNIQUE REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（1:1 关联 properties 表）
|
||||
|
||||
is_protected BOOLEAN NOT NULL DEFAULT FALSE,
|
||||
reason TEXT,
|
||||
start_at TIMESTAMPTZ,
|
||||
end_at TIMESTAMPTZ,
|
||||
set_by UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
||||
is_protected BOOLEAN NOT NULL DEFAULT FALSE, -- 是否处于保护状态：true=受保护（防止被他人抢单/公盘化）/ false=未保护
|
||||
reason TEXT, -- 保护原因（说明为何启用保护）
|
||||
start_at TIMESTAMPTZ, -- 保护开始时间（NULL=尚未生效）
|
||||
end_at TIMESTAMPTZ, -- 保护到期时间（NULL=长期保护）
|
||||
set_by UUID REFERENCES staff(id) ON DELETE SET NULL, -- 设置人（关联 staff 表；人员离职后置 NULL）
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW() -- 记录创建时间（系统自动）
|
||||
);
|
||||
```
|
||||
|
||||
@@ -1032,19 +1032,19 @@ CREATE TABLE property_protections (
|
||||
```sql
|
||||
-- 号码方变更审批流：经纪人申请，上级审批
|
||||
CREATE TABLE number_holder_approvals (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE,
|
||||
contact_id UUID NOT NULL REFERENCES property_contacts(id) ON DELETE CASCADE,
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(), -- 主键（系统生成，业务无关）
|
||||
property_id UUID NOT NULL REFERENCES properties(id) ON DELETE CASCADE, -- 所属房源（关联 properties 表）
|
||||
contact_id UUID NOT NULL REFERENCES property_contacts(id) ON DELETE CASCADE, -- 申请变更的联系方（关联 property_contacts 表；即号码方）
|
||||
|
||||
applicant_id UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT,
|
||||
approver_id UUID REFERENCES staff(id) ON DELETE SET NULL,
|
||||
applicant_id UUID NOT NULL REFERENCES staff(id) ON DELETE RESTRICT, -- 申请人（关联 staff 表；提交号码方变更申请的经纪人；禁止置 NULL 保留审计）
|
||||
approver_id UUID REFERENCES staff(id) ON DELETE SET NULL, -- 审批人（关联 staff 表；上级审批人；审批前为 NULL）
|
||||
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'pending'
|
||||
status VARCHAR(20) NOT NULL DEFAULT 'pending' -- 审批状态：pending=待审批 / approved=已通过 / rejected=已驳回
|
||||
CHECK (status IN ('pending','approved','rejected')),
|
||||
remarks TEXT,
|
||||
remarks TEXT, -- 审批备注（审批人填写的意见或驳回原因）
|
||||
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
|
||||
decided_at TIMESTAMPTZ
|
||||
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), -- 申请提交时间（系统自动）
|
||||
decided_at TIMESTAMPTZ -- 审批决定时间（NULL=尚未审批）
|
||||
);
|
||||
|
||||
CREATE INDEX idx_number_holder_approvals_status ON number_holder_approvals(status)
|
||||
|
||||
Reference in New Issue
Block a user