## 项目概述

S-PMS（Smart Production Management System，智能生产管理系统）是一个集成化、智能化的企业级应用软件。本仓库为 S-PMS 的 Web 前端项目，基于 Vue 3 与 TypeScript 构建。系统整合了制造执行系统（MES）、仓库管理系统（WMS）、企业资源计划系统（ERP）、质量管理系统（QMS）以及物联网管理系统（IoTS）等核心模块，目标覆盖从采购、生产、仓储到销售的全流程信息化、精细化、智能化管理。

## 核心功能

- MES（制造执行系统）：优化车间层生产活动，实时监控从订单下达到产品完成的整个生产过程，采集并分析生产数据，提高生产效率、产品质量和资源利用率。
- WMS（仓库管理系统）：管理入库、出库、库存、盘点、批次等仓库业务流程，保障仓库作业高效、准确、透明。
- ERP（企业资源计划系统）：整合财务、采购、销售、生产、库存等环节信息，为决策提供及时、准确的数据支持。
- QMS（质量管理系统）：进行质量策划、质量控制、质量保证及质量改进，确保产品和服务满足质量要求。
- IoTS（物联网管理系统）：连接生产设备和传感器，采集实时数据，实现设备远程监控、预防性维护和生产过程智能化控制。
- 提供 Docker 一键部署入口（通过独立部署仓库 SPMS-Docker）。
- 支持基于 AGENT.md 的 AI 辅助开发规范。

## 适用与不适用场景

仓库资料未提供明确的适用/不适用场景边界。根据 README 描述，本项目适合制造企业在生产管理、仓库管理、企业资源计划、质量管理及物联网设备管理等方面进行一体化、智能化管理；同时可作为智能制造、工业互联网相关行业的前端项目参考。由于本仓库为 Web 前端项目，不包含后端服务，使用前需自行准备并配置后端 API 环境；若仅需单模块简单管理或非制造类业务场景，可能并不完全适用。

## 技术架构与依赖

根据仓库标识与 README，项目技术栈包括：

- 核心基础：AirPower4T
- 开发语言：TypeScript
- 前端框架：Vue 3
- 构建工具：Vite
- UI 组件库：Element Plus
- 包管理：yarn
- 许可证：MIT

其他依赖与版本号等信息，仓库资料未提供。

## 安装与快速开始

以下命令均来自 README：

```shell
# 通过 GitHub 初始化
git clone https://github.com/s-pms/SPMS-Web.git
cd SPMS-Web
yarn
cp .env.dev .env
yarn s

# 通过 Gitee 初始化（推荐）
git clone https://gitee.com/s-pms/SPMS-Web.git
cd SPMS-Web
yarn
cp .env.dev .env
yarn s
```

打包命令：

```shell
yarn dev          # 开发环境，使用 .env.dev
yarn test         # 测试环境，使用 .env.test
yarn production   # 生产环境，使用 .env.production
```

README 提示：Windows 用户建议使用 Git Bash；启动前建议关闭 VS Code 的 Vetur 插件，避免 Vue2/Vue3 冲突。

## 典型使用方法

1. 按上述快速开始命令克隆并安装依赖。
2. 复制环境变量模板：`cp .env.dev .env`，按需修改配置。
3. 使用 `yarn s` 启动开发服务，或使用 `yarn dev`、`yarn test`、`yarn production` 分别按开发、测试、生产环境打包。
4. 如需 AI 辅助开发，请参考仓库中的 AGENT.md 文档，其中约定了开发规范、目录结构、编码风格等。
5. 如需 Docker 一键部署，可查看独立的 SPMS-Docker 部署仓库。

## 配置与部署要点

- 环境变量配置（.env）示例：

```conf
VITE_APP_NAME = "开发环境"
VITE_APP_API_URL = "/api/"
VITE_APP_STATIC_URL = "/static/"
```

- 部署方式：本仓库是前端项目，具体 Docker 部署请参考 SPMS-Docker 仓库（GitHub 或 Gitee）。
- README 推荐 VS Code 插件：Vue - Official、ESLint、SCSS Formatter；如遇兼容问题，建议禁用其他插件（尤其是 Vetur）。
- 其他生产环境部署细节，仓库资料未提供。

## 限制、风险与许可证

- 许可证：MIT。README 声明“所有代码均在 MIT 开源协议规范下免费提供”。
- 风险与限制：仓库资料未提供明确的限制与风险说明。需注意本仓库仅为前端项目，必须搭配后端 API 与相应环境才能完整运行；Docker 部署、后端服务、权限与数据安全等细节请参阅官方文档或联系项目方。

## 官方链接

- GitHub 仓库：https://github.com/s-pms/SPMS-Web
- Gitee 仓库：https://gitee.com/s-pms/SPMS-Web
- Docker 部署仓库（GitHub）：https://github.com/s-pms/SPMS-Docker
- Docker 部署仓库（Gitee）：https://gitee.com/s-pms/SPMS-Docker
- 开发者指南（GitHub）：https://github.com/s-pms/SPMS-Docs
- 开发者指南（Gitee）：https://gitee.com/s-pms/SPMS-Docs
- 联系邮箱：admin#hamm.cn（# 请替换为 @）
- QQ 交流群：773726377

## 信息来源和分析时间

信息来源：GitHub 仓库 s-pms/SPMS-Web 的 README、仓库描述、Topic 标签及公开元数据。

分析时间：2026-04-26