## 项目概述

S-PMS (Smart Production Management System) 智能生产管理系统，是一个企业级后端应用。仓库 `s-pms/SPMS-Server` 为服务端实现，语言为 Java，许可证为 MIT。项目集成了制造执行系统（MES）、仓库管理系统（WMS）、企业资源计划系统（ERP）、质量管理系统（QMS）和物联网管理系统（IoTS）等模块，旨在覆盖从采购、生产、仓储到销售的全流程管理。

## 核心功能

- MES 制造执行系统：车间层生产活动优化，实时监控从订单下达到产品完成的过程，采集和分析生产数据。
- WMS 仓库管理系统：管理入库、出库、库存、盘点、批次等仓库业务。
- ERP 企业资源计划：整合财务、采购、销售、生产、库存等信息，支撑企业决策。
- QMS 质量管理：质量策划、控制、保证和改进。
- IoTS 物联网管理：连接生产设备和传感器，实现设备远程监控、预防性维护和智能化控制。
- 项目提供 Docker 一键部署仓库和 Demo 站点（仓库资料显示）。

## 适用与不适用场景

适用：需要将 MES、WMS、ERP、QMS、IoT 等能力整合到统一平台的制造企业；希望用同一套系统打通车间、仓库、质量与资源计划的企业。
不适用：仓库资料未提供明确不适用场景。从技术栈看，非制造/工业场景或只需要单点轻量模块的团队可能不适合直接使用这套集成式后端；若有快速定制且无 Java/Spring Boot 团队技术储备，也可能增加使用成本。

## 技术架构与依赖

- 语言：Java 17
- 框架：Spring Boot 3
- ORM：JPA
- 数据库：MySQL 8
- 中间件/工具：Redis（前置要求）、Maven
- 基础核心包：AirPower4J
- 前后端：该仓库为 Server 后端项目，前端未在本仓库提供。

## 安装与快速开始

前置技能：Java 17、Spring Boot 3、IDEA、MySQL、Redis。

1. 创建项目文件夹并克隆代码：
   - `git clone https://github.com/s-pms/SPMS-Server.git`
   - 或 Gitee: `git clone https://gitee.com/s-pms/SPMS-Server.git`
2. 使用 IDEA 打开目录，刷新 Maven 依赖。
3. 复制 `resources/application-template.yml` 为运行环境配置文件（如 `application-local.yml`），并按环境配置数据库、Redis 等环境变量。
4. 启动时使用对应的 profile（如 `local`）。
5. 数据库结构由 JPA 的 `ddl-auto: create-drop` 自动创建（测试环境）。测试完成后建议导出数据库，并将 `ddl-auto` 改为 `validate`，再导入生产数据库。
6. 如果你希望 Docker 部署，可参考 `SPMS-Docker` 仓库。

## 典型使用方法

作为后端服务，通常为前端/客户端提供 API。仓库未提供更详细的 API 示例和调用文档，开发者指南文档位于 `SPMS-Docs` 仓库。运行服务后，可通过 Demo 站点（`https://spms.hamm.cn`）了解功能展示。

## 配置与部署要点

- 使用 `application-template.yml` 复制为本地配置文件。
- 管理 `ddl-auto` 策略：开发可使用 `create-drop`，生产建议 `validate` 并提前准备数据库。
- 需要提前安装并配置 MySQL 8、Redis。
- Docker 部署可参考 `SPMS-Docker` 仓库（Github/Gitee）。
- 生产部署前建议备份/导出数据库。

## 限制、风险与许可证

- 许可证：MIT。
- 项目说明称代码免费提供，但作者没有精力提供无偿问题解答和技术支持。
- 仓库未提供 `latestRelease` 信息，也未提供专门的变更日志。
- 仓库中的 `docs/DEV.md` 内容为空，开发者指南需查看外部文档仓库。
- 生产环境使用前需要自行验证其稳定性、安全性和数据迁移流程，仓库资料未提供更多风险说明。

## 官方链接

- GitHub 仓库：https://github.com/s-pms/SPMS-Server
- Gitee 仓库：https://gitee.com/s-pms/SPMS-Server
- Docker 部署：https://github.com/s-pms/SPMS-Docker | https://gitee.com/s-pms/SPMS-Docker
- 开发者指南：https://github.com/s-pms/SPMS-Docs | https://gitee.com/s-pms/SPMS-Docs
- 演示站点：https://spms.hamm.cn
- 联系邮箱：admin@hamm.cn
- QQ 群：773726377
- 依赖核心包 AirPower4J：https://github.com/AirPowerTeam/AirPower4J

## 信息来源和分析时间

信息来源：GitHub 仓库 `s-pms/SPMS-Server` 的元数据、README、文档目录及仓库内 `docs/DEV.md`。
分析时间：以本次生成的时间为准；仓库未提供文档更新日期。