# 医梦患者智能服务门户（Adjutant）

面向单家医院部署的移动端 Web 智能服务门户 P0。患者可通过语音、文字和图片进入智能分诊挂号、检验检查报告解读、中医舌诊三项演示服务。

- 对外名称：医梦患者智能服务门户
- 内部代号：Adjutant（副官）
- 当前范围：单医院、固定 Mock 患者、三个 P0 智能体、移动端 Web

首次接手项目请先阅读 [开发与联调接手指引](./docs/DEVELOPMENT_GUIDE.md)，产品与交互决策见 [P0 文档集](./docs/p0-mobile/README.md)。

## 环境要求

- Node.js >= 20
- pnpm >= 9

## 快速启动

```bash
# 安装依赖
pnpm install

# 启动开发服务器（默认 http://127.0.0.1:5173）
pnpm dev

# 生产构建
pnpm build

# 预览生产构建
pnpm preview
```

## 测试

```bash
# 单元测试（Vitest）
pnpm test:unit

# E2E 测试（Playwright，需先安装浏览器）
npx playwright install chromium
pnpm test:e2e

# 全部测试
pnpm test
```

## 当前可演示流程

1. 智能分诊挂号：语音式输入、连续补槽、急诊风险分流、Mock 号源与挂号确认。
2. 报告智能解读：对话内上传报告、模拟识别、结构化解读与风险提醒。
3. 中医舌诊：体质问答、舌象上传、模拟 MCP 分析与综合结果。

服务目录会展示医院智能体清单，但 P0 只有以上三项可进入。

## 技术栈

| 类别 | 方案 |
|------|------|
| 框架 | Vue 3 (Composition API) |
| 语言 | TypeScript |
| 构建 | Vite 6 |
| 状态管理 | Pinia |
| 单元测试 | Vitest + @vue/test-utils |
| E2E 测试 | Playwright |
| 类型检查 | vue-tsc |

## 目录结构

```
src/
├── portal/       # 当前移动端门户页面、三智能体会话和 P0 状态
├── api/          # 既有 API、鉴权、SSE 和 Mock 卡片基础
├── cards/        # 既有挂号业务卡片
├── chat/         # 既有对话组件
├── layouts/      # 既有桌面终端布局（保留作参考，当前未挂载）
├── state/        # 既有终端状态（当前门户尚未接入）
├── theme/        # 全局设计令牌
├── App.vue       # 挂载 PortalApp
└── main.ts       # 应用入口
```

## 联调环境变量

```bash
VITE_API_BASE_URL=http://localhost:6040/api/v1
VITE_DEMO_MODE=true
```

当前 `src/portal/` 仍使用前端内置 P0 演示状态。后续联调应通过统一 Agent Gateway 接入，不要让页面组件直接绑定 FastGPT 应用 ID。具体顺序与数据边界见 [开发与联调接手指引](./docs/DEVELOPMENT_GUIDE.md)。