Skip to content

运维与部署 ​

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.ymlmvn -DskipTests package → test-compile → node tools/arch/check-boundaries.mjs(跨模块越界棘轮)→ node tools/docs/check-error-codes.mjs(错误码唯一)
.github/workflows/frontend.ymlnpm 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 通过
  • [ ] 数据库脚本与代码同步(新表/字段/菜单/权限)
  • [ ] 配置项无明文密钥