P0相关页面
认证与账号
验证码登录退出登录当前用户通知中心
POST /api/auth/codePOST /api/auth/loginPOST /api/auth/logoutGET /api/auth/mePATCH /api/notifications/:id
移动端需保存 HttpOnly Cookie 等价凭证；如果改 Token，需要后端兼容 Authorization。
App API
Web 功能稳定后，先把 App 接口边界定清楚。
按移动端模块梳理接口、页面、鉴权和开发顺序，后续 Android 客户端可以直接按 P0/P1 拆任务。
移动端闭环
1
登录
2
咨询
3
下单支付
4
我的进度
App API 对接清单
面向 Android 开发的接口分层、页面映射和上线优先级。
Android 准备
按 App 模块拆接口，后续可以直接进入移动端开发。
优先保证 P0 用户闭环：登录、咨询、律师、订单支付和我的进度；企业能力作为 P1 复用 Web 已有接口。
7模块
P0相关页面
AI 咨询与案件报告
AI 咨询追问补充案件报告知识库参考
POST /api/ai/consultPOST /api/ai/intakePOST /api/ai/case-reportGET /api/legal-knowledge
当前 AI 是规则版，App 先按结构化结果渲染，后续替换大模型不影响字段。
P0相关页面
律师匹配与预约
律师列表律师详情可约时段预约下单律师评价
GET /api/lawyers/matchGET /api/lawyers/availabilityPOST /api/ordersGET /api/lawyer-reviewsPOST /api/lawyer-reviews
预约时段由订单占用扣减，App 需在支付前刷新可用时段。
P0相关页面
订单、支付与服务包
服务目录订单确认收银台支付结果服务包权益
GET /api/legal-servicesPOST /api/ordersPOST /api/payments/sessionPOST /api/payments/confirmGET /api/service-packagesPOST /api/package-subscriptions
真实支付 SDK 接入后，App 负责调起渠道支付，服务端仍统一处理会话、回调和状态。
P0相关页面
我的进度与交付件
进度流订单详情合同报告文书下载签收回执
GET /api/meGET /api/orders/:idGET /api/document-drafts/:id/downloadPOST /api/document-drafts/:id/confirmGET /api/contract-reviews/:id/downloadPOST /api/contract-reviews/:id/confirm
下载接口可能返回 HTML/PDF/Word 兼容内容，App 需走系统浏览器或文件预览。
P1相关页面
企业工作台
企业套件企业工单风险地图合同台账材料库服务报告
POST /api/business-ticketsGET /api/meGET /api/enterprise-reportsGET /api/enterprise-reports/downloadPOST /api/contract-reviews
企业模块先复用 /api/me 聚合数据，后续可拆专用 mobile dashboard 接口。
P1相关页面
材料上传与 OCR
材料上传直传凭证证据识别材料下载
POST /api/uploadsPOST /api/uploads/presignPUT /api/uploads/presignPOST /api/cases/:id/evidencePOST /api/cases/:id/evidence/:evidenceId/analyze
移动端大文件优先 OSS 直传；本地规则识别可先展示摘要，真实 OCR 后替换结果来源。
开发顺序
先做能形成收入闭环的路径，再扩展企业和交付体验。
P0：登录、AI咨询、律师匹配、下单支付、我的进度P1：文书/合同交付、企业套件、材料上传P2：离线缓存、推送通知、真实 IM/电话/视频P3：Android 原生支付、文件预览优化、企业多角色协作
移动端鉴权约定
当前 Web 以 Cookie session 为主；App 开发前建议确认是否新增 Bearer Token。
生产环境可开启 REQUIRE_CLIENT_AUTH 强制登录敏感下载接口需要登录用户或 q 查询标识匹配归属统一错误格式为 { "error": "错误说明" }