# TBM-LIMS

**Repository Path**: aerlee/tbm-lims

## Basic Information

- **Project Name**: TBM-LIMS
- **Description**: 检验设备管理，适用于工厂实验室检验设备管理
- **Primary Language**: Java
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TBM-LIMS 检验设备管理平台

## 项目简介

TBM-LIMS检验设备管理平台是LIMS系统的子模块，用于管理检验设备的全生命周期，包括设备台账、维护计划、维护记录、BI看板、闲置物料共享等功能。

## 在线演示

**演示地址**：[https://www.echojournal.cn/tbm-lims/](https://www.echojournal.cn/tbm-lims/)

| 用户名 | 密码 | 权限说明 |
|--------|------|----------|
| admin | 123456 | 管理员账号（拥有所有权限） |
| demo | 123456 | 演示账号（只读权限，可查看所有功能，无操作权限） |

## 技术栈

### 后端技术

| 技术 | 版本 | 说明 |
|------|------|------|
| Java | 21 | 编程语言 |
| Spring Boot | 3.2.5 | 应用框架 |
| Spring Cloud | 2023.0.1 | 微服务框架 |
| Spring Cloud OpenFeign | 4.1.0 | 服务间调用 |
| Nacos | 2.3.2 | 服务发现与配置中心 |
| MyBatis-Plus | 3.5.6 | ORM框架 |
| Sa-Token | 1.38.0 | 权限认证 |
| Knife4j | 4.4.0 | API文档 |
| MariaDB | 12.2.2 | 数据库 |
| Redis | 7.2 | 缓存 |
| MinIO | 8.5.9 | 文件存储 |

### 前端技术

| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.4+ | 前端框架 |
| Element Plus | 2.7+ | UI组件库 |
| ECharts | 5.5+ | 图表库 |
| Pinia | 2.1+ | 状态管理 |
| Vue Router | 4.x | 路由管理 |
| Axios | 1.7+ | HTTP客户端 |
| Vite | 5.x | 构建工具 |
| TypeScript | 5.x | 类型系统 |

### 数据采集终端

| 技术 | 说明 |
|------|------|
| Rust | 采集终端开发语言 |
| Tauri | 桌面应用框架 |

## 系统架构

### 微服务架构

本系统采用微服务架构，包含以下服务：

| 服务 | 端口 | 说明 |
|------|------|------|
| lims-gateway | 9000 | API网关，统一入口，路由转发，认证鉴权 |
| lims-system | 8081 | 系统管理服务，用户、角色、权限、组织管理 |
| lims-equipment | 8082 | 设备管理服务，设备台账、分类、型号管理 |
| lims-maintenance | 8083 | 维护管理服务，维护计划、工单、记录管理 |
| lims-dashboard | 8084 | BI看板服务，数据统计与可视化 |
| lims-sharing | 8085 | 闲置物料共享服务 |
| tbm-lims-frontend | 80 | 前端应用（Nginx） |

### 基础设施

| 组件 | 说明 |
|------|------|
| Nacos | 服务发现与配置中心 |
| Redis | 缓存与会话存储（Sa-Token） |
| MariaDB | 关系型数据库 |

### 服务间通信

- 使用 **OpenFeign** 进行服务间 HTTP 调用
- 所有服务通过 **Nacos** 注册和发现
- **Gateway** 统一处理认证和路由

## 项目结构

```
tbm-lims/
├── lims-common/                      # 公共模块（Result, 异常, 工具类）
├── lims-gateway/                     # API网关服务（端口 9000）
├── lims-system/                      # 系统管理服务（端口 8081）
├── lims-equipment/                   # 设备管理服务（端口 8082）
├── lims-maintenance/                 # 维护管理服务（端口 8083）
├── lims-dashboard/                   # BI看板服务（端口 8084）
├── lims-sharing/                     # 闲置物料共享服务（端口 8085）
├── tbm-lims-frontend/                # 前端项目（Vue 3 + Element Plus）
├── tbm-collector/                    # 数据采集终端（Rust + Tauri）
├── docker/                           # Docker部署配置
│   ├── docker-compose.yml            # 开发环境
│   ├── docker-compose.prod.yml       # 生产环境
│   └── sql/                          # 初始化SQL
├── scripts/                          # 部署与运维脚本
├── docs/                             # 项目文档
├── archive/                          # 归档目录（旧单体架构代码）
└── README.md                         # 项目说明
```

## 快速开始

### 环境要求

- JDK 21+
- Node.js 20+
- Maven 3.9+
- MariaDB 12.2.2+
- Redis 7.2+
- Nacos 2.3.2+

### 一键启动（推荐）

```bash
# 启动所有服务（基础设施 + 后端 + 前端）
scripts/start-dev.sh

# 停止所有服务
scripts/stop-dev.sh
```

### 手动启动

1. 启动基础设施
```bash
cd docker && docker compose up -d nacos redis mariadb
```

2. 初始化数据库
```bash
mysql -u root -plims2026 < docker/sql/init.sql
```

3. 编译打包并启动后端
```bash
mvn clean package -DskipTests

java -jar lims-gateway/target/lims-gateway-2.0.0.jar
java -jar lims-system/target/lims-system-2.0.0.jar
java -jar lims-equipment/target/lims-equipment-2.0.0.jar
java -jar lims-maintenance/target/lims-maintenance-2.0.0.jar
java -jar lims-dashboard/target/lims-dashboard-2.0.0.jar
java -jar lims-sharing/target/lims-sharing-2.0.0.jar
```

4. 启动前端
```bash
cd tbm-lims-frontend
npm install
npm run dev
```

### 生产环境部署

```bash
# 一键部署
chmod +x scripts/deploy.sh
./scripts/deploy.sh
```

详见 [部署指南](docs/deployment/01-环境搭建指南.md)。

## 服务端口说明

| 服务 | 端口 | 说明 |
|------|------|------|
| 前端 | 80 | Vue前端应用 |
| 网关 | 9000 | API网关，所有请求统一入口 |
| 系统服务 | 8081 | 用户、角色、权限管理 |
| 设备服务 | 8082 | 设备台账、分类管理 |
| 维护服务 | 8083 | 维护计划、工单管理 |
| 看板服务 | 8084 | 数据统计、BI看板 |
| 共享服务 | 8085 | 闲置物料共享 |
| Nacos | 8848 | 服务发现与配置中心 |
| Redis | 6379 | 缓存与会话存储 |
| MariaDB | 3306 | 数据库 |

## 常用命令

```bash
# 构建所有模块
mvn clean package -DskipTests

# 构建单个模块
mvn clean package -DskipTests -pl lims-system -am

# 启动基础设施（Docker）
cd docker && docker compose up -d nacos redis mariadb

# 查看服务状态
docker compose ps

# 查看服务日志
docker compose logs -f lims-system
```

## 开发规范

- 后端开发规范：[Java编码规范](docs/standards/01-Java编码规范.md)
- 前端开发规范：[Vue前端编码规范](docs/standards/02-Vue前端编码规范.md)
- Git分支管理：[Git分支管理规范](docs/standards/03-Git分支管理规范.md)
- 接口联调规范：[接口联调规范](docs/standards/04-接口联调规范.md)
- 代码审查规范：[代码审查规范](docs/standards/05-代码审查规范.md)

## 文档

- [部署指南](docs/deployment/01-环境搭建指南.md)
- [系统总体架构设计](docs/architecture/01-系统总体架构设计.md)
- [前后端分离架构设计](docs/architecture/02-前后端分离架构设计.md)
- [数据库架构设计](docs/architecture/03-数据库架构设计.md)
- [接口设计规范](docs/design/api/01-接口设计规范.md)
- [前端架构设计](docs/design/ui/01-前端架构设计.md)
- [文档中心](docs/README.md)

## 许可证

Copyright © 2024-2026 TPM-LIMS Team