AutoMedinfo/PROJECT_STRUCTURE.md

医学信息支持系统 - 项目结构说明

项目概述

本项目是为益普生(Ipsen)开发的医学信息支持系统，旨在帮助医学信息团队快速处理客户（主要是医生）的信息支持需求。

技术栈

后端

• Java 17
• Spring Boot 3.2.0
• Spring Data JPA
• Spring Security
• MySQL 8.0
• Maven

前端

• Vue 3
• Vite
• Element Plus
• Pinia (状态管理)
• Vue Router
• Axios

部署

• Docker
• Docker Compose
• Nginx

项目结构

文献流程/
├── backend/                          # 后端Spring Boot项目
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/ipsen/medical/
│   │   │   │   ├── MedicalInfoApplication.java    # 主应用类
│   │   │   │   ├── controller/                    # 控制器层
│   │   │   │   │   ├── InquiryController.java
│   │   │   │   │   ├── KnowledgeBaseController.java
│   │   │   │   │   └── LiteratureController.java
│   │   │   │   ├── service/                       # 服务层接口
│   │   │   │   │   ├── InquiryService.java
│   │   │   │   │   ├── KnowledgeBaseService.java
│   │   │   │   │   ├── LiteratureService.java
│   │   │   │   │   ├── DifyService.java
│   │   │   │   │   └── ExcelParserService.java
│   │   │   │   ├── service/impl/                  # 服务层实现
│   │   │   │   │   ├── InquiryServiceImpl.java
│   │   │   │   │   ├── KnowledgeBaseServiceImpl.java
│   │   │   │   │   ├── LiteratureServiceImpl.java
│   │   │   │   │   ├── DifyServiceImpl.java
│   │   │   │   │   └── ExcelParserServiceImpl.java
│   │   │   │   ├── entity/                        # 实体类
│   │   │   │   │   ├── InquiryRequest.java
│   │   │   │   │   ├── KnowledgeBase.java
│   │   │   │   │   ├── Literature.java
│   │   │   │   │   ├── User.java
│   │   │   │   │   └── AuditLog.java
│   │   │   │   ├── repository/                    # 数据访问层
│   │   │   │   │   ├── InquiryRequestRepository.java
│   │   │   │   │   ├── KnowledgeBaseRepository.java
│   │   │   │   │   ├── LiteratureRepository.java
│   │   │   │   │   ├── UserRepository.java
│   │   │   │   │   └── AuditLogRepository.java
│   │   │   │   └── dto/                           # 数据传输对象
│   │   │   │       ├── ApiResponse.java
│   │   │   │       ├── InquiryRequestDTO.java
│   │   │   │       ├── KnowledgeBaseDTO.java
│   │   │   │       └── LiteratureDTO.java
│   │   │   └── resources/
│   │   │       └── application.yml                # 应用配置
│   │   └── test/                                  # 测试代码
│   ├── pom.xml                                    # Maven配置
│   ├── Dockerfile                                 # Docker构建文件
│   └── .gitignore
│
├── frontend/                         # 前端Vue3项目
│   ├── src/
│   │   ├── api/                                   # API接口
│   │   │   ├── inquiry.js
│   │   │   ├── knowledge.js
│   │   │   └── literature.js
│   │   ├── assets/                                # 静态资源
│   │   ├── components/                            # 通用组件
│   │   ├── layout/                                # 布局组件
│   │   │   └── index.vue
│   │   ├── router/                                # 路由配置
│   │   │   └── index.js
│   │   ├── store/                                 # 状态管理
│   │   ├── utils/                                 # 工具函数
│   │   │   └── request.js
│   │   ├── views/                                 # 页面组件
│   │   │   ├── Dashboard.vue                      # 工作台
│   │   │   ├── Login.vue                          # 登录页
│   │   │   ├── inquiry/                           # 查询管理
│   │   │   │   ├── InquiryList.vue
│   │   │   │   ├── InquiryCreate.vue
│   │   │   │   └── InquiryDetail.vue
│   │   │   ├── knowledge/                         # 知识库管理
│   │   │   │   └── KnowledgeList.vue
│   │   │   └── system/                            # 系统设置
│   │   │       ├── SystemConfig.vue
│   │   │       └── UserManagement.vue
│   │   ├── App.vue                                # 根组件
│   │   └── main.js                                # 入口文件
│   ├── index.html
│   ├── package.json                               # npm配置
│   ├── vite.config.js                             # Vite配置
│   ├── nginx.conf                                 # Nginx配置
│   ├── Dockerfile                                 # Docker构建文件
│   └── .gitignore
│
├── database/                         # 数据库脚本
│   ├── schema.sql                                 # 数据库结构
│   └── sample_data.sql                            # 示例数据
│
├── docker-compose.yml                # Docker Compose配置
├── .env.example                      # 环境变量示例
├── .dockerignore                     # Docker忽略文件
├── Readme.md                         # 项目说明（需求文档）
└── PROJECT_STRUCTURE.md              # 项目结构说明（本文件）

核心功能模块

1. 查询请求管理 (Inquiry Management)

• 上传标准化表格或手动创建查询请求
• 自动提取关键词（药物名称、疾病、问题）
• 执行多层次信息检索
• 生成回复内容
• 审核流程管理
• 文献下载

2. 知识库管理 (Knowledge Base Management)

• 支持三种类型知识库：
  • 自有数据 (INTERNAL): 企业研究、历史回复、内部文献
  • 公开数据 (PUBLIC): PubMed、EMBASE、知网、ClinicalTrials.gov
  • 扩展数据 (EXTENDED): 疾病药物关联数据
• 优先级配置
• 动态启用/禁用

3. 文献管理 (Literature Management)

• 文献检索结果展示
• 文献选择
• 批量下载
• 多数据库账号配置

4. 系统配置 (System Configuration)

• Dify AI引擎配置
• 大模型API配置
• 文献下载账号配置
• 用户管理

数据库设计

主要表结构

1. users - 用户表

   • 管理员 (ADMIN)
   • 医学信息专员 (MEDICAL_SPECIALIST)
   • 审核人员 (REVIEWER)

2. inquiry_requests - 查询请求表

   • 请求状态流转：PENDING → KEYWORD_EXTRACTED → SEARCHING → SEARCH_COMPLETED → UNDER_REVIEW → DOWNLOADING → COMPLETED

3. knowledge_bases - 知识库表

   • 类型、优先级、配置管理

4. literatures - 文献表

   • 文献信息、下载状态

5. audit_logs - 审核日志表

   • 操作追踪、审核记录

API接口

查询管理 API

• POST /api/inquiries/upload - 上传查询表格
• POST /api/inquiries - 创建查询请求
• GET /api/inquiries - 获取查询列表
• GET /api/inquiries/{id} - 获取查询详情
• POST /api/inquiries/{id}/extract-keywords - 提取关键词
• POST /api/inquiries/{id}/search - 执行检索
• POST /api/inquiries/{id}/generate-response - 生成回复
• POST /api/inquiries/{id}/review - 审核回复
• POST /api/inquiries/{id}/complete - 完成处理

知识库管理 API

• GET /api/knowledge-bases - 获取知识库列表
• POST /api/knowledge-bases - 创建知识库
• PUT /api/knowledge-bases/{id} - 更新知识库
• DELETE /api/knowledge-bases/{id} - 删除知识库
• PATCH /api/knowledge-bases/{id}/toggle - 启用/禁用

文献管理 API

• GET /api/literatures/inquiry/{inquiryId} - 获取文献列表
• POST /api/literatures/{id}/select - 选择文献
• POST /api/literatures/{id}/download - 下载文献
• POST /api/literatures/inquiry/{inquiryId}/download-selected - 批量下载

工作流程

1. 接收请求: 医学信息专员上传标准化表格或手动填写查询内容
2. 关键词提取: 系统调用Dify API提取关键词
3. 信息检索: 按优先级在各知识库中检索相关信息
4. 生成回复: 系统整理检索结果，生成回复草稿
5. 人工审核: 审核人员审核回复内容
6. 下载文献: 系统下载选中的文献
7. 完成处理: 将回复和文献发送给客户

扩展点

系统设计了多个扩展点，便于后续功能增强：

1. AI引擎: 使用Dify作为AI引擎，支持切换不同的大模型
2. 知识库: 支持动态添加新的知识库类型
3. 文献下载: 支持添加新的文献数据库
4. 审核流程: 可扩展多级审核流程
5. 权限管理: 基于角色的权限控制

开发说明

详细的部署和开发说明请参考 DEPLOYMENT.md 文件。