主题
运维与部署
1. 运行形态
单进程:pmforge-server.jar 托管 API(/admin-api)、前端静态资源(/)、接口文档(/doc.html),端口 48080。
2. Profile
| profile | 用途 | 特点 |
|---|---|---|
local | 本机开发 | 关闭 Quartz、关闭验证码、单库 |
demo | 演示环境 | 启用 Quartz、演示模式、IoT 本地总线、14 个模块装配 |
dev | 联调环境 | 独立库 pmforge、开启远程调用 |
3. 容器化
deploy/docker/docker-compose.yml 提供 MySQL + Redis 依赖;应用镜像按需追加。构建:
bash
mvn -B -ntp -Dmaven.test.skip=true package
cd web/pmforge-ui-web && npm ci && npm run build
docker build -f deploy/docker/Dockerfile -t pmforge/server:local .4. CI
| 工作流 | 内容 |
|---|---|
.github/workflows/backend.yml | mvn -DskipTests package → test-compile → node tools/arch/check-boundaries.mjs(跨模块越界棘轮)→ node tools/docs/check-error-codes.mjs(错误码唯一) |
.github/workflows/frontend.yml | npm ci → vite build → 上传 dist 产物 |
.github/workflows/docs.yml | 知识库门禁(npm run docs:check:扫描器一致性 + PRD 对齐 + lint)→ 构建 → Cloudflare Pages 发布 |
本地等价命令:npm run code:check、npm run arch:check、npm run docs:check。
4.1 演示环境启动(本机 MySQL + Redis)
bash
# 1) 建库并导入正式 DDL 与 Quartz
mysql -h127.0.0.1 -uroot -p -e "CREATE DATABASE \`pmforge-jdk8\` DEFAULT CHARSET utf8mb4"
mysql -h127.0.0.1 -uroot -p pmforge-jdk8 < sql/mysql/pmforge.sql
mysql -h127.0.0.1 -uroot -p pmforge-jdk8 < sql/mysql/quartz.sql
# 2) 需要 12 个业务模块可浏览时,导入预留模块骨架 DDL(326 张表,含 iot_* 15 张,均已带 tenant_id)
mysql -h127.0.0.1 -uroot -p pmforge-jdk8 < sql/mysql/pmforge-modules-skeleton.sql
# 3) 可选:导入演示数据(三批:46 张表×3 行 + 20 张主列表页表各 6 行 + MES/商城 18 张表各 6 行;主键固定、可重复执行)
mysql -h127.0.0.1 -uroot -p --default-character-set=utf8mb4 pmforge-jdk8 < sql/demo/pmforge-demo-data.mysql.sql
mysql -h127.0.0.1 -uroot -p --default-character-set=utf8mb4 pmforge-jdk8 < sql/demo/pmforge-demo-data-extra.mysql.sql
mysql -h127.0.0.1 -uroot -p --default-character-set=utf8mb4 pmforge-jdk8 < sql/demo/pmforge-demo-data-mes-mall.mysql.sql
# 4) 构建前端 + 打包(前端产物进 server 的 static/)
cd web/pmforge-ui-web && npm ci && npm run build && cd ../..
mvn -B -ntp -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -Dmaven.source.skip=true package
# 5) 启动 demo
java -jar apps/pmforge-server/target/pmforge-server.jar --spring.profiles.active=demo首次启动约 60–85 秒(Flowable 建表 + 缓存预热)。健康检查:GET /(前端)、 POST /admin-api/system/auth/login(admin / admin123,头 tenant-id: 1)、 GET /admin-api/system/auth/get-permission-info(1126 个权限点)。
端到端自检(登录 + 35 个业务列表接口;--strict 时空列表也算失败):
bash
npm run demo:smoke -- --strict # 等价于 node tools/demo/smoke.mjs --strict
npm run demo:smoke -- --base https://pmforge.example.com演示环境已知取舍:RocketMQ 自动配置已排除;IoT 使用本地消息总线(pmforge.iot.message-bus.type: local); TDengine 初始化默认关闭(pmforge.iot.tdengine.enable: false);pmforge.demo 在 demo profile 中为 false, 对外演示时如需禁用写操作应改回 true(DemoFilter 会拦截已登录用户的 POST/PUT/DELETE)。
5. 发布前检查
- [ ]
mvn -Dmaven.test.skip=true package成功,jar 体积与上一次差异合理 - [ ]
npm run build产物已进入 jar(unzip -l ... | grep static/index.html) - [ ]
npm run docs:check、npm run code:check通过 - [ ] 数据库脚本与代码同步(新表/字段/菜单/权限)
- [ ] 配置项无明文密钥