Workspace sync: auto commit 2026-04-23 14:15:18

Project/fonrey/PRD/系统设置模块PRD.md

@@ -0,0 +1,783 @@
+# PRD: 系统设置模块
+**状态**: Draft  
+**作者**: 产品经理  
+**最后更新**: 2026-04-23（v1.0 初稿，基于首页设置、房源设置-新增编辑查看、房源设置-字段标签设置（含修改字段必填要求、新增自定义字段、添加标签、修改标签）共7张截图分析完成）  
+**版本**: 1.0  
+**所属系统**: Fonrey 房产经纪管理系统  
+**关联模块**: 房源管理、客源管理、交易管理、人事OA管理、权限管理
+
+---
+
+## 1. 问题陈述
+
+### 背景
+
+房产经纪管理系统需要支撑不同规模、不同业务模式的经纪公司落地使用。各公司在业务流程、数据规则、展示偏好、权限边界等方面存在显著差异，若系统行为完全固化，则无法匹配多样化的经营场景，推广与落地成本极高。
+
+系统设置模块是整个平台的"控制中心"，负责将系统核心行为参数化，让管理员（通常是运营或IT人员）在不需要改动代码的前提下，通过配置界面完成以下任务：
+
+- **首页展示定制**：控制首页各模块的数据口径、排行榜展示规则、成交战报内容等，使首页数据真实反映公司当前的业务重点
+- **房源业务规则配置**：控制房源录入的校验规则、流转权限、价格管理方式、属性保护逻辑等，确保房源数据质量和经纪人行为合规
+- **字段与标签自定义**：允许各公司按自身需求调整字段的必填/选填要求、新增自定义扩展字段，并管理房源标签体系，适配差异化的信息采集诉求
+- **多维度配置扩展**：系统还包含客源设置、交易设置、财务设置、人事OA设置、合同设置、通用及移动端设置、安装与登录设置等，覆盖全业务线配置需求
+
+若缺乏系统设置模块，则会面临：
+- 每家客户的定制需求都需要开发排期，交付周期长
+- 同一套代码维护多套不同配置版本，工程复杂度爆炸
+- 业务规则变更（如修改必填字段）无法由运营自助完成，响应慢
+
+### 目标用户
+
+| 角色 | 描述 | 使用频率 |
+|------|------|----------|
+| 系统管理员 | 负责全局配置，包括所有设置项的查看和修改 | 不定期，集中在系统初始化或规则调整时 |
+| 公司运营人员 | 维护字段标签、自定义参数等业务规则配置 | 每月 1~3 次 |
+| 店长/经理 | 查看首页设置，了解排行榜及成交战报规则 | 偶尔 |
+
+---
+
+## 2. 目标与成功指标
+
+| 目标 | 指标 | 当前基准 | 目标值 | 衡量周期 |
+|------|------|----------|--------|----------|
+| 降低客户定制开发需求 | 新客户上线无需定制开发的比例 | 待统计 | ≥ 70% | 上线后 90 天 |
+| 提升系统初始化效率 | 新公司完成核心配置所需时间 | 待统计 | < 2 小时 | 上线后 30 天 |
+| 提升配置自助完成率 | 运营自助修改设置的比例（无需提工单） | 待统计 | ≥ 90% | 上线后 90 天 |
+| 减少因配置错误导致的业务异常 | 因设置引发的业务反馈工单数 | 待统计 | 较基准降低 50% | 上线后 90 天 |
+
+---
+
+## 3. 非目标（本期不做）
+
+- 不包含权限角色管理（独立的权限管理模块负责）
+- 不包含多语言/国际化配置（暂时仅支持中文环境）
+- 不包含基于 API 的外部系统集成配置界面
+- 不包含审计日志的可视化展示（设置变更日志为后续版本规划）
+- 不包含客源设置、交易设置、财务设置、人事OA设置、合同设置、通用及移动端设置、安装与登录设置的详细功能说明（本期 PRD 聚焦**首页设置**与**房源设置**，其余设置项在各自模块 PRD 中分别说明）
+
+---
+
+## 4. 用户故事与验收标准
+
+### Story 1：管理员配置首页展示规则
+
+**As** 系统管理员，**I want** 通过首页设置界面控制员工首页各模块的展示内容与数据口径，**So that** 首页数据真实反映公司业务规则，避免因展示规则不明确导致员工误解业绩数据。
+
+**验收标准**：
+
+**基本设置**：
+- [ ] 首页设置包含"员工信息模块"配置区，支持开关"是否展示员工司龄"，开启后首页员工信息展示司龄字段
+- [ ] 首页设置包含"行程模块显示指标"配置区，可设置显示的行程类型（买卖、租赁）
+- [ ] 首页设置包含"首页业绩显示设置"区，明确说明业绩统计口径（审批中和审批通过的转定业绩的统计逻辑）
+
+**排行榜设置**：
+- [ ] 支持开关"是否显示业绩和单数"，关闭后排行榜不展示业绩和单数
+- [ ] 支持配置"业绩计算方式"，明确统计转定/认购后统计审批中，或审批驳回和审批通过的单量和业绩口径
+- [ ] 支持配置"默认按店或组排名"（门店/组别两种维度），控制首页排行榜默认统计层级
+- [ ] 支持开关"默认展示全公司前10排名数据"，关闭时员工只能看本人排名
+- [ ] 支持配置"过滤账号"：被添加的账号不出现在首页排行榜中（多账号选择，默认无限制）
+- [ ] 支持配置"过滤部门"：被添加的部门不出现在首页排行榜中（多部门选择，默认无限制）
+
+**成交战报设置**：
+- [ ] 支持配置"成交时间范围"：只展示成交天数在设定范围内的成交战报，空=不限制
+- [ ] 支持配置"成交业绩范围"：只展示成交业绩在设定范围内的成交战报，空=不限制
+- [ ] 支持开关"是否显示业绩"：控制成交战报中是否展示业绩金额
+- [ ] 支持开关"是否显示房源"：控制成交战报中是否展示房源名称
+- [ ] 支持开关"是否显示房源总价"：控制成交战报中是否展示房源总价
+
+---
+
+### Story 2：管理员配置房源录入与新增/编辑行为规则
+
+**As** 系统管理员，**I want** 通过房源设置界面定义房源录入时的默认行为、流转权限限制和编辑数量限制，**So that** 规范经纪人的录入行为，保障数据质量和相关方权益。
+
+**验收标准**：
+
+**新增/编辑设置 - 新增规则**：
+- [ ] 支持配置"新增时属性可选"：房源新增时属性是否可在公盘/私盘之间切换（公盘/私盘/选择范围）
+- [ ] 支持配置"新增时状态可选"：房源新增时的可选交易状态（出售/出租/租售/租区）
+- [ ] 支持配置"新增房源时与同业主的历史挂牌状态范围"：如"我管辖/我部门/全公司"范围内的历史挂牌
+- [ ] 支持开关"新增房源审核通过后才可见"：若开启，新审核仅在审核通过后对他人可见；关闭时审核通过前已对他人可见
+- [ ] 支持配置"新增房源来源（批量录入）的房源处置方式"：智能/不抢不弃
+- [ ] 支持配置"激活房源时属性可选范围"：激活时可选择的属性范围
+- [ ] 支持配置"激活房源时是否可将原挂牌信息电话归为己有"（开关）
+- [ ] 支持配置"激活房源时是否开启温馨提醒发送主告知话术"（开关）
+- [ ] 支持开关"激活房源审核通过后才可以展示状态"：状态通过后才能在列表中展示
+- [ ] 支持配置"重新激活/重新挂牌时房源的处置方式"：智能/不抢不弃
+- [ ] 支持配置"新增/激活时保护房设置"：非保护房/是否保护
+
+**新增/编辑设置 - 激活重新挂牌**：
+- [ ] 支持配置"激活时属性可选范围"
+- [ ] 支持配置"激活时是否可以将历史电话归为己有"
+- [ ] 支持开关"温馨提醒是否在激活时必须发送主告知话术"
+
+**新增/编辑设置 - 编辑数量限制**：
+- [ ] 支持配置"房本年份问题"：针对未知/满二/不满五年的字段字段是否可改的规则描述
+- [ ] 支持配置"每人拥有私盘数量限制"（默认 999 条，0=不允许）
+- [ ] 支持配置"每个门门拥有私盘数量限制"（默认 999 条）
+- [ ] 支持配置"出售业主主号码数量上限"（默认 999 条，控制单一主号码可以被录入多少套出售房源）
+- [ ] 支持配置"出租业主主号码数量上限"（默认 999 条）
+
+---
+
+### Story 3：管理员配置房源状态流转规则
+
+**As** 系统管理员，**I want** 定义房源在不同状态下的流转约束和保护行为，**So that** 防止经纪人违规操作状态，保护相关方权益，维护数据一致性。
+
+**验收标准**：
+
+- [ ] 支持配置"暂缓与不帮/不租的切换逻辑"：默认暂缓时不允许选其他状态，未能实时同步到新增数据
+- [ ] 支持配置"设置房源状态在列表展示范围图"
+- [ ] 支持开关"未挂牌房源状态是否允许允许其他未挂牌房源状态"（即跨状态流转限制）
+- [ ] 支持配置"房子下手验证"：设置发起初步状态变更时需要信息联动变更规则
+- [ ] 支持开关"新增真实房源不允许修改状态为审核状态"
+- [ ] 支持开关"激活房源真实房源限制不允许修改房源状态"
+- [ ] 支持开关"激活/改真实房源不允许修改房源状态"
+- [ ] 支持开关"业主主号码在中中号码不允许修改房源状态"
+- [ ] 支持开关"调价中不允许修改房源状态"
+- [ ] 支持配置"挂牌房源无到期状态自动变为"：配置超期自动流转至的目标状态（如自动转为暂缓），并定义处理机制
+
+---
+
+### Story 4：管理员配置房源价格管理规则
+
+**As** 系统管理员，**I want** 定义调价行为的规则和限制、议价流程以及成交价格的处理方式，**So that** 统一价格管理口径，防止经纪人随意调价，保护业主利益。
+
+**验收标准**：
+
+**基础设置**：
+- [ ] 支持开关"售底价是否启用"：关闭时调价/激活房源/重新挂牌操作中隐藏底价字段
+- [ ] 支持开关"租底价是否启用"：关闭时租价调价中隐藏底价字段
+- [ ] 支持开关"仅购买方可查看底价的模式"：开启后仅购买方可在"查看号码"后查看底价（截图注明"本博开开启，所有人都可以查看"）
+- [ ] 支持配置"商铺字段单价格单位及计算"：按日单价单位（元/m²（月*租*365/12）面积））
+
+**调价设置**：
+- [ ] 支持配置"价格计算基准"：控制各类型房源（售、租）价格计算基准为原价还是折扣一比例，以及是否配置了相关方需要遵守达到的折扣比例
+- [ ] 支持配置"调价成功通知方"：无/（含从选项中选择相关方）
+- [ ] 支持开关"相对价格达到的折扣比例是否成为置顶议价的"：开启后折扣达标后直接置顶议价
+- [ ] 支持开关"调价回真实性管理"：配置为必填/非必填，并提供"去设置"快捷链接
+- [ ] 支持开关"若知道证据的在其生命中，可选择话单号"：开启后调价证据中可选择关联话单
+- [ ] 支持开关"调价知晓证据的在生命中是否业主认可"（以及24小时业主短信通知等相关配置）
+- [ ] 支持配置"调价证据/重量设置"：调价成功后多久确认业主回复，并说明相关联动规则（如经纪人下次操作前必须回复/重新调价）
+- [ ] 可通过"查看规范则示"、"去设置角色"、"去设置相关方"等快捷跳转链接进入相关配置页面
+
+**开启业主真实性验证**：
+- [ ] 支持开关"开启业主主确认价格后，按调度确设置具体方式"：开启后业主确认后才能生效调价，并允许定义确认范围、操作等
+
+**成交价管理**：
+- [ ] 支持开关"他他房源成交录入成交信息"：若开启，录入他他房源成交状态时，必须填写成交价格和成交时间
+- [ ] 支持开关"他他房源是否显示在成交列表"：可通过"可进行设置"快捷链接进入相关页面
+
+---
+
+### Story 5：管理员配置房源海报展示样式
+
+**As** 系统管理员，**I want** 统一配置房源海报的品牌标识和视觉风格，**So that** 对外推广的房源海报与公司品牌保持一致。
+
+**验收标准**：
+
+- [ ] 支持上传"公司Logo"：展示在海报头部，支持图片上传
+- [ ] 支持配置"公司简称"：展示在海报中，如"沪城房产"
+- [ ] 支持配置"海报主色"：从颜色选择器选择海报默认主题颜色（Hex/RGB），实时预览
+- [ ] 支持开关"主颜色是否支持修改"：关闭后经纪人不可自行更换海报颜色，只能使用管理员统一设定的颜色
+- [ ] 支持配置"二维码"：可选展示类型（公司微信/个人微信/公司二维码）；说明限制条件（仅未开全企业微信公司可设置企业微信二维码；仅开全企业微信公司可显示 5 名以上人员进二维码）
+- [ ] 支持开关"二维码是否支持修改"：关闭后经纪人不可在制作海报时替换二维码
+
+---
+
+### Story 6：管理员配置房源其他杂项规则
+
+**As** 系统管理员，**I want** 设置房源相关方变更通知、信息联动更新等细节行为，**So that** 减少人工通知成本并保证数据联动的及时性。
+
+**验收标准**：
+
+- [ ] 支持开关"交易过户/成功后是否更新为当前时间为新房售方"：成交后自动更新相关方
+- [ ] 支持开关"房源清晰的相关方为初始录入人入口"：控制清晰相关方的识别逻辑
+- [ ] 支持开关"相关方关注工更新后，房源相关方所在方向自动更新"：关联方离职/调岗后同步更新房源归属
+- [ ] 支持配置"存在重复地址的房源时如何通知相邻的员工"：配置提醒方式（如第二天上午9点发送消息提醒相邻员工）
+
+---
+
+### Story 7：运营人员配置字段必填要求
+
+**As** 运营人员，**I want** 针对不同房源用途（住宅/商住/别墅/商铺/写字楼/其他）和不同交易状态（出售/出租/租售/他售/他租/暂缓）分别设置字段的必填/选填要求，**So that** 确保经纪人在录入不同类型房源时，填写与该类型最相关的信息，减少无效填写和遗漏。
+
+**验收标准**：
+
+- [ ] 字段必填要求配置页面以二维矩阵（用途行 × 交易状态列）展示所有组合，每个单元格显示当前配置下的必填字段列表和选填字段列表
+- [ ] 支持点击任意一个用途+交易状态组合格子，触发右侧抽屉（Drawer）展示该组合的字段完整配置列表
+- [ ] 字段配置抽屉中，每行字段显示：字段名称、填写要求（必填/选填，单选）、录入页展示开关（是/否）
+- [ ] 必填与选填的切换以单选按钮（Radio）形式呈现，可直接在抽屉内修改
+- [ ] 录入页展示开关以 Toggle 形式呈现，关闭时该字段不在新增/编辑页面展示
+- [ ] 修改完成后点击"确定"保存，点击"取消"放弃修改
+- [ ] 配置支持的字段范围覆盖（从截图归纳）：二级用途、朝向、装修、售底价、房屋现状、租约到期时间、唯一住房、包税费、购房付款方式、售房原因、来源、看房时间、房源备注、有无抵押、抵押说明、有无贷款、贷款说明、有无查封、限制说明、有无查封、查封说明、学校、学区是否占用、学区释放时间、套内面积、建成年代、电梯、产权性质、产权年限、微信、房源标签、营销标题（括号注明"售"）等
+
+---
+
+### Story 8：运营人员新增和管理自定义字段
+
+**As** 运营人员，**I want** 新增系统预设字段之外的自定义字段并将其纳入房源录入流程，**So that** 满足公司个性化的信息采集需求，无需技术改动。
+
+**验收标准**：
+
+- [ ] 自定义字段列表展示已创建的自定义字段，字段包含：字段名称、字段类型、选项参数（枚举类型展示选项值）、应用范围、录入人员、操作（编辑/删除）
+- [ ] 点击"新增自定义字段"按钮触发右侧抽屉
+- [ ] 新增抽屉字段说明文字：
+  - 新字段在录入人员时，显示在「自定义信息」分组中
+  - 新增自定义字段默认选项目不在新增房源时展示，如您有其他要求，请完成新增自定义字段后到「字段填写和新增页展示」中进行修改
+- [ ] 抽屉必填字段包含：
+  - 字段名称（文本输入）
+  - 字段类型（下拉选择，如：文本输入/单选/多选/日期等）
+  - 适用房源用途（多选：住宅/商住/别墅/商铺/写字楼/其他）
+  - 适用房源状态（下拉多选）
+- [ ] 支持"＋ 新增字段"按钮（在抽屉内可继续追加多个字段，批量新增）
+- [ ] 点击"保存"完成新增，自定义字段出现在列表中
+- [ ] 自定义字段新增后不自动展示在新增房源页，需通过"字段必填要求"配置页显式开启
+- [ ] 支持编辑已存在的自定义字段（字段类型可能限制修改范围）
+- [ ] 支持删除自定义字段（删除前需提示该字段已关联的历史数据处理方式）
+
+---
+
+### Story 9：运营人员管理自定义预设参数值
+
+**As** 运营人员，**I want** 查看并维护各下拉字段的预设枚举选项，**So that** 经纪人在录入房源时只能选择公司规范化的值，保证数据一致性。
+
+**验收标准**：
+
+- [ ] 自定义预设参数值列表展示所有可配置的枚举字段，字段包含：参数值名称、选项值（逗号分隔展示全部选项）、操作（修改）
+- [ ] 支持的可配置枚举字段范围（从截图归纳）：购房付款方式、租房付款方式、其他房屋用途、看房时间、商铺二级用途、委托作废类型、别墅二级用途、来源、住宅二级用途、写字楼二级用途、商住二级用途、产权性质、委托签约类型、调价单证方式、凭证填写要求、价格类型、委托附件类型
+- [ ] 点击"修改"打开对应枚举字段的选项值编辑弹窗，支持：增加选项、修改选项名称、删除选项、调整选项顺序
+- [ ] 说明文字提示："预设参数不可修改初始项目，只能新增项目"（部分基础预设值不可删改，只能追加）
+- [ ] 修改保存后，经纪人在录入房源时相关字段的下拉选项即时更新
+
+---
+
+### Story 10：运营人员管理房源标签
+
+**As** 运营人员，**I want** 维护房源标签（如：速销、独家、有钥匙、满N年等），包括添加新标签、修改标签名称和颜色，**So that** 经纪人可以通过标签快速标识房源特征，买家在筛选时可依标签缩小范围。
+
+**验收标准**：
+
+**标签列表**：
+- [ ] 标签设置页以表格形式展示所有已配置的标签，列字段包含：排序（拖拽排序句柄）、标签名、标签颜色（可点击的色块）、标签说明、允许（控制角色权限）、管控 ①（信息按钮提示说明）、状态（启用/禁用开关）、最后修改结束日已绑定房源数①、操作（设置/修改）
+- [ ] 标签类型分为"预制标签"（系统内置，不可删除）和"自定义标签"（公司或部门创建）
+- [ ] 预制标签展示（从截图归纳）：房东直销、速销、独家、八九成、中拍、周三、意一、行（滨）、拍后、AI标签、行内、3D、磁选流、一次出售中
+
+**添加标签**：
+- [ ] 点击"平台添加标签"按钮弹出"添加标签"对话框
+- [ ] 添加标签对话框字段：
+  - 标签名称（必填，文本输入，不超过4个字）
+  - 标签类别（必填，下拉选择，如：B 等类别）
+  - 标签说明（选填，文本区域，50字以内）
+  - 各部门可设标签数量（选填，数字输入，大于0的整数）
+  - 颜色设置（单选：默认（蓝色）/ 次要（绿色）/ 重要（橙红色））
+  - 标签预览（实时预览标签的外观效果）
+- [ ] 点击"确定"保存，新标签出现在标签列表中
+- [ ] 点击"取消"关闭对话框不保存
+
+**修改预制标签**：
+- [ ] 点击预制标签的"修改"操作打开"修改预制标签"对话框
+- [ ] 修改预制标签对话框字段：
+  - 标签名称（必填，文本输入；注意：截图中"满N"为只读灰底，表明预制标签名称不可修改）
+  - 颜色设置（单选：默认 / 次要 / 重要）
+  - 标签预览（实时更新）
+- [ ] 预制标签不支持修改名称（灰底只读），仅支持修改颜色
+- [ ] 点击"确定"保存修改
+
+---
+
+## 5. 功能详细说明
+
+### 5.1 系统设置整体结构
+
+系统设置模块（路径：系统 / 设置 / 系统配置）采用左侧导航 + 右侧内容区的两栏布局。左侧为二级导航树，包含以下一级菜单及其子项：
+
+| 一级菜单 | 主要子项 |
+|---------|---------|
+| 首页设置 | （无子项，直接展示配置内容） |
+| 房源设置 | 新增/编辑/查看、字段/标签设置、相关方设置、相关方保护规则设置、跟进/面访方问、实勘/视频/VR/实地验验、预约拍摄设置、钥匙/委托/政府核验、作业业设置、维护人设置、列表/房源分级、营销设置、楼盘设置、资料收/业主委主状拟录入、隐私保护及防骚扰、房源检查及补填 |
+| 新房设置 | — |
+| 客源设置 | — |
+| 交易设置 | — |
+| 财务设置 | — |
+| 人事OA设置 | — |
+| 合同设置 | — |
+| 通用及移动端设置 | — |
+| 安装与登录设置 | — |
+
+页面顶部提供"请输入设置项名称"搜索框，支持快速定位设置项。
+
+> **本 PRD 聚焦范围**：首页设置 + 房源设置下的「新增/编辑/查看」和「字段/标签设置」两个子项，其余子项将在后续版本补充。
+
+---
+
+### 5.2 首页设置
+
+**路径**：系统配置 / 首页设置  
+**操作权限**：每个配置区块右上角提供"编辑"按钮，点击进入编辑态；保存后即时生效
+
+#### 5.2.1 基本设置
+
+包含以下三个子区块：
+
+**① 员工信息模块**
+
+| 配置项 | 类型 | 说明 |
+|--------|------|------|
+| 是否展示员工司龄 | Toggle（开关） | 若开启则首页展示员工司龄；若关闭则不显示 |
+
+**② 行程模块显示指标**
+
+| 配置项 | 类型 | 说明 |
+|--------|------|------|
+| 显示的业务类型 | 多选复选框 | 买卖、租赁（控制行程模块显示哪些类型的指标） |
+
+**③ 首页业绩显示设置**
+
+该区块以说明文本形式展示业绩统计口径的规则：
+- 统计审批中和审批通过的转定业绩
+- 录转定/认购后统计审批中、审批驳回和审批通过的业绩
+- 若无转定/认购，直接签约则统计录签约后审批中、审批驳回和审批通过的分成后业绩
+
+> 此区块为只读说明，不提供可修改的配置开关（业绩口径在更底层的交易设置中配置）。
+
+---
+
+#### 5.2.2 排行榜设置
+
+| 配置项 | 类型 | 当前值示例 | 说明 |
+|--------|------|-----------|------|
+| 是否显示业绩和单数 | Toggle | 开启 | 若开启则排行榜中显示业绩和单数；若关闭则不显示 |
+| 业绩计算方式 | 只读文本 | （展示计算规则说明） | 说明录转定/认购后统计口径及直接签约统计口径 |
+| 默认按店或组排名 | 只读文本 | 门店 | 首页排行榜默认统计维度（门店/组别） |
+| 默认展示全公司前10排名数据 | Toggle | 关闭 | 开启时可查看全公司排名；关闭时员工只能看本人排名 |
+| 过滤账号 | 多选/文本 | 无限制 | 添加的账号不出现在首页排行榜中 |
+| 过滤部门 | 多选/文本 | 无限制 | 添加的部门不出现在首页排行榜中 |
+
+**业绩计算方式说明文字**（只读展示）：
+> 录转定/认购后统计审批中、审批驳回和审批通过的单量和业绩，若无转定/认购，直接签约则统计录签约后审批中、审批驳回和审批通过的单量和分成后业绩
+
+---
+
+#### 5.2.3 成交战报设置
+
+| 配置项 | 类型 | 当前值示例 | 说明 |
+|--------|------|-----------|------|
+| 成交时间范围 | 数字输入（天） | 不限制 | 只展示成交天数在此范围内的战报，空=不限制 |
+| 成交业绩范围 | 数字输入（元） | 不限制 | 只展示成交业绩在此范围内的战报，空=不限制 |
+| 是否显示业绩 | Toggle | 关闭 | 开启则成交战报显示业绩金额 |
+| 是否显示房源 | Toggle | 开启 | 开启则成交战报显示房源名称 |
+| 是否显示房源总价 | Toggle | 关闭 | 开启则成交战报显示房源总价 |
+
+---
+
+### 5.3 房源设置 - 新增/编辑/查看
+
+**路径**：系统配置 / 房源设置 / 新增/编辑/查看  
+**操作权限**：每个配置区块右上角提供"修改"按钮，点击进入编辑态；提供"保存"和"取消"操作
+
+#### 5.3.1 新增/编辑设置
+
+##### 5.3.1.1 新增规则
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 新增时属性可选 | 下拉单选 | 公盘/私盘 | 新增房源时属性是否可在公盘/私盘之间切换；包括重新挂牌（包括重新挂牌） |
+| 新增时状态可选 | 下拉多选 | 出售/出租/租售/租区 | 如果是新分子公司，租帮不全，不同状态，智能/不抢不弃 |
+| 新增房源时与同业主的历史挂牌状态范围 | 下拉单选 | 我管辖/我部门/全公司 | 设置范围：地区-地级-单元-号，重复联系人数量 |
+| 新增房源审核通过后才可见 | Toggle | 关闭 | 如果开启，新审核通过后仅对他人可见；关闭时审核中即可见 |
+| 新增房源来源（批量录入）的房源处置方式 | 下拉 | 智能/不抢不弃 | 重复录入时的房源归属处理策略 |
+
+##### 5.3.1.2 激活/重新挂牌规则
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 激活房源时属性可选范围 | 下拉 | 选择范围 | 激活时可选择的属性范围 |
+| 激活时是否可以将历史电话归为己有 | Toggle | 开启 | 开启后激活时可以选择将原挂牌信息电话归为己有，经纪人同意并主告知话术 |
+| 温馨提醒是否在激活时必须发送主告知话术 | Toggle | 开启 | 开启后，激活时必须发送主告知话术告知业主，并告知获取者 |
+| 激活审核通过后才可以展示状态 | Toggle | 关闭 | 如果关闭，仅对已有交人和当前审核人可见，关闭后激活交直立即展示新状态 |
+| 重新激活/重新挂牌时房源的处置方式 | 下拉 | 智能/不抢不弃 | 如本活活时活时处活 |
+| 新增/激活时保护房设置 | 下拉 | 非保护房 | 新增和激活时房源是否默认为保护房 |
+
+##### 5.3.1.3 编辑数量限制
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 房本年限问题 | 说明文本 | 未知/满二/不满五年 | 可以以二/不满五年"字段可改的规则说明 |
+| 每人拥有私盘数量限制 | 数字输入 | 999 | 999=不限，0=不允许拥有私盘 |
+| 每个门门拥有私盘数量限制 | 数字输入 | 999 | 999=不限制 |
+| 出售业主主号码数量上限 | 数字输入 | 999 | 999=不限制，控制单一主号码一用途最多可以被录入多少套出售房源，未挂牌/跳/录入新房/租出 |
+| 出租业主主号码数量上限 | 数字输入 | 999 | 999=不限制，控制单一主号码一用途最多可以被录入多少套出租房源，未挂牌/跳/录入新房/租出 |
+
+---
+
+#### 5.3.2 状态设置
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 暂缓与不帮/不租是否允许配置 | 下拉 | 暂缓 | 暂缓与不帮/不租的切换逻辑；默认暂缓时不允许选择其他一个，未能实时产生新增数据，历史已存在的数据继续支持 |
+| 设置房源状态在列表展示范围图 | 下拉 | 超超/不帮/不租 | 设置哪些状态的房源可以在列表中展示 |
+| 未挂牌房源状态是否允许允许其他未挂牌房源状态 | Toggle | 关闭 | 若开启，暂缓/不帮/他他等状态中不可以选以为暂缓、不帮、他他、他其他无效的另一状态 |
+| 房子下手验证 | 下拉 | 非必须 | 设置发起初步状态时是否需要信息联动变更，若设置则联系房管部门业绩变更状态，去设置 |
+| 新增真实房源不允许修改状态为审核状态 | Toggle | 关闭 | 若开启，设置发标为真实状态时，设置信息联系交更 |
+| 激活房源真实房源限制不允许修改房源状态 | Toggle | 关闭 | 若开启，若设置真实房源的判定，真实房源暂时不允许修改房源状态 |
+| 激活/改真实房源不允许修改房源状态 | Toggle | 开启 | 若开启，若设置真实房源的判定，真实房源暂时不允许修改房源状态 |
+| 业主主号码在中中号码不允许修改房源状态 | Toggle | 关闭 | 若开启，房源在中中号码中不允许修改房源状态 |
+| 调价中不允许修改房源状态 | Toggle | 关闭 | 若开启，房源在调价中不允许修改房源状态 |
+| 挂牌房源无到期状态自动变为 | 多选 + Toggle | — | 本地启、接触接收有效有期明的房源状态联接成功（实时），关闭至当24小时，系统将自动处理当前存有挂牌房源状态（单帧中销中有中进行中的交活的房源，不处理） |
+
+---
+
+#### 5.3.3 价格设置
+
+##### 5.3.3.1 基础设置
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 售底价是否启用 | Toggle | 关闭 | 在调价/激活房源/重新挂牌操作中，若关闭则不显示底价（激活房源/重新挂牌 不清空） |
+| 租底价是否启用 | Toggle | 关闭 | 在调价/激活房源/重新挂牌操作中，若关闭则不显示租底价（激活房源/重新挂牌 不清空） |
+| 仅购买方可查看底价的模式 | Toggle | 关闭 | 开启后，仅购买方可在"查看号码"后查看底价；关闭后所有人都可以查看（本博开启） |
+| 商铺字段单价格单位及计算 | 下拉 | 按日单价 | 单位：元/m²（月*租*365/12面积），商铺字段历史数据同步调整按格公式，若单位未修改则历史数据不受影响 |
+
+##### 5.3.3.2 调价设置
+
+**价格计算基准**（表格配置）：
+
+| 房源类型 | 价格计算基准 | 是否配置折扣比例 | 折扣比例 |
+|---------|------------|----------------|---------|
+| 售 | 原价 | 统一比例 | — |
+| 租 | 原价 | 统一比例 | — |
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 调价成功通知方 | 下拉多选 | 无 | 调价通过后，到对应折扣比例则置顶议价方（（（若存在右侧），则调价后达到价比则置顶至告以下 方 |
+| 相对价格达到的折扣比例是否成为置顶议价的 | Toggle | 开启 | 若开启，折扣达标后自动置顶议价 |
+| 调价回真实性管理 | 下拉 | 非必填 | 开启价格管理，此配置置置非必填，去设置 |
+| 若知道证据的在其生命中，可选择话单号 | Toggle | 开启 | 若开启，调价证据生命存在中，可选择关联话单号；注意：字心小于字段该项不支持话单号选择，短信费用按配置确认从配置业主短信费确认从默认时从原则认从认从 |
+| 调价知晓证据的在生命中是否业主认可 | Toggle | 关闭 | （点击"查看"查看）业主短暂时时时有效，若下时后为业主通时达，下一个后时可再次操作价格 |
+| 业主短暂保护时效时长 | 数字输入 | 24小时 | 若接触色签显提示方式设置设置员工在调价后向业主短暂确认和和价格和，直接调查结果，结果查看规范规则规范规范规范规范，去设置角色角色，去设置相关方 |
+
+**开启业主真实性验证**：
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 开启业主主确认价格后，按调度确设置具体方式 | Toggle | 关闭 | 请主：业主告知配合收到折扣通知开后，你可以自定义调价确认价格的验证方式，确认幅度阈值请设置，设置价格价格方式，确认幅度则设置，设置价格方式，确认价格请设置，去设置 |
+
+##### 5.3.3.3 成交价管理
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 他他房源成交录入成交信息 | Toggle | 关闭 | 若开启，录入他他房源成交状态时，必须填写成交价格和成交时间 |
+| 他他房源是否显示在成交列表 | 说明+链接 | — | 可进行设置（链接跳转至对应配置页） |
+
+---
+
+#### 5.3.4 房源海报设置
+
+| 配置项 | 类型 | 说明 |
+|--------|------|------|
+| 公司Logo | 图片上传 | 上传公司Logo，展示在海报头部 |
+| 公司简称 | 文本输入 | 如"沪城房产"，展示在海报中 |
+| 海报主色 | 颜色选择器 | 设置海报默认主题颜色，实时预览 |
+| 主颜色是否支持修改 | Toggle | 关闭后经纪人不可自行更换海报颜色 |
+| 二维码 | 下拉+说明 | 可选：公司微信/个人微信/公司二维码；限制：仅未开全企业微信公司可设置企业微信二维码；仅开全企业微信公司可显示5名以上人员进二维码；仅开企业微信公司可以显示5名以上人员进二维码 |
+| 二维码是否支持修改 | Toggle | 关闭后经纪人不可在制作海报时替换二维码 |
+
+---
+
+#### 5.3.5 其他设置
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|-------|------|
+| 交易过户/成功后是否更新为当前时间为新房售方 | Toggle | 关闭 | 交易过户成功后，是否自动更新为新房售方 |
+| 房源清晰的相关方为初始录入人入口 | Toggle | 开启 | 开启后，相关方关注方工更新后，房源相关方所在方向是门店根据是否更新的最新相关方（关注方所在门店），关注，关注为以到关注门店自动更新到最新相关方 |
+| 相关方关注工更新后，房源相关方所在方向自动更新 | Toggle | 开启 | 若开启，关注方工作调到3第，关注不挂牌房源在门店是是自动更新到最新相关方（门店），关注，（注意：若房源需要需要，若您开启了您们的门店为下面公告特殊处理的门店，请请请联系技术工程人员对于），请联系对应的技术工程人员 |
+| 存在重复地址的房源时如何通知相邻的员工 | 说明+链接 | — | 若存在重复地址的房源，第二天上午9点发送消消消消消息提醒相邻房源的员工 |
+
+---
+
+### 5.4 房源设置 - 字段/标签设置
+
+**路径**：系统配置 / 房源设置 / 字段/标签设置  
+**操作权限**：配置项修改即时生效（部分需通过弹窗确认），管理员权限
+
+页面包含4个子 Tab：**字段必填要求 / 自定义字段 / 自定义预设参数值 / 标签设置**
+
+---
+
+#### 5.4.1 字段必填要求
+
+##### 5.4.1.1 整体布局
+
+页面以"用途"为行、"交易状态"为列的矩阵表格展示。每个格子显示该组合下的"必填字段"和"选填字段"列表（文字枚举，截断显示）。
+
+**行（用途）分类**：
+- 住宅/商住/别墅
+- 商铺
+- 写字楼
+- 其他
+
+**列（交易状态）分类**：
+- 出售
+- 出租
+- 租售
+- 他售/不帮
+- 他租/不租
+- 暂缓
+
+##### 5.4.1.2 字段配置矩阵示例（部分）
+
+| 用途 | 交易状态 | 必填字段 | 选填字段（部分） |
+|------|---------|---------|----------------|
+| 住宅/商住/别墅 | 出售 | 朝向、装修 | 二级用途、售底价、房屋现状、租约到期时间、唯一住房、包税费、购房付款方式、售房原因、来源、看房时间、房源备注、有无抵押… |
+| 住宅/商住/别墅 | 出租 | 朝向、装修 | 二级用途、租底价、房屋现状、租约到期时间、来源、看房时间、房源备注… |
+| 住宅/商住/别墅 | 租售 | 朝向、装修 | 二级用途、售底价、房屋现状、租约到期时间、唯一住房、包税费、购房付款方式、售房原因、来源、看房时间… |
+| 商铺 | 出售 | 朝向、装修 | 二级用途、进深、层高、开间、售底价、房屋现状、购房付款方式、售房原因、来源、看房时间、房源备注… |
+| 写字楼 | 出售 | 朝向、装修 | 二级用途、进深、层高、开间、售底价、房屋现状、购房付款方式、售房原因、来源、看房时间、房源备注… |
+
+##### 5.4.1.3 单个组合字段配置（右侧抽屉 Drawer）
+
+点击矩阵中任意格子，右侧滑出配置抽屉，标题为"[用途/交易类型] — 出售字段填写要求和新增页展示设置"。
+
+**抽屉字段列表**（每行一个字段）：
+
+| 字段名 | 填写要求 | 录入页展示 |
+|--------|---------|-----------|
+| 二级用途 | ● 必填 ○ 选填 | Toggle（开/关） |
+| 朝向 | ● 必填 ○ 选填 | Toggle |
+| 装修 | ● 必填 ○ 选填 | Toggle |
+| 售底价 | ○ 必填 ● 选填 | Toggle |
+| 房屋现状 | ○ 必填 ● 选填 | Toggle |
+| 租约到期时间 | ○ 必填 ● 选填 | Toggle |
+| 唯一住房 | ○ 必填 ● 选填 | Toggle |
+| 包税费 | ○ 必填 ● 选填 | Toggle |
+| 购房付款方式 | ○ 必填 ● 选填 | Toggle |
+| 售房原因 | ○ 必填 ● 选填 | Toggle |
+| 来源 | ○ 必填 ● 选填 | Toggle |
+| 看房时间 | ○ 必填 ● 选填 | Toggle |
+| 房源备注 | ○ 必填 ● 选填 | Toggle |
+| 有无抵押 | ○ 必填 ● 选填 | Toggle |
+| 抵押说明 | ○ 必填 ● 选填 | Toggle |
+| 有无贷款 | ○ 必填 ● 选填 | Toggle |
+| 贷款说明 | ○ 必填 ● 选填 | Toggle |
+| 有无查封 | ○ 必填 ● 选填 | Toggle |
+| 限制说明 | ○ 必填 ● 选填 | Toggle |
+| 有无查封 | ○ 必填 ● 选填 | Toggle |
+| 查封说明 | ○ 必填 ● 选填 | Toggle |
+| 学校 | ○ 必填 ● 选填 | Toggle |
+| 学区是否占用 | ○ 必填 ● 选填 | Toggle |
+| 学区释放时间 | ○ 必填 ● 选填 | Toggle |
+| 套内面积 | ○ 必填 ● 选填 | Toggle |
+| 建成年代 | ○ 必填 ● 选填 | Toggle |
+| 电梯 | ○ 必填 ● 选填 | Toggle |
+| 产权性质 | ○ 必填 ● 选填 | Toggle |
+| 产权年限 | ○ 必填 ● 选填 | Toggle |
+| 微信 | ○ 必填 ● 选填 | Toggle |
+| 房源标签 | ○ 必填 ● 选填 | Toggle |
+| 营销标题（售） | ○ 必填 ● 选填 | Toggle |
+
+**底部操作按钮**：确定（橙色主按钮）/ 取消
+
+---
+
+#### 5.4.2 自定义字段
+
+##### 5.4.2.1 自定义字段列表
+
+| 列名 | 说明 |
+|------|------|
+| 字段名称 | 自定义字段的名称 |
+| 字段类型 | 如：文本输入、单选、多选、日期等 |
+| 选项参数 | 若为枚举类型，展示选项值列表 |
+| 应用范围 | 适用的房源用途（如：住宅/商住/别墅） |
+| 录入人员 | 适用的经纪人角色范围 |
+| 操作 | 编辑 / 删除 |
+
+**示例数据**（从截图归纳）：
+
+| 字段名称 | 字段类型 | 选项参数 | 应用范围 |
+|---------|---------|---------|---------|
+| 产证号 | 文本输入 | — | 住宅/商住/别墅，第，第 |
+
+##### 5.4.2.2 新增自定义字段（右侧抽屉）
+
+**说明文字**：
+1. 新字段在录入人员时，显示在「自定义信息」分组中
+2. 新增自定义字段默认选项目不在新增房源时展示，如您有其他要求，请完成新增自定义字段后到「字段填写和新增页展示」中进行修改
+
+**抽屉字段**：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| 字段名称 | 文本输入 | 是 | 输入框，placeholder "请输入" |
+| 字段类型 | 下拉选择 | 是 | 如：文本输入/单选/多选/日期等 |
+| 适用房源用途 | 多选 Tab | 否 | 住宅/商住/别墅 / 商铺 / 写字楼 / 其他（横向 Tab 多选） |
+| 适用房源状态 | 下拉多选 | 否 | 如：出售/出租/暂缓等 |
+
+底部按钮："＋ 新增字段"（追加更多字段行）/ "保存"（橙色）/ 取消
+
+---
+
+#### 5.4.3 自定义预设参数值
+
+**说明文字**（页面顶部）："预设参数不可修改初始项目，只能新增项目"
+
+**参数列表**（从截图归纳，完整枚举）：
+
+| 参数值名称 | 项目值（选项枚举） |
+|-----------|----------------|
+| 购房付款方式 | 一次付清、按揭付款、分批次付款、垫资解按 |
+| 租房付款方式 | 押一付三、押一付一、押二付一、0押金、半年付、年付、季租、月租 |
+| 其他房屋用途 | 车库、车位、平房、四合院、仓库、厂房、地皮、铺厂、网点、写厂 |
+| 看房时间 | 随时可看、提前预约、不方便看 |
+| 商铺二级用途 | 无 |
+| 委托作废类型 | 录错委托信息、系统自动作废、其他 |
+| 别墅二级用途 | 联排别墅、独栋别墅、双拼别墅、叠加别墅 |
+| 来源 | 驻守、网络、老客户、派单、朋友、上门、同事、广告、米客、来访、扫描、中介、资料房、资料客、业主委托、投投人 |
+| 住宅二级用途 | 普通住宅、花园洋房 |
+| 写字楼二级用途 | 无 |
+| 商住二级用途 | 无 |
+| 产权性质 | 商品房、房改房、集资房、经济活用房 |
+| 委托签约类型 | 他司成交、多家委托、终止挂牌、其他 |
+| 调价单证方式 | 业主短信确认以议价、提交议价审批 |
+| 凭证填写要求 | 非必填、录音/图片必填中一项、仅录音必填、仅图片必填、录音/图片均必填 |
+| 价格类型 | 售价/售底价、租价/租底价 |
+| 委托附件类型 | 委托书、产权人身份证件、委托人身份证件、第三方代签授权证明、房产证、其他 |
+
+**操作**：每行提供"修改"按钮，点击打开编辑弹窗，支持增加/修改/删除选项（基础预设值不可删除）
+
+---
+
+#### 5.4.4 标签设置
+
+##### 5.4.4.1 标签列表
+
+| 列名 | 说明 |
+|------|------|
+| 排序 | 拖拽句柄，支持拖拽调整标签展示顺序 |
+| 标签名 | 标签名称，以色块形式展示（颜色对应配置的颜色） |
+| 标签颜色 | 色块预览（点击可修改颜色） |
+| 标签说明 | 标签的说明文字 |
+| 允许 | 控制哪些角色权限可使用该标签 |
+| 管控 ① | 信息按钮，点击后提示管控说明 |
+| 状态 | Toggle（启用/禁用），禁用后标签不在房源录入时展示 |
+| 最后修改结束日/已绑定房源数 ① | 展示标签最后修改时间及当前绑定的房源数量 |
+| 操作 | 设置 / 修改 |
+
+**已有标签示例**（从截图归纳）：
+
+| 标签名 | 颜色 | 说明 |
+|--------|------|------|
+| 房东直销 | 蓝色 | 该房发地关联某些绑定房源的描述 |
+| 速销 | 蓝色 | 该房只剩一个方每带两套有空的描述 |
+| 八九成 | — | 法拍类——法拍某一线拍卖信息 |
+| 中拍 | — | 法拍类——法拍某一线拍卖信息 |
+| 周三 | 橙色 | 设房定价地产上，设置某一些 |
+| 意一 | — | 该房已某满意向，已经意 |
+| 行（滨） | 蓝色 | 该房经带拍有某有意向客户 |
+| 拍后 | — | 设房已有某拍后的状态 |
+| AI标签 | 橙/红色 | 法拍类——通过某一线AI判断的标签 |
+| 行内 | — | 法拍类——法院某一设内拍信息 |
+| 3D | 蓝色 | 该设房具有某某3D户型 |
+| 磁选流 | 橙红色 | 设房某某特殊某某某流流流 |
+| 一次出售中 | — | 设房某某某特殊中中中中中 |
+
+##### 5.4.4.2 添加标签（对话框）
+
+**触发方式**：点击"平台添加标签"按钮
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| 标签名称 | 文本输入 | 是 | 不超过 4 个字 |
+| 标签类别 | 下拉选择 | 是 | 如：B 等分类（类别为管理员预设的分组维度） |
+| 标签说明 | 文本区域 | 否 | 50 字以内 |
+| 各部门可设标签数量 | 数字输入 | 否 | 大于 0 的整数，控制各部门可自行设置的标签总数上限 |
+| 颜色设置 | 单选 | 是 | 默认（蓝色）/ 次要（绿色）/ 重要（橙红色） |
+| 标签预览 | 只读展示 | — | 实时显示标签名称+颜色的视觉效果，初始显示"-" |
+
+底部操作：确定（橙色）/ 取消
+
+##### 5.4.4.3 修改预制标签（对话框）
+
+**触发方式**：点击预制标签行的"修改"操作
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| 标签名称 | 文本输入（只读/灰底） | — | 预制标签名称不可修改，灰底展示原名称 |
+| 颜色设置 | 单选 | 是 | 默认（蓝色）/ 次要（绿色）/ 重要（橙红色） |
+| 标签预览 | 只读展示 | — | 实时显示标签颜色变化效果 |
+
+底部操作：确定（橙色）/ 取消
+
+> **差异说明**：预制标签与自定义标签的修改弹窗区别在于：预制标签名称字段为只读灰底，**不支持修改名称**，仅支持修改颜色；自定义标签支持修改名称和颜色。
+
+---
+
+## 6. 技术考量
+
+### 6.1 依赖关系
+
+| 依赖系统/功能 | 依赖原因 | 所有者 | 风险等级 |
+|-------------|---------|-------|---------|
+| 权限管理模块 | 设置项的查看/修改需按角色权限控制 | 权限模块团队 | 中 |
+| 房源管理模块 | 房源字段必填/选填规则、标签配置直接影响房源录入表单渲染 | 房源模块团队 | 高 |
+| 首页模块 | 首页设置参数直接控制首页数据展示逻辑 | 前端团队 | 中 |
+| 交易管理模块 | 价格设置、成交价管理规则与交易流程紧密耦合 | 交易模块团队 | 高 |
+
+### 6.2 已知风险
+
+| 风险 | 可能性 | 影响 | 缓解措施 |
+|------|-------|------|---------|
+| 配置变更实时生效影响进行中的业务 | 中 | 高 | 关键配置（字段必填规则）变更时增加二次确认弹窗，说明影响范围 |
+| 枚举预设参数被误删导致历史数据孤值 | 低 | 高 | 系统预置参数禁止删除；自定义参数删除前检查并提示关联的历史数据数量 |
+| 多管理员并发修改同一配置项导致数据冲突 | 低 | 中 | 采用乐观锁机制，最后一次保存覆盖，并在编辑态提示当前锁定人 |
+| 字段配置与表单渲染之间的缓存不一致 | 中 | 中 | 配置保存后强制刷新相关表单的渲染缓存，或设置 TTL ≤ 5 分钟 |
+
+### 6.3 待确认问题
+
+- [ ] 配置变更是否需要记录变更日志（谁在什么时间改了什么）？若需要，日志的保留期限是多久？—— Owner：产品/运营 —— Deadline：Dev 启动前
+- [ ] 自定义字段删除后，历史房源中该字段的已填数据如何处理（保留/清空/标记为已废弃）？—— Owner：产品 —— Deadline：Dev 启动前
+- [ ] 标签的"允许"和"管控"列具体控制的权限范围是什么（哪些角色可以使用/编辑）？—— Owner：权限模块负责人 —— Deadline：联调前
+- [ ] 自定义预设参数值的新增/删除是否有审批流，或直接生效？—— Owner：产品 —— Deadline：Dev 启动前
+
+---
+
+## 7. 上线计划
+
+| 阶段 | 时间 | 受众 | 成功门槛 |
+|------|------|------|---------|
+| 内部 Alpha | TBD | 研发团队 + 2 家设计合作客户 | 无 P0 Bug，核心配置流程跑通 |
+| 封闭 Beta | TBD | 10 家试点客户运营人员 | 配置完成率 ≥ 90%，无阻断性反馈 |
+| 正式发布 | TBD | 全量客户 | 自助配置率 ≥ 80%，配置相关工单降低 30% |
+
+**回滚条件**：若发布后 48 小时内出现配置保存失败率 > 1%，或因配置变更导致房源录入异常工单超过 10 条，立即回滚并启动紧急排查。
+
+---
+
+## 8. 附录
+
+### 8.1 截图参考
+
+| 截图文件 | 对应功能章节 |
+|---------|------------|
+| `设置/首页设置.png` | 5.2 首页设置（基本设置、排行榜设置、成交战报设置） |
+| `设置/房源设置-新增编辑查看.png` | 5.3 房源设置-新增/编辑/查看（查看态） |
+| `设置/房源设置-新增编辑查看-修改.png` | 5.3 房源设置-新增/编辑/查看（编辑态） |
+| `设置/房源设置-字段标签设置.png` | 5.4 字段/标签设置（概览页） |
+| `设置/房源设置-字段标签设置-修改字段必填要求.png` | 5.4.1.3 单个组合字段配置（右侧抽屉） |
+| `设置/房源设置-字段标签设置-新增自定义字段.png` | 5.4.2.2 新增自定义字段（右侧抽屉） |
+| `设置/房源设置-字段标签设置-添加标签.png` | 5.4.4.2 添加标签（对话框） |
+| `设置/房源设置-字段标签设置-修改标签.png` | 5.4.4.3 修改预制标签（对话框） |
+
+### 8.2 术语表
+
+| 术语 | 解释 |
+|------|------|
+| 预制标签 | 系统内置的标签，不可删除，仅支持修改颜色 |
+| 自定义标签 | 由公司管理员创建的标签，支持完整的 CRUD 操作 |
+| 自定义字段 | 运营人员扩展的非标准字段，展示在录入表单的「自定义信息」分组 |
+| 自定义预设参数值 | 下拉字段的枚举选项，基础预设值不可删除，可追加自定义选项 |
+| 公盘 | 全体经纪人可见的房源属性 |
+| 私盘 | 仅录入人（或其团队）可见的房源属性 |
+| 相关方 | 房源的首录经纪人、号码来源经纪人、出售方/实买方经纪人等 |
+| 保护房 | 具有特殊保护机制的房源，在相关方离职后具有一定保护期 |

wiki/index.md

@@ -4,6 +4,9 @@
 - [Overview](overview.md) — living synthesis
 
 ## Sources
+- [2026-04-23] [做TK跨境思路不对努力白费](sources/做tk跨境思路不对努力白费.md)
+- [2026-04-23] [超达物流定价](sources/超达物流定价.md)
+- [2026-04-23] [TK美国面单授权及操作流程](sources/tk美国面单授权及操作流程.md)
 - [2026-04-23] [Scrapy + Playwright 抓取TikTok Shop Data](sources/scrapy-playwright-抓取tiktok-shop-data.md)
 - [2026-04-23] [GOG CLI 安装配置指南](sources/gog-cli-安装配置指南.md)
 - [2026-04-23] [Last30Days 使用指南](sources/last30days-使用指南.md)
@@ -411,9 +414,6 @@
 - [2026-04-18] [电商如何选品-如何找到爆款-选品策略](sources/电商如何选品-如何找到爆款-选品策略.md) — (expected: wiki/sources/电商如何选品-如何找到爆款-选品策略.md — source missing)
 - [2026-04-18] [电商视频prompt](sources/电商视频prompt.md) — (expected: wiki/sources/电商视频prompt.md — source missing)
 - [2026-04-18] [tiktok-shop-apache-superset-dashboard设计思路](sources/tiktok-shop-apache-superset-dashboard设计思路.md) — (expected: wiki/sources/tiktok-shop-apache-superset-dashboard设计思路.md — source missing)
-- [2026-04-18] [做tk跨境思路不对努力白费](sources/做tk跨境思路不对努力白费.md) — (expected: wiki/sources/做tk跨境思路不对努力白费.md — source missing)
-- [2026-04-18] [超达物流定价](sources/超达物流定价.md) — (expected: wiki/sources/超达物流定价.md — source missing)
-- [2026-04-18] [tk美国面单授权及操作流程](sources/tk美国面单授权及操作流程.md) — (expected: wiki/sources/tk美国面单授权及操作流程.md — source missing)
 - [Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog](sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md) — (expected: wiki/sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md — source missing)
 - [Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend](sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md) — (expected: wiki/sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md — source missing)
 - [zk-steward](sources/zk-steward.md) — (expected: wiki/sources/zk-steward.md — source missing)

wiki/log.md

@@ -1,3 +1,44 @@
+## [2026-04-18] ingest | 做TK跨境思路不对努力白费
+- Source file: 跨境电商/做TK跨境思路不对努力白费.md
+- Status: ✅ 成功摄入
+- Summary: TikTok跨境电商全流程实战指南——从市场选择(美区/日本>东南亚)→账号准备→选品策略(数据软件+垂直类目)→店铺运营(流量监控+商品优化)→流量获取(短视频+达人营销)→仓储物流(海外仓+海运补货)→团队建设，提供完整执行框架。
+- Concepts touched: [[跨境电商]], [[选品策略]], [[TikTok电商]], [[达人营销]]
+- Entities touched: [[TikTok Shop]], [[美区]], [[日本]]
+- Source page: wiki/sources/做tk跨境思路不对努力白费.md
+- Notes:
+  - 新增 1 个 Source Page（wiki/sources/做tk跨境思路不对努力白费.md）
+  - Concept 和 Entity 均以 wikilink 形式建立关联，暂不创建独立页面（出现次数<2次阈值）
+  - 冲突检测：无已知冲突内容
+  - 已在 index.md 添加 Source 条目
+  - 已在 overview.md 新增 "TikTok E-commerce Operations" 小节
+
+## [2026-04-23] ingest | 超达物流定价
+- Source file: 跨境电商/超达物流定价.md
+- Status: ✅ 成功摄入
+- Summary: 超达物流跨境电商定价规则：申报/实重/材积取最大值计费，UIN渠道24-48h轨迹推送，TK平台面单"TKM"开头单号无效，UIN/TK取消单号收费规则，发货截止时间12点/美区周日休息。
+- Concepts touched: [[计费重量原则]], [[轨迹推送机制]], [[取消单号收费]]
+- Source page: wiki/sources/超达物流定价.md
+- Notes:
+  - 新增 1 个 Source Page（wiki/sources/超达物流定价.md）
+  - Entity 和 Concept 均以 wikilink 形式建立关联，暂不创建独立页面（各仅出现 1 次，未达 ≥2 次阈值）
+  - 冲突检测：无实质冲突，与 [[TK美国面单授权及操作流程]] 互为补充（前者专注授权配置，本文专注计费规则）
+  - 已在 index.md 添加 Source 条目
+  - overview.md 无需更新（物流定价内容与 AI/软件主题 overview 相关性低）
+
+## [2026-04-25] ingest | TK美国面单授权及操作流程
+- Source file: 跨境电商/TK美国面单授权及操作流程.md
+- Status: ✅ 成功摄入
+- Summary: TikTok美国市场面单授权配置与操作流程截图教程，通过6张Zipline图床备份图片展示具体操作步骤。
+- Concepts touched: [[TikTokShop]], [[面单授权]], [[跨境电商物流]]
+- Entities touched: [[TikTok美国站]]
+- Source page: wiki/sources/tk美国面单授权及操作流程.md
+- Notes:
+  - 新增 1 个 Source Page（wiki/sources/tk美国面单授权及操作流程.md）
+  - Concept 和 Entity 均以 wikilink 形式建立关联，暂不创建独立页面（内容为截图教程，信息量有限）
+  - 冲突检测：无已知冲突内容
+  - 已在 index.md 修正 Source 条目
+  - overview.md 无需更新（物流操作类内容与 overview 主题相关性低）
+
 ## [2026-04-24] ingest | Scrapy + Playwright 抓取TikTok Shop Data
 - Source file: 跨境电商/Scrapy + Playwright 抓取TikTok Shop Data.md
 - Status: ✅ 成功摄入

wiki/overview.md

@@ -360,6 +360,9 @@ Key concepts: [[Generalist]], [[Self-Education]], [[Self-Interest]], [[Self-Suff
 - **[[MinIO]]** — 开源 S3 兼容对象存储，Zipline 图床系统的存储后端，提供高性价比本地存储
 - **[[Zipline]]** — 开源自托管图床应用，提供前端上传 UI 和 REST API，支持 [[n8n]] 工作流集成
 
+### TikTok E-commerce Operations
+**[[做TK跨境思路不对努力白费]]**：TikTok 跨境电商全流程实战指南——从市场选择（优先美区/日本，避开东南亚）→ 账号准备（选区看直播了解流程）→ 选品策略（数据软件分析+单一垂直类目）→ 店铺运营（流量监控+商品优化）→ 流量获取（短视频营销+达人合作）→ 仓储物流（海外仓+海运补货）→ 团队建设（招聘分工），提供完整的执行框架。核心观点：思路正确是成功的前提，市场定位和选品是核心竞争力。与 [[电商如何选品]] 同属选品策略范畴，与 [[TikTok E-commerce Product Management]]（Django 产品管理系统）互补——前者侧重运营策略，后者侧重技术实现。
+
 ### TikTok E-commerce Product Management
 A comprehensive Django-based product data management system for TikTok Shop. Covers Django ORM models (Product, ProductImage, ProductVideo, ProductVariation, ProductReview), Django Admin customization (TinyMCE rich text, inline models, image preview modals), REST API via Django REST Framework with django-filter for search and filtering, Docker + Gunicorn + Nginx production deployment, Django-Q async task queue for Bright Data API scraping, and custom Management Commands for JSON data import. Key components: Product list with thumbnail display, multi-condition filtering by store_name, bulk product fetch via Bright Data asynchronous API, description detail HTML generation, and Apache Superset BI dashboard integration.
 

wiki/sources/tk美国面单授权及操作流程.md

@@ -0,0 +1,36 @@
+---
+title: "TK美国面单授权及操作流程"
+type: source
+tags: ["tiktok", "跨境电商", "物流", "面单", "美国"]
+date: 2025-12-19
+---
+
+## Source File
+- [[跨境电商/TK美国面单授权及操作流程.md]]
+
+## Summary（用中文描述）
+- 核心主题：TikTok美国市场面单授权配置与操作流程
+- 问题域：跨境电商物流履约中的面单打印与授权管理
+- 方法/机制：通过截图教程演示TK美国面单的授权步骤和操作流程
+- 结论/价值：帮助跨境卖家完成TikTok美国站的面单系统配置
+
+## Key Claims（用中文描述）
+- TikTok美国站需要完成面单授权才能进行订单履约
+- 面单授权流程包含多个配置步骤（截图展示具体操作界面）
+
+## Key Quotes
+> 图片教程来源：Zipline图床备份，包含6张操作截图
+
+## Key Concepts
+- [[TikTokShop]]：TikTok电商平台，支持美国市场
+- [[面单授权]]：跨境物流系统中打印官方物流面单的必要授权流程
+- [[跨境电商物流]]：涉及国际运输、清关、最后一公里配送的电商履约体系
+
+## Key Entities
+- [[TikTok美国站]]：TikTok Shop的美国市场站点，商家在此开展跨境销售
+
+## Connections
+- [[做tk跨境思路不对努力白费]] ← related_to ← [[TK美国面单授权及操作流程]]
+
+## Contradictions
+- 暂无冲突记录

wiki/sources/做tk跨境思路不对努力白费.md

@@ -0,0 +1,45 @@
+---
+title: "做TK跨境思路不对努力白费"
+type: source
+tags: [tiktok, 跨境电商]
+date: 2026-04-18
+---
+
+## Source File
+- [[跨境电商/做TK跨境思路不对努力白费]]
+
+## Summary（用中文描述）
+- 核心主题：TikTok 跨境电商全流程实战指南，从市场选择到团队建设的完整攻略
+- 问题域：个人或小团队如何从零开始在 TikTok 平台开展跨境电商业务
+- 方法/机制：市场选择 → 账号准备 → 选品策略 → 店铺运营 → 流量获取 → 仓储物流 → 团队建设
+- 结论/价值：提供了一套完整的 TikTok 跨境电商执行框架，强调"思路正确"是成功的前提
+
+## Key Claims（用中文描述）
+- 跨境卖家应优先选择发达国家市场（如美区、日本），避免竞争激烈且利润低的东南亚市场
+- 选品是跨境电商的核心竞争力，应使用数据软件分析市场环境，确定单一垂直类目
+- 店铺运营需要持续监控流量数据，及时下架表现不佳的商品，优化商品列表
+- 短视频营销和达人合作是获取流量、提升转化的关键手段
+- 随着业务规模扩大，应招聘合适人才分担日常任务，确保业务持续增长
+
+## Key Quotes
+> "市场选择：优先考虑发达国家市场，如美区和日本，避免东南亚。" — 强调市场定位的重要性
+> "选品策略：使用数据软件分析市场环境，确保选择适合的单一类目。" — 聚焦垂直领域
+> "团队协作：成功的电商运营需要团队的配合与沟通，分工明确才能高效运作。" — 组织能力
+
+## Key Concepts
+- [[跨境电商]]：通过互联网平台进行跨国商品交易的商业模式
+- [[选品策略]]：通过数据分析确定适合目标市场的商品类目
+- [[TikTok电商]]：基于 TikTok 平台的短视频+直播带货模式
+- [[达人营销]]：与平台 KOL 合作推广商品的营销方式
+
+## Key Entities
+- [[TikTok Shop]]：TikTok 平台的电商功能，支持短视频带货和直播带货
+- [[美区]]：美国 TikTok 市场，消费能力强，利润空间大
+- [[日本]]：发达国家市场，目标用户购买力强
+
+## Connections
+- [[电商如何选品-如何找到爆款-选品策略]] ← related_to ← [[做tk跨境思路不对努力白费]]
+- [[可自动化-可扩展-ai增强的电商数据采集与处理系统]] ← related_to ← [[做tk跨境思路不对努力白费]]
+
+## Contradictions
+- 暂无已知冲突内容

wiki/sources/超达物流定价.md

@@ -0,0 +1,52 @@
+---
+title: "超达物流定价"
+type: source
+tags: []
+date: 2025-12-19
+---
+
+## Source File
+- [[跨境电商/超达物流定价]]
+
+## Summary（用中文描述）
+- 核心主题：超达物流（ChaoDa Logistics）跨境电商定价规则与操作注意事项
+- 问题域：TikTok Shop 美国市场跨境发货的物流计费与面单管理
+- 方法/机制：
+  - 计费重量取申报重量、实重、材积重三者最大值
+  - UIN渠道提供预上网服务，申请单号后24-48小时推送轨迹
+  - TK平台面单跟踪号以"TKM"开头的为无效单号
+  - 发货截止时间每天12点，美区周日不发货
+- 结论/价值：掌握超达物流计费规则，避免因申报重量或面单问题导致额外费用
+
+## Key Claims（用中文描述）
+- 超达物流对申报重量、实重、材积取最大值收费，申报重量应低于或等于收费重量
+- UIN渠道申请单号后24-48小时产生轨迹上网，需控制好申请单号的时间
+- TK平台"TKM"开头的跟踪号为无效单号，需联系客服处理
+- 草稿订单状态的单号不会推送轨迹上网，需及时处理
+- UIN渠道：未推送轨迹取消单号不收费，已推送则收取全额挂号费
+- TK平台面单：未推送轨迹取消单号不收费，已推送收取10元/票操作费
+- 选错渠道后期修改均收取10元/票操作费
+- 每天12点前到仓的货物当天打包发走，美区周日休息不发货
+
+## Key Quotes
+> "申报重量、实重、材积取最大值收费，请务必注意。" — 超达物流核心计费原则
+
+## Key Concepts
+- [[计费重量原则]]：申报重量、实际重量、材积重量三者取最大值作为收费依据
+- [[轨迹推送机制]]：UIN渠道在收到单号后24-48小时内推送上网轨迹
+- [[取消单号收费]]：以轨迹是否推送为分界，未推送免费，已推送根据渠道收取操作费
+
+## Key Entities
+- [[超达物流]]：跨境电商物流服务商，提供UIN渠道和TK平台面单服务
+- [[TikTok Shop]]：主要销售平台，本文档涉及美国市场发货操作
+- [[UIN渠道]]：超达物流提供的预上网渠道，支持24-48小时轨迹推送
+
+## Connections
+- [[TikTok Shop]] ← 使用 ← [[超达物流]]
+- [[超达物流定价]] ← relates_to ← [[TK美国面单授权及操作流程]]
+
+## Contradictions
+- 与 [[TK美国面单授权及操作流程]]：
+  - 冲突点：两份文档均涉及超达物流与TikTok美国市场，但本文档专注于定价规则，前者专注于授权配置
+  - 当前观点：定价规则与授权配置可独立存在，互为补充
+  - 对方观点：授权文档侧重系统配置步骤