邹方成
6ee627139c
Some checks failed
Build docker and publish / linux (1.24.5) (push) Failing after 40s
feat(pay): 添加支付API基础结构 feat(miniapp): 创建支付测试小程序页面与配置 feat(wechatpay): 配置微信支付参数与证书 fix(guild): 修复成员列表查询条件 docs: 更新代码规范文档与需求文档 style: 统一前后端枚举显示与注释格式 refactor(admin): 重构用户奖励发放接口参数处理 test(title): 添加称号效果参数验证测试
25 lines
2.1 KiB
Markdown
25 lines
2.1 KiB
Markdown
## 是否变更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接口扩展，并提供前端适配示例。 |