cart API（购物车）

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

Action 一览（5）

action	鉴权	说明
add	登录	加入购物车（upsert qty 累加 / 商品下架 400）
remove	登录	移除（幂等）
list	登录	列表（合计仅 on 商品 toFixed(2)）
updateQty	登录	改数量（qty≤0 → remove 形态）
clear	登录	清空

通用约定

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

变更记录

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