学习日期：2026-10-29 · 环境：禅道开源版 22.x
关键词：禅道 / 用户管理 / 权限分组 / 后台配置
前言
今天第一次正经摸禅道后台，把"加一个能干活的人 + 给他合适的权限"这条线完整走了一遍。
之前一直只在项目视图里看需求、看甘特图（今天也顺手截了项目仪表盘，能看到阶段进度和"延期 302 天"这种扎心数据），但后台的用户和权限一直没敢动。趁着刚做完，把步骤和坑记下来，明天忘了能直接照抄。
一、先分清两个容易混的概念
禅道里有两个"分组"性质的东西，新手最容易搞混：
- 部门：你公司 / 团队的组织架构，决定上下级汇报关系。纯组织视角。
- 权限分组：决定这个用户"能看什么、能点什么"。纯权限视角。
二者没有必然关系。比如产品部和研发部的人，都可以被放进同一个"能提交 Bug"的分组。重点：加完用户一定要关联权限分组，否则这人登录后啥也干不了。
二、添加用户
界面速览：后台 → 人员管理 → 用户
进到这一页，你会看到这样的布局（和你本地 / 演示环境一致）： - 顶部三个标签：部门 / 用户 / 权限，当前停在「用户」。
- 工具栏左侧：全部 / 内部人员 N / 外部人员 标签 + 搜索框；右侧有 导出、导入、维护职位 按钮，以及一个蓝色 + 添加用户 按钮。
- 左侧是部门树（如总行 → 总经理办公室、管理部、研发一部 / 二部 / 三部……），点某个部门可只看该部门的人。
- 右侧用户表格字段：ID、姓名、用户名、性别、职位、直属上级、电话、QQ、邮箱、操作。每行「操作」列可编辑 / 删除单个用户；底部还能批量编辑。
注意：刚加完用户时，职位、直属上级、邮箱等列通常是空的，需要后续在编辑里补全。
- 用管理员账号登录，进 后台 → 人员管理 → 用户。
- 点右上角 添加用户（多人可点"批量添加用户"）。
- 填写基础信息：
- 用户名 / 真实姓名 / 密码 / 邮箱：基础必填项。
- 所属部门：选组织架构里的部门。
- 职位：选了职位后，系统会按职位默认带一个权限分组（例如选"测试"可能默认进测试分组），不合适可手动改。职位还会影响"指派列表"排序和"我的地盘"默认展示——产品人登录先看需求，研发登录先看任务。
- 界面类型：综合研发界面 / 运营管理界面等，按角色分工分配，决定他看到的功能范围。
- 权限分组：直接指定该用户归属的分组。
- 页面底部"您的密码"：这里填的是当前操作管理员自己的密码（不是新用户的密码！），用来二次确认。
- 点 保存，自动回到用户列表，刚加的人就在里面了。
小技巧：列表页可以全选或多选后点"编辑"做批量编辑（统一改部门、职位等），不用一个个改。
三、设置权限（核心在"分组"）
禅道的权限是"挂在分组上"的，用户通过加入分组来获得权限。 - 进 后台 → 人员管理 → 权限，看到分组列表（默认有管理员、项目经理、产品经理、开发、测试等）。
- 新增分组：点"新增分组"创建一个自定义组。
- 权限维护：选某个分组 → 点"权限维护"，进入按模块排列的权限清单（产品、项目、测试、组织、后台……）。可以勾选单个动作，也可以点模块名左侧的全选框一次性全选该模块。
- 视野维护：选某个分组 → "视野维护"，可限制该组只能查看指定的项目或看板（数据隔离很实用）。
- 成员维护：把对应用户拉进这个分组，权限就生效了。
四、几个容易踩的坑
- ❌ 加完用户忘了关联权限分组 → 登录后空白 / 无权限。
- ❌ 把底部的"您的密码"当成新用户密码填 → 保存失败。那是管理员自己的确认密码。
- ❌ 以为改了部门就自动有权限 → 部门和权限分组是两码事。
- ⚠️ 管理员分组权限最高、能给的模块最全，谨慎分配。
- ⚠️ 界面类型选错，用户进来找不到对应功能，别急着怀疑装错了。
五、小结
今天这条线理清了：部门管组织、分组管权限、用户挂在分组上拿权限。配合之前看的项目仪表盘（甘特图、阶段进度、延期风险），对禅道"组织 — 项目 — 权限"的骨架算是有体感了。
下一步准备在禅道里建一个真实项目，把"需求 → 任务 → Bug"的完整流程跑一遍，再用自己搭的博客 API 把这类学习笔记接进去。
附：操作清单（照着勾）
[ ] 管理员登录 → 后台 → 人员管理 → 用户
[ ] 添加用户，填用户名 / 姓名 / 密码 / 邮箱 / 部门 / 职位
[ ] 确认职位带出的默认权限分组，必要时改
[ ] 底部"您的密码"填管理员自己的密码 → 保存
[ ] 后台 → 人员管理 → 权限 → 维护分组（权限 / 视野 / 成员）
[ ] 用新账号登录验证权限是否到位
浙公网安备 33010602011771号