# 实现与验证

Type: task
Status: resolved

按 spec.md 实现模型/接口、同步 CLI、页面及研究/AI/MCP 接入，更新测试和部署说明。

## Comments

- 开始实施；工作区初始无改动。

- 完成模型与迁移 0015、集合/字段 API、完整同步 CLI、新页面与公共选择器、研究及 AI/MCP 输入快照接入；旧输入模型及接口已移除。
- 全量同步复用账户事务锁实现同范围并发去重；重试也复用活动任务。逐集批次独立发布，保留分页检查点、失败原因和上一完整版本；连接故障暂停，等待超时不取消后台任务。

## Answer

已完成本地实现与隔离验收，未提交或部署。

验证证据：

- `uv run ruff check app tests`：通过；`git diff --check`：通过。
- 后端全量 `uv run pytest -q`：420 项通过。之后的任务重试/CLI修改定向回归 62 项通过；补强模型不能追加准备集合的输入边界后，研究工作区 35 项通过。
- `pnpm build`：通过，保留已有 bundle 大小与 lottie eval 警告。
- Playwright：相关 15 项全部通过，覆盖数据目录、在线字段跨页多选、集合编辑、公共选择器、特征转换、模板/变体 AI、回测及来源快照、流水线、QuantFlow、导航和工作区；范围选项刷新调整后，再跑数据目录 2 项通过。已查看字段目录截图。
- PostgreSQL 17 独立空库：0014 → 0015 迁移与 Alembic metadata check 通过；旧目录分页 offset 保留、旧输入表移除、分类筛选和分页、五路并发任务去重及冻结、删除集合后快照保留均通过。对应脚本 `backend/tests/preparations_postgres.py`，测试容器已清理。
- CLI 隔离测试覆盖状态退出码、活动任务复用、超时、续页、网络暂停和重试；无效 delay/NaN 或零等待时间的实际进程退出码均为 2。
- 生产说明已补充 1Panel 的 docker exec、日志、恢复命令、六小时默认等待和全部退出码；README 与 MCP 文档同步更新。

边界：全部上游为模拟数据，没有调用真实 WorldQuant，也没有配置或触发 1Panel 调度。真实平台过滤/分页协议、范围权限及调度效果需单独联调。迁移按用户确认不兼容旧研究输入，回退需要升级前数据库备份。