# 保真迁移目标目录与切片顺序

> 状态：已由用户确认
> 生效日期：2026-07-30

本文件把已批准的`app/`目标结构和迁移顺序固化为可恢复约束。目录只表达职责，迁移时从
原版复制、移动和拆分真实实现；禁止先建立空业务骨架后按规格书重写。

## 目标目录

```text
app/
  server.py                    # 最终仅保留进程入口与HTTP服务器组装
  backend/
    bootstrap/                 # 路径、环境、配置和依赖容器
    http/                      # 路由、鉴权、响应、静态资源和通用传输能力
    features/
      accounts/                # 登录、账号、会员及用户身份
      system/                  # 管理员配置和运行状态
      market/                  # 公共行情、搜索、详情和图表
      sentiment/               # 情绪周期
      pools/                   # 涨停、炸板、跌停、昨日涨停和涨停表现
      ladder/                  # 市场天梯
      rotation/                # 板块轮动
      auction/                 # 集合竞价
      themes/                  # 题材库
      popularity/              # 人气热榜
      dragon_tiger/            # 龙虎榜与游资档案
      screener/                # 阶段、策略、自定义选股及持续跟踪
      mentor/                  # 问师
      heaven/                  # 观势、观气、观心
      review/                  # 自选、复盘笔记、交易日志和复盘助手
      alerts/                  # 提醒中心
    data/                      # 统一数据网关、口径、质量和供应商适配
    database/                  # 连接、迁移和领域Repository
    jobs/                      # 后台任务定义、状态、调度和重试
    llm/                       # 唯一模型网关、流式协议和调用审计
  frontend/
    index.html                 # 原版DOM骨架；仅在等价验证后拆分
    shared/                    # API、状态、Shell、弹窗和通用组件
    pages/<feature>/           # 页面自己的行为与样式
    styles/                    # 令牌、基础层、Shell和经验证后的公共样式
    vendor/                    # 浏览器端第三方静态资产
  config/                      # 页面、功能、API、任务及数据字段注册表
  data/                        # SQLite及私有运行数据，保持Git忽略
  tests/                       # 单元、契约、差异和浏览器回归
  tools/                       # 清查、迁移、差异验证和维护工具
  vendor/                      # Python离线依赖
  游资skills/                 # 原版公开Skill；私有Skill仍位于data/
```

允许迁移期间保留根级兼容外壳；外壳只能转发到唯一实现，并须在账本登记删除条件。

## 固定切片顺序

| 切片 | 完整纵向范围 |
|---:|---|
| 00 | 原版可运行副本、资产清单、数据库副本和视觉基线 |
| 01 | 启动、HTTP通用能力、登录账号、会员和系统管理 |
| 02 | 公共行情、全局搜索、详情、悬浮图表、数据网关和数据质量 |
| 03 | 情绪周期、五类股池和涨停表现 |
| 04 | 市场天梯和板块轮动 |
| 05 | 集合竞价、题材库、人气热榜和龙虎榜 |
| 06 | 智能选股、自定义选股和策略持续跟踪 |
| 07 | 问师、模型Skill和LLM流式链路 |
| 08 | 问天：观势、观气和观心 |
| 09 | 我的复盘、自选、笔记、交易日志、提醒和复盘助手 |
| 10 | 前端Shell、页面文件、共享组件、CSS层级和移动端职责归位 |
| 11 | 待定代码试删、全量并行验收、维护文档和切换准备 |

每个切片先记录原版证据，再移动实现，再执行同输入差异；未通过时不得进入下一切片。
