zt-closet-backend/.codebuddy/plans/同步更新三个项目文档_5b365d72.md

name, overview, todos

name	overview	todos
同步更新三个项目文档	同步更新 README.md、接口文档.md、Stitch.md，反映本轮代码变更（广告激励配置开关+服务端定价、退款管理员操作、会员类型推导、iOS 退款问询细化等），并在 Stitch.md 额度商城页补充「看广告得额度」入口 UI。	id content status update-readme 更新 README.md 的 AdReward 配置段、错误码 80004、退款管理员操作与广告激励接口描述 completed id content status update-api-doc 更新接口文档.md 的广告激励参数与错误码、订单状态机、会员类型推导说明 completed id content status update-stitch 更新 Stitch.md 在额度商城页补充「看广告得额度」入口 UI 描述 completed

用户需求

将 README.md、接口文档.md、Stitch.md 三个文档同步更新至最近一轮后端代码修复后的最新状态。

核心变更点（需映射到文档）

1. 广告激励：新增 AdReward 配置段（Enable 开关 + Cos/AI/OutfitShare/ClosetShare 各类型固定金额）；/ad-reward/grant 请求移除 amount，仅传 reward_type 与 ref_id；金额由服务端配置固定；新增错误码 80004 广告激励未开启。
2. 退款管理员操作：订单「已取消但已付款」由「自动调微信退款」改为「生成待审核退款单，管理员后台手动退款」；退款成功回调兼容「已取消」订单流转且跳过权益回收。
3. XPay 退款反查：退款推送回退权益前反查微信侧退款真实性。
4. 会员类型推导：vip_type 按续费后最终到期时长推导（剩余不低于 365 天为年度，否则月度），体验会员保持不变。
5. iOS 退款问询：按权益消耗情况细化拒绝。
6. 上传接口：解析 multipart 前限制请求体大小。

更新范围

• README.md：配置说明表新增 AdReward 段；业务流程第 5 条退款描述；错误码段位表补 80004；API 概览广告激励行；额度体系措辞。
• 接口文档.md：/ad-reward/grant 参数表删除 amount 并补业务逻辑与 80004；额度模块引言；微信回调竞态兜底描述；订单状态机 mermaid；会员类型推导规则；错误码全表补 80004；版本号与日期。
• Stitch.md：在「额度与会员商城」页的「我的额度」卡片后补充「看广告得额度」入口 UI 描述（含开关控制、服务端定价、加载/失败态），严格沿用既有 iOS HIG 与 SF Symbols 风格。