## 目标 - 汇总所有前后端需求与 API 到一个文档,其他分散文档删除,仅保留总览,便于统一查看与维护。 ## 操作与产物 - 新增单一文档:`docs/估值二期-需求与API总览.md` - 内容包含: 1) 概述与约定(认证、响应包装、错误码、前缀) 2) 数据实体(InvoiceHeader、PaymentReceipt、TransactionRecord、Valuation、AppUser、Complaint、SMSMessage)与字段定义 3) 用户端流程与 API(登录/首页摘要、评估提交/校验/状态、估值记录下载与分享、个人中心-对公转账、发票抬头/类型、发票列表与详情、剩余次数、投诉与短信、批量与异步Job) 4) 管理端流程与 API(交易管理记录:列表/详情/状态/邮件/开票/批量;审核列表;用户管理) 5) 前端对接映射(`web/src/api/index.js` 现有与新增占位) 6) 请求/响应示例与字段校验(重点:抬头管理、对公转账、交易管理记录) 7) 性能与限制(分页、异步、频率) - 删除分散文档: - `web/docs/项目结构.md`、`web/docs/技术架构.md`、`web/docs/关键模块说明.md`、`web/docs/接口约定与预留.md` - `app/docs/项目结构.md`、`app/docs/技术架构.md`、`app/docs/关键模块说明.md`、`app/docs/接口约定与预留.md` ## 你提出的新增明确项(将详列在文档中) - 抬头管理字段(必填项标注):公司名称、公司税号、注册地址、注册电话、开户银行、银行账号、邮箱 - 对公转账(用户端):上传图片(付款凭证)+ 选择发票抬头 + 开票类型(电子/纸质、专票/普票) - 交易管理记录(管理端):提交时间、付款凭证、手机号、微信号、公司名称、公司税号、注册地址、注册电话、开户银行、银行账号、接收邮箱、开票类型、状态 - 状态枚举:pending/verified/issued/rejected 等 ## 执行步骤 1. 创建总览文档并写入上述结构内容与端点清单 2. 迁移现有 app/web 文档中的有效信息到总览文档 3. 删除分散文档,仅保留总览 ——请确认上述方案,确认后我将生成唯一的总览文档并删除分散文档。