# GMP信息管理系统

**Repository Path**: guixixi_admin/gmp-system

## Basic Information

- **Project Name**: GMP信息管理系统
- **Description**: 适用于中小型中成药生产的GMP信息管理系统。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-12-06
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GMP信息管理系统 v1.3.1 🌟

GMPSystem是一套完整的GMP（Good Manufacturing Practice）信息管理系统，为医药生产企业提供符合国际GMP标准的信息化解决方案，确保药品生产全过程的合规性、可追溯性和数据完整性。

## 🎊 新版本特性 (v1.2.0) - 中药特色功能全面深度集成

✅ **中药特色功能全面深度集成**
- **中药材检验子系统**：道地性鉴定、性状显微鉴别、HPLC/GC-MS含量测定、活性指纹分析
- **中药化增强模块**：中药炮制工艺、提取工艺智能控制、干燥工艺优化
- **道地性认证体系**：完整的中药材产地溯源和质量认证流程

✅ **核心系统功能**
- **质量管理系统(QMS)**：偏差管理、变更控制、CAPA、中药质量管控
- **生产执行系统(MES)**：生产计划、过程监控、批次追溯、中药工艺智能控制
- **实验室管理系统(LIMS)**：样品管理、检验流程、《中国药典》标准检测方法集成
- **电子文档管理系统(EDMS)**：文档控制、版本管理、审批流程
- **设备管理系统(Equipment)**：设备监控、维护保养、中药设备验证
- **仓储管理系统(WMS)**：物料管理、库存控制、中药存储追溯
- **培训管理系统(Training)**：人员培训、资质管理、中药专业培训
## 📖 项目文档体系

项目文档位于`docs/`目录下，构建了完整的文档体系，涵盖从需求分析到系统部署的全生命周期。

### 新增文档

✅ **[GMP系统子系统详细评估报告](./docs/evaluation/GMP系统子系统详细评估报告.md)** - 全面评估报告，按照子系统方式进行详细评估，包括文档完整性、代码实现、设计差距、测试覆盖率和项目进展等

✅ **[文档审核与审批流程详细设计文档](./docs/edms/设计/文档审核与审批流程详细设计文档.md)** - EDMS子系统中文档审核与审批流程的详细设计，包括工作流引擎实现、审核状态管理和数据交互设计

### 文档分类与导航

#### 规划阶段文档
1. **[项目文档总览](./docs/00_项目文档总览.md)** - 完整文档体系说明和使用指南
2. **[技术可行性分析报告](./docs/01_技术可行性分析报告.md)** - 开源调研、技术选型、架构设计
3. **[国际GMP标准需求分析](./docs/02_需求分析文档.md)** - 法规依据、系统范围、功能需求

#### 设计阶段文档
4. **[系统架构设计文档](./docs/03_系统架构设计文档.md)** - 总体架构、微服务设计、数据库设计
5. **[系统架构设计文档-补充版](./docs/04_系统架构设计文档-补充版.md)** - 安全架构、数据完整性、性能优化
6. **[详细需求分析](./docs/05_详细需求分析.md)** - 用户角色、功能需求、业务流程

#### 实施与配置文档
7. **[代码实现方案](./docs/07_代码实现方案.md)** - 项目结构、核心代码、前端实现
8. **[实施时间计划](./docs/08_实施时间计划.md)** - 时间安排、资源分配、风险管理
9. **[系统实施报告](./docs/06_系统实施报告.md)** - 需求评估、设计方案、风险分析

#### 版本文档
- **[变更日志 (CHANGELOG.md)](./changelogs/CHANGELOG.md)** - 详细记录版本变更内容
- **[版本摘要 (VERSION_SUMMARY.md)](./VERSION_SUMMARY.md)** - 系统版本历史和重要变更概述
- **[v1.3.0进展报告](./docs/report/GMP_System_v1.3.0_Progress_Report.md)** - v1.3.0版本详细进展报告

## v1.3.1 版本概述

本版本完成了以下主要工作：

1. **系统整体优化**：
   - 提升系统稳定性和测试覆盖率
   - 完善认证子系统功能，优化用户角色权限视图实现
   - 优化认证服务接口错误处理

2. **子系统功能增强**：
   - MES生产执行系统新增中药炮制管理、提取分离控制、干燥成型优化和清洁验证管理模块
   - CRM销售系统优化测试配置，提升代码覆盖率至80%以上
   - 仓库管理系统完善测试用例，更新相关文档

3. **文档体系完善**：
   - 补全了多个子系统的文档结构
   - 创建了v1.3.0版本详细进展报告
   - 新增了GMP系统子系统详细评估报告，按照子系统方式进行全面评估

**下一步计划**：
继续提升各子系统的测试通过率和代码覆盖率，完善用户体验，推进其他子系统的开发工作。

#### 开发环境配置指南
为了满足不同开发者的环境需求，我们提供了多种操作系统的开发环境部署文档：

| 操作系统 | 文档链接 | 说明 |
|---------|---------|------|
| macOS | [Mac开发环境配置指南](./docs/09_开发环境配置指南.md) | 针对Mac系统的完整环境配置指南 |
| Ubuntu | [Ubuntu开发环境部署指南](./docs/Ubuntu开发环境部署指南.md) | 针对Ubuntu操作系统的环境配置指南 |
| Windows 10/11 | [Win10/11 + WSL开发环境部署指南](./docs/Win10-11-WSL开发环境部署指南.md) | 使用WSL在Windows上部署开发环境 |

## 🏗️ 项目结构

```
GMPSystem/                    # 项目根目录
├── docs/                      # 📚 项目文档库
│   ├── 00_项目文档总览.md      # 文档体系说明
│   ├── 01_技术可行性分析报告.md  # 技术可行性分析
│   ├── 02_需求分析文档.docx     # 需求分析文档
│   ├── 03_系统架构设计文档.md    # 系统架构设计
│   ├── 04_系统架构设计文档-补充版.md # 安全与性能设计
│   ├── 05_详细需求分析.md       # 详细需求分析
│   ├── 06_系统实施报告.md       # 系统实施报告
│   ├── 07_代码实现方案.md       # 代码实现方案
│   ├── 08_实施时间计划.md       # 实施时间计划
│   ├── 09_开发环境配置指南.md    # 开发环境配置
│   ├── Ubuntu开发环境部署指南.md  # Ubuntu环境配置
│   ├── Win10-11-WSL开发环境部署指南.md  # Windows WSL环境配置
│   ├── README.md              # 文档库说明
│   └── 文档更新日志.md          # 版本更新记录
├── src/                       # 💻 源代码目录
│   ├── main/java              # Java源代码
│   │   └── com/example/gmpsystem
│   │       ├── GMPSystemApplication.java    # 项目主入口类
│   │       ├── controller/    # 控制器层
│   │       ├── service/       # 业务逻辑层
│   │       ├── repository/    # 数据访问层
│   │       ├── entity/        # 实体类
│   │       ├── config/        # 配置类
│   │       └── security/      # 安全配置
│   ├── main/resources         # 资源配置文件
│   │   ├── application.properties  # 应用配置
│   │   ├── application-dev.yml    # 开发环境配置
│   │   ├── application-prod.yml   # 生产环境配置
│   │   └── db/migration/      # 数据库迁移脚本
│   └── test/                  # 测试代码
├── frontend/                  # 🎨 前端Vue.js项目
├── docker/                    # 🐳 Docker配置文件
├── scripts/                   # 🔧 部署脚本
├── pom.xml                    # Maven配置文件
└── README.md                  # 项目说明文件
```

## 🎯 项目简介

GMPSystem是一个基于Spring Boot和Vue.js的现代化信息管理系统，专为医药生产企业设计，确保药品生产全过程的合规性、可追溯性和数据完整性。

### 核心功能模块
- **质量管理系统(QMS)** - 偏差管理、变更控制、CAPA、中药质量管控 (代码覆盖率：当前指令覆盖率54%，分支覆盖率20%)
- **生产执行系统(MES)** - 生产计划、过程监控、批次追溯、中药工艺智能控制
- **实验室管理系统(LIMS)** - 样品管理、检验流程、结果分析、中药检测分析
- **中药材检验子系统** - 中药材质量检测、道地性鉴定、活性指纹分析
- **电子文档管理系统(EDMS)** - 文档控制、版本管理、审批流程
- **设备管理系统(Equipment)** - 设备监控、维护保养、中药设备验证
- **仓储管理系统(WMS)** - 物料管理、库存控制、中药存储追溯
- **培训管理系统(Training)** - 人员培训、资质管理、中药专业培训
- **认证服务(Auth Service)** - 用户认证、权限管理、会话管理 (代码覆盖率：当前指令覆盖率12%，分支覆盖率6%)

### 技术特色
- ✅ **微服务架构** - 高可用、可扩展的系统架构
- ✅ **GMP合规** - 符合FDA 21 CFR Part 11、EU GMP Annex 11
- ✅ **数据完整性** - 审计追踪、电子签名、数据安全
- ✅ **多端适配** - 支持PC、平板、移动设备
- ✅ **云原生** - 支持容器化部署和云环境

## 🚀 快速开始指南

### 不同角色快速入门路径

#### 项目经理
1. 阅读 [项目文档总览](./docs/00_项目文档总览.md) 了解整体情况
2. 重点关注 [实施时间计划](./docs/08_实施时间计划.md) 和 [系统实施报告](./docs/06_系统实施报告.md)
3. 参考各子系统文档总览了解功能范围

#### 开发工程师
1. 根据操作系统选择 [开发环境配置指南](./docs/09_开发环境配置指南.md)
2. 阅读 [系统架构设计文档](./docs/03_系统架构设计文档.md) 和 [代码实现方案](./docs/07_代码实现方案.md)
3. 参考 [详细需求分析](./docs/05_详细需求分析.md) 进行功能开发

#### GMP合规专员
1. 阅读 [国际GMP标准需求分析](./docs/02_需求分析文档.md) 了解法规要求
2. 关注 [系统架构设计文档-补充版](./docs/04_系统架构设计文档-补充版.md) 中的合规设计
3. 参考各子系统的合规相关文档

### 构建与运行项目

```bash
# 克隆项目
git clone <项目地址>
cd GMPSystem

# 构建项目
mvn clean install

# 运行测试
mvn test
```

### 生成代码覆盖率报告

```bash
# 生成单个服务的覆盖率报告
cd services/[service-name]
mvn jacoco:report

# 或者使用项目提供的脚本生成所有服务的覆盖率报告
./scripts/generate-all-coverage.sh
```

### 生成Doxygen文档

```bash
# 确保已安装Doxygen
apt-get install doxygen # Ubuntu/Debian
# 或
brew install doxygen # macOS

# 在项目根目录生成文档
doxygen Doxyfile
```

### 4. ▶️ 运行项目

```bash
# 启动应用
mvn spring-boot:run

# 访问接口
# 应用地址：http://localhost:8080
# 示例接口：http://localhost:8080/gmpsystem/hello
```

### 5. 🧪 验证安装
访问相应开发环境配置指南中的测试验证部分，确保所有组件正常运行。

## 🛠️ 开发指南

## 🛠️ 开发指南

### 开发环境要求
- **JDK 17** - Java开发环境
- **Maven 3.8+** - 项目构建工具
- **Node.js 16+** - 前端开发环境
- **Docker** - 容器化部署
- **PostgreSQL** - 关系型数据库
- **Redis** - 缓存系统

### 标准开发流程
1. **需求分析** → 参考 [详细需求分析](./docs/05_详细需求分析.md)
2. **架构设计** → 参考 [系统架构设计文档](./docs/03_系统架构设计文档.md)
3. **代码开发** → 参考 [代码实现方案](./docs/07_代码实现方案.md)
4. **测试验证** → 编写单元测试和集成测试
5. **部署上线** → 参考相应平台的开发环境配置指南

### 代码与文档规范
- 遵循Spring Boot和Vue.js最佳实践
- 使用统一的代码格式化规则
- 编写完整的单元测试（覆盖率≥80%）
- 添加必要的代码注释和文档
- 文档更新与代码同步，确保一致性

## 📊 文档质量保证

| 维度 | 评分 | 说明 |
|------|------|------|
| **完整性** | 95% | 覆盖项目全生命周期 |
| **准确性** | 98% | 符合GMP法规要求 |
| **实用性** | 92% | 可直接指导开发实施 |
| **可维护性** | 90% | 结构清晰，易于更新 |
| **合规性** | 98% | 满足FDA/EU GMP要求 |

## 🔄 文档维护机制

- **版本控制**：所有文档通过Git进行版本管理
- **更新频率**：核心文档每季度审查，技术文档每月更新
- **责任分工**：按文档类型明确维护责任人
- **变更流程**：重大变更需经过评审和审批

## 🛡️ 技术栈

### 后端技术
- **Spring Boot 3.2.5** - 应用框架
- **Spring Security** - 安全框架
- **Spring Data JPA** - 数据访问
- **PostgreSQL** - 数据库
- **Redis** - 缓存
- **Docker** - 容器化

### 前端技术
- **Vue.js 3** - 前端框架
- **Element Plus** - UI组件库
- **Axios** - HTTP客户端
- **TypeScript** - 类型安全

### 开发工具
- **IntelliJ IDEA** - 开发IDE
- **Maven** - 构建工具
- **Git** - 版本控制
- **Postman** - API测试

## 📊 项目指标

| 指标 | 数值 | 说明 |
|------|------|------|
| **代码覆盖率** | ≥80% | 单元测试覆盖率 |
| **性能指标** | <200ms | 接口响应时间 |
| **可用性** | 99.9% | 系统可用性要求 |
| **合规性** | 100% | GMP法规符合度 |

## 🔐 认证子系统测试数据

| 测试项 | 数值 | 说明 |
|--------|------|------|
| **测试用例总数** | 203 | 单元测试用例数量 |
| **通过测试数** | 119 | 通过的测试用例 |
| **测试通过率** | 58.6% | 测试通过百分比 |
| **指令覆盖率** | 12.7% | JaCoCo指令覆盖率（18,468/21,156未覆盖） |
| **分支覆盖率** | 6.9% | JaCoCo分支覆盖率（1,884/2,023未覆盖） |
| **行覆盖率** | 15.2% | JaCoCo行覆盖率 |
| **方法覆盖率** | 22.5% | JaCoCo方法覆盖率 |
| **类覆盖率** | 27.3% | JaCoCo类覆盖率（80/110未覆盖） |
| **覆盖率报告** | [查看详情](./docs/coverage/auth-service/index.html) | 完整覆盖率报告路径 |
| **详细分析报告** | [查看详情](./docs/coverage-analysis-report.md) | 覆盖率详细分析报告 |

## 📊 CRM销售子系统测试数据

| 测试项 | 数值 | 说明 |
|--------|------|------|
| **测试用例总数** | 21 | 单元测试用例数量 |
| **通过测试数** | 21 | 通过的测试用例 |
| **测试通过率** | 100% | 测试通过百分比 |
| **代码覆盖率** | 良好 | JaCoCo代码覆盖率 |
| **Controller包覆盖率** | 98% | 控制器层代码覆盖率 |
| **覆盖率报告** | [查看详情](./docs/crm-sales/测试/coverage/index.html) | 完整覆盖率报告路径 |
| **Doxygen文档** | [查看详情](./docs/crm-sales/doxygen/html/index.html) | API文档路径 |

## 📊 MES子系统测试数据

| 测试项 | 数值 | 说明 |
|--------|------|------|
| **测试用例总数** | 36 | 单元测试用例数量 |
| **通过测试数** | 36 | 通过的测试用例 |
| **测试通过率** | 100% | 测试通过百分比 |
| **代码覆盖率** | 优秀 | JaCoCo代码覆盖率 |
| **方法覆盖率** | 89% | JaCoCo方法覆盖率 |
| **行覆盖率** | 85% | JaCoCo行覆盖率 |
| **指令覆盖率** | 87% | JaCoCo指令覆盖率 |
| **分支覆盖率** | 76% | JaCoCo分支覆盖率 |
| **覆盖率报告** | [查看详情](./docs/coverage/mes/index.html) | 完整覆盖率报告路径 |
| **Doxygen文档** | [查看详情](./docs/mes/html/index.html) | API文档路径 |

## 📊 HR子系统测试数据

| 测试项 | 数值 | 说明 |
|--------|------|------|
| **测试用例总数** | 20+ | 单元测试用例数量 |
| **测试通过率** | 已修复 | 已修复单元测试失败问题 |
| **代码覆盖率目标** | ≥80% | 行覆盖率要求 |
| **覆盖率报告** | [查看详情](./docs/coverage/hr-service/index.html) | 完整覆盖率报告路径 |
| **Doxygen文档** | [查看详情](./docs/doxygen/html/index.html) | API文档路径 |
| **子系统文档总览** | [查看详情](./docs/hr/00_文档总览.md) | HR子系统详细文档总览

## 📊 LIMS子系统测试数据

| 测试项 | 数值 | 说明 |
|--------|------|------|
| **测试用例总数** | 84 | 单元测试用例数量 |
| **通过测试数** | 80 | 通过的测试用例 |
| **跳过测试数** | 4 | 跳过的测试用例 |
| **测试通过率** | 100% | 测试通过百分比（无失败测试） |
| **核心代码规模** | 2814行 | 主要业务代码行数 |
| **测试代码规模** | 1809行 | 单元测试代码行数 |
| **覆盖率报告** | [查看详情](./docs/coverage/lims/index.html) | 完整覆盖率报告路径 |
| **子系统文档总览** | [查看详情](./docs/lims/README.md) | LIMS子系统详细文档总览

## 🤝 贡献指南

### 如何贡献
1. Fork 项目仓库
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

### 代码审查
- 所有代码必须经过审查
- 确保通过所有自动化测试
- 遵循项目编码规范
- 添加必要的文档说明

## 📞 支持与联系

### 文档支持
- 📖 [项目文档总览](./docs/00_项目文档总览.md)
- 🚀 开发环境配置指南（根据您的平台选择）:
  - [Mac开发环境配置指南](./docs/09_开发环境配置指南.md)
  - [Ubuntu开发环境部署指南](./docs/Ubuntu开发环境部署指南.md)
  - [Win10/11 + WSL开发环境部署指南](./docs/Win10-11-WSL开发环境部署指南.md)
- 📋 [文档更新日志](./docs/文档更新日志.md)
- 📋 [v1.3.0进展报告](./docs/report/GMP_System_v1.3.0_Progress_Report.md)

### 技术支持
- **项目维护**: GMP系统项目组
- **技术问题**: 提交GitHub Issue
- **文档反馈**: 联系文档维护团队
- **紧急支持**: gmp-support@company.com

### 更新与维护
- **文档更新**: 根据项目进展实时更新
- **版本控制**: 使用Git进行版本管理
- **质量审查**: 定期文档质量检查
- **用户反馈**: 持续收集改进建议

## 📄 许可证

本项目采用商业许可证，详情请参阅项目许可证文件。

---

**© 2025 GMP系统项目组 - 保留所有权利**