楼宇特征库设计（Building Profile Library - BPL）¶

文档编号：DOC-P51-B / BPL 版本：V1.1 创建日期：2026-08-05 维护人：BO / TL / DT 关联文档：MDS-D、QMD、CPT-D 历史：吸收原 TND D03 楼宇数据库设计（业务设计部分迁移至本文件，技术实现方案仍归 TND）

一、定位¶

楼宇特征库（BPL）是 MDS 主数据服务的核心子库之一，统一管理平台服务覆盖范围内全部楼宇的档案信息，包括楼宇类型、电梯配置、楼层、管理要求、停车条件等。

BPL 是香港市场最独特的主数据——楼宇类型是影响报价的最大变量（唐楼系数 2.5 vs 豪宅 0.9，差异 178%）。

BPL 与 QMD 报价模型的关系： - BPL 是主数据源：维护楼宇档案、类型系数、电梯/楼层信息 - QMD 是消费方：从 BPL 读取楼宇系数与楼层附加费参数 - 校准反哺：CPT 师傅现场核实数据 → BPL 档案修正

二、楼宇类型体系¶

2.1 七大楼宇类型¶

基于 QMD §3.2 楼宇类型系数与香港实际居住环境，BPL 定义 7 类楼宇：

类型编码	楼宇类型	简称	系数	特征	报价影响
BLD-01	豪宅	LUX	0.9	有电梯、管理严格、货梯专用	系数最低，但服务品质要求高
BLD-02	标准屋苑	ESS	1.0	有电梯、楼层 20-40F、标准化	基准值
BLD-03	居屋	HOS	1.1	有电梯、保安登记	轻度溢价
BLD-04	公屋	PRH	1.3	有电梯、高层高密度、屋邨规模大	电梯等待与登记耗时
BLD-05	洋楼	COM	1.2	有电梯、单体楼	中度溢价
BLD-06	村屋	VIL	1.8	偏远分散、部分无电梯、道路狭窄	高溢价
BLD-07	唐楼	TONG	2.5	无电梯、楼梯狭窄、3-7F	最高系数，搬运困难

2.2 楼宇类型识别规则¶

flowchart TD
    A["输入楼宇名称/地址"] --> B{"BPL 已存在?"}
    B -- "是" --> C["返回楼宇档案"]
    B -- "否" --> D["按规则预判类型"]
    D --> E{"有电梯?"}
    E -- "是" --> F{"管理严格度?"}
    F -- "严格+货梯专用" --> G["豪宅 LUX"]
    F -- "保安登记" --> H["居屋 HOS"]
    F -- "标准" --> I{"屋邨规模?"}
    I -- "大型屋邨" --> J["公屋 PRH"]
    I -- "单体楼" --> K["洋楼 COM"]
    I -- "标准" --> L["屋苑 ESS"]
    E -- "否" --> M{"位置?"}
    M -- "市区" --> N["唐楼 TONG"]
    M -- "郊区" --> O["村屋 VIL"]
    G --> P["创建临时档案<br/>等级:待核实"]
    H --> P
    I --> P
    J --> P
    K --> P
    L --> P
    N --> P
    O --> P
    P --> Q["师傅上门核实后<br/>升级为已核实"]

三、楼宇档案字段¶

3.1 核心字段¶

字段编号	字段名称	数据类型	必填	采集方	说明
BPL-001	楼宇ID	String	★	系统	唯一标识
BPL-002	楼宇名称	String	★	OL/公开数据	如"太古城"、"美孚新邨"
BPL-003	楼宇类型	Enum	★	OL/师傅核实	BLD-01~07
BPL-004	区域	Enum	★	OL	港岛/九龙/新界/离岛
BPL-005	详细地址	String	★	OL	街道+门牌
BPL-006	地理坐标	GeoPoint	—	系统	经纬度，用于派单距离计算
BPL-007	总楼层数	Number	★	OL/公开数据	—
BPL-008	电梯配置	Enum	★	OL/师傅核实	有电梯/无电梯/部分有
BPL-009	电梯数量	Number	—	OL	货梯/客梯分别
BPL-010	货梯专用	Boolean	—	OL	是否有货梯专用
BPL-011	货梯可用时段	String	—	OL	如"9-12,14-17"
BPL-012	管理处电话	String	—	OL	物业联系
BPL-013	访客登记要求	Enum	—	OL	无/身份证/预约/通行证
BPL-014	停车条件	Enum	—	OL	路边/停车场/禁停/卸货区
BPL-015	停车费	Number	—	OL	HKD/小时
BPL-016	楼宇系数	Number	★	系统派生	0.9-2.5（按类型）
BPL-017	楼层附加基准	Number	★	系统派生	有电梯=0；无电梯=80/层
BPL-018	历史报价偏差	Number	—	系统统计	实际vs报价平均偏差%
BPL-019	历史订单数	Number	—	系统统计	该楼宇累计订单
BPL-020	档案状态	Enum	★	系统	待核实/已核实/已校准
BPL-021	数据来源	Enum	★	OL	公开数据/师傅核实/客户提供
BPL-022	最后核实时间	Datetime	★	系统	师傅上次核实时间
BPL-023	核实师傅ID	String	—	系统	关联 WPL
BPL-024	创建时间	Datetime	★	系统	—
BPL-025	版本号	String	★	系统	V1.0 等

3.2 扩展字段（豪宅/特殊楼宇）¶

字段编号	字段名称	数据类型	适用类型	说明
BPL-101	货梯预约要求	Boolean	豪宅/居屋	是否需提前预约货梯
BPL-102	施工许可	Enum	豪宅/公屋	是否需物业施工许可
BPL-103	施工时段限制	String	豪宅/公屋	如"工作日 10-17"
BPL-104	高空作业限制	Enum	豪宅	是否禁止外墙作业
BPL-105	入场押金	Number	豪宅	HKD，部分豪宅要求

3.3 扩展字段（唐楼/村屋）¶

字段编号	字段名称	数据类型	适用类型	说明
BPL-201	楼梯宽度	Enum	唐楼	窄/中/宽，影响大件搬运
BPL-202	楼梯转角	Enum	唐楼	是否能转大件
BPL-203	道路宽度	Enum	村屋	是否能停车卸货
BPL-204	信号覆盖	Enum	村屋	好/差/无，影响智能设备配置
BPL-205	水电燃气表位置	String	唐楼/村屋	影响安装定位

3.4 扩展字段（特殊楼宇约束 · V1.1 新增 · 对齐 EVAL 4.1 + 4.2）¶

真实业务中部分楼宇有特殊约束（如尖沙咀重庆大厦/美丽大厦仅地下自提，不提供上楼服务），须建立约束清单影响派送费和派单决策。

字段编号	字段名称	数据类型	必填	说明
BPL-301	楼宇约束清单	Array	—	枚举值见下表，可多选
BPL-302	楼梯台阶数	Number	—	楼梯总台阶数，用于上楼费计算（≤60kg 按 40 港币/10 台阶）
BPL-303	上楼方式判定	Enum	—	elevator（电梯）/ stairs（楼梯）/ mixed（混合，部分楼层有电梯）/ no_upper_floor（禁止上楼，对齐 DIS upper_floor_mode）
BPL-304	上楼重量阈值	Number	—	电梯 100kg / 楼梯 60kg，超阈值切换计费模式
BPL-305	约束备注	String	—	如"重庆大厦仅 1F 自提"

楼宇约束枚举值：

约束编码	含义	业务影响
`no_upper_floor`	禁止上楼	仅提供地下自提，上楼费=0，派单须标注
`ground_pickup_only`	仅地面自提	同 no_upper_floor，客户须自行到地面取货
`freight_elevator_reservation`	货梯须预约	须提前预约货梯，影响排期
`construction_permit_required`	须施工许可	入场须物业审批，影响 L2 报价时效
`construction_time_restriction`	施工时段限制	如"仅工作日 10-17"，影响排期

联动规则：① BPL-301 含 no_upper_floor 或 ground_pickup_only 时，QMD 物流费跳过上楼费计算，DIS 派单标注"仅自提"；② BPL-302 楼梯台阶数用于 QMD 上楼费阶梯计价（联动 QMD §十六阶梯计价机制）；③ BPL-303 上楼方式判定驱动 DIS 派送上楼决策（联动 DIS-D 上楼方式决策）。

四、楼宇系数与楼层附加¶

4.1 楼宇系数表（QSV 消费）¶

数据源：本表与 QMD §3.2 一致，BPL 为主数据源，QMD 引用。

楼宇类型	系数	BPL 字段
豪宅	0.9	BPL-016
标准屋苑	1.0	BPL-016
居屋	1.1	BPL-016
公屋	1.3	BPL-016
洋楼	1.2	BPL-016
村屋	1.8	BPL-016
唐楼	2.5	BPL-016

4.2 楼层附加费计算规则¶

电梯配置	计算规则	说明
有电梯	HKD 0	不收楼层附加
无电梯	HKD 80 × (楼层 - 1)	1 楼免费；2 楼 80；3 楼 160...
部分有电梯	按步行楼层计算	如 1-3F 无电梯、4F+ 有电梯

4.3 特殊场景系数叠加¶

flowchart LR
    A["基础楼宇系数"] --> B{"是否有特殊场景?"}
    B -- "无" --> C["最终系数 = 基础系数"]
    B -- "高密度公屋高峰" --> D["+ 0.1 拥挤附加"]
    B -- "豪宅货梯专用" --> E["+ 0 系数但+服务品质要求"]
    B -- "村屋偏远" --> F["+ 区域系数叠加"]
    D --> G["最终系数"]
    E --> G
    F --> G
    C --> G

五、数据采集与更新机制¶

5.1 数据来源优先级¶

优先级	来源	可信度	说明
1	师傅现场核实（CPT 反哺）	★★★★★	最高可信度，自动升级档案状态
2	公开数据（屋苑官网/政府）	★★★★	初始录入主要来源
3	客户提供（L2 需求确认）	★★★	需师傅核实
4	系统预判（按规则）	★★	临时档案，待核实

5.2 师傅现场核实流程¶

sequenceDiagram
    participant CPT as CPT 跟踪服务
    participant BPL as BPL 楼宇库
    participant WPL as WPL 师傅库
    participant QSV as QSV 报价服务

    CPT->>BPL: 查询楼宇档案(L2 阶段)
    BPL-->>CPT: 返回档案(可能待核实)
    CPT->>QSV: 基于档案生成报价
    QSV-->>CPT: 返回报价
    Note over CPT: L6 师傅上门安装
    CPT->>WPL: 师傅现场核实楼宇信息
    WPL-->>CPT: 返回核实结果(电梯/楼层/管理)
    CPT->>BPL: 反哺核实数据
    BPL->>BPL: 更新档案+升级状态为已核实
    BPL->>QSV: 触发报价校准(如系数变化)

5.3 校准触发条件¶

触发条件	阈值	校准动作
楼宇类型修正	任何类型变更	更新系数 + 通知 QSV
电梯配置修正	有/无变更	更新楼层附加计算
历史报价偏差	> ±15%	复核楼宇系数
累计核实次数	≥ 3 次	升级档案状态为"已校准"

六、MVP 覆盖范围¶

6.1 筹备期楼宇库覆盖目标¶

按 RQD-O §阶段规划，筹备期（1-3 月）需覆盖港岛/九龙核心区域 80% 住宅楼宇。

区域	目标楼宇数	优先级	数据来源
港岛（湾仔/中西/东）	200+	P0	公开数据 + 师傅核实
九龙（油尖旺/深水埗）	200+	P0	公开数据 + 师傅核实
港岛（南区/东区）	100+	P1	公开数据
九龙（九龙城/黄大仙）	100+	P1	公开数据
新界（沙田/大埔）	100+	P2	公开数据
离岛	50+	P2	公开数据

6.2 高频楼宇优先建档¶

优先建立高频下单楼宇档案，包括： - 大型屋苑：太古城、美孚新邨、黄埔花园、丽港城等 - 主要公屋：彩虹邨、坪石邨、爱民邨等 - 唐楼集中区：深水埗、旺角、土瓜湾等

七、后续规划¶

楼宇库数据采集工具设计（OL 录入 + 师傅 App 核实）
与香港政府开放数据（屋宇署）对接
楼宇照片库（电梯间/楼梯/货梯/卸货区）关联
楼宇-订单关联分析（高频楼宇服务画像）
BPL 技术实现方案（归入 TND，原 D03）
特殊楼宇约束清单初始化（V1.1 新增：重庆大厦/美丽大厦等黑名单录入）
楼梯台阶数批量采集（V1.1 新增：从 CPT L6 师傅反哺回填）

修订记录¶

版本	日期	修订人	修订内容
V1.0	2026-08-05	DT	首版创建：吸收原 TND D03；7 大楼宇类型、25+10 扩展字段、系数映射、采集更新机制、MVP 覆盖范围
V1.1	2026-08-25	DT	基于 EVAL 单证流程评估的 P0+P1 修改：① §3.4 新增特殊楼宇约束字段 BPL-301~305（楼宇约束清单/楼梯台阶数/上楼方式判定/重量阈值/约束备注）；② 新增 5 种楼宇约束枚举（no_upper_floor/ground_pickup_only/freight_elevator_reservation/construction_permit_required/construction_time_restriction）；③ 定义约束联动规则（QMD 跳过上楼费 + DIS 派单标注 + 阶梯计价联动）；④ §七后续规划新增 2 项待办（黑名单初始化+台阶数批量采集）