# VISTA C-2.11 版本更新说明（功能说明 + 用户用例）

版本状态：开发完成
版本范围：C-2.11 / B-1.27 / 后台-1.38 / 后台-1.39
发布日期：2026-06-10（按实际发布时间更新）

以下为本次更新汇总的 5 项功能，按功能章节输出“功能说明 + 用户用例”。
用户用例均保留端侧标注（C 端 / B 端 / 运营端），并拆分为独立小节，便于后续补充截图。

---

## 1. C-2.11 移动端展开菜单提示（C 端）

### 1.1 功能说明

1. 将“移动端首页自动打开菜单”的交互改为“菜单按钮引导提示”交互。
2. 首页加载完成后触发：
   - 顶部菜单按钮播放 2 次呼吸动效后停止。
   - 左侧弹出气泡提示，文案为“点击这里打开菜单”。
3. 提示动效开始条件为：首页图像加载完成，且 PNG 透明图加载完成后再启动。
4. 文案国际化 key：`HOMEVISTA_C_MOBILE.menu.tip`。
5. 文案靠右对齐并保持单行优先显示，必要时自动换行。
6. 气泡常驻显示，但以下任一动作后自动消失：点击导航按钮打开菜单、下滑打开导航。
7. 气泡一旦消失，不再重复显示；再次访问首页时重新展示。
8. 导航按钮点击后不再展示气泡，不需要独立关闭按钮。
9. 该行为只作用于移动端首页；用户从内页打开不触发该提示。

### 1.2 用户用例

#### UC1-01（C 端）首页首次进入显示菜单提示
- 场景：用户在移动端打开 C 端首页。
- 操作：等待页面主图与透明 PNG 资源加载完成后观察菜单按钮区域。
- 预期结果：菜单按钮执行呼吸动画，左侧显示“点击这里打开菜单”。

#### UC1-02（C 端）点击菜单按钮后的提示消失
- 场景：用户看到提示后点击菜单按钮。
- 操作：点击顶部菜单按钮展开导航。
- 预期结果：气泡提示和动效立即消失，导航成功展开。

#### UC1-03（C 端）下滑打开导航后提示消失
- 场景：用户以下滑手势触发导航打开。
- 操作：在首页进行下滑打开导航。
- 预期结果：气泡提示消失，不再显示。

#### UC1-04（C 端）内页不应触发提示
- 场景：用户从外部链接或路由进入首页以外的内页。
- 操作：直接打开内页。
- 预期结果：不展示“点击这里打开菜单”气泡。

---

## 2. C-2.11 周边地图增加卫星图层切换（C 端）

### 2.1 功能说明

1. 在 C 端 Google 地图（PC 与移动）新增地图图层切换能力。
2. 仅支持“地形图 / 卫星图”两个状态按钮。
3. 地图默认图标与当前状态按设计规则切换。
4. 鼠标悬停提示文案采用国际化：
   - 地形图态：`map.default`
   - 卫星图态：`map.satellite`
5. 切换按钮在街景下方，视觉风格与现有地图控件一致。
6. 点击切换按钮直接生效，不弹窗。
7. 按钮样式尺寸约束：
   - PC：40
   - 移动端：32
8. 本功能仅在 Google 地图样式生效；中国大陆 Bing 地图不增加该能力。
9. 本次更新不下放到 B 端。

### 2.2 用户用例

#### UC2-01（C 端 PC）地图切换到卫星图
- 场景：用户在 C 端 PC 浏览周边地图。
- 操作：点击地图图层切换按钮。
- 预期结果：地图从当前图层切换为卫星图，按钮图标/状态同步更新。

#### UC2-02（C 端移动）地图切换到地形图
- 场景：用户在 C 端移动端浏览周边地图。
- 操作：在卫星态下再次点击切换按钮。
- 预期结果：地图返回地形图显示，图标/提示同步切换。

#### UC2-03（C 端）hover 提示展示校验
- 场景：用户长时间停留在切换图标上。
- 操作：观察按钮提示文案。
- 预期结果：地形态为 `map.default`，卫星态为 `map.satellite`。

#### UC2-04（B 端）功能不下放验证
- 场景：B 端查看同一项目周边地图相关能力。
- 操作：确认是否存在该图层切换入口。
- 预期结果：该入口不在 B 端出现。

---

## 3. C-2.11 资料集图片沉浸查看优化（C 端）

### 3.1 功能说明

1. 在资料集大图场景引入“沉浸查看”模式，减少顶部控件遮挡。
2. 右上方新增“沉浸查看”入口；进入后按钮切为“恢复”。
3. 进入沉浸态后：
   - 左上 Logo 与菜单隐藏（若菜单已打开则主动关闭）。
   - 右上按钮组隐藏。
   - 底部图片切换列表收起。
4. 底部列表控制按钮不受沉浸态直接控制，仍可操作展开/收起。
5. 用户在沉浸态下切换图片后，列表自动收起，页面仍保持沉浸状态。
6. 点击“恢复”后恢复顶部控件显示，返回常态展示。
7. 底部列表状态在退出沉浸后尽可能保留用户当前状态；若未主动展开通常为收起态。
8. 本版本 PC/Pad 增加沉浸能力，移动端不改动。
9. 刷新或重新进入页面时，不记录历史沉浸状态，默认恢复常态。

### 3.2 用户用例

#### UC3-01（C 端 PC）开启沉浸查看
- 场景：用户在资料集大图页查看图片，顶部控件遮挡内容。
- 操作：点击右上方“沉浸查看”。
- 预期结果：顶部 Logo、菜单、右上按钮组隐藏；底部列表收起；页面进入沉浸态。

#### UC3-02（C 端 PC）沉浸态下切图后再次收起列表
- 场景：用户在沉浸态下切换图片。
- 操作：通过底部列表或现有控件切换下一张图片。
- 预期结果：切图完成后，列表自动收起，页面仍保持沉浸态。

#### UC3-03（C 端 PC）从沉浸态恢复常态
- 场景：用户需要再次使用顶部菜单与功能入口。
- 操作：点击低透明度“恢复”按钮。
- 预期结果：顶部控件恢复显示，可继续进行平时操作。

#### UC3-04（C 端 Pad）沉浸查看开启与退出
- 场景：销售在 Pad 上演示资料集图片。
- 操作：进入支持沉浸的页面后点击“沉浸查看”，再次点击“恢复”。
- 预期结果：进入沉浸后顶部控件隐藏；恢复后回到常态界面。

#### UC3-05（C 端 PC/Pad）离开并重新进入页面
- 场景：用户在沉浸状态下离开页面后再返回。
- 操作：关闭页面再打开同一资料集图片页。
- 预期结果：页面默认常态打开，不记忆上次沉浸状态。

---

## 4. C-2.11_B-1.27_后台-1.38 资料集文件夹挂导航权限关联（运营端 / B 端 / C 端）

### 4.1 功能说明

1. 运营后台新增配置项：**隐藏导航资料集文件夹**（项目级）。
2. 配置位置：运营后台项目基本信息页，计算器开关下方。
3. 配置条件：仅 C 端版本 ≥ 2.11 的项目展示；低于 2.11 不展示。
4. 逻辑说明：
   - 关闭：C 端资料集页面继续显示已挂导航文件夹（保留双入口）。
   - 开启：C 端资料集页隐藏已挂导航文件夹，仅保留导航入口。
5. 无论开关状态，已挂导航文件夹不允许直接删除。
6. 删除行为限制包含单条与批量；必须先解除全部导航关联。
7. 删除拦截必须同步前端与服务端。
8. 拦截提示统一使用弹窗，不使用仅提示 Toast。
9. 国际化 key：`HOMEVISTA_B.collection.deleteDenied`。
10. 文案参数 `folderNameList` 需使用双引号包裹文件夹名并拼接展示。

### 4.2 用户用例

#### UC4-01（运营端）开启“隐藏导航资料集文件夹”开关
- 场景：项目需避免资料集页重复入口。
- 操作：在项目基本信息配置该开关并保存。
- 预期结果：开关状态生效，C 端资料集列表中已挂导航文件夹被隐藏。

#### UC4-02（运营端）关闭“隐藏导航资料集文件夹”开关
- 场景：项目希望保留资料集页入口。
- 操作：在项目基本信息关闭该开关并保存。
- 预期结果：已挂导航文件夹在资料集页面继续展示。

#### UC4-03（C 端）开启状态下避免重复入口
- 场景：某文件夹已挂导航且用户有查看权限。
- 操作：用户打开项目查看资料集列表。
- 预期结果：文件夹在资料集列表隐藏，仅可通过导航入口访问。

#### UC4-04（C 端）关闭状态下保留双入口
- 场景：同一文件夹已挂导航且用户有查看权限。
- 操作：用户查看资料集列表。
- 预期结果：导航入口与资料集列表中该文件夹均可见。

#### UC4-05（B 端）删除前阻断已挂导航文件夹
- 场景：B 端尝试删除已挂导航文件夹。
- 操作：点击单条删除。
- 预期结果：系统弹窗阻断删除，不执行删除动作。

#### UC4-06（B 端）批量删除中含已挂导航文件夹
- 场景：批量列表中包含已关联导航文件夹。
- 操作：执行批量删除。
- 预期结果：弹窗提示包含 `folderNameList`，一次性阻断该批次删除。

#### UC4-07（B 端）解除关联后允许删除
- 场景：文件夹已解除所有导航关联。
- 操作：再次执行删除。
- 预期结果：删除可正常完成。

---

## 5. C-2.11_B-1.27_后台-1.39 样板间权限升级（方案C）（运营端 / B 端 / C 端）

### 5.1 功能说明

1. 新增运营配置：项目基本信息新增“样板间权限联动”开关，默认关闭。
2. 开关关闭时保持历史行为。
3. 开关开启时进入方案 B 风格联动辅助：
   - 不清空、不迁移、不重算历史配置。
   - B 端样板间选框受关联户型图勾选状态控制；单向联动：户型图→样板间。
   - 用户手动取消样板间不回写户型图。
4. B 端样板间交互要求：
   - 关联户型未勾选：样板间选框置灰，不可操作。
   - 点击时展示提示 toast：`HOMEVISTA_B.pub.optionRejected`（“先勾选户型图才能共享样板间”）。
   - 关联户型勾选：样板间恢复可操作，支持手动勾选/取消。
   - 全选按钮仅作用于可操作样板间。
5. C 端样板间列表页接口新增过滤条件（开启后）：
   - 样板间已共享
   - 户型可访问
   - 户型未售罄
   - 未关联住户 OR （住户可访问 且 住户未售罄）
6. C 端 UI 不调整；导航入口联动仍按 B 端样板间勾选态处理，不按过滤后列表反向推导。
7. B 端勾选动作不判断户型/住户访问权限及售罄；对应规则仅在 C 端列表过滤。

### 5.2 用户用例

#### UC5-01（运营端）配置样板间权限联动开关
- 场景：项目管理者要求按当前访问场景过滤样板间列表。
- 操作：在运营后台项目基本信息页开启/关闭“样板间权限联动”并保存。
- 预期结果：关闭时保持历史规则；开启时按联动辅助与 C 端过滤逻辑生效。

#### UC5-02（B 端）未勾选户型时禁用样板间勾选
- 场景：销售管理员进行共享设置。
- 操作：尝试勾选某未选户型下的样板间。
- 预期结果：样板间项置灰不可操作，弹出提示“先勾选户型图才能共享样板间”。

#### UC5-03（B 端）勾选户型后关联样板间自动可见并可操作
- 场景：关联关系存在的户型与多个样板间。
- 操作：将该户型从未勾选改为勾选。
- 预期结果：关联样板间自动勾选且可手动继续调整；状态改变不回写到户型图。

#### UC5-04（B 端）样板间全选仅对可操作项生效
- 场景：部分样板间因未关联勾选户型而置灰。
- 操作：点击“样板间全选”。
- 预期结果：只对可操作样板间生效；无可操作项时按钮置灰。

#### UC5-05（C 端）样板间列表过滤不可见内容
- 场景：客户进入样板间列表页。
- 操作：读取列表数据并展示。
- 预期结果：不返回未共享、户型不可访问、户型已售罄、住户不可访问或住户已售罄所关联的样板间。

#### UC5-06（C 端）区分户型样板间与住户样板间
- 场景：同一列表包含两类样板间。
- 操作：在样板间列表中按当前访问场景返回结果。
- 预期结果：户型样板间仅评估“户型可访问/未售罄”；住户样板间额外评估“住户可访问/住户未售罄”。

#### UC5-07（B 端）公开访问与客户共享场景一致性
- 场景：管理员配置公开访问范围与销售人员配置客户共享范围。
- 操作：分别在不同共享页进行勾选。
- 预期结果：均基于历史保存态回显，开启联动后仅在可操作条件满足时允许样板间操作。

---

## 6. 本次上线建议验收点

1. 开关类能力在 C 端 2.11+ 与非 2.11 项目边界区分清晰。
2. 删除拦截（单条/批量）在 UI 与后端均有效。
3. 文案国际化 Key 与实际渲染文案一致，包含多语言场景。
4. C 端地图图层切换交互与 B 端能力边界明确（B 端无该功能）。
5. 样板间联动开启后，B 端交互与 C 端列表过滤规则联动一致且不影响历史数据。