feat: add run.ps1 script to start projects easily

add a powershell script that supports starting MES, WMS, WMSClient, Workstation and Dashboard projects with one command, includes build and run logic for backend services and npm dev for dashboard
This commit is contained in:
SunYF
2026-08-28 17:03:03 +08:00
parent a9c3fbeb41
commit cbd55338f1
30 changed files with 592 additions and 61 deletions
+37 -4
View File
@@ -41,13 +41,15 @@ Redis 不一致时同样改上述 yaml 的 Redis 段。
WMS 启动时自动建表并预置数据,无需手工操作。
默认账号:`admin/admin123``store1/123456`(出库)、`insp1/123456`(检验)。
MES 表结构需手工执行一次迁移:
MES 表结构需手工执行一次迁移**必须输入管理员密码才生效**
```powershell
cd d:\hardman\bj_power\bj_power_mes
go run schema/tools/migrate.go
.\bj_power_mes.exe migrate # 输入管理员密码(默认 Hardman_2026
```
> 或者对全新/可丢弃的库直接 `.\bj_power_mes.exe reset-all`(清空重建全部表,不可恢复)。
MES 启动时会自动 Seed 数据(见 internal/logic/seed.go):默认角色(SUPER_ADMIN/OPERATOR/INSPECTOR)、菜单权限、12 道工序步骤、12 工位↔工序派工。默认账号:`admin / Hardman_2026`
## 三、编译与运行
@@ -140,7 +142,38 @@ server {
说明:
- 看板数据(概览/工位状态划/工单进度/报警/趋势)全部来自 MES `/api/internal/dashboard/*`Redis 60s 缓存),SSE 实时刷新 + 10s 轮询兜底。
## 四、启动顺序与验证
## 四、MES 命令行维护命令(需管理员密码)
所有涉及建表/清库/改密的命令**都必须先输入管理员密码**(默认 `Hardman_2026`),密码错误会记录日志并终止,绝不执行。所有命令均写入按天日志 `bj_power_mes/logs/bj_power_mes-YYYY-MM-DD.log`
```powershell
cd d:\hardman\bj_power\bj_power_mes
.\bj_power_mes.exe migrate # 建表/补列(只增,不删数据)——常规升级用
.\bj_power_mes.exe reset-all # 清空并重建全部表 + 写基础数据(破坏性,不可恢复)
.\bj_power_mes.exe seed # 仅对齐基础数据(角色/admin/菜单/工序模板/工位派工)
.\bj_power_mes.exe serve # 正常运行服务(可省略;默认即 serve)
```
要点:
- 门禁密码配置在 `etc/bj_power_mes-api.yaml``Cli.AdminPassword`(默认 `Hardman_2026`)。
- 明文传给命令执行审计:每次成功/失败均在日志记录时间与命令名。
- 生产升级流程:`migrate``serve`;如曾存在旧版本不兼容库,先手工确认后 `reset-all`
- 用户改密码在**管理后台登录后**「修改密码」完成(`POST /api/v1/user/change-password`),命令行不改密。
## 五、各系统管理员账号(部署后请尽快修改默认密码)
| 系统 | 管理员账号 | 默认密码 | 修改方式 |
|------|-----------|---------|---------|
| MES (B) | admin | `Hardman_2026` | 管理后台登录后点右上「修改密码」(旧密码+新密码)|
| WMS (C) | admin | `admin123` | WMS 登录后改密,或直接改 `bj_power_wms` 数据库 users 表 |
| 工位终端 (D) | admin / operator1 | `admin123` / `123456` | 终端登录后改密,或直接改本地 `workstation.db`SQLiteusers 表 |
| 库房客户端 (E) | 复用 WMS 账号 | 同 WMS | 登录 WMS 后改密 |
| 看板 (A) | 无登录账号 | — | 只读,无管理员 |
> 工位终端/库房客户端若需与 MES/WMS 一致的统一密码,请在对应 yaml/种子中调整后再部署。
## 六、启动顺序与验证
顺序:PostgreSQL/Redis → MES(8888) → WMS(8890) → 工位网关/终端 → Dashboard。
@@ -155,7 +188,7 @@ server {
| SSE 推送 | 看板打开后操作工单下发,看板秒级刷新(DevTools Network → sse 连接 pending |
| 工位终端 | 打开 http://127.0.0.1:8892 登录,扫一个 SN 报工,回 MES 追溯页查询 |
## 、常见问题
## 、常见问题
1. **前端依赖/构建**:所有前端(MES frontend / 工位终端 / 库房客户端 / 看板)一律 `npm install && npm run build`,无需 pnpm。
2. **ent 代码生成**:改 schema 后须到对应目录执行 `go generate ./...`MES`cd bj_power_mes/schema && go generate ./...`WMS`cd bj_power_wms/schema && go generate ./...`)。