# MES 生产管理系统 - 开发指导手册

**整理给**: 张凤琴 (PMC经理)  
**系统**: 智步生产管理系统 (MES)  
**版本**: v1.0  
**日期**: 2026-04-13

---

## 📋 系统概述

MES 生产管理系统是一个轻量级的生产管理工具，用于：
- PMC 创建生产需求
- 生产部门排期和跟踪
- 实时看板监控生产状态

### 核心流程
```
PMC创建需求 → 系统自动排序 → 生产排期 → 执行跟踪 → 完成
```

---

## 🌐 系统访问

| 环境 | 地址 |
|------|------|
| 外网 | https://erp.we-smart.cn |
| 工厂内网 | http://localhost:8091 |
| API | https://erp.we-smart.cn/api/ |

---

## 🏗️ 技术架构

### 前端
- **技术**: 纯 HTML/CSS/JavaScript
- **位置**: `/home/maocai/.openclaw/workspace/internal/mes/*.html`
- **页面**:
  - `index.html` - 订单管理
  - `schedule.html` - 生产排期
  - `board.html` - 生产看板
  - `gantt.html` - 甘特图

### 后端
- **技术**: Node.js + Express
- **位置**: `/home/maocai/.openclaw/workspace/internal/mes/api/`
- **数据库**: JSON 文件 (`api/data/db.json`)
- **端口**: 3009

### 部署
- **工厂服务器**: Web (8091) + API (3009)
- **FRP穿透**: 阿里云 7012(Web) / 7013(API)
- **外网域名**: https://erp.we-smart.cn

---

## 💻 开发环境

### 进入项目目录
```bash
cd /home/maocai/.openclaw/workspace/internal/mes
```

### 常用命令
```bash
# 查看系统状态
./check-status.sh

# 停止服务
./stop-mes.sh

# 启动/重启服务
./deploy-mes.sh

# 查看日志
tail -f logs/api.log
tail -f logs/web.log
```

---

## 📝 数据库结构

**文件**: `api/data/db.json`

```json
{
  "orders": [
    {
      "id": "PO20250413001",
      "productName": "智步楼梯灯 ZM1",
      "productModel": "PBL80",
      "quantity": 500,
      "status": "completed",
      "priority": "high",
      "requestedDate": "2025-04-10",
      "plannedDate": "2025-04-08",
      "actualDate": "2025-04-09",
      "estimatedHours": 80,
      "requiredWorkers": 5,
      "createdBy": "张凤琴",
      "createdAt": "2025-04-01T09:00:00Z",
      "notes": "备注信息"
    }
  ],
  "workers": [...],
  "schedule": {...}
}
```

### 订单状态 (status)
- `pending` - 待排期
- `scheduled` - 已排期
- `in_progress` - 生产中
- `completed` - 已完成
- `delayed` - 延期

### 优先级 (priority)
- `high` - 高
- `medium` - 中
- `low` - 低

---

## 🔌 API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/orders` | GET | 获取所有订单 |
| `/api/orders` | POST | 创建订单 |
| `/api/orders/:id` | PUT | 更新订单 |
| `/api/orders/:id` | DELETE | 删除订单 |
| `/api/stats` | GET | 获取统计 |
| `/api/gantt` | GET | 获取甘特图数据 |
| `/api/health` | GET | 健康检查 |

---

## 🤖 AI 交互指令

### 你可以这样要求 AI 助手：

#### 1. 功能开发
```
请帮我给 MES 系统添加 [功能名称] 功能。
系统位置: /home/maocai/.openclaw/workspace/internal/mes/
```

#### 2. 修改页面
```
请修改 MES 系统的 [页面名称] 页面，添加 [具体需求]。
文件位置: /home/maocai/.openclaw/workspace/internal/mes/[文件名].html
```

#### 3. 数据操作
```
请帮我导出 MES 系统的订单数据。
数据库位置: /home/maocai/.openclaw/workspace/internal/mes/api/data/db.json
```

#### 4. 问题排查
```
MES 系统出现 [问题描述]，请帮我检查并修复。
服务端口: Web(8091) API(3009)
```

#### 5. 新增报表
```
请给 MES 系统添加一个 [报表名称] 报表页面。
参考现有页面: index.html / board.html
```

---

## 🎨 开发规范

### 前端
- 使用现有 CSS 变量 (`:root` 中定义的颜色)
- 保持与现有页面一致的设计风格
- 响应式布局 (适配移动端)

### 后端
- API 返回格式: `{success: true/false, data: ..., message: ...}`
- 新增接口在 `api/server.js` 中添加
- 数据库操作使用 `readDB()` 和 `writeDB()` 函数

### Git 提交
```bash
cd /home/maocai/.openclaw/workspace
git add internal/mes/
git commit -m "MES: [修改描述]"
```

---

## 📞 联系支持

如有技术问题，可以：
1. 查看 `README.md` 和 `DEPLOY.md` 文档
2. 检查 `logs/` 目录下的日志文件
3. 向 AI 助手描述问题并请求帮助

---

## ✅ 系统状态检查清单

部署或修改后，检查以下项目：

- [ ] Web 服务运行正常 (http://localhost:8091)
- [ ] API 服务运行正常 (http://localhost:3009/api/health)
- [ ] FRP 穿透正常 (阿里云 7012/7013 端口)
- [ ] 外网访问正常 (https://erp.we-smart.cn)
- [ ] 数据库文件正常 (`api/data/db.json`)

---

**祝使用愉快！**