# clms

**Repository Path**: oneinchofsunshine/clms

## Basic Information

- **Project Name**: clms
- **Description**: Cytogenetics Lab Management System (CLMS)
中文名称：细胞遗传实验室管理系统
推荐理由：
专业性：使用"Cytogenetics"专业术语，体现领域特性
简洁性：CLMS缩写简洁易记
国际化：英文名称便于技术文档和代码管理
扩展性：为未来功能扩展留有余地
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2026-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CHROMSYS V3.0 - 细胞遗传信息管理系统

## 系统简介

CHROMSYS V3.0 是一个专业的细胞遗传信息管理系统，面向医学实验室使用。系统采用模块化设计，支持从标本接收到报告发布的完整工作流程管理。

## 系统功能

### 核心业务流程
- **标本管理**：标本接收、登记、追踪状态显示
- **实验流程**：实验进度跟踪、质量控制和数据录入
- **遗传分析**：核型分析、异常检测、结果记录
- **报告管理**：报告生成、审核流程、版本控制

### 实验与资源管理
- **数据管理**：手工录入、设备自动上传、数据验证
- **打印管理**：条码、玻片标签、接种批号打印
- **试剂管理**：试剂入库、领用、库存管理

### 系统后台与管理
- **系统配置**：菜单管理、标本类型设置、集成配置
- **日志管理**：操作记录、打印追踪、错误监控
- **权限管理**：用户角色、访问控制、操作权限
- **统计分析**：数据可视化、趋势分析、报表导出

## 技术架构

- **前端框架**：React 18 + TypeScript
- **UI组件库**：Ant Design
- **状态管理**：React Context + useReducer
- **路由管理**：React Router v6
- **样式方案**：CSS Modules + Ant Design主题定制
- **图表库**：Recharts (数据可视化)
- **图标库**：Ant Design Icons

## 登录信息

系统提供了三个演示账号：

| 用户名 | 密码 | 角色 | 权限 |
|--------|------|------|------|
| admin | admin123 | 系统管理员 | 全部权限 |
| lab | lab123 | 技术员 | 标本管理、查看报告 |
| doctor | doc123 | 医师 | 标本管理、报告编辑 |

## 运行项目

### 前端运行

1. 安装依赖：
```bash
npm install
```

2. 启动开发服务器：
```bash
npm run dev
```

3. 在浏览器中访问：
```
http://localhost:3000
```

### 后端运行

#### 环境要求
- Java 17 或更高版本
- Redis 服务器 (本地安装或Docker)
- H2 数据库 (开发环境) 或 PostgreSQL (生产环境)

#### Redis 安装与启动

**选项1: 使用Docker (推荐)**
```bash
docker run -d --name chromsys-redis -p 6379:6379 redis:7-alpine
```

**选项2: 本地安装Redis**
运行项目中的安装脚本：
```bash
install-redis.bat
```

**选项3: 启动Redis服务**
```bash
start-redis-docker.bat
```

#### 启动后端服务

1. 启动Spring Boot后端：
```bash
start-spring-backend.bat
```

2. 后端服务将在以下地址可用：
- API服务: http://localhost:8080
- API文档: http://localhost:8080/swagger-ui.html

#### 配置说明

系统支持多环境配置：

- **开发环境 (dev)**: 使用内存数据库，不使用Redis
- **本地环境 (local)**: 使用H2文件数据库，连接Redis
- **生产环境 (prod)**: 使用PostgreSQL数据库，连接Redis

默认使用dev环境，如需切换到local环境连接Redis，请在启动时指定：
```bash
mvn spring-boot:run -Dspring-boot.run.profiles=local
```

注意：使用local或prod环境前，请确保Redis服务已启动。可以使用以下脚本启动Redis：
```bash
start-redis-docker.bat
```

## 系统演示

### 1. 登录系统
使用任一演示账号登录系统。

### 2. 仪表板
- 查看系统概览和关键数据
- 查看最近一周标本接收趋势和科室分布
- 查看待处理标本和待审核报告
- 查看最近操作记录

### 3. 标本管理
- 查看标本列表
- 筛选和搜索标本
- 查看标本详情
- 编辑标本信息
- 打印条码

### 4. 工作流程
- 选择正在处理的标本
- 查看工作流程步骤
- 开始、完成步骤
- 记录操作

### 5. 遗传分析
- 选择要分析的标本
- 手动分析或AI辅助分析
- 上传图像
- 查看分析历史

### 6. 报告管理
- 查看报告列表
- 筛选和搜索报告
- 查看报告详情
- 编辑、提交审核、批准发布报告

### 7. 系统配置
- 基础配置
- 系统集成设置
- 菜单配置
- 标本类型配置

### 8. 日志管理
- 查看操作日志、打印日志、错误日志
- 筛选和搜索日志
- 查看日志详情
- 导出日志

### 9. 用户管理
- 查看用户列表
- 添加、编辑用户
- 重置密码
- 管理用户权限

## 项目结构

```
src/
├── components/          # 公共组件
├── contexts/           # React上下文
├── hooks/              # 自定义钩子
├── layouts/            # 布局组件
├── pages/              # 页面组件
│   ├── Dashboard/      # 仪表板
│   ├── Specimen/       # 标本管理
│   ├── Analysis/       # 遗传分析
│   ├── Reports/        # 报告管理
│   ├── Config/         # 系统配置
│   ├── Logs/           # 日志管理
│   ├── Admin/          # 用户管理
│   ├── Login.tsx       # 登录页面
│   └── Workflow.tsx    # 工作流程
├── services/           # 模拟数据服务
├── types/              # TypeScript类型定义
├── utils/              # 工具函数
├── App.tsx             # 应用主组件
├── index.css           # 全局样式
└── main.tsx            # 应用入口
```

## 注意事项

- 这是一个演示系统，数据为模拟数据，不会持久化保存
- 系统UI设计采用医疗科技专业风格，以医疗蓝为主色调
- 所有页面均为响应式设计，适配不同屏幕尺寸
- 系统支持多种权限角色，不同角色看到的菜单和功能不同

## 联系方式

如有问题或建议，请联系开发团队。