交付出件箱

← 返回出件箱

两端新首页 · 方案自检 v5

2026-09-24 · 接 v4（home-redesign-plan-v4-20260924.md）。自检方法：我自查 + 另派一个只读审查员按 11 个角度挑 v4 的毛病，审查员的前 4 条高危结论我逐条复核了代码（见附录）。只读，零代码改动。

零、本轮长官回复

一、自检发现的问题（按严重程度）

审查员建议中不采纳的一条：它建议门店汇总排除「org_id 是本店但 service_org_id 为空」的孩子来挡品牌方视角——这会把门店自己建档的孩子全排除掉（门店自建孩子 service_org_id 本来就是空）。品牌方视角问题改为在 tech 阶段按家长席位来源（seat_source='brand_code'）区分，不作为本轮拍板项。

二、改后的方案（相对 v4 的变化）

2.1 门店码：一个码，两种人

• 柜台贴一个码（网址式，微信自带扫一扫即可打开），与品牌码分开
• 扫码后先认微信身份：
• 没有任何家长账号 → 当场开号，账号归这家店，孩子直接归这家店（开号算不算这家店的开通数 → 待拍板五-2）
• 有 1 个账号 → 直接登录，选孩子绑到这家店，不开新号、不计开通
• 有多个账号 → 先选账号，再选孩子
• 门店码不建新表：用服务端签名的机构令牌（与家长码同类做法），故本包可不依赖迁移链（tech 阶段定）
• 门店扫家长码（反方向）：沿用已通的 4 个接口 + 家长"我的二维码"页 + 门店"扫一扫"（wx_jssdk.py 已有签名接口，jsApiList 加 scanQRCode）

2.2 设备库（小米之家式）

2.3 同龄排第几：先定功能

• 9-15 调研 axial-length-percentile-feasibility-20260915.md 已列过候选：JAMA 全球曲线 / 已发表的中国儿童眼轴百分位曲线（如武汉学龄儿童 Sci Rep s41598-022-08907-5）/ 自有门诊数据
• 下一步出一份"功能 × 数据源"对比给长官选：
• 参照数据：① 自有 5411 条（贴近客户，但都是近视门诊孩子，排名会偏）② 已发表的中国儿童曲线（覆盖普通孩子）③ 两者结合
• 显示什么：① 现在排第几 ② 历次检查的排名变化 ③ 往后走势（不能叫预测）
• 首页留位置，定下来之前不显示；现成可复用：PeerAxialBlock 组件、enable_peer_axial_compare 开关

三、先做什么（拆 4 包，逐包 test 验收）

准备项（不写代码，可同时）：长官看批次五对比图；我出设备库效果图 + 首页效果图增量改；我出同龄排名对比；立项写文档。

四、影响什么（在 v4 第四节基础上补充）

• 可见性改三处：影响门店列表/详情、家长列表/详情；现在 test/生产认领数据均为 0，零存量影响
• 登录：多账号选择改的是全体家长的登录流程 → 由批次五统一做
• 平板：见五-3
• 结算：新家长扫门店码开号是否计数 → 见五-2
• 其余同 v4：12 处跳转、nginx 根地址、公众号菜单与二维码物料（运维）、新增表、AI 与 4L 秒读不受影响

五、待长官拍板

1. 打卡数据门店能看到什么？ 建议：谁记了 / 谁没记 + 各类平均数（与效果图一致），看不到单个孩子每天的具体数字——算作规则 15 的一个明确例外
2. 新家长扫门店码当场开号，算不算这家店开通一个（结算）？
3. 平板这期做不做？ 建议这期不做，门店用手机看；平板下一期
4. 同意拆 4 包、扫码绑定先上？
5. 设备库的产品图、品牌 logo 谁来准备？

附录：复核证据（主会话亲跑）

$ sed -n '188,202p' app/services/refractive_record_service.py | grep -n where
3:    stmt = select(Patient).where(or_(_org_visibility_clause(org_id), Patient.is_sample.is_(True)))
14:        stmt = stmt.where(or_(own_clause, Patient.is_sample.is_(True)))
$ grep -n seat_bound_unionid app/models/user.py   → 94: …（注释「非 UNIQUE 允许同人多席位」）
$ grep -n "return_all" app/services/seat_service.py   → 602: return_all: bool = False
$ grep -n lookup_seat_username_by_wx app/api/seat_auth.py
510:    seat_username = await lookup_seat_username_by_wx(unionid, openid, db)     # 主登录·不带 return_all
814:    candidates = await lookup_seat_username_by_wx(                           # 重置密码·带 return_all
$ awk '/async def _find_existing_family_seat/,/^async def _provision/' app/services/brand_code_service.py | grep -n linked_org_id
16:            User.linked_org_id == brand_org_id,

规则 15 原文：brand-partner-spec-v1-20260915.md:63「机构只能看到机构自己录入的检查记录，家长自己录入的数据不对机构开放 | 9-15（长官明确：不打开）」

六、长官 9-24 第四轮拍板（追加）