# manufacturing

**Repository Path**: xiaoming-gitee/manufacturing

## Basic Information

- **Project Name**: manufacturing
- **Description**: 轻量云制造MES系统
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中小制造业轻量化 MES

本目录是项目工程实现区，和 `docs` 中的需求、设计文档对应。

## 目录结构

```text
manufacturing
├── backend       Spring Boot 后端服务
├── admin-web     PC 管理端
├── mobile-h5     一线员工移动报工端
├── sql           数据库建表与初始化脚本
└── deploy        本地/私有化部署配置
```

## 技术边界

- 后端：Java 17、Spring Boot 3、MyBatis-Plus、MySQL、Redis。
- 管理端：Vue 3、Vite、TypeScript、Element Plus。
- 移动端：Vue 3、Vite、TypeScript、Vant。
- 部署方式：每个客户独立私有化部署，不做共享多租户库。

## 本地启动顺序

1. 启动 MySQL 与 Redis。
2. 在 MySQL 中依次执行 `sql/schema.sql`、`sql/init_data.sql`。
   默认初始化账号为 `admin / admin123`。
   已存在的数据库可执行 `sql/add_column_comments.sql` 补充字段注释；如需排查历史乱码数据，可执行 `sql/check_garbled_text.sql`。
3. 启动后端：

```bash
cd backend
mvn spring-boot:run
```

启动后可访问接口文档：

- Swagger UI：`http://localhost:8080/api/swagger-ui.html`
- OpenAPI JSON：`http://localhost:8080/api/v3/api-docs`

4. 启动管理端：

```bash
cd admin-web
npm install
npm run dev
```

5. 启动移动 H5：

```bash
cd mobile-h5
npm install
npm run dev
```

## 开发约定

- Controller 只处理参数、认证上下文和响应包装，不写业务规则。
- Service 定义业务能力，ServiceImpl 负责事务、幂等、Redis、状态流转和领域规则。
- Dao/Mapper 只做数据库访问，不承载业务判断。
- Redis Key 统一维护在后端 `RedisKeys`，禁止业务代码散写字符串。
- 所有分页接口统一返回 `PageResult`。
- 所有接口统一返回 `ApiResult`。
- 所有业务异常统一抛出 `BusinessException`。

## 本机端口提示

- 后端默认端口：`8080`
- 管理端默认端口：`5173`
- H5 默认端口：`5174`
- MySQL 默认端口：`3306`
- Redis 默认端口：`6379`

如果本机已占用 `3306` 或 `6379`，请直接复用已有 MySQL/Redis，或调整 `deploy/docker-compose.yml` 的端口映射后再启动容器。