# 历史项目导入新项目设计记录

## 本次改动

- 新增设计文档 `docs/design/2026-03-29-project-import-history-design.md`
- 明确历史项目导入弹窗采用“新项目配置在上、历史项目列表在下”的纵向布局
- 明确历史项目支持多选，且仅允许选择“已完成”“已归档”项目
- 明确新项目固定走现有 `createProject` 默认参数链路
- 明确时间过滤固定按 `trxDate`
- 明确跨来源项目重复流水按现有唯一性口径去重
- 明确仅复制 `parsed_success` 且实际贡献导入流水的文件记录
- 明确历史导入记录需补充来源标识，并在前端只读展示
- 明确历史导入生成的文件记录不支持删除

## 设计结论

- 采用“同步创建新项目 + 异步历史导入任务”的实现路径
- 不将历史导入伪装为普通文件上传
- 复用现有项目状态轮询、自动打标、结果表刷新和统计刷新链路
- 后续实施阶段需要分别输出前端、后端两份实施计划

## 审阅说明

- 按仓库约束，本次未启用 subagent
- 已按设计文档审阅清单完成人工检查，重点确认了完整性、一致性、范围收敛和无额外兜底方案
