MediLink Global 文档

E2E 测试约定（总纲）

Mon, 01 Jan 0001 00:00:00 +0000

本项目 E2E 体系的初始世界定义与规则手册。场景覆盖地图见 e2e-medilink-场景清单.md；功能行为的 as-is 权威 = prd/fsd-medilink/（FSD）。实现原则：API-first、workers 1、断业务结果不断实现细节、事件链轮询非 sleep。

PRD 分区地图 —— MediLink Global 海外来华就医服务平台

Mon, 01 Jan 0001 00:00:00 +0000

本目录是需求的唯一源（md），交互原型是 UX 提案附件。技术设计见 ../docs/tech-design.md。

文档索引

文档	状态	说明
srs-medilink-v1.md	DRAFT	系统需求规格书 v1.0（MVP）。唯一权威源，由同名 docx 转换（2026-10-07），docx 仅存档不再更新

原型索引（prd/workspace/）

纯静态 HTML，每页自包含，演示件不代表真实性能方案：

E2E 场景清单（medilink 册）

Mon, 01 Jan 0001 00:00:00 +0000

覆盖地图非用例步骤表——用例步骤即 scripts/dev/e2e.sh 本体（一次性长链，段=场景）；本表给全景覆盖、FSD 回链与缺口。测试约定见 e2e-测试约定.md。断言规模：83 处 expect_status + 若干业务字段断言（896 行脚本）。

MediLink Global —— 海外来华就医服务平台系统需求规格书（SRS）

Mon, 01 Jan 0001 00:00:00 +0000

本文件由 海外来华就医平台-系统需求规格书(1).docx 转换而来（2026-10-07，pandoc + 人工整理），内容忠实于原 docx。 本 md 是需求的唯一权威源；docx 仅作存档，后续修订直接改本文件。

MediLink Global 功能规格说明书（FSD）v1.0 · 总则

Mon, 01 Jan 0001 00:00:00 +0000

上游文档：prd/srs-medilink-v1.md（v1.1，需求唯一权威源）。本文档以代码实现为事实基准，还原系统真实运转规则；与 SRS 的差异以 ⚠ DIF 注记标出并登记 99-附录差异台账。功能 ID 规则：F<m>.<两位序号>（m = 模块号 1~10，与代码域包对应）。ID 全局唯一、只增不改号。技术设计（为什么这样实现）见 docs/tech-design.md（15 节）；本文只记 as-is 行为。

FSD m01 · 账号认证与权限（auth + gateway）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/auth 与横切包 internal/gateway。全局规则见 00-总则 §2（权限矩阵 §2.1、状态机 §2.2、一致性 §2.3）。

m01 功能节目录

ID	名称	路由/入口
F1.01	B 端两段式登录（密码+TOTP）	`POST /api/auth/login` + `POST /api/auth/mfa`
F1.02	患者登录	`POST /pub/v1/login`
F1.03	访客会话签发 guest-session	`POST /pub/v1/guest-session`
F1.04	JWT 五面鉴权与路由矩阵	全部路由面（中间件）
F1.05	RBAC 权限码字典与路由守卫	`/api` 面业务路由（中间件）
F1.06	/pub IP 限流	`/pub` 面组级中间件

F1.01 B 端两段式登录（密码+TOTP）

对应 SRS：§4.2 后台账号安全（机制细化）｜实现落点：internal/domain/auth/service.go:70（Login）/:114（MFA）/handler.go:22-27（路由）｜操作入口：web /admin/login 登录页两段表单；API curl

FSD m02 · 医院主数据与展示（hospital）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/hospital。全局规则见 00-总则 §2；直传三步通用规则见 §2.5；医院/科室/专家三同构状态机见 §2.2。

FSD m03 · 双语咨询（chat）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/chat。全局规则见 00-总则 §2（SSE 聊天专项见 tech-design §9）；直传三步通用规则 §2.5。

m03 功能节目录

ID	名称	路由/入口
F3.01	创建匿名咨询会话	`POST /pub/v1/chat/session`
F3.02	SSE 流与心跳重连	`GET /pub/stream`、`GET /pt/stream`、`GET /api/stream`
F3.03	发消息与异步翻译回填	`POST /pub/v1/chat/messages`
F3.04	图片消息	`POST .../chat/images/presign` + 发消息
F3.05	已读回执	`POST .../chat/messages/read`
F3.06	B 端会话管理与回复	`GET /api/chat/sessions`、`POST /api/chat/sessions/:id/messages` 等
F3.07	注册卡片推送	`POST /api/chat/sessions/:id/card`
F3.08	患者端聊天（/pt 转正+重译）	`GET /pt/chat/session`、`POST /pt/chat/messages` 等

F3.01 创建匿名咨询会话

对应 SRS：F-CHAT-001 ｜实现落点：internal/domain/chat/service.go:96（EnsureSession）/handler.go:25（路由）｜操作入口：app H5 医院详情页「咨询」按钮 / 聊天页首次进入（详情页按钮曾因 onConsult 引用未定义变量点击必抛 ReferenceError——⚠ DIF-F3-1 已修复 M15，回归锁 detail.test.tsx）

FSD m04 · 患者注册与病历（patient + ticket 直传）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/patient 与 internal/domain/ticket 的直传三步/注册事务链部分。全局规则见 00-总则 §2；直传三步通用规则 §2.5。

m04 功能节目录

ID	名称	路由/入口
F4.01	注册事务链（建账号+绑会话+开单+通知）	`POST /pub/v1/register`
F4.02	病历直传三步协议	`POST /pub/v1/documents/presign` + `/confirm`
F4.03	注册完成通知（确认邮件+顾问 INBOX）	outbox（事务链内入列）
F4.04	患者资料与进度派生	`GET /pt/me`、`GET /pt/progress`
F4.05	GDPR 导出与抹除	`GET /pt/me/export`、`POST /api/patients/:id/erase`

F4.01 注册事务链（建账号+绑会话+开单+通知）

对应 SRS：F-REG-001 / F-TICK-001（开单腿）｜实现落点：internal/domain/patient/service.go:70（Register）/chat.BindPatientInTx（chat/service.go:480）/ticket.CreateInTx（ticket/service.go:236）/ticket.BindDocumentsInTx（ticket/service.go:126）/handler.go:30（路由）｜操作入口：app H5 #/pages/register（聊天卡片点击或直达）

FSD m05 · 工单与看板（ticket）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/ticket 的 B 端面（直传三步/注册链部分在 m04）。全局规则见 00-总则 §2（A 轴状态机 §2.2、AST 守卫 §2.3）。

m05 功能节目录

ID	名称	路由/入口
F5.01	工单自动生成	（F4.01 事务链内 CreateInTx）
F5.02	工单分配与流转	`POST /api/tickets/:id/assign(-doctor)`、`POST /api/tickets/:id/transition`
F5.03	状态机 transition() 与三条回退边	（F5.02 内核；守卫测试锁定）
F5.04	病历下载与版本组读	`GET /api/documents/:id/download`、`GET /api/documents/:id/versions`
F5.05	运营看板（聚合+三超时+对账 tab）	`GET /api/board`

F5.01 工单自动生成

对应 SRS：F-TICK-001 ｜实现落点：internal/domain/ticket/service.go:236（CreateInTx，F4.01 注册事务链内调用）｜操作入口：—（系统自动，随注册发生）

FSD m06 · 预诊断与方案（diagnosis）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/diagnosis（无新表——医生输出落 ticket 列，状态变更走 ticket.TransitionInTx 唯一入口）。全局规则见 00-总则 §2。

m06 功能节目录

ID	名称	路由/入口
F6.01	医生工作台（预诊+专家选人 dept 锚）	`GET /api/diagnosis/pending`、`GET /api/diagnosis/experts`、`POST /api/diagnosis/:ticketId`
F6.02	拒绝与重派	`POST /api/diagnosis/:ticketId/reject`
F6.03	患者方案确认	`GET /pt/plan`、`POST /pt/plan/confirm`

F6.01 医生工作台（预诊+专家选人 dept 锚）

对应 SRS：F-DIAG-001（专家选人为 M10 扩展，SRS 未细化）｜实现落点：internal/domain/diagnosis/service.go:47（PendingList）/:78（Submit）/:229（ExpertOptions）/main.go:259-262（路由）｜操作入口：web /admin/diagnosis 医生待诊页（列表→病历预览 Modal→填意见/选专家→提交）

FSD m07 · 支付与对账（payment）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/payment（两表：payment_order 状态表 + payment_webhook_event 技术表）。全局规则见 00-总则 §2（支付单状态机 §2.2）。

FSD m08 · 诊疗过程（care）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/care（无新表——care_stage 落 ticket 列 TransitionStageInTx 唯一入口，阶段历史=lifecycle 行集，不建阶段记录表——DIF-M7 ①）。全局规则见 00-总则 §2（C 轴状态机 §2.2）。

FSD m09 · 出行协助（trip）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/trip（单表 trip_record，detail JSON 列承载酒店/交通字段差异）。全局规则见 00-总则 §2（trip 状态机 §2.2）。

FSD m10 · 系统管理与审计（user + audit + infra/notify）

Mon, 01 Jan 0001 00:00:00 +0000

本册覆盖代码域 internal/domain/user、横切包 internal/audit 与 internal/infra/notify。全局规则见 00-总则 §2（双日志轨 §2.6）。

FSD 99 · 附录

Mon, 01 Jan 0001 00:00:00 +0000

A. SRS 需求 ID → FSD 功能节权威对照表

SRS §3 共 22 个功能 ID；一个 SRS 功能可拆多个 FSD 节（实现粒度），一个 FSD 节可承载多个 SRS 功能（事务链）。FSD 50 节中 28 节直接对应 SRS，22 节为代码先行（基础设施/扩展批次）。

MediLink Global 文档

E2E 测试约定（总纲）

PRD 分区地图 —— MediLink Global 海外来华就医服务平台

文档索引

原型索引（prd/workspace/）

E2E 场景清单（medilink 册）

MediLink Global —— 海外来华就医服务平台 系统需求规格书（SRS）

MediLink Global 功能规格说明书（FSD）v1.0 · 总则

FSD m01 · 账号认证与权限（auth + gateway）

m01 功能节目录

F1.01 B 端两段式登录（密码+TOTP）

FSD m02 · 医院主数据与展示（hospital）

FSD m03 · 双语咨询（chat）

m03 功能节目录

F3.01 创建匿名咨询会话

FSD m04 · 患者注册与病历（patient + ticket 直传）

m04 功能节目录

F4.01 注册事务链（建账号+绑会话+开单+通知）

FSD m05 · 工单与看板（ticket）

m05 功能节目录

F5.01 工单自动生成

FSD m06 · 预诊断与方案（diagnosis）

m06 功能节目录

F6.01 医生工作台（预诊+专家选人 dept 锚）

FSD m07 · 支付与对账（payment）

FSD m08 · 诊疗过程（care）

FSD m09 · 出行协助（trip）

FSD m10 · 系统管理与审计（user + audit + infra/notify）

FSD 99 · 附录

A. SRS 需求 ID → FSD 功能节 权威对照表

MediLink Global —— 海外来华就医服务平台系统需求规格书（SRS）

A. SRS 需求 ID → FSD 功能节权威对照表