group_buy API（拼团）

路由：POST /api/v1/group_buy（action 协议：{"action": "...", "payload": {...}}） 错误码段：40413xxx（全表见错误码权威注册表） 鉴权：全部需登录 字段真相：src/app/group_buy/application/usecase/（Request dataclass）+ tests/integration/test_group_buy_actions.py（可执行契约）

Action 一览（4）

action	鉴权	说明
list	登录	拼团列表（商品读 mall 真实现）
detail	登录	拼团详情
join	登录	参团（人数成团判定 + 全员通知）
myJoined	登录	我参与的团

通用约定

• 信封：HTTP 200 + {"code","msg","data"}；code="0" 成功；404413002 未登录（HTTP 401）；404413001 参数错（HTTP 400）
• 写操作均落 audit/测试可断言（集成测试 = 可执行契约）

变更记录

日期	内容
2026-09-16	首版（四域审查棒 3 — action 清单代码直出）