For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/commerce.md (or send Accept: text/markdown).
移动端电商
为工作区管理商店商品与订单。
商品
/api/mobile/commerce/products 上的 GET 与 POST 用于列出和创建商品 —— 仅所有者与管理员。新商品以草稿起步;价格以字符串录入、以分为单位按两位小数精度存储,库存跟踪可选。商品永不真正删除:archived 即移除状态,PATCH 同时更新字段与状态 —— draft、active、archived。
订单只能向前流转
GET /api/mobile/commerce/orders 列出订单;订单由商店结账创建,应用本身永不创建。PATCH 只允许状态向前推进 —— pending 到 paid 到 fulfilled —— 付款前可转 cancelled,付款后可转 refunded。取消会在同一事务中回补被跟踪的库存;非法流转是静默的空操作,而不是需要用户去消除的错误。
验证与排障
通过公开结账完成一笔销售,在移动端推进订单,并确认取消 pending 订单时库存回补。低于 admin 的成员完全无法进入该界面 —— 验证他们看到的是“不可用”而不是空白。