邹方成
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): 添加称号效果参数验证测试
2.1 KiB
2.1 KiB
是否变更APP接口
- 路由与参数：不变。现有 APP 端接口保持原路径与入参。
POST /api/app/guilds/:guild_id/members（加入）：internal/api/guild/members_app.go:19-50DELETE /api/app/guilds/:guild_id/members/:user_id（离开）：internal/api/guild/members_app.go:52-83GET /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）。
客户端适配建议（保持接口不变）
- 加入后状态提示：将文案改为“申请已提交，待审核”，并在个人/工会页显示“待审核”状态。
- 功能限制：待审期间禁用仅成员可用的操作（如成员互动、贡献等）。
- 成员列表：无需变更，列表只显示已通过成员。
可选后端增强（增强体验，仍向后兼容）
- 加入响应增强：在
POST /api/app/guilds/:guild_id/members返回体中新增join_status（0待审/2已通过），便于客户端无额外查询即可知状态。 - 成员自查接口：新增
GET /api/app/guilds/:guild_id/members/me返回当前用户在该工会的role/status/join_status。 - 申请查询接口：新增
GET /api/app/guilds/:guild_id/applications?user_id=xxx用于查询自己的待审记录（只读）。
- 以上均为增量字段与新端点，旧客户端不受影响。
验收
- 加入审核工会时，APP 加入成功但显示“待审核”，成员列表不包含该用户；审核通过后自动展示。
- 保持现有路由与参数不变，无需强制更新客户端。
- 若启用增强：客户端通过
join_status或新查询端点准确展示状态。
如确认，我将按照“保持接口不变 + 提供可选增强”的方式推进服务与（可选）APP接口扩展，并提供前端适配示例。