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

LLMS 索引： [llms.txt](/llms.txt)

---

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

| 元信息 | 内容 |
|--------|------|
| 版本 | v1.1（MVP 最轻量商用版；v1.1 2026-10-07 文件存储选型收敛为 MinIO（S3 兼容），见 §5） |
| 编制日期 | 2026-08-27 |
| 状态 | DRAFT（含 5 项待确认事项，见 §8.1） |
| 配套原型 | `workspace/` 下 5 个 HTML 交互原型（索引见 [README.md](/prd/readme/)） |
| 技术设计 | `../docs/tech-design.md` |

## 1. 引言

### 1.1 编写目的

本文档为海外来华就医服务平台的最轻量商用版本（MVP）提供完整的系统需求定义，作为开发、测试及验收的基准依据。

### 1.2 项目背景

本项目面向海外患者提供来华就医的一站式服务，连接国内三甲医院国际部资源，通过数字化平台实现从咨询、预诊断、方案制定到就医安排的全流程管理。

### 1.3 术语定义

| 术语 | 定义 |
|------|------|
| MVP | Minimum Viable Product，最小可行产品 |
| 工单 | 患者注册后生成的服务跟踪单，贯穿整个服务周期 |
| 预诊断 | 正式就诊前，由合作医生对病历资料进行初步评估 |
| 国际部 | 三甲医院面向外籍/海外患者的特需医疗服务部门 |

## 2. 总体描述

### 2.1 系统愿景

构建一个连接海外患者与国内三甲医院国际部的数字化服务平台，实现双语沟通、在线预诊、行程管理和诊疗跟踪的闭环。

### 2.2 MVP 范围界定

包含范围：医院国际部信息展示、双语实时聊天咨询、患者注册与病历上传、工单生成与流转、医生预诊断分配、诊疗方案与时间确认、在线定金支付、酒店/交通安排协助、诊疗阶段进度跟踪。

暂不包含：完整的电子病历系统（EMR）、医保结算对接、多医院 API 直连、视频问诊、术后康复长期跟踪。

### 2.3 用户角色

| 角色 | 描述 | 核心诉求 |
|------|------|----------|
| 海外患者 | 需要来华就医的海外人士 | 了解医院、顺畅沟通、掌握进度 |
| 顾问客服 | 平台服务顾问，负责对接客户 | 高效获取信息、跟进工单 |
| 预诊断医生 | 合作医院的医生，负责预诊评估 | 查看病历、提供专业意见 |
| 运营人员 | 平台后台管理人员 | 管理医院、监控工单 |

### 2.4 运行环境

| 端 | 技术栈建议 |
|----|------------|
| 患者端 | 响应式 Web（H5），支持微信内打开 |
| 顾问/医生端 | Web 管理后台 |
| 运营后台 | Web 管理后台 |
| 移动端适配 | 患者端优先移动端体验 |

## 3. 功能需求

### 3.1 医院国际部展示模块

- F-HOS-001：医院列表展示（名称、等级、城市、特色科室、筛选）
- F-HOS-002：医院详情页（国际部介绍、特色服务、科室列表、就诊流程、咨询入口）

### 3.2 双语咨询模块

- F-CHAT-001：聊天入口（匿名咨询、顾问在线状态、常见问题快捷入口）
- F-CHAT-002：实时双语聊天（患者英文/顾问中文、自动翻译、文本+图片、已读状态、本地缓存）
- F-CHAT-003：注册登记推送（顾问发送注册卡片、患者点击进入、完成后自动通知）

### 3.3 患者注册与病历管理模块

- F-REG-001：患者注册（护照姓名、国籍、年龄、性别、联系方式、症状描述、期望时间/城市、保险信息）
- F-REG-002：病历资料上传（PDF/JPG/PNG，20MB/文件，最多 10 个，标签描述，拖拽上传，进度显示）
- F-REG-003：注册完成确认（成功页面、工单编号、确认邮件、自动通知顾问）

### 3.4 工单管理模块

- F-TICK-001：工单自动生成（8 个状态、关联信息、自动通知）
- F-TICK-002：工单分配与流转（分配顾问、提交预诊断请求、医生确认/拒绝、操作日志）
- F-TICK-003：工单状态跟踪（患者进度条、后台详细日志）

### 3.5 预诊断模块

- F-DIAG-001：医生工作台（待诊断列表、查看病历、在线预览、填写预诊断意见、推荐科室和专家、预估时间和费用）
- F-DIAG-002：诊疗方案确认（患者通知、方案内容、在线确认、进入支付）

### 3.6 支付模块

- F-PAY-001：定金支付（明细展示、Visa/Mastercard/PayPal/支付宝国际版、支付凭证 PDF、状态更新）

### 3.7 出行协助模块

- F-TRIP-001：酒店安排（推荐合作酒店、距离/价格/翻译服务、预订需求、状态记录）
- F-TRIP-002：交通安排（机场接送、就医期间交通、信息同步）

### 3.8 诊疗过程管理模块

- F-CARE-001：8 个标准阶段定义（出发准备→到达接待→初诊→检查→确诊→治疗→康复→返程）
- F-CARE-002：阶段信息上传（文件上传、文字说明、自动归类、版本管理）
- F-CARE-003：患者进度同步（可视化进度条、阶段详情、待办事项、推送通知、报告下载）

### 3.9 后台运营模块

- F-ADMIN-001：医院信息管理（增删改、图片上传、科室专家管理）
- F-ADMIN-002：用户管理（账号创建/编辑/禁用、权限设置）
- F-ADMIN-003：工单监控（总览看板、超时提醒、搜索筛选）

## 4. 非功能需求

### 4.1 性能需求

| 指标 | 要求 |
|------|------|
| 页面加载时间 | 首屏 < 2 秒（3G 网络） |
| 聊天消息送达 | < 500ms |
| 文件上传 | 支持断点续传，显示实时进度 |
| 并发用户 | 支持 100 人同时在线（MVP 阶段） |

### 4.2 安全需求

| 需求 | 说明 |
|------|------|
| 数据加密 | 敏感数据传输使用 HTTPS，静态数据加密存储 |
| 身份认证 | 所有管理后台需登录，支持双因素认证 |
| 访问控制 | 基于角色的权限控制（RBAC） |
| 审计日志 | 关键操作记录日志 |
| 隐私合规 | 遵守 GDPR 和数据跨境传输相关法规 |

### 4.3 可用性需求

患者端默认英文，可选繁体中文、日文、韩文。响应式设计，患者端完美适配手机浏览器。基础无障碍访问支持。网络异常时友好提示。

### 4.4 可靠性需求

每日自动备份，保留 7 天。单点故障不影响核心功能。聊天消息持久化，离线消息同步。

## 5. 接口需求

翻译服务：集成第三方翻译 API（Google Translate / DeepL / Azure Translator），支持中英文实时互译，医学术语优化。

支付接口：Stripe / PayPal（国际卡），支付宝国际版，微信支付。

通知接口：邮件服务（SendGrid / AWS SES），短信服务（Twilio / 国内短信服务商），站内消息推送。

文件存储：对象存储采用 **MinIO（S3 兼容协议）**——dev/e2e 实例 `192.168.50.190:9000`；生产可零代码切换任意 S3 兼容云（含 AWS S3），阿里云 OSS 经 storage driver 层一个实现文件切换（2026-10-07 v1.1 裁决，原「AWS S3 / 阿里云 OSS」二选一收敛）。CDN 加速图片和文档预览。

## 6. 数据需求

### 6.1 核心实体

患者（Patient）：基本信息（ID、姓名、国籍、年龄、性别、邮箱、手机），就诊信息（主诉、期望时间、目标城市、保险信息），账户信息。

工单（Ticket）：编号、患者 ID、顾问 ID、医生 ID、当前状态、状态历史、医院/科室/诊断结果/治疗方案、定金金额/支付状态、酒店/交通安排。

病历文件（MedicalDocument）：ID、工单 ID、文件名、类型、大小、标签、上传阶段、存储路径。

聊天消息（ChatMessage）：ID、会话 ID、发送者、接收者、原文、译文、语言代码、发送时间、读取状态。

用户（User）：ID、姓名、角色、邮箱、手机、所属医院/负责区域、账户状态。

### 6.2 工单状态流转

新建 → 待分配 → 预诊断中 → 方案确认中 → 待支付 → 待出行 → 就医中 → 已完成

## 7. MVP 裁剪策略

| 功能 | 策略 |
|------|------|
| 翻译服务 | 首期接入标准翻译 API，不做术语库优化 |
| 支付方式 | 首期仅支持 PayPal 和信用卡（Stripe） |
| 酒店交通 | 首期人工协助，系统仅做记录，不自动对接 OTA |
| 医生端 | 首期通过 Web 端实现，不做独立 App |
| 报告预览 | 首期提供下载，不做在线 PDF 渲染 |
| 通知渠道 | 首期邮件+站内消息，短信可选 |
| 语言支持 | 首期仅英文和中文 |

## 8. 附录

### 8.1 待确认事项

- 目标市场优先级（东南亚？中东？欧美？）影响语言和支付方式
- 合作医院数量和首批上线医院名单
- 定金比例和退款政策
- 翻译服务预算和供应商选择
- 是否需要 ICP 备案和医疗相关资质

### 8.2 参考文档

三甲医院国际部服务标准、跨境医疗数据合规要求、各目标国家的医疗旅游政策。

---

反链：

- [需求文档](/prd/)
- [MediLink Global 功能规格说明书（FSD）v1.0 · 总则](/prd/fsd-medilink/00-%E6%80%BB%E5%88%99/)
- [PRD 分区地图 —— MediLink Global 海外来华就医服务平台](/prd/readme/)