department (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和通用选项说明。
Commands
department list— 列出所有部门department get— 获取部门详情
Core Concepts
- Department(部门):ZenTao 中的组织架构单元,用于管理用户所属部门。
- Parent(父部门):部门可以有层级关系,parent 字段表示父部门 ID。
- Path(路径):部门的完整路径,如
/1/2/3/表示从根部门到当前部门的完整路径。
Department Fields
| Field | Type | Description |
|---|---|---|
| id | u64 | 部门 ID |
| name | string | 部门名称 |
| parent | u64 | 父部门 ID(0 表示根部门) |
| order | u64 | 排序序号 |
| path | string | 部门路径,如 /1/2/ |
Common Use Cases
1. 查看所有部门
# 列出所有部门
zentao-cli department list
2. 查看特定部门详情
# 获取部门详情
zentao-cli department get 1
Examples
# 列出所有部门
zentao-cli department list
# 获取部门详情
zentao-cli department get 1
Gotchas
部门层级:部门有层级关系,可以通过
path字段了解部门的完整层级位置。parent=0:当
parent为 0 时,表示该部门是根部门。与用户关联:用户的
dept字段关联到部门的 ID。