# 云脑医疗

**Repository Path**: richhenry/cloud-brain-medical

## Basic Information

- **Project Name**: 云脑医疗
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2025-11-12
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 医疗系统 - 多团队协作项目

## 项目结构

本项目是一个大型医疗系统，由三个团队协作开发，每个团队负责一个独立模块。

## 目录结构

```
Medical/
├── backend/                           # 后端服务
│   ├── guidance-service/              # AI导诊服务（寻医挂号）
│   ├── prescription-service/          # 处方助手服务（协助开药）
│   ├── medical-record-service/         # 电子病历助手服务（病历管理）
│   ├── common/                        # 公共模块（共享代码）
│   └── gateway/                      # API网关
├── frontend/                           # 前端应用
│   └── src/
│       ├── modules/
│       │   ├── guidance/              # AI导诊前端模块
│       │   ├── prescription/          # 处方助手前端模块
│       │   └── medical-record/        # 电子病历前端模块
│       ├── shared/                    # 共享组件和工具
│       ├── api/                       # API调用
│       ├── router/                    # 路由配置
│       └── stores/                    # 状态管理
├── database/                           # 数据库相关
│   ├── scripts/                       # 数据库脚本
│   ├── migrations/                    # 数据库迁移
│   └── seeds/                         # 种子数据
└── docs/                              # 项目文档
    ├── api/                           # API文档
    ├── architecture/                  # 架构文档
    ├── deployment/                    # 部署文档
    ├── guidance/                      # AI导诊文档
    ├── prescription/                  # 处方助手文档
    └── medical-record/                # 电子病历文档
```

## 模块说明

### 1. AI导诊服务 (Guidance Service)
- **功能**: 寻医挂号
- **描述**: 基础入口功能，帮助患者进行疾病咨询 → 科室推荐 → 医生选择 → 在线预约挂号
- **后端模块**: `backend/guidance-service/`
- **前端模块**: `frontend/src/modules/guidance/`
- **文档**: `docs/guidance/`
- **包名**: `com.medical.guidance`

### 2. 处方助手服务 (Prescription Service)
- **功能**: 协助开药
- **描述**: 核心组件，使用大模型技术进行智能、标准化、安全的处方开具、审核、优化和管理
- **后端模块**: `backend/prescription-service/`
- **前端模块**: `frontend/src/modules/prescription/`
- **文档**: `docs/prescription/`
- **包名**: `com.medical.prescription`

### 3. 电子病历助手服务 (Medical Record Service)
- **功能**: 病历助手
- **描述**: 核心智能单元，利用大语言模型和医疗知识图谱，实现病历的自动生成、智能归档和结构化管理
- **后端模块**: `backend/medical-record-service/`
- **前端模块**: `frontend/src/modules/medical-record/`
- **文档**: `docs/medical-record/`
- **包名**: `com.medical.medicalrecord`

## 新增功能：症状文本接收接口

### 功能描述
AI导诊服务新增了症状文本接收接口，用于接收前端传递的症状文本数据，进行必要的数据验证与处理后，将标准化的症状文本数据传递给AI分析模块。

### 技术实现
- RESTful API接口设计
- 支持HTTP POST请求方式
- 完整的数据验证机制
- 标准化的响应格式
- 日志记录和安全验证

### API接口详情

**Endpoint**: `POST /guidance/api/v1/symptoms/submit`

**请求参数**:
- `userId` (Long): 用户ID
- `symptomText` (String): 症状文本内容（非空，最大2000字符）
- `timestamp` (LocalDateTime): 请求时间戳

**响应格式**:
```json
{
  "code": 200,
  "message": "症状数据处理成功",
  "data": null,
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1731834600000
}
```

### 后端实现详情
- **控制器**: `com.medical.guidance.presentation.controller.SymptomController`
- **服务层**: `com.medical.guidance.application.service.SymptomService`
- **数据传输对象**: `com.medical.guidance.application.dto.SymptomRequest` 和 `SymptomResponse`
- **领域模型**: `com.medical.guidance.domain.model.Symptom`

## 共享资源

- **后端公共模块**: `backend/common/` - 所有团队共享的后端代码
- **前端共享模块**: `frontend/src/shared/` - 所有团队共享的前端代码
- **API网关**: `backend/gateway/` - 统一API入口

## 协作者配置

**首次加入项目或遇到推送权限问题？** 请查看 [协作者配置指南](docs/COLLABORATION_SETUP.md)

该指南包含：
- SSH 密钥配置
- HTTPS + 个人访问令牌配置
- 常见问题排查
- 权限问题解决方案

## 开发规范

1. 每个团队在自己的模块目录下开发
2. 共享代码放在 `common/` 或 `shared/` 目录
3. 遵循统一的代码规范和目录结构
4. 及时更新团队文档
5. 使用语义化的模块名称，便于理解和维护

## 注意事项

- 不要修改其他团队的代码
- 共享代码的修改需要团队协商
- 保持目录结构的一致性
- 模块命名遵循业务领域命名规范

## 技术栈配置

本项目已配置以下技术栈版本：

- **JDK**: 17
- **Maven**: 3.9
- **Spring Boot**: 3.4.5
- **数据库**: MySQL 8
- **ORM框架**: MyBatis Plus 3.5.14
- **AI框架**: Spring AI 1.0.3

所有模块均已统一配置并验证通过，可直接进行开发工作。