组织与成员

组织

POST /api/orgs

创建组织。创建者自动成为 owner。

鉴权：需 Authorization: Bearer <JWT>

请求体（JSON）

字段	类型	说明
name	string	组织名称

响应 201

{ "org": { "id": "...", "name": "..." } }

---

GET /api/orgs/:id

获取组织详情。调用者须为该组织成员。

鉴权：需 Authorization: Bearer <JWT>

响应 200

{ "org": { "id": "...", "name": "...", "members": [...] } }

---

成员

成员角色分三级（权限由低到高）：member → admin → owner。

GET /api/orgs/:id/members

列出组织成员。任意成员可读。

鉴权：需 Authorization: Bearer <JWT>

响应 200

{ "members": [{ "userId": "...", "email": "...", "role": "member" }] }

---

POST /api/orgs/:id/members

按邮箱添加成员。需 admin 及以上角色。

鉴权：需 Authorization: Bearer <JWT>（admin+）

请求体（JSON）

字段	类型	说明
email	string	受邀成员邮箱
role	string	member | admin

响应 201

{ "member": { "userId": "...", "role": "member" } }

---

PATCH /api/orgs/:id/members/:uid

修改成员角色。需 admin 及以上角色。

鉴权：需 Authorization: Bearer <JWT>（admin+）

请求体（JSON）

字段	类型	说明
role	string	新角色

响应 200

{ "member": { "userId": "...", "role": "admin" } }

---

DELETE /api/orgs/:id/members/:uid

移除成员。需 admin 及以上角色。

鉴权：需 Authorization: Bearer <JWT>（admin+）

响应 200

{ "ok": true }