面向单个企业的自部署项目管理系统。工作台、项目交付、组织与权限都在一个实例里完成。不是多租户 SaaS，也不拆微服务。
本仓库是安装入口，使用预构建镜像。本机不需要安装 Java、Maven、Node.js 或 pnpm。源码在 pms-backend 和 pms-front。
截图来自隔离演示实例。本次新增截图展示中文界面、流程模板、企业项目看板与审计日志能力。
- 流程模板：按流程类型维护模板和版本，当前支持项目管理、专题管理和故事管理；可配置节点顺序、字段组件、固定业务工作台与节点排期，支持保存草稿、发布、归档和设为默认版本。
- 企业项目看板：从组织视角查看项目组合、阶段、等级、交付健康、风险、节点里程碑与近期关注项目，并支持按组织、阶段、等级和健康状态筛选。
- 审计与治理：审计列表和详情保留动作、资源、操作人、请求 ID 及变更前后差异；系统自动生成的无项目/无操作人记录也可以稳定展示。
- 文档与演示：README、变更记录和演示截图同步更新，方便直接了解核心工作流和企业级项目组合视图。
研发交付采用“项目 → 项目流程节点 → 开发与迭代控制 → 专题 → 故事”的关系。项目流程模板可以把任意节点配置为专题绑定节点；项目实例使用该模板后，专题会出现在这个节点的开发与迭代控制工作区中。绑定节点不是写死的，后续可以在流程模板中调整。
- 项目、专题、故事分别使用各自类型的已发布流程模板；详情页会沿用统一的流程节点、字段、负责人、排期和节点任务组件。
- 专题通常在项目的开发与迭代控制工作区中拆分，故事在专题流程的具体节点下拆分；专题和故事也都可以暂不关联上级对象。
- 专题可以关联任意进行中的项目，也可以保持未关联；已完成、已终止或已删除的项目不能新增关联。未关联项目的专题对所有人可见。
- 故事可以关联专题，也可以保持独立。关联或改绑时，负责人、节点负责人和任务执行人会按关联关系同步到上级对象的成员范围。
- 节点负责人、节点排期、节点字段和节点任务均在详情页直接编辑；任务和子任务只归属于当前流程节点，节点完成后才能推进流程。
| 模块 | 说明 |
|---|---|
| 工作台 | 汇总当前账号的任务、参与项目和最近评论，不是全公司总览 |
| 项目交付 | 固定节点流转（立项、需求范围、方案评审、计划与风险等），任务挂在节点上 |
| 流程模板 | 按流程类型维护可发布版本，配置项目、专题、故事的节点字段、业务组件和默认模板 |
| 研发管理 | 以列表和详情页管理专题、故事，按各自流程模板推进节点、负责人、排期与任务 |
| 企业项目看板 | 组织级项目组合、交付健康、风险与里程碑视图 |
| 组织与人员 | 主职组织树、角色权限、邀请开通、批量导入 |
| 协作与治理 | 评论、通知、反馈、审计日志 |
| 可选登录 | 默认使用本地密码，也可接入 LDAP / OIDC |
一个部署实例只服务一家企业，没有 tenant_id。
需要 Docker Engine 或 Docker Desktop，以及 Compose v2。默认数据库是 MySQL 8.4，Docker 建议至少分配 2 GiB 内存。
git clone https://github.com/xiebinJava/pms-distribution.git
cd pms-distribution
./scripts/bootstrap.sh打开 http://localhost:5173。首次空库会创建初始管理员：
| 项 | 值 |
|---|---|
| 登录邮箱 | admin@example.com |
| 密码 | PmsAdmin123! |
请立刻修改该密码。MySQL 与 JWT 等基础设施密钥仍由脚本随机生成，写入未被 Git 跟踪的 .pms-bootstrap-secrets。生产部署必须更换管理员密码（validate-production-config.sh 会拒绝上述默认值）。
当前发行版本：1.0.8。镜像在 GHCR，可匿名拉取。
如果改了 PMS_PORT，请把 PMS_CORS_ALLOWED_ORIGINS 和 PMS_PUBLIC_BASE_URL 改成同一端口。只改端口、不改 CORS 时，浏览器登录会被后端拒绝。bootstrap.sh 在端口已改、CORS 仍是示例值时，会自动对齐（见下方配置）。
./scripts/status.sh
./scripts/logs.sh backend
./scripts/backup.sh
./scripts/upgrade.sh 1.0.1脚本默认用仓库目录名作为 Compose 项目名（本仓库为 pms-distribution）。隔离环境请让每条命令使用同一组变量：
COMPOSE_PROJECT_NAME=pms-staging ENV_FILE=.env.staging COMPOSE_FILE=compose.yaml ./scripts/bootstrap.sh
COMPOSE_PROJECT_NAME=pms-staging ENV_FILE=.env.staging COMPOSE_FILE=compose.yaml ./scripts/status.sh停止服务但保留数据：
docker compose --env-file .env -f compose.yaml down不要使用 down -v，除非你明确要删除数据库和附件。
| 项目 | 当前发行路径 |
|---|---|
| 容器运行时 | Docker Engine / Docker Desktop / Colima + Compose v2 |
| 数据库 | 仅 MySQL 8.4 |
| 前端入口 | Nginx 容器，默认 5173 |
| 后端入口 | 仅容器网络可见，默认 8080 |
| 生产 HTTPS | 由企业反向代理或 Ingress 负责 |
完整组合见 支持矩阵。
首次启动前可以编辑 .env。敏感值只放在本地 .env、Docker secrets 或外部密钥管理器，不要提交到 Git。
改入口端口时，至少同步这三项：
PMS_PORT=5173
PMS_PUBLIC_BASE_URL=http://localhost:5173
PMS_CORS_ALLOWED_ORIGINS=http://localhost:5173,http://127.0.0.1:5173bootstrap.sh 会在 PMS_PORT 不是 5173、且 CORS / 公网地址仍是示例值时，自动改成当前端口。
生产环境至少需要：
PMS_DEPLOYMENT_ENV=production- 由密钥管理器注入的
PMS_JWT_SECRET - 非默认的数据库和管理员密码
- 正式域名、HTTPS 和受限的
PMS_CORS_ALLOWED_ORIGINS - SMTP、对象存储、备份策略和监控告警
完整说明见 生产配置。
使用 Docker Desktop 时，建议至少分配 2 GiB 内存。首次拉镜像和初始化 MySQL 可能要一两分钟。
启动脚本会在拉镜像前检查 Docker 内存。低于 PMS_MIN_DOCKER_MEMORY_GIB（默认 2 GiB）会直接提示并退出。已确认资源足够时，可在 .env 里调整该阈值。
本地开发能跑起来，不代表一台内存很小的机器一定能完成发行包冷启动：
- 本地开发可能已经有初始化过的数据卷
- 本地前后端可能跑在宿主机上，不和 MySQL 抢同一块虚拟机内存
- 发行包是全新冷启动，要同时拉起数据库、后端 Flyway 和前端
- Docker 内存还要分给引擎和其他容器
Colima 用户请给对应 profile 同样的内存，并把 Compose 工程放在 $HOME 下，以便虚拟机挂载。
pms-distribution 安装、升级、备份、发行文档（你在这里）
pms-backend Spring Boot API、迁移、后端镜像
pms-front Vue / Nginx 前端和前端镜像
发行仓库只引用经过测试的镜像版本，避免复制源码造成版本漂移。
bash scripts/test-distribution-contract.sh
bash scripts/test-compose-config.sh
bash scripts/test-operations-safety.sh
./scripts/check-privacy.sh
bash -n scripts/*.sh docker/*.sh
git diff --check发布顺序：源码仓库测试并发布镜像 → 更新本仓库 PMS_VERSION → 干净环境启动 / 升级 / 恢复 → 创建 Release。
| 文档 | 说明 |
|---|---|
| 生产配置 | 上线前必须完成的安全与运行配置 |
| 升级 | 备份、升级和失败回滚 |
| 备份与恢复 | 数据库与附件归档 |
| 故障排查 | 常见启动、登录和迁移问题 |
| 支持矩阵 | 当前支持与不支持的组合 |
| 发布镜像 | GHCR 发布顺序与校验 |
| 干净环境冒烟验收 | 发布前必过清单 |
| 发行镜像归因 | 第三方镜像来源 |
| 变更记录 | 版本变更 |
| 贡献指南 | 如何提交改动 |
| 安全策略 | 漏洞私下报告 |
问题跟踪用 Issues，使用讨论用 Discussions。