第一批 · 家长首页技术方案 v0.2

在现有家长入口中搭好完整新首页，接入孩子档案、最近检查和已有功能。旧首页保留。缺失功能在原位置展示未开通或真实空态，后续逐块补齐。此页是技术方案，不表示系统已经开发或上线。

①家长首页框架与已有功能 → ②设备绑定与今日护眼记录 → ③子席位设备展示与互绑台账 → ④家长其余模块和二级页 → ⑤门店首页和二级页 → ⑥整体联调与适配验收。每批按技术方案、实施、验收推进。已确认的是第十二版设备绑定流程；首页其余内容继续逐项核验。 第二批先完成扫码与手动绑定必需的孩子、机构和设备关系；第三批扩展子席位关联展示、台账与筛选导出。

顺序保持：顶部卡片、孩子视光档案、今日护眼四卡、赵阳首页解读、最近检查、趋势三页签、眼轴百分位、五个常用入口、服务说明。保留横滑、页签切换及浮层等目标交互，配色与头图协调。原型继续在原页面增量调整。方案注释、演示数据和模拟扫码控件不进入正式界面。

新版首页采用机构级统一开关，默认关闭；第一批先接家长端，第五批门店首页完成后接同一个开关。头图开关独立：没有头图，也可以使用新首页，其顶部显示原 Logo、名称与介绍卡片；有图且开启，使用当前系统头图样式。上传头图只自动开头图，不自动开新版首页。关闭新版后回到旧首页，不影响聊天和已有记录。 开关须由当前账号所属机构的有效响应确认；加载、缺字段或读取失败均关闭。

上传或替换成功后自动开启头图；失败不改变原状态。没有图片时不能开启头图显示。删除图片同时关闭头图，手动关闭则保留图片。已有但关闭的图片不批量自动开启。图片加载失败回到旧卡片，换图后允许重新加载。上传或删除后同步管理页面状态，避免随后保存其他设置覆盖刚更新的状态。 关闭头图时沿用原卡片；若机构品牌展示也关闭，则按现有规则只显示机构全称，不额外显示 Logo 或介绍。

复用现有家长档案和检查接口，仅读取当前家长有权查看的数据。示范档案不自动当成真实孩子。切换孩子立即清除旧数据，迟到的请求不能覆盖新孩子。无孩子、无检查和请求失败分别处理。最近检查取同一条真实记录，保留左右眼、字段含义和源单位；缺失值不补零，不拿球镜当等效球镜，也不擅自转换视力口径。

档案、添加孩子、检查记录、报告上传、关于、设置、会话历史等复用现有入口或处理流程。每个入口继续遵守现有权限规则：档案按家长功能名单控制，报告等有机构配置的功能还需满足对应开关。品牌码首次设置密码、登录失效续期与到期拦截继续有效；首页切换不能丢失聊天消息或绕过登录层。门店、散客及开关缺失或读取失败时保留原页面。 新版首页开关只改变布局，不授予其他功能。未获档案权限时不请求孩子或检查数据；未获报告权限时不触发上传。隐藏入口和禁用操作均需验收，不能以接口返回成功替代功能授权。

今日护眼四类设备保留完整卡片和横滑位置，本批不使用旧演示时长或虚构完成度。设备绑定和手动记录在第二批接入，扫码对子席位的关联在第三批接入。首页 AI 解读、完整消息、三指标趋势与眼轴百分位，缺少可靠能力的部分保留位置并在第四批补齐。已有门店推送结论不冒充首页 AI 解读。

原12维物理核验的28条记录与失败历史完整保留；本次新增17条命令已分别由主会话和独立检查者重跑，退出码与输出一致。本轮仅修订技术方案与记忆，业务验收尚未执行。

先补配置和头图状态，再搭完整首页、接真实孩子与检查、接现有功能，最后验证整条链路。测试先失败再修正。需要真实数据库、接口和浏览器证据：新旧开关、机构隔离、头图全状态、快速切换孩子、失败重试、首次设密、登录续期、聊天落库及门店旧功能回归。宽度覆盖320、375、390、430、767、768、769、820、1024、1440。上述均为待执行验收项，不以演示代替业务测试。

以下规则纳入第一批实施与验收，不改变已确认首页版式。