## 目标 * 将“用户端”API补齐内容更新到现有文档,便于你审阅。 ## 更新范围 * 修改 `app/docs/接口约定与预留.md`:新增“用户端 API”章节,覆盖登录/首页/评估/个人中心/估值记录/通知/批量与异步,与错误码和校验对齐。 * 修改 `web/docs/接口约定与预留.md`:新增“前端对接(用户端)”章节,列出与 `web/src/api/index.js` 的映射与新增端点占位,确保路径与请求方式一致。 ## 文档结构变更 * `app/docs/接口约定与预留.md` * 新增: * “用户端 API 概览” * “认证与首页” * “评估提交与引导提示” * “估值记录与分享” * “个人中心:汇款凭证/发票抬头与类型/发票列表与详情” * “剩余估值次数”
* `web/docs/接口约定与预留.md` * 新增: * “用户端对接路径”与现有 `invoice/*`、`valuation/*`、`app-user/*` 的映射 * 新增端点建议(如 `app-valuation/*`、`invoice/headers`、`invoice/{id}/receipt`、`jobs/{id}`)的前端占位说明 ## 风格与格式 * 统一中文、RESTful端点风格,示例以JSON格式。 * 保持与现有文档用语一致(Success/Fail、token、code===200)。 ## 交付 * 完成上述两处文档更新,不新增新文档文件;更新内容可直接在IDE中查看。