一、功能介绍
客户画像用于把预算区间、户型偏好、需求类型等信息定义为可复用的结构化字段。每个画像项包含名称、单选/多选方式、是否必填和一组候选选项；画像项和选项均可排序。当前后端实现尚未按已验签企业隔离数据，因此这篇指南只用于已明确为单企业可控测试的环境，不应把当前页面当作可安全投入多企业生产的隔离配置。
二、功能亮点
- 按画像项名称、单选/多选和是否必填组合筛选。
- 画像项列表不分页，按排序值升序展示，可通过「上移」和「下移」调整。
- 选项抽屉支持单个新增、批量添加、编辑、删除和排序。
- 新建画像项会自动生成 `profile_`加时间戳的系统编码，页面不要求用户填写技术标识。
- 删除画像项会软删除该项及其所有选项，删除单个选项也会使其不再参与画像显示。
三、使用场景
适用于把客户信息标准化为有限候选值，例如「预算区间」单选、「关注品类」多选或「户型偏好」单选。它不是企微官方标签管理，也不适合存储自由长文本。
四、使用权限
- 进入页面需要「客户画像」菜单权限。前端用 `add`、`edit` 和 `del` 三个按钮键分别控制「新增类别」、「编辑选项/修改/排序」和「删除画像项」。
- 选项抽屉只有持有 `edit` 的用户能打开，但抽屉内的「新增选项」、「批量添加」、「编辑」和「删除」均没有再做按钮权限判断；因此 `edit` 实际也可删除选项，不受 `del` 单独限制。
- 对应后端控制器当前没有功能权限守卫；前端按钮隐藏不等于服务端强制授权。只应把菜单授予可承担数据结构变更风险的管理员。
- 画像项和选项实体未实现租户接口或 Hibernate 租户过滤，仓储查询也不带 `auth_corp_id`。多企业环境下不能依赖本页隔离或授权企业画像配置。
五、前置条件
- 仅在已确认为单企业可控测试的环境操作；多企业生产环境应先完成租户隔离和服务端权限整改并通过验收。
- 取得配置变更审批并记录完整画像项、选项、排序和客户引用快照；服务没有版本号或回收站。
- 与客户运营、销售和数据团队共同定义画像项名称、单选/多选方式、必填性、候选值和生效日期。
- 搜索相近画像项和选项，避免重复创建同义字段；当前后端不会检查名称唯一性或前端声明的长度上限。
- 准备一条演示客户，用于验证新增、修改、必填和排序后的真实展示与录入。
- 删除前导出或记录已有客户画像值，并确认表单、筛选、报表和接口不再依赖目标项目或选项 ID；后端不会做引用检查。
六、操作步骤
- 进入「客户管理 → 客户设置 → 客户画像」。先查看画像项名称、是否必填、选择方式、选项内容和当前排序。
- 需要查重时，输入画像项名称子串，选择「单选/多选」和「是否必填」后点击「搜索」。点击「重置」会清空三类条件并重新加载。
- 点击「新增类别」，输入最多 10 个字符的画像项名称，选择「单选」或「多选」，并设置「是否必填」。新建默认为单选、非必填。
- 点击「保存」。页面成功后刷新列表；系统将画像项设为启用，生成唯一时间戳编码，并放在现有排序的最后。
- 在新画像项的操作列点击「编辑选项」。需要单个录入时点击「新增选项」，输入最多 50 个字符的名称，点击「确定」。页面会把同一文本同时作为显示名称和存储值。
- 需要批量录入时点击「批量添加」，使用换行、中英文逗号或分号分隔选项。当前会对本次输入内部去重，并排除与列表既有名称重复的值；提交为逐条创建，中途失败不会回滚。
- 在选项抽屉中用上下箭头调整顺序。每次移动会并发更新当前画像项的所有选项排序，完成后重新加载抽屉列表。
- 需要修改画像项名称或必填性时点击「修改」。编辑模式下「选择方式」已锁定，只能调整名称和是否必填。
- 调整画像项顺序前点击「重置」确保所有筛选条件为空，再在操作列点击「上移」或「下移」。有任一筛选条件时，页面会提示先清空筛选，不会提交排序。
- 保存后到一个真实读取客户画像的详情或录入页面，使用演示客户验证字段名、选项、单选/多选、必填和顺序。仅看到配置页成功提示不等于消费端已正确生效。
- 删除选项或画像项前，在确认框中核对名称。删除画像项会一并软删除它的所有选项；删除后页面没有恢复入口。
七、字段与规则说明
- 画像项名称在页面必填且最多 10 个字符；选项在页面最多 50 个字符，但后端只检查非空，不校验这些长度。
- 页面不检查画像项名称或选项名称唯一性；后端也会允许同名画像项和同名选项。
- 批量添加按换行、中英文逗号、中英文分号切分；只排除已存在选项，不对本次输入内部去重。每个值逐一发起创建请求，中途失败可能已部分保存。
- 编辑选项会同时把新文本写入 `label` 和 `value`。修改技术值可能影响接口或报表，不应只把它当作显示文案修改。
- 编辑选项成功后当前只重新加载右侧抽屉，主表「选项内容」摘要不会立即刷新；关闭后需点击「搜索」或「重置」重载主表。
- 选项排序会对抽屉内的每个选项分别调用更新接口；页面不检查每个响应的业务成功标记，排序后必须人工复核。
- 画像项排序服务会跳过无法解析的 ID、空排序和不存在项目，仍统一返回排序更新成功。
- 删除为软删除，但页面没有回收站或恢复功能；服务不检查客户画像值或其他消费者引用。删除项目时关联选项一并软删除，历史关联值可能不再显示。
- 当前画像配置后端不使用 `auth_corp_id` 筛选或写入当前企业，也未实现服务端功能权限守卫；在完成整改前不得将本页作为多企业生产隔离配置使用。
八、风险与限制
当前缺少租户隔离和服务端权限守卫，在多企业环境下存在查看或改动非本企业画像配置的风险。另外，删除项目或选项会使历史客户画像值无法正常解析，错误的必填、选择方式和排序还会同时影响录入、筛选、报表和接口。
注意
多企业生产环境暂停使用当前客户画像配置页，直到 `auth_corp_id` 隔离、写入约束和服务端功能权限全部通过验收。在可控测试中，每次删除、修改选项文本、改必填或批量添加前，仍必须先核对已有客户引用并保留变更记录。
九、常见问题
- 为什么这个页面暂不适合多企业生产使用？实体和仓储未按 `auth_corp_id` 隔离，控制器也无服务端功能权限。
- 为什么有 `edit` 但没有 `del` 仍能删除选项？抽屉入口由 edit 控制，内部删除不再检查 del。
- 后端会限制名称长度吗？不会，10 字和 50 字上限只在页面。
- 为什么批量添加后有同名选项？本次输入不内部去重，后端也不检查唯一。
- 为什么排序提示成功但部分项目没变化？服务会静默跳过无效 ID、空排序或不存在项目。
- 为什么编辑选项后主表还是旧文本？只重载抽屉，关闭后需搜索或重置主表。
- 删除项目会同时删除选项吗？会软删除项目及未删除选项，但不会检查历史客户引用。
- 为什么历史画像值不再显示？消费端只解析启用且未删除配置，删除前需迁移或评估。
十、相关指南
阅读《管理客户标签》区分画像字段与企业标签；配置验收时配合《查看和筛选客户》抽样检查实际显示和筛选结果。
说明
页面入口：/customer/settings/labels