本目录是 2026-06 完成的 vNext 重构归档。当前生产架构入口是
docs/architecture.md；本目录只保留迁移规格、过程记录和验证历史。
docs/architecture.md是项目顶层架构入口，描述当前生产架构。docs/finished/refactor/vnext-2026-06/*是本轮完成归档。docs/finished/referactor/*是更早历史参考，不再作为当前实施依据。
本轮重构的核心不是换目录名，而是：
- 收口业务入口，避免
app.py、gui.facade.py、library.manager.py等兼容层继续承载新业务。 - 隔离可重建扫描事实与不可丢失的用户状态。
- 统一后台任务、扫描、仓储、缩略图、People、Maps、Edit 等能力的应用层边界。
- 让 GUI 只做 presentation 和 Qt 适配，业务规则进入 use case / application service。
01-target-architecture-vnext.md：目标架构和关键数据流。02-detailed-requirements.md：功能、非功能、边界和验收需求。03-development-roadmap.md：阶段规划和迁移策略。04-implementation-checklist.md：逐阶段执行清单、完成条件和回归测试。05-current-progress.md及06之后的编号文档：当前状态和过程性交接记录。
当前架构方向正确，但还不是最终最优目标。项目已经有 Clean Architecture、 MVVM、RuntimeContext、global SQLite index、People、Maps、GPU editing 等基础， 但仍存在双仓储、双扫描路径、compat shim、直接 singleton 访问和跨层导入。
因此，本轮重构应以“行为收口”和“状态边界清晰”为第一优先级。旧文档中类似 “所有文件小于 300 行”“EventBus 使用率 100%”这类机械指标只作为历史参考； 新的验收标准以边界清晰、行为一致、关键路径测试覆盖和性能不回退为准。