# 私有资料上传实施计划

按已批准的[简化方案](../specs/2026-10-12-private-documents-design.md)直接实施，本轮不重新设计、不提交代码。

- [x] 后端：`PrivateDocuments.php`、`v1/Documents.php`、`extra/private_documents.php`、三条路由及单表 SQL。复用 Auth/Token、Secret、documents 同意记录；默认关闭且私有目录留空。先写隔离 HTTP 测试，再实现。
- [x] 前端：新增 `services/documents.uts`，复用现有资料卡片及协议服务，区分本机待上传与服务端 ID；手动重试、本人鉴权下载/删除、会话及离页迟到回包防护；复用同意读取恢复全部本人ID，照片直接显示在原卡片，通过卡片菜单管理，不加下方列表。
- [x] 评估：资料单独保存、暂不绑定或参与分析；确认页明示此边界，仅已取得合法 ID 的资料可以绕过旧“上传未开放”提示，外部授权仍拒绝；服务端继续拒绝非空评估附件。
- [x] 验证：全新本机合成 MySQL/Redis/私有目录；上传、读取、删除、同意及归属、大小/格式、故障重试；纯 UTS 会话/页面测试、Android/微信编译、拦截全部 API 的受控 H5 页面。
- [x] 收尾：核验合成数据及所属服务清理，更新进度、交接及验证记录。用途、期限、正式私有目录、正式协议和真机验收留待启用前确定；生产、短信和模型全程不连接。