identity-ocr-face Specification

Purpose

定义 PRI-MP-USER-003 实名认证、证件 OCR、人脸列表与人脸采集能力。OCR、实名核身和人脸保存须严格使用旧版字段与交互顺序，并由用户明确确认后执行。

Requirements

Requirement: REQ-USER-003-01 USER-003 实名 OCR 人脸能力

系统 MUST 按 PRI-MP-USER-003 上下文包、功能点专项矩阵和集成队列裁定口径实现本模块能力，并保留跨模块契约、真实接口边界和人工联调边界。

历史追溯：本模块最初从 develop@9a529fc 的 feature/PRI-MP-USER-003-identity-ocr-face 分支开发；该记录不构成当前业务或验收要求。
MUST：覆盖当前模块功能点专项矩阵，并对每个功能点给出已实现、暂缓、划归其他模块、待确认或不属于本模块的结论。
MUST：记录契约与依赖闭环，未完成依赖必须使用待开放、禁用态或安全兜底。
MUST：自检报告包含新版设计基线、旧源码功能基线、视觉布局基线、真实接口与禁止模拟业务数据检查。
MUST：提交待集成时列出共享文件清单、固定检查结果和人工联调项。
MUST NOT：子 Agent 自行合并或推送 develop。
MUST NOT：使用 mock、本地假接口、硬编码业务返回或静态业务数据替代真实接口。
MUST NOT：在页面加载、显示、回跳或刷新时自动触发真实支付、医保、退款、订单创建、预约提交、实名/OCR/人脸、IM/TRTC 等高风险写操作；真实写操作必须通过用户确认、授权和旧版接口字段校验。

Scenario: 模块提交待集成

Given PRI-MP-USER-003 模块开发完成
When 子 Agent 提交待集成材料
Then OpenSpec strict、功能点矩阵闭环、契约与依赖闭环、共享文件清单、禁止 mock/硬编码扫描、人工联调项和固定检查结果 MUST 齐全。

Requirement: REQ-USER-003-02 实名认证入口与上下文承接

系统 MUST 在“我的”页提供实名认证与人脸识别入口，并基于当前登录态、医院上下文和当前就诊人生成受控参数，不得绕过 USER-002 就诊人维护契约。生产页面仅可渲染最小化、非敏感状态；不得渲染身份证号、手机号、openID、验证码、就诊人标识、完整请求对象或本地证件图片路径。

Scenario: 从我的页进入实名认证

Given 用户已登录、已选择医院并存在当前就诊人
When 用户点击“实名认证”
Then 系统 MUST 进入 pages/mine/identity/identityVerify/identityVerify
And 页面 MUST 仅展示实名资料就绪、待补齐或人工联调边界等最小化状态，不得展示当前就诊人、医院、手机号或身份证字段值。

Scenario: 当前上下文不足

Given 用户未登录、未选择医院或未选择当前就诊人
When 用户点击实名认证或人脸识别入口
Then 系统 MUST 使用 toast 提示补齐前置条件
And 系统 MUST NOT 发起 OCR、实名核身或人脸接口调用。

Requirement: REQ-USER-003-03 OCR 与实名核身受控契约

系统 MUST 按旧源码真实链路提供 OCR、短信验证码与实名核身能力。生产页面只可显示证件已选择、未选择、资料待补齐和执行结果等最小化状态；不得展示 OCR 或实名核身完整参数、验证码、openID、证件号、手机号或本地临时文件路径。

Scenario: 选择证件图片

Given 用户进入实名认证页面
When 用户选择证件图片
Then 系统 MUST 仅记录本地临时图片路径作为未上传的页面控制状态，并仅展示非敏感的“证件图片已选择”状态
And 系统 MUST NOT 渲染路径、图片元数据或 01020017 请求参数
And 系统 MUST NOT 自动调用 wx.uploadFile 或上传证件图片。

Scenario: 用户确认后执行 OCR 与实名核身

Given 当前医院、就诊人、证件图片和必要身份字段有效
When 用户在页面明确确认识别或实名核验
Then 系统 MUST 按旧源码顺序使用图片上传、01020017、01020014、01020015、01020023 执行对应真实链路
And 系统 MUST 在缺少用户确认或必要业务字段时拒绝提交，不得以 mock 或静态成功替代服务端结果。

Requirement: REQ-USER-003-04 人脸列表、采集准备与接口冲突闭环

系统 MUST 提供人脸列表和采集页面，并按旧源码顺序执行 88030003、相机拍照、88010021、88030002。页面只能展示采集准备、处理、保存与失败状态；不得展示采集前校验、图片处理或保存的完整参数对象，也不得渲染 openID、身份证号、手机号、验证码、就诊人标识或本地图片路径。

Scenario: 查询人脸列表

Given 用户进入人脸识别列表页面
When 当前上下文可用
Then 系统 MAY 调用只读接口 88030001 查询人脸列表
And 系统 MUST 对空列表、网络错误和业务错误提供页面态兜底。

Scenario: 用户确认采集人脸

Given 当前医院和就诊人信息有效
When 用户点击开始采集并明确确认
Then 系统 MUST 依次执行 88030003 患者校验、相机拍照、88010021 图片处理和 88030002 人脸保存
And 系统 MUST NOT 渲染这些接口的请求对象或任何敏感参数
And 用户未确认、取消相机或必要字段缺失时系统 MUST 停止后续步骤并显示真实失败状态。

Scenario: 接口语义冲突

Given 旧源码与接口材料对 88010021 和 88030002 语义存在不一致
When 系统展示或封装人脸能力
Then 系统 MUST 记录 88010021 暂按人脸图片处理/转换理解、88030002 暂按人脸采集保存理解
And 最终语义 MUST 列入真机人工联调裁定。

Requirement: REQ-USER-003-05 实名与人脸二级页响应式布局

实名认证、人脸列表和人脸采集页 MUST 在微信原生导航栏下保持单一导航层级，且固定底部操作区 MUST 在小屏和安全区设备上无横向溢出、屏外按钮或内容遮挡。

Scenario: 实名认证页显示四个操作

GIVEN 用户进入实名认证页
WHEN 页面渲染选择证件图片、识别身份证、拍照实名核验和人脸识别四个操作
THEN 四个操作 MUST 以两列等宽布局完整显示
AND 任一按钮 MUST NOT 被推出可见区域或遮挡页面内容。

Scenario: 人脸页使用原生导航

GIVEN 页面 JSON 已配置微信原生导航标题
WHEN 用户进入人脸列表或采集页
THEN 页面 MUST NOT 重复渲染页内返回按钮和同名导航标题
AND 刷新操作 MUST 保留为尺寸受控的内容操作。

spec.md 6.6 KB Постійне посилання Історія Запис