# 智慧医院 AI 影像诊断与电子病历辅助决策系统

混合架构：**Spring Boot 3**（业务 / JWT）+ **FastAPI AI 微服务**（YOLO / MONAI / LangChain RAG / DeepSeek）+ **Vue 3**（Element Plus + ECharts）。

## 目录结构

```
smart-hospital/
├── smart-hospital/      # 业务后端 Maven 项目（Spring Boot 3.3）
├── ai-service/          # AI 微服务（FastAPI + YOLO + LangChain RAG）
├── frontend/            # 前端 Vue 3 项目
├── smart-hospital.sql   # 数据库初始化脚本
└── PROJECT_REPORT.md    # 早期探索汇报
```

## 〇、AI 微服务启动（推荐先启）

先决条件：Python 3.10+。

```bash
cd ai-service
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # macOS/Linux
# 建议先装 CPU 版 torch（避免 CUDA 包体积过大）
pip install torch torchvision --index-url https://download.pytorch.org/whl/cpu
pip install -r requirements.txt
copy .env.example .env          # 可填 DeepSeek/Qwen 的 LLM_API_KEY
uvicorn app.main:app --host 0.0.0.0 --port 8001
```

> 说明：`.venv`、`frontend/node_modules`、`smart-hospital/target` 为可重建依赖，不入库；
> 删掉后按上列命令重新安装即可。源码 + 医学权重精简后约数十 MB。

- 健康检查：http://127.0.0.1:8001/health  
- Swagger：http://127.0.0.1:8001/docs  
- 未启动 AI 服务时，Spring Boot 会**自动降级**为本地规则模拟，业务仍可用。  
- 详见 `ai-service/README.md`。

## 一、业务后端启动

先决条件：JDK 17+（默认 **H2 内存库**，无需安装 MySQL）。

1. 启动（默认 H2）：
   ```bash
   cd smart-hospital
   ./mvnw spring-boot:run       # macOS/Linux
   mvnw.cmd spring-boot:run     # Windows
   ```
2. 可选 H2 控制台：`http://localhost:8080/h2-console`  
   JDBC URL：`jdbc:h2:mem:smart_hospital`，用户 `sa`，密码留空。
3. 若要用本地 MySQL：
   ```bash
   # 先建库 smart_hospital，改 application-mysql.yml 账号密码后：
   mvnw.cmd spring-boot:run -Dspring-boot.run.profiles=mysql
   ```
4. 启动后 `DataInitializer` 会自动写入测试账号：
   - `admin / admin123`（角色 ADMIN，可管理用户）
   - `doctor1 / pass123`（角色 DOCTOR）
   - `radio1 / radio123`（角色 RADIOLOGIST）

后端监听 `http://localhost:8080`，业务前缀 `/api/**`。  
AI 服务地址配置：`ai.service.base-url`（默认 `http://127.0.0.1:8001`）。  
> H2 为内存库，进程退出后数据清空；每次启动会重新初始化演示数据。

## 二、前端启动

先决条件：Node.js 18+。

```bash
cd frontend
npm install
npm run dev
```

打开 `http://localhost:5173`，Vite 会把 `/api` 代理到 `http://localhost:8080`。

生产构建：
```bash
npm run build
```
产物在 `frontend/dist/`，可交给 Nginx 或后端静态资源目录托管。

## 三、主要功能

- 登录（JWT，token 存 localStorage，24h 过期）+ **修改密码**
- 仪表盘：患者/影像/病历/预约等多项 KPI + 近 7 天趋势 + 检查类型/诊断状态饼图 + 快捷入口与待办
- 患者管理：分页 + 关键字搜索 + 增删改 + **360° 档案**（关联影像 / 病历 / 预约）
- 影像管理：CRUD + 上传 + **AI 诊断**（FastAPI YOLO 检测框/标注图 + 标准报告，不可用时本地降级）
- 电子病历：CRUD + **AI 辅助决策**（治疗/护理/随访 + LangChain RAG 知识库引用）
- AI 对话与知识库管理（管理端可配置 DeepSeek 等 OpenAI 兼容接口）
- **预约挂号**：新建/编辑/删 + 状态流转（预约→确认→完成/取消/未到诊）+ 按日期筛选
- 用户管理：仅 ADMIN 角色可访问；前端路由守卫 + 后端 `@PreAuthorize` 双重校验

### 推荐演示路径

1. 依次启动：`ai-service:8001` → `smart-hospital:8080` → `frontend:5173`
2. 使用 `doctor1 / pass123` 登录
3. **影像诊断**：上传图片 → AI 诊断 → 查看标注图与报告
4. **电子病历**：诊断填写「高血压/肺炎」等 → 查看护理/治疗/随访与 RAG 来源

## 四、REST 接口一览

| 方法 | 路径 | 说明 | 权限 |
|---|---|---|---|
| POST | `/api/auth/login` | 登录，返回 `{token, user}` | 公开 |
| GET | `/api/auth/me` | 当前用户信息 | 已登录 |
| POST | `/api/auth/change-password` | 修改密码 | 已登录 |
| GET | `/api/stats/overview` | 统计概览（KPI + 趋势 + 分布） | 已登录 |
| GET/POST/PUT/DELETE | `/api/patients` 及 `/api/patients/{id}` | 患者 CRUD | 已登录 |
| GET | `/api/patients/{id}/profile` | 患者 360° 档案 | 已登录 |
| GET/POST/PUT/DELETE | `/api/imaging` 及 `/api/imaging/{id}` | 影像 CRUD（支持 keyword/status/studyType） | 已登录 |
| POST | `/api/imaging/upload` | 影像文件上传 | 已登录 |
| POST | `/api/ai-diagnosis/analyze/{recordId}` | 触发 AI 诊断 | 已登录 |
| GET | `/api/ai-diagnosis/result/{recordId}` | 查询 AI 诊断结果 | 已登录 |
| GET/POST/PUT/DELETE | `/api/emrs` 及 `/api/emrs/{id}` | 病历 CRUD（支持 keyword） | 已登录 |
| GET | `/api/emrs/{id}/ai-suggestions` | 获取 AI 辅助决策 | 已登录 |
| GET/POST/PUT/DELETE | `/api/appointments` 及 `/api/appointments/{id}` | 预约挂号 CRUD | 已登录 |
| PATCH | `/api/appointments/{id}/status` | 更新预约状态 | 已登录 |
| GET/POST/PUT/DELETE | `/api/users` 及 `/api/users/{id}` | 用户管理 | ADMIN |

所有响应格式：
```json
{ "code": 0, "message": "OK", "data": { ... } }
```
`code != 0` 由前端 axios 拦截器统一弹 `ElMessage`。

## 五、关键改造点

相较于原始 Thymeleaf 单体版本：

- Spring Boot 从 2.7 升级到 3.3.4，`javax.*` → `jakarta.*`，MySQL 驱动坐标改为 `com.mysql:mysql-connector-j`
- 引入 Spring Security + JWT（`jjwt` 0.12），无状态会话；密码 BCrypt 存储
- 引入统一 `Result<T>` + `GlobalExceptionHandler`，Controller 不再直接抛 `RuntimeException`
- `AsyncConfig` 声明 `ThreadPoolTaskExecutor` Bean，替换 `AIDiagnosisService` 里手动 `Executors.newFixedThreadPool(5)`
- `AiProperties` / `StorageProperties` 落地 `application.yml` 里原本"悬空"的配置
- `UserRepository.findByUsername` / `existsByUsername` 替换原 `findAll().stream()` 全表登录
- 删除 `templates/` 与 `PageController`，Thymeleaf 服务端渲染完全被 Vue SPA 替换
- 前端影像轮询增加 30 次上限 + `onBeforeUnmount` 清理，修复原页面死循环风险

## 六、验证清单

1. 后端 `mvnw package` 通过（当前工程已验证 BUILD SUCCESS）
2. 前端 `npm run dev` 启动成功后访问 5173
3. 用 `admin/admin123` 登录 → 能看到「用户管理」菜单
4. 用 `doctor1/pass123` 登录 → 访问 `/users` 显示 403
5. 患者页新增-编辑-删除全流程可用；点「档案」可查看 360° 关联数据
6. 影像页上传图片 → 新建记录 → 点「AI 诊断」→ 状态从 PENDING → ANALYZING → COMPLETED；筛选状态/类型可用
7. 病历页新建后弹出 AI 辅助决策 dialog，显示治疗/用药/风险/冲突四类内容
8. 预约挂号页可新建预约并切换状态（确认/完成/取消）
9. 右上角用户菜单 → 修改密码 → 成功后需重新登录