开源项目管理软件入门指南：第一次自建要做的七件事

项目从几个扩到几十个后，需求散在表格、聊天和邮件里，周会花两小时对齐口径，上线前才发现权限、备份和回滚都没做。第一次自建开源项目管理软件，难点不在安装，而在按依赖顺序把范围、环境、权限、迁移和运维落地。PMI 在《项目管理知识体系指南》中强调，范围、进度、质量、风险等要素需要协同管理；工具只是承载这些要素的基础设施。本文按七件事展开：先定范围基线，再选版本与部署方式，接着准备环境、安装验收、配置权限、迁移数据，最后建立备份升级与推广机制；每一步的交付物就是下一步的输入。

图 1：七件事的依赖链。范围基线 → 版本决策 → 环境基线 → 安装验收 → 权限矩阵 → 迁移核对 → 运维手册。

一、先定范围基线

范围基线回答三个问题：首期做什么、谁决策、什么算完成。

1. 项目章程写清五个字段

目标、范围、成功标准、约束、项目负责人。成功标准用可观测结果，例如“需求到发布全程可追溯”“Bug 关闭前必须有验证记录”“项目经理能按周导出进度”。

2. WBS 按 8/80 原则拆到工作包

首期拆三层，工作包控制在 8～80 小时可估算粒度；超过 80 小时继续拆，少于 8 小时合并。WBS 叶子节点对应可交付物，不对应部门。拆完后标出关键路径和里程碑，作为进度基线。

3. RACI 保证每项活动只有一个 A

每项活动只有一个最终负责人（A），执行人（R）可以有多个，咨询（C）和知情（I）按需设置。范围变更走同一张变更单，记录影响、决策人和生效时间。

本节交付物：范围基线包，包含章程、WBS、RACI、验收场景。版本选择按这份基线判定。

二、选版本与部署方式

范围基线确定后，版本选择按硬性门槛判定，不按功能清单打分。

1. 先过六道门槛

用户规模、统一身份认证、审计、原厂服务等级、国产化适配、二次开发支持。任何一项是硬要求，就把商业版或增强版列入候选；没有硬要求，先用开源版跑通首期范围。开源版通常不按人数授权，覆盖需求、任务、Bug、用例、文档等核心流程；商业版补充组织级权限、流程与技术服务，具体许可和功能边界以所选软件为准。

2. 部署方式按现有能力三选一

有专职运维且已有 Web 运行环境：源码部署；有容器平台和镜像治理：容器部署；两者都没有：一体化安装包。首期按现有能力选，不按未来规划选。

3. 决策记录写清四个字段

版本号、部署方式、升级责任人、年度维护预算。记录存档后，环境准备按这份记录执行。

本节交付物：版本与部署决策记录。

三、准备环境

决策记录确定后，环境准备按容量模型和兼容矩阵执行。

1. 容量模型算三块

并发用户数按峰值在线人数的 20%～30% 做初始估算；附件容量按“现有附件 ×（1 + 年增长率）³”预留三年；备份空间按数据盘容量的 2～3 倍独立准备。三项写入容量表，压测后修正。

2. 兼容矩阵按官方基线

下表是安装前必须逐项确认的兼容矩阵。

表中任何一项不满足，先在测试环境修正，不要在生产环境边装边补。

3. 安全基线四项

HTTPS 终止在网关；数据库使用独立账号，禁用高权限账号远程登录；应用、附件、备份目录分目录授权；安装完成后删除安装入口文件，关闭目录浏览。

本节交付物：环境基线表与压测记录。

图 2：部署架构与信任边界。80/443 终止在网关，应用服务器访问数据库，备份与监控独立。

四、安装与初始化

环境基线通过后，安装按 runbook 执行，按验收项签收。

1. 安装 runbook 六步

从官方渠道获取与操作系统、CPU 架构匹配的包；上传到约定目录；解压；启动服务；浏览器访问安装向导；设置管理员密码并删除安装入口文件。启动和停止命令按安装包说明执行。

2. 初始化参数一次写全

站点 URL、时区、管理员邮箱、邮件通知、备份路径、定时任务。定时任务至少包含备份和通知；日志清理用系统计划任务单独配置。参数写入《系统配置表》，后续变更走变更单。

3. 五项验收

登录后台；新建产品与项目；创建需求并拆任务；提交一个 Bug 并关闭；上传附件并触发通知。再核对日志、磁盘、版本号。五项通过后签收。

本节交付物：安装验收记录。

五、组织、权限与项目结构

系统可用后，先配权限与结构，再迁数据。顺序反过来，迁移会带着旧权限和旧结构进来。

1. RBAC 权限矩阵

按角色授权，不按人授权。下表给出最小权限矩阵的起点。

矩阵落到用户组，离岗即停用；导出权限单独审批。

2. 四层结构映射

用“项目组合—项目集—项目—迭代或阶段”四层结构搭骨架。项目组合承接战略，项目集承接多项目统筹，项目承接交付，迭代或阶段承接执行。首期一个业务线一个项目组合，一个交付团队一个项目，一个迭代一个阶段。层级超过四层时，先确认是否真的需要，而不是继续加层。

3. 流程模板与状态机

Scrum 项目定义 DoR、DoD、迭代长度和看板列；瀑布项目定义阶段门和基线；看板项目设置 WIP 上限。工作项状态机只保留必要状态，每个状态必须有进入条件、退出条件和责任人。

本节交付物：权限矩阵与项目模板。

图 3：项目组合/项目集/项目/迭代或阶段四层结构与 RBAC。角色按最小权限发卡。

六、数据迁移与工具链

权限和模板确定后，迁移按“剖析—映射—清洗—演练—切换”五步执行。

1. 五步迁移法

数据剖析统计空值、重复、非法状态；字段映射形成“源字段—目标字段—转换规则—责任人”；清洗只改影响交付的字段；演练在测试环境跑全量；切换按停机窗口执行，保留回滚包。

2. 核对规则

核对五类结果：记录总数、状态分布、负责人映射、附件数量与大小、关联关系。任何一项差异超过约定阈值，停止切换。关闭超过 6 个月的项目只保留归档索引，不进入首期迁移。

3. 工具链集成顺序

统一身份认证 → 代码库 → 持续集成 → 通知。具体集成方式以所选软件开放的接口为准。集成后用 DORA 四项指标验证：部署频率、变更前置时间、变更失败率、恢复时长。每接一个系统，记录凭证有效期和失败告警。

本节交付物：迁移核对表与试运行报告。

七、备份、升级与推广

试运行通过后，进入长期运维。运维用 RPO/RTO 和 runbook 约束。

1. 备份按 3-2-1

三份副本、两种介质、一份异地。备份范围覆盖配置文件、代码、数据库、附件；初始可设 RPO 24 小时、RTO 4 小时，按业务影响调整。每季度做一次恢复演练，记录恢复时长和数据完整性。

2. 升级 runbook

读版本说明；全量备份；测试环境演练；业务低峰切换；保留回滚目录。跨版本升级按官方文档确认路径，不直接覆盖。出现组织级权限、审计、原厂服务等级、国产化适配等硬缺口时，再评估商业版或增强版。

3. 推广用采用指标

按角色培训：管理层看进度与风险，项目经理学计划与迭代，开发测试学工作项闭环。前 30 天每周跟踪四个指标：周活跃用户、工作项更新率、需求周期时间、Bug 平均关闭时长。指标连续两周下降，先查流程卡点，不要先加功能。

本节交付物：运维手册与 30 天推广计划。

七件事的交付物连成一条链：范围基线、版本决策、环境基线、安装验收、权限矩阵、迁移核对、运维手册。链上任何一环缺失，下一环都会返工。

方法说明：WBS、RACI、DoR/DoD、RBAC、DORA、RPO/RTO 属于通用项目管理与运维实践；具体版本、扩展、端口和许可条款以所选软件官方文档为准。