交付出件箱

← 返回出件箱

新版手机端首页（家长端 P2 + 门店端 S1）· 可行性 verify 报告

2026-09-23 · 效果图：zhaoyang-home-6styles-20260921-flat1.html（设计 gpt-6-astra，组装校验 Claude）
基线：本 worktree HEAD = c6884c23（main）· origin/test 领先 1362 commit
方法：5 路并行子代理物理 grep + 主会话复核，每条结论带命令与真实输出；0 命中处均带对照组

一句话结论

两端首页在现有代码里都不存在容器（家长端和门店端目前共用同一个 /h5/chat，3412 行）。效果图 24 个区块里，11 个可直接复用、6 个需改造、7 个是从零新建；其中「今日护眼四设备手动记录」是最大的一块新工程（家长端录入 + 门店端汇总两头连锁），「眼轴百分位」卡在外部数据、不该排期。

与「二维码与端口绑定断开」（= Phase 83 批次五 / 子席位登录 v2）有真实文件级冲突：家长端首页就是 chat/page.tsx，批次五要改的 :791 :861 在同一个文件里。

一、先纠正 4 个会改变方案形状的事实

事实 1 · 家长端和门店端现在是同一个页面

/h5/chat（web/app/h5/chat/page.tsx，3412 行）既是家长端首页，也是门店坐席登录后的落地页，靠一个布尔分流：

$ grep -n "getSeatType()" web/app/h5/chat/page.tsx
1179:    setIsParentSeat(getSeatType() === "parent");

门店的"视光档案"/h5/store-refractive 只是从这个页面胶囊按钮跳进去的二级列表页（chat/page.tsx:3086-3101），它自己带门禁，不满足就 router.replace("/h5/chat")（store-refractive/page.tsx:34-105）。

→ 效果图画的两个首页，现实里一个都不存在。要做就是新建两个路由容器，不是"改现有首页"。

事实 2 · 「今日护眼情况」不是"没接数据"，是整条功能都不存在，而且现有 UI 是不可达死代码

$ grep -n "TodayBand\|TodayDetailSheet\|setTodayDetailOpen" web/app/h5/chat/page.tsx
42:import { TodayBand } from "./components/today-band";
43:import { TodayDetailSheet } from "./components/today-detail-sheet";
1380:  const [todayDetailOpen, setTodayDetailOpen] = useState(false);
2595:  {false && <TodayBand onOpenDetail={() => setTodayDetailOpen(true)} />}
3308:  <TodayDetailSheet open={todayDetailOpen} onOpenChange={setTodayDetailOpen} />

# 对照组(同文件正常渲染的组件,证明查法有效)
3299:  <HistorySheet

TodayBand 被 {false && ...} 短路永不渲染；而 setTodayDetailOpen(true) 全文件只在这个死代码块里被调用过一次 → TodayDetailSheet 物理上永远打不开。today-detail-sheet.tsx（310 行）全文件 fetch 零命中，纯静态 JSX。

后端侧：
- app/models/device.py 三张表 DeviceData / DeviceTypeConfig / UserPhoneVerification，DeviceData 的 comment 明写「设备使用数据（厂商推送）」，走 device_report.py:71 POST /report + API-Key
- 全仓 grep 离焦镜|红光仪|护眼灯|读写台 在 app/models app/api 里零命中记录功能（命中的全是 AI 话术治理规则和验光单品牌下拉选项）
- 对照组：grep -rn "护眼" --include="*.py" 能查到 DeviceTypeConfig(device_type="light", display_name="护眼台灯") → 查法有效

→ 没有表、没有字段、没有 API、没有可用前端。只有一份视觉骨架可以抄。

事实 3 · 「眼轴百分位」不是"还没做"，是做过又主动拆掉了

$ grep -n "@router\." app/api/find_similar.py
43:@router.post("/search")   83:@router.get("/facets")
99:@router.get("/cases/{case_id}")   135:@router.get("/image/{image_id}")

→ 历史上存在的 /peer-axial-norms 端点在当前代码里已不存在；前端 find-similar-pane.tsx:1254 注释写明「flags / peerNorms + peer-axial-norms 请求随双 tab 一并移除」；机构开关 enable_peer_axial_compare 默认 false（app/models/database.py:133），迁移注释写着「无合格人群基线前不得开」。

拆除原因写在 flywheel-progress.md:42：b3_cases 是成功案例集、不是人群样本，拿它算同龄中位数会误伤正常孩子；合格基线（门诊 5411 条历史记录清洗入库）另立 Phase，至今数据文件仍未上服务器。

→ 效果图上家长端、门店端各画了一张百分位图，这两张图背后是一个需要外部数据的独立工程，不是首页改版的一部分。

事实 4 · 「该功能需门店开通」这个弹窗，跟现网门控逻辑是相反的

$ grep -rn "该功能需门店开通\|需门店开通" web/app app
（0 命中）
# 对照组
$ grep -n "谣言粉碎机" web/app/h5/chat/page.tsx
3157: {/* Phase 75 · 机构开关 gate 谣言粉碎机入口 · 关则不渲染 */}

现网口径是 「关则不渲染」 —— 用户根本看不见这个入口，不会点到、也就不会弹窗。效果图改成了「看得见 + 点了告诉你需要开通 + 联系门店」，这是产品行为变更，不是视觉改版，需要长官单独拍板。

二、效果图 24 区块 · 逐块 verify 结果

家长端 P2（11 块）

门店端 S1（13 块）

工具入口逐项（两端共用）

门控机制：后端 OrgBrainConfig → /api/seat/org-features 下发 → 前端 parent-feature-gate.ts 做「机构开关 ∩ 家长可见名单(parent_visible_features)」交集 → 条件渲染。前端隐藏 + 后端 fail-closed 双门，没有裸露漏洞。

三、与「二维码与端口绑定断开」的冲突/依赖矩阵

先说清楚我对这个说法的理解（⚠️ 需长官确认）

代码里没有任何叫「设备/端口二维码解绑」的能力。我找到的最接近的在建工作是今天 23:22 落的《子席位账号与登录体系 v2》批次五（归口 Phase 83，长官已逐条拍板 13 条）：品牌码（=二维码）扫进来的家长，账号被微信身份绑死，拿不到 unionid 就彻底进不去，批次五给他们一条不依赖微信的手机号+密码通道 —— 这在口语上就是"把二维码进来的账号跟微信端的绑定断开"。

如果长官指的是别的（比如平板/门店设备与二维码的绑定），那我查到的是：
- device_epoch 只有换绑（清绑定+重置密码+踢设备，原子操作），seat_service.py:341,382,502
- 刻意不做独立"解绑"：phase50-seat-wechat-openid-binding-spec:32 D4 决策原文「单独"解绑"会留缺口(旧人抢绑/新人403) → 必须解绑+改密码合并一步」
- 唯一一份"设备绑定/解绑"设计（kid-clock-binding-spec-v0.1.md 的 device_bind_record 表 + DELETE /api/h5/devices/{sn}）是纯 spec，0 行代码落地（对照组：同样查法能查到 brand_code_claim.py 与 refractive_records.py 的 bind/unbind，证明查法有效）

冲突矩阵（按我的理解 = 批次五）

依赖（必须等）

结论：不是"等它做完才能用"，而是 C1/C2 要求两件事必须同分支串行做，或者由同一个人排期。并行改同一个 3412 行文件，必炸。

四、建议的实施分批（供拍板）

五、待长官拍板

六、我没验的 / 说不准的

1. 没在真机/test 上打开过新首页 —— 本报告全部是静态代码 grep 结论，没有渲染证据
2. 示范档案「已上生产」只验到代码在 main，没查发布记录确认生产容器真的带了它
3. 工作量估算是相对大小，不是人天 —— 没做过任务拆解，不敢给绝对数字
4. 「二维码与端口绑定断开」的所指是我的推断，证据链指向批次五但不排除是别的事（见 H1）
5. 效果图的交互细节（如门店端"看别人怎么做"tab 里到底放什么）效果图上是占位页，没有内容定义
6. 平板端 /h5/tablet 本次没有深入 verify —— 它是第三个端，若首页改版要覆盖平板，需要再查一轮

证据全部来自 5 路并行子代理 grep + 主会话复核，0 命中处均带对照组。本机为云端隔离开发机，非验收环境。