--- id: v4-2318-internal-wifi-module-mode title: Internal Module Mode (Disable / Hotspot / WiFi) on Touch Screen doc_type: handoff status: QA last_updated: 2026-06-04 sources: - { type: jira, ref: "V4-2318", url: "https://tvunetworks.atlassian.net/browse/V4-2318" } - { type: jira, ref: "FB-7775", url: "https://tvunetworks.atlassian.net/browse/FB-7775" } figma: file: 0054ib0nLmt27bC3QlGDl7 nodes: - { id: "8672:11", label: "V4-2318 LCD Mode Toggle section", url: "https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=8672-11" } --- # V4-2318 LCD Mockup — Internal Module Mode (Disable / Hotspot / WiFi) on Touch Screen **Date**: 2026-06-04 **Author**: Nancy Zeng **Status**: Draft — awaits PM/dev review **Jira**: V4-2318 (new) — mirrors the LCD side of [V4-1865](https://tvunetworks.atlassian.net/browse/V4-1865) (Config-T) · customer [FB-7775](https://tvunetworks.atlassian.net/browse/FB-7775) **Figma**: LCD file `0054ib0nLmt27bC3QlGDl7` · page [`< V4-2318 >` (8476:2)](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=8476-2) · Section [`8672:11`](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=8672-11) --- ## 1. Goal 把 V4-1865 在 Config-T 上做的「Hotspot 模块 3-mode（Disable / Hotspot / WiFi）」操作，映射到 **TM1100 LCD 触摸屏**（480×320）。用户可在 LCD 上查看并切换该内部模块的工作模式，无需 Config-T。 Scope = pack LCD only。Config-T(V4-1865) / backend(V4164) 不在本 ticket。 ## 2. Architecture / 核心交互 - **Mode 选择器 = 横向 3-segment pills**（Disable / Hotspot / WiFi），位于 Hotspot 页顶部，替换原 ON/OFF。当前态 = 高亮 pill。 - **切换即确认，无独立 OK**：点另一个 pill → **直接弹原生确认框** → Confirm 进过渡(Switching) → 落到目标模式屏。Cancel 取消。 - **页面主名 = "Hotspot"**（模式设置入口），避免与真正的 WiFi 网络页撞名。 - 每种模式的产品表现： | Mode | LCD 表现 | |---|---| | **Disable** | 两个二维码置灰；本地扫码不可达 → 提示用 Command Center 远程管理 | | **Hotspot**（开机默认） | 双二维码：`Scan to connect`(热点) + `Scan to manage this device`(配置页) | | **WiFi** | 模块作为第二 WLAN 客户端；本屏用 `Go to WiFi page`(LCD Primary 按钮) 引导到 WiFi 页配置 | ## 3. Deliverables（Section 8672:11 内，全部包于一个 Figma Section） | 类别 | Frame | node-id | |---|---|---| | Mode flow | F1 Disable / F2 Hotspot(默认) / Confirm / F4 Switching / F3 WiFi-result | 8493:74 · 8487:11 · 8622:232 · 8493:188 · 8493:131 | | M23 UX 卡 | F1 / F2 / Confirm / F4 / F3 | 8509:308 · 8509:311 · 8624:244 · 8509:317 · 8509:314 | | Linked screens | B WiFi 页(WiFi 2) · C Slot 页 · C Home | 8606:58 · 8610:193 · 8610:362 | | 分析表 | 模式→Home/Slot 对比矩阵 · 6 条切换确认文案表 | 8637:2 · 8664:233 | | 需求 | PRD 卡 · 真 Jira 组件 | 8505:308 · 8483:11 | ## 4. Key decisions 1. **原生 LCD 确认框，非 M41 web 式**：header(chrome 色) + content-panel(内容色满宽) + 底部 `Cancel / [action]`，按钮克隆本地组件（Cancel 灰渐变 frame、主操作 = `update` 实例深底+绿边框）。参考帧 6443:16784。**不**用 20% 遮罩+blur 居中卡片（那是 web 范式）。 2. **6 条互切全部确认**，但 dev 只做**一个参数化弹窗组件**，文案/影响按[切换确认文案表 8664:233](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=8664-233)代入。High = 离开 Hotspot/WiFi 或 → Disable；Low = 从 Disable 开启。 3. **模块统一命名 = "WiFi / Hotspot Module"**：WiFi 页该条目标为 `WiFi 2 (WiFi / Hotspot Module)`（内联灰色括号提示，非边框 pill——避免像输入框）。点明它身兼热点、又不暗示当前在当热点。 4. **LCD 双背景色硬规则**：导航条 + 底部按钮区 = chrome `#252525`，页面内容区 = `#313131`，内容左右内缩 12px、背景满宽。弹窗同样遵守。**适用于后续每个 LCD 任务**。 5. **对比矩阵**：H/W 是同一模块互斥两面，每行只显示当前模式那一面（Disable→H 灰 Off / Hotspot→H 激活 / WiFi→W 激活）；Ethernet 不变、不列举。 ## 5. Acceptance（F1 walkthrough + F2-late persona） - **PRD 覆盖**：3 模式查看/切换 ✅ · 双 QR(Hotspot) ✅ · Disable 远程兜底 ✅ · WiFi 模式跳转配置 ✅ · 切换确认 ✅。 - **F2-late persona**（现场工程师 / 直播 PM）： - 现场工程师："切到 WiFi 会不会断我远程？" → Confirm 正文明确"Command Center 仍可用"，疑虑被解 ✅。 - "哪个 WiFi 是刚切过来的模块？" → WiFi 页 `WiFi 2 (WiFi / Hotspot Module)` 标识解决 ✅。 - **Audit**：M-FONT 29 处 off-grid 已修正(→{12,14,16,18,20,22,24})；M-TXT-ICON `‹ 2/2 ›` 文字图标已删；M-INTEGRITY(标准 480×320 克隆,布局一致) / M-COLOR(取 sibling 实际色) 通过。 - **Cleanup Gate**：封面页 4140:13 无残留；全部交付物收于 Section 8672:11。 ## 6. Cross-product alignment — Config-T (V4-1865) LCD 与 Config-T 命名/范式已对齐： - ✅ **已实施**：Config-T「Onboard WiFi」第 2 页（F2 6602:2792）加了内联 `(WiFi / Hotspot Module)` 灰色标识，保留 `‹ 2/2 ›` 分页范式（UI 机制不变，仅加命名标识）。 - 两端用同一模块名，用户跨产品都认得出"WiFi 2 = 那个身兼热点的模块"。 - 注：该标识用 Inter 渲染（Helvetica Neue 在 plugin 环境不可加载，M47 fallback）；V4-1865 owner 可在原生环境换回 HN。属 V4-1865 scope 的小增量。 - ✅ Config-T WiFi-section UX 交付卡「Changes」已补该命名说明（双语，同色 ZH）。 - ✅ Config-T 页已补 Section [`6703:1116`](https://www.figma.com/design/rJJjWWs51n2iFOlCIC7aYG/Config-T---Local-UI---v7.7---8.0--20240220?node-id=6703-1116) 收纳全部内容（原先无 Section：V4-1865 建于 05-29/06-01，早于「全内容包 Section」规则 06-03 入 design-process.md；本次顺手补齐）。 ## 7. 项目级规则（TVU Pack / LCD，不回流真源） Owner 拍板：以下 3 条属 LCD 项目级，**不进 tvu-design-system**，存于 [`docs/decisions/2026-06-04-lcd-mockup-project-rules.md`](../decisions/2026-06-04-lcd-mockup-project-rules.md)： | # | 规则 | |---|---| | L1 | **LCD 双背景色**（导航/底部=chrome、内容=另一色，含弹窗；内容内缩 12px 背景满宽） | | L2 | **LCD 高影响操作=原生确认**（M41 的 LCD 例外，非 web scrim）+ N 变体用 1 锁样帧+文案表 | | L3 | **Disable 模块远程兜底**：本地扫码失效 → 置灰 + 指向 Command Center | > 其余返工（Section 完整性/sizing、双语 ZH 同色+透明、caption 避让 frame 名、库优先按钮）均为**违反 tvu-design-system 既有规则**，非新规则——按既有 acceptance 自查即可（同上 decisions 文件附录）。 ## 8. Open items / next - [ ] PM/dev review V4-2318 Figma。 - [ ] V4-1865 Config-T 同步 `WiFi / Hotspot Module` 命名（§6）。 - [ ] 规则回流 §7 待 Owner 拍板后 commit 到 tvu-design-system。 - [ ] dev：确认弹窗做成参数化组件，文案按 8664:233 表代入。 --- ## 9. Trevor Review Round 1 — Fix Log (2026-06-05 → 2026-06-08) **Review chain**: [FB-7775 #245592](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=245592) → [#245647](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=245647) → [#245650](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=245650) → [#245653](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=245653) → [#245811](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=245811) ### Trevor 关键反馈 > [#245811 (2026-06-05)] @Nancy Zeng Then you should just say "Connect to WiFi" on the button. Remove the wording "Set up its WiFi connection on the WiFi page". **核心改动**： - Button text → `Connect to WiFi`（替代旧 "Go to WiFi page"） - 删除文案 `Set up its WiFi connection on the WiFi page`（在 mockup 内 hint + Mode-switch confirm 表两处出现） ### 改动明细（2 轮） **第 1 轮（Owner 手动改 UI text，2026-06-07）**： - Button instance text → `Connect to WiFi` ✅ - Reply Trevor `Done.` ([#246009](https://tvunetworks.atlassian.net/browse/V4-2318?focusedCommentId=246009)) **第 2 轮（AI 扫 UX 交付层未同步项 + 顺带 term 一致性收尾，2026-06-08）**： | # | Node | 改动 | |---|---|---| | 1 | `8602:306` (F3 mockup 内 hint) | **DELETED** `Set up its WiFi connection on the WiFi page.` | | 2 | `8509:316` UX 卡 §F3 行 2 ZH | `"Go to WiFi page"（LCD Primary）按钮` → `"Connect to WiFi"（LCD Primary）按钮` | | 3 | `8509:316` UX 卡 §F3 行 4 EN | typo `Connect-to-WiFie button` → `"Connect to WiFi" button` | | 4 | `8665:35` Mode-switch 表（Hotspot → WiFi 行） | EN/ZH 删 `Set up its connection on the WiFi page` + `WiFi client` → `WLAN client` | | 5 | Button instance `8648:3` layer name | `Go to WiFi page (btn)` → `Connect to WiFi (btn)` | | 6 | `8665:17` (WiFi → Hotspot 行) + `8665:23` (WiFi → Disable 行) | EN+ZH `WiFi client` → `WLAN client` / `WiFi 客户端` → `WLAN 客户端`（Canonical Terms Discipline 真源对齐）| **Final scan empty** — 全 Section 无残留 `WiFi client` / `Set up...WiFi page` / `Go to WiFi page` / `WiFie` typo。 ### 触发的真源规则验证 - ✅ **No Open Questions in Deliverables**（design-process.md Step B § c707fd0a）— 反例预防：Trevor 反馈不是 open question 而是明确删除指令，归属"明确文案修正"非 open question - ✅ **Canonical Terms Discipline**（design-process.md Step B § a9f09894）— `WLAN client` 全局对齐 V4-1865 Trevor approved 措辞，Term `WiFi client` 同义词漂移 6 处全清 - ✅ **Step A.1 Parent FB read**（design-process.md § 32d85811）— 本次直接读 V4-2318 评论链 + 链接 FB-7775 全 history（V4-2318 status 评论#245811 + 同 ticket V4-1865 同源 review history #244618），无遗漏 context ### 反思 **process gap**：第 1 轮 Owner 改 UI text 后回 Trevor `Done.`，UX 交付层的 hint text / spec card / mode-switch table 文案没同步。原因：button text 改动看似"单点"，实际牵连 mockup hint + spec card + confirm table 多处。**回流候选**（但暂不立规则，先观察）：button text 改动起手做"reverse-grep"——按旧 button text 全 section 搜，列出所有引用点统一改。