PR_Min_APP_V2/openspec/specs/eye-health-zone/spec.md

eye-health-zone Specification

Purpose

Define the archived behavior contract for PRI-MP-EYE-001, covering the eye health zone aggregation pages, fixed education content, real service/content/doctor entry points, and the boundary that personal eye archive data belongs to EYE-002.

Requirements

Requirement: REQ-EYE-001-01 眼健康专区路由与页面

系统 MUST 提供眼健康专区及近视防控、近视手术、白内障、干眼护理相关页面，承接新版专区聚合体验。

• MUST：注册 pages/index/pages/eyeZone/eyeZone。
• MUST：注册 pages/index/pages/eyeZone/myopia/myopia。
• MUST：注册 pages/index/pages/eyeZone/myopia/selftest/selftest。
• MUST：注册 pages/index/pages/eyeZone/surgery/surgery。
• MUST：注册 pages/index/pages/eyeZone/surgery/guide/guide。
• MUST：注册 pages/index/pages/eyeZone/cataract/cataract。
• MUST：注册 pages/index/pages/eyeZone/cataract/guide/guide。
• MUST：注册 pages/index/pages/eyeZone/dryeye/dryeye。
• MUST：注册 pages/index/pages/eyeZone/dryeye/care/care。
• MUST：安全路由白名单包含本模块页面。

Scenario: 进入眼健康专区

• Given 用户从首页或服务入口进入眼健康专区
• When 页面加载
• Then 系统 MUST 展示专区聚合页，并允许进入各专病专区。

Requirement: REQ-EYE-001-02 专区服务入口配置

系统 MUST 使用真实服务入口配置或明确待开放态展示专区服务，不得使用临时模拟入口冒充后端业务数据。

• MUST：优先通过 01030009 查询服务入口配置。
• MUST：请求参数包含医院态字段，如 hospID/hospCode。
• MUST：归一服务标题、说明、图标、路由、状态和服务类型。
• MUST：接口失败、返回空或未配置时展示待开放/待配置状态。
• MUST NOT：使用模拟服务列表作为最终实现。

Scenario: 服务配置缺失

• Given 当前医院没有返回眼健康服务配置
• When 用户进入专区页
• Then 页面 MUST 展示服务待配置或待开放提示，不得展示伪造业务入口。

Requirement: REQ-EYE-001-03 专区科普内容

系统 MUST 使用真实科普内容接口展示专区文章，并跳转 CONTENT-001 详情能力。

• MUST：通过 01010042 查询科普文章列表。
• MUST：请求参数包含 categoryID/page/pageSize/hospCode 或等价医院态字段。
• MUST：归一文章标题、摘要、封面、分类、发布时间和链接。
• MUST：文章点击跳转 pages/index/pages/healthScienceDetail/healthScienceDetail。
• MUST：覆盖加载中、空数据、接口失败和资源失败。
• MUST NOT：使用模拟文章或本地静态文章冒充接口结果。

Scenario: 科普文章加载失败

• Given 01010042 请求失败
• When 专区科普区块渲染
• Then 系统 MUST 展示错误态和重试入口，不得展示假文章。

Requirement: REQ-EYE-001-04 专区专家与医生入口

系统 MUST 使用真实医生接口或 HOME-003 契约展示专区专家入口。

• MUST：通过 03100042/03100038 或 HOME-003 既有领域工具查询医生列表。
• MUST：请求参数包含医院态字段，必要时包含就诊人契约字段。
• MUST：归一医生头像、姓名、职称、科室、擅长和医生 ID。
• MUST：医生点击跳转 pages/index/pages/doctorDetail/doctorDetail 或 HOME-003 安全入口。
• MUST：预约入口只跳转 REG-001 挂号入口，不在本模块锁号、下单或支付。
• MUST：咨询模块可用时，咨询入口必须跳转既有图文咨询链路；仅在咨询模块不可用时显示“暂未开通功能”。
• MUST NOT：使用模拟医生或模拟排班、预约状态、咨询状态。

Scenario: 专区医生为空

• Given 医生接口返回空列表
• When 专区专家区块渲染
• Then 页面 MUST 展示医生空态或推荐去找医生，不得展示模拟专家。

Requirement: REQ-EYE-001-05 宣教固定内容边界

系统 MUST 允许展示新版原型中的宣教、流程说明和服务介绍，但不得生成个人业务结论。

• MUST：近视防控、近视手术、白内障、干眼护理页面可展示固定宣教文案。
• MUST：术式对比、手术指南、白内障指南、干眼疗程说明可展示固定说明。
• MUST：自测说明页只能展示检查建议、风险提示和就诊引导。
• MUST NOT：输出个人风险等级、诊断结果、费用估算、报告结论、治疗适配结论或预约状态。

Scenario: 用户查看自测说明

• Given 用户进入近视、白内障或干眼自测说明页
• When 页面展示说明内容
• Then 系统 MUST 只展示宣教说明和就诊建议，不得生成个人自测结果。

Requirement: REQ-EYE-001-06 个人健康与高风险能力划出

系统 MUST 将眼健康档案、筛查、报告、费用、风险和护理打卡等能力划出本模块。

• MUST：白内障专区的检查报告记录入口跳转 EYE-002 pages/index/pages/visonArchives/archiveIndex/archiveIndex，用于查看当前就诊人的真实检查记录。
• MUST：该入口不得生成报告结论、临床解读、风险等级、诊断或治疗建议；临床解读仍由真实接口或线下医生确认。
• MUST：费用估算、疗效追踪、护理打卡、医生同步通知、预警和个性化报告生成显示待开放或待确认。
• MUST NOT：直接调用 17050008/17050009/17050010/17050015/17050042。
• MUST NOT：迁移或调用旧前端明文 appId/appSecret 近视筛查接口。
• MUST NOT：调用支付、医保、治疗预约提交、商品下单或档案写入接口。

Scenario: 用户查看白内障检查记录

• Given 用户点击白内障专区的报告记录入口
• When EYE-002 上下文有效
• Then 系统 SHALL 打开视觉档案查看真实检查记录，不在 EYE-001 页面生成任何解读。

Requirement: REQ-EYE-001-07 UI 与交互状态

系统 MUST 按新版 UI 标准呈现专区页面并覆盖异常状态。

• MUST：专区页面使用蓝青医疗服务风格、顶部业务区、白色卡片、服务卡、医生卡、科普卡和固定 CTA。
• MUST：高还原新版页面 page-zone/page-myopia/page-surgery/page-cataract/page-dryeye 的信息分组、入口、CTA 和视觉层级。
• MUST：覆盖加载中、空数据、接口失败、未选医院、未配置、目标模块不可用和资源加载失败状态。
• MUST：所有跨模块入口失败时给出 toast、空态或安全兜底，不得静默失败。

Scenario: 接口失败后重试

• Given 专区服务、科普或医生接口失败
• When 用户点击重试
• Then 系统 MUST 重新请求对应真实接口并更新页面状态。