## 是否变更APP接口 - 路由与参数:不变。现有 APP 端接口保持原路径与入参。 - `POST /api/app/guilds/:guild_id/members`(加入):internal/api/guild/members_app.go:19-50 - `DELETE /api/app/guilds/:guild_id/members/:user_id`(离开):internal/api/guild/members_app.go:52-83 - `GET /api/app/guilds/:guild_id/members`(成员列表):internal/api/guild/members_app.go:102-141 - 响应结构:不变(仍返回 `{ message }`)。 - 行为变化:当工会 `join_mode=1` 时,加入后处于待审状态,不会立即出现在成员列表(服务层变更:internal/service/guild/join.go:13-48;成员列表过滤正式成员:internal/service/guild/members_list.go:9-29)。 ## 客户端适配建议(保持接口不变) - 加入后状态提示:将文案改为“申请已提交,待审核”,并在个人/工会页显示“待审核”状态。 - 功能限制:待审期间禁用仅成员可用的操作(如成员互动、贡献等)。 - 成员列表:无需变更,列表只显示已通过成员。 ## 可选后端增强(增强体验,仍向后兼容) 1) 加入响应增强:在 `POST /api/app/guilds/:guild_id/members` 返回体中新增 `join_status`(0待审/2已通过),便于客户端无额外查询即可知状态。 2) 成员自查接口:新增 `GET /api/app/guilds/:guild_id/members/me` 返回当前用户在该工会的 `role/status/join_status`。 3) 申请查询接口:新增 `GET /api/app/guilds/:guild_id/applications?user_id=xxx` 用于查询自己的待审记录(只读)。 - 以上均为增量字段与新端点,旧客户端不受影响。 ## 验收 - 加入审核工会时,APP 加入成功但显示“待审核”,成员列表不包含该用户;审核通过后自动展示。 - 保持现有路由与参数不变,无需强制更新客户端。 - 若启用增强:客户端通过 `join_status` 或新查询端点准确展示状态。 如确认,我将按照“保持接口不变 + 提供可选增强”的方式推进服务与(可选)APP接口扩展,并提供前端适配示例。