# sms

**Repository Path**: musicmtv/sms

## Basic Information

- **Project Name**: sms
- **Description**: 智能制造系统包括System（系统管理）、MES（制造执行）、IoT（设备物联）、Quality（质量管理）、WMS（仓储管理）、AI（服务管理）
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 旭创智能制造系统 (Xuchuang Smart Manufacturing System)

<p align="center">
  <img src="https://img.shields.io/badge/Release-1.0.1-blue" alt="Release 1.0.1">
  <img src="https://img.shields.io/badge/Java-17-blue" alt="Java 17">
  <img src="https://img.shields.io/badge/Spring%20Boot-3.1.x-green" alt="Spring Boot 3.1.x">
  <img src="https://img.shields.io/badge/Vue-3.4%2B-brightgreen" alt="Vue 3.4+">
  <img src="https://img.shields.io/badge/Vite-4%2F5-blueviolet" alt="Vite 4/5">
  <img src="https://img.shields.io/badge/License-Apache%202.0-orange" alt="License Apache 2.0">
</p>

## 📋 项目简介

旭创智能制造系统是一个面向现代制造企业的综合性智能制造解决方案。系统采用微服务架构，集成了MES（制造执行系统）、APS（高级计划排程）、IoT（物联网）、质量管理、仓储管理等核心业务模块，并融入基于大语言模型的AI智能分析能力，帮助企业实现数字化转型和智能制造升级。

## 🚀 核心特性

### 后端服务
- **微服务架构**：基于 Spring Cloud Alibaba + Nacos 构建，网关统一路由与鉴权，支持高可用和弹性扩展
- **模块化设计**：
  - 后端服务（全部纳入统一 Maven 构建）：common、api-gateway、system-service、mes-service、iot-service、auth-service、quality-service、wms-service、aps-service
  - AI 引擎：ai-engine（Python FastAPI，独立构建部署）
- **技术栈**：
  - Java 17 + Spring Boot 3.1.11
  - Spring Cloud 2022.0.4 + Spring Cloud Alibaba 2022.0.0.0
  - MyBatis-Plus 3.5.3.2
  - Sa-Token 1.38.0（认证授权，Redis 会话）
  - Knife4j 4.4.0（OpenAPI 接口文档）
  - Nacos 2.2.0（服务注册与配置中心）
  - MySQL 8.0 / PostgreSQL 15
  - Redis 7.x / EMQX 5.8（MQTT）/ MinIO

### 前端应用
- **多应用架构**：7 个相互独立的 Vue 3 前端应用，按业务域拆分，npm 独立构建
- **技术栈**：Vue 3.4+ / Element Plus / Pinia / Vue Router / ECharts，Vite 4/5 构建
- **业务覆盖**：门户、系统管理、MES、IoT、质量管理、仓储管理、AI 服务
- **统一接入**：开发环境全部代理至网关 `http://localhost:8080`

### AI能力
- **智能对话**：基于 Ollama 大语言模型的智能问答
- **知识库**：RAG（检索增强生成）+ ChromaDB 向量检索
- **预测分析**：设备故障预测、需求预测
- **图像识别**：质量检测、产品识别
- **语音识别**：语音指令控制

## 📦 系统架构

```
┌──────────────────────────────────────────────────────────────┐
│                           前端层                              │
│  core   system   mes    iot   quality   wms    ai            │
│ (3000)  (3001)  (3002) (3003)  (3004)  (3005) (3006)         │
├──────────────────────────────────────────────────────────────┤
│                       API 网关层                              │
│                     api-gateway (8080)                       │
├──────────────────────────────────────────────────────────────┤
│                        业务服务层                             │
│  system-service   mes-service   iot-service                  │
│      (8100)          (8200)        (8400)                    │
│  auth-service · quality-service · wms-service · aps-service  │
├──────────────────────────────────────────────────────────────┤
│                        基础设施层                             │
│  MySQL 8.0 · PostgreSQL 15 · Redis 7 · Nacos 2.2 ·           │
│  EMQX 5.8 · MinIO · Ollama                                   │
├──────────────────────────────────────────────────────────────┤
│                         AI 引擎层                            │
│          ai-engine（Python FastAPI · :8086）                 │
└──────────────────────────────────────────────────────────────┘
```

## 🏗️ 仓库结构

```
├── smart-manufacturing-system/       # Maven 父工程 + 核心后端服务
│   ├── pom.xml                 # 父 POM（统一依赖与版本管理）
│   ├── common/                 # 公共模块（统一响应/异常/工具类）
│   ├── api-gateway/            # API 网关（8080）
│   ├── system-service/         # 系统管理服务（8100）
│   ├── mes-service/            # 制造执行服务（8200）
│   ├── iot-service/            # 设备物联服务（8400）
│   └── deploy/                 # Docker Compose / Nginx / Rocky 部署产物
├── xuchuang-modules/           # 扩展模块（后端扩展 + 前端 + AI + 基础设施编排）
│   ├── auth-service/           # 认证授权服务（已纳入统一构建）
│   ├── quality-service/        # 质量管理服务（已纳入统一构建）
│   ├── wms-service/            # 仓储管理服务（已纳入统一构建）
│   ├── aps-service/            # 高级排程服务（已纳入统一构建）
│   ├── ai-engine/              # AI 引擎（Python FastAPI，8086）
│   ├── frontend-*/             # 7 个前端应用（core/system/mes/iot/quality/wms/ai）
│   └── infrastructure-*/       # 基础设施编排（db/mq/storage/ai）
├── docs/                       # 架构/数据库/功能/测试等文档
├── deploy.sh / deploy.ps1      # Docker 一键部署入口（Linux / Windows）
└── check-env.ps1 / check-docker-env.ps1 / docker-check.bat   # 环境检查
```

## 🛠️ 快速开始

### 环境要求
- JDK 17+、Maven 3.8+
- Node.js 18+（前端）
- Docker + Docker Compose（Docker 部署方式）
- 或本机安装 MySQL 8.0+ / PostgreSQL 15 / Redis 7 / Nacos 2.2（本地开发方式）

### 方式一：Docker 一键部署（推荐）

```bash
# 1. 环境自检（Windows PowerShell；Linux 跳过此步）
.\check-docker-env.ps1          # 或 docker-check.bat

# 2. 一键部署（构建后端+前端 → 启动基础设施 → 初始化数据库 → 启动业务服务）
.\deploy.ps1 all                # Windows；Linux 使用 ./deploy.sh all
# 其他动作：build / start / stop / restart / status / cleanup

# 3. 访问入口
# API 网关：  http://localhost:8080
# Nacos：     http://localhost:8848/nacos   （nacos / nacos）
# EMQX 控制台：http://localhost:18083       （admin / public）
# MinIO 控制台：http://localhost:9001       （minioadmin / minioadmin）
```

### 方式二：本地开发模式

```bash
# 1. 启动基础设施（MySQL 8.0 / PostgreSQL 15 / Redis 7 / Nacos 2.2 / EMQX / MinIO）
docker compose -f smart-manufacturing-system/deploy/docker/docker-compose.yml up -d

# 2. 编译后端（Maven 父工程）
cd smart-manufacturing-system
mvn clean install

# 3. 逐个启动后端服务
mvn spring-boot:run -pl api-gateway     # 8080
mvn spring-boot:run -pl system-service  # 8100
mvn spring-boot:run -pl mes-service     # 8200
mvn spring-boot:run -pl iot-service     # 8400

# 4. 启动前端（7 个应用，一键后台启动）
cd ../xuchuang-modules
./start-all-frontends.sh        # 停止：./stop-all-frontends.sh
```

> 💡 也可单独启动某个前端：`cd xuchuang-modules/frontend-mes && pnpm install && pnpm dev`，访问 `http://localhost:3002`。

## 🖥️ 前端应用

| 应用 | 业务域 | 开发端口 |
|------|--------|---------|
| frontend-core | 平台门户 / 登录 / 工作台 | 3000 |
| frontend-system | 系统管理（用户/角色/权限/部门/字典/日志） | 3001 |
| frontend-mes | 制造执行（工单/生产报工/BOM/工艺/排产/追溯/设备） | 3002 |
| frontend-iot | 设备物联（台账/监控/OEE/预测性维护/边缘） | 3003 |
| frontend-quality | 质量管理（检验/SPC/追溯/8D/改善） | 3004 |
| frontend-wms | 仓储管理（出入库/库存/库位/物流） | 3005 |
| frontend-ai | AI 服务管理（对话/知识库/预测/图像/语音） | 3006 |

## 📚 文档

### 设计与开发文档
- [架构设计文档](docs/架构设计文档.md)
- [数据库设计文档](docs/数据库设计文档.md)
- [功能模块设计文档](docs/功能模块设计文档.md)
- [技术实现文档](docs/技术实现文档.md)
- [系统适用性分析](docs/系统适用性分析.md)
- [拆分多个模块开发与测试](docs/拆分多个模块开发与测试.md)

### 测试文档
- [测试计划与测试报告](docs/测试计划与测试报告.md)
- [单元测试执行报告](docs/单元测试执行报告.md)
- [Java单元测试报告](docs/Java单元测试报告.md)

### 部署与运维文档
- [Docker 部署指南](docs/Docker部署指南.md)
- [快速启动指南](docs/快速启动指南.md)
- [远程开发连接指南](docs/远程开发连接指南.md)
- [连接故障排除指南](docs/连接故障排除指南.md)
- [本地开发环境部署指南](文档1_本地开发环境部署指南.md)
- [Docker 容器化部署指南](文档2_Docker容器化部署指南.md)
- [云服务器部署指南](文档3_云服务器部署指南.md)
- [Kubernetes 集群部署指南](文档4_Kubernetes集群部署指南.md)

> 说明：`文档1~4` 为早期手工部署指南，其中端口与组件信息可能与当前 Docker 一键部署存在差异，实际以 `deploy.sh / deploy.ps1` 和 `smart-manufacturing-system/deploy/docker/` 下的 Compose 配置为准。

## 🧪 测试

```bash
# 后端：单元测试（Surefire）+ 集成测试（Failsafe）
cd smart-manufacturing-system
mvn test
mvn verify
```

> 前端测试覆盖正在完善中，详见 [CHANGELOG.md](CHANGELOG.md)。

## 🤝 贡献指南

我们欢迎所有形式的贡献，包括但不限于：
- 提交Bug报告
- 提交功能请求
- 提交代码修复
- 提交新功能
- 改进文档

请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细贡献流程。

## 📄 许可证

本项目采用 [Apache License 2.0](LICENSE) 开源。

## 👥 团队

- **项目负责人**：旭创智造团队
- **核心开发者**：智能制造系统开发组
- **技术支持**：技术架构团队



## 🙏 致谢

感谢所有为这个项目做出贡献的开发者、测试人员和用户！

---

<p align="center">
  <strong>旭创智造 - 让制造更智能</strong>
</p>