migration: preserve market insights slice

2026-07-31 02:41:56 +08:00
parent 814e75730a
commit cf2aad28ec
30 changed files with 2487 additions and 1759 deletions
@@ -0,0 +1,69 @@
+# 切片 05：集合竞价、题材库、人气热榜与龙虎榜
+
+> 基线：`814e757`（切片 04）
+> 回档标签：`xiaobai-preservation-slice-05-20260731`
+> 结论：源码、API、数据库、真实页面和全量回归通过；最终视觉仍等待全站人工验收
+
+## 1. 原实现归位
+
+本切片没有从`next/`取用代码，也没有重写计算、页面或接口。集合竞价、题材库和人气热榜原本
+共享`MarketInsightsService`，其中竞价候选会直接调用人气榜热度数据，因此整体移动到公共行情
+领域，避免拆出互相复制的实现；各页面入口仍按功能目录归位。
+
+| 原位置 | 新的唯一实现位置 | 兼容方式 |
+|---|---|---|
+| `app/market_insights.py` | `app/backend/features/market/insights.py` | 根级模块导出同一类对象 |
+| `DashboardService`竞价入口 | `app/backend/features/auction/service.py` | `AuctionServiceMixin` |
+| `DashboardService`题材入口 | `app/backend/features/themes/service.py` | `ThemeServiceMixin` |
+| `DashboardService`人气入口 | `app/backend/features/popularity/service.py` | `PopularityServiceMixin` |
+| `DashboardService`龙虎榜及游资档案 | `app/backend/features/dragon_tiger/service.py` | `DragonTigerServiceMixin` |
+| 竞价、人气、龙虎榜持久化方法 | 对应功能目录的`repository.py` | `ReviewDatabase`继承原接口 |
+
+Tushare Provider 中`hot_money_profiles`与`dragon_tiger`继续保持切片02归位的唯一实现，没有为目录
+形式再制造一套数据构造逻辑。
+
+## 2. 源码与接口等价
+
+- `test_preservation_slice_market_insights.py`逐项比较22个市场洞察方法、8个页面服务方法、7个
+  Repository方法和2个Tushare方法，全部与根目录原版无位置信息AST一致。
+- `DashboardService`与`ReviewDatabase`不再重复保留已移动方法；根级`market_insights`与新模块
+  暴露同一个`MarketInsightsService`类对象。
+- 原版`8784`和迁移版`8785`使用同一数据库的独立副本，集合竞价、题材库、题材详情、人气热榜、
+  龙虎榜、游资档案和席位别名共7个真实API状态码及JSON一致。
+- 题材详情在当前外部网络条件下两版均返回HTTP 400；差分只排除每次请求随机生成的
+  `request_id`，错误码与错误内容仍完全一致。
+- 完整接口摘要见`api-diff.json`。
+
+## 3. 数据库差分
+
+- 两个副本均为62个schema对象，哈希均为
+  `60a4e044f0ddb6502e44b45f65bedc1a0a31d4bd596f386d4ccfe153a6c8ddd1`。
+- `auction_factors` 511914行、`popularity_factors` 232行、`lhb_institution_daily` 47行、
+  `seat_aliases` 0行、`stock_master` 5535行均逐行一致。
+- 完整表计数与哈希见`database-diff.json`；运行数据库副本已在验收后删除，未提交凭据或正式数据。
+
+## 4. 真实浏览器检查
+
+- 1920×1080日间模式检查集合竞价、题材库、人气热榜和龙虎榜四页；均无横向溢出，控制台无
+  错误或警告。
+- 集合竞价载入30行重点候选；题材库载入394个题材及选中题材成分股；人气热榜载入3个摘要
+  模块和200行综合榜；龙虎榜按当前缓存显示既有不可用空态。
+- 四页HTML、主JS、CSS及各自页面JS与根目录原版字节哈希一致。
+- 截图SHA-256：
+  - `app-light-auction-1920x1080.png`：`8065086c8f2b360aeb1004bd60429f3e2d7f1b8c872ec4a965e9a5d0c016b915`
+  - `app-light-themes-1920x1080.png`：`80e1e41101497ee7213e1dadfaa4c9572a1c47b3495edd09e36745ccdb639402`
+  - `app-light-popularity-1920x1080.png`：`614d6b7770f4e9ec72c059ab8a4129486df9eff5c4dd7e8279cc68ebcb80a36b`
+  - `app-light-dragon-tiger-1920x1080.png`：`2f1e2ad3a9bc3874c73bae884fc8744177cef354c7176559da1453fab1f85993`
+
+## 5. 自动验证与保留边界
+
+| 验证 | 结果 |
+|---|---:|
+| `python -m unittest discover -s tests -q` | 258项通过 |
+| `python -m unittest tests.test_preservation_slice_market_insights -q` | 6项通过 |
+| `npx.cmd playwright test --reporter=dot` | 45项通过 |
+| `git diff --check` | 通过 |
+
+- 竞价、人气和龙虎榜因子同时服务切片06智能选股，迁移后仍由`ReviewDatabase`原方法名暴露。
+- 前端资产保持原位置，切片10再按页面职责归档；本切片没有改DOM、CSS、动画或交互。
+- 没有删除待定代码、没有修改根目录正式数据库、没有切换Docker/NAS。
@@ -0,0 +1,61 @@
+{
+  "all_equal": true,
+  "endpoints": [
+    {
+      "endpoint": "/api/auction?trade_date=2026-07-29",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "523144cc14d876577b7d518cdf38fd2722b13a8f01ed5d2e20dcc38f6a2624ce",
+      "migrated_sha256": "523144cc14d876577b7d518cdf38fd2722b13a8f01ed5d2e20dcc38f6a2624ce",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/themes?trade_date=2026-07-29",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "95c2ad418f18d877d94ec2a71fe6fafd5e329b069d87a9300f7fcac92d4ba5d1",
+      "migrated_sha256": "95c2ad418f18d877d94ec2a71fe6fafd5e329b069d87a9300f7fcac92d4ba5d1",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/themes/detail?code=885001.TI&trade_date=2026-07-29",
+      "original_status": 400,
+      "migrated_status": 400,
+      "original_sha256": "b11a3314b172d3ad6ba28d969fcd6a9a2a4b49e7d29ed804496a4dfecd2a364a",
+      "migrated_sha256": "b11a3314b172d3ad6ba28d969fcd6a9a2a4b49e7d29ed804496a4dfecd2a364a",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/popularity?trade_date=2026-07-29",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "e62a93c41f7c3f95c3d47f8ccaedaa809563c8dd65c04dd54b164f73e6014e94",
+      "migrated_sha256": "e62a93c41f7c3f95c3d47f8ccaedaa809563c8dd65c04dd54b164f73e6014e94",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/dragon-tiger?trade_date=2026-07-29",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "a3998b935377d5fd0673ec5b9214d1b0a64680d155c61e6cff49d0d5fcf0e843",
+      "migrated_sha256": "a3998b935377d5fd0673ec5b9214d1b0a64680d155c61e6cff49d0d5fcf0e843",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/dragon-tiger/profiles",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "dfb1e534c018ec12fd8d8ee0e7fe0f234e73dc7715d7f0a948f74ef8d12d779a",
+      "migrated_sha256": "dfb1e534c018ec12fd8d8ee0e7fe0f234e73dc7715d7f0a948f74ef8d12d779a",
+      "equal": true
+    },
+    {
+      "endpoint": "/api/seat-aliases",
+      "original_status": 200,
+      "migrated_status": 200,
+      "original_sha256": "2b0fb0a6b3e353c69158d61221c2200e4199d0d60dd0b9d99702a22eaa917a78",
+      "migrated_sha256": "2b0fb0a6b3e353c69158d61221c2200e4199d0d60dd0b9d99702a22eaa917a78",
+      "equal": true
+    }
+  ]
+}
@@ -0,0 +1,51 @@
+{
+  "all_equal": true,
+  "schema": {
+    "object_count": 62,
+    "original_sha256": "60a4e044f0ddb6502e44b45f65bedc1a0a31d4bd596f386d4ccfe153a6c8ddd1",
+    "migrated_sha256": "60a4e044f0ddb6502e44b45f65bedc1a0a31d4bd596f386d4ccfe153a6c8ddd1",
+    "equal": true
+  },
+  "tables": [
+    {
+      "table": "auction_factors",
+      "original_count": 511914,
+      "migrated_count": 511914,
+      "original_sha256": "3d0470787adaf7c4cf5f15f5ad9fa1d67c8fcd4807285ac264eeacdcf5054cd1",
+      "migrated_sha256": "3d0470787adaf7c4cf5f15f5ad9fa1d67c8fcd4807285ac264eeacdcf5054cd1",
+      "equal": true
+    },
+    {
+      "table": "popularity_factors",
+      "original_count": 232,
+      "migrated_count": 232,
+      "original_sha256": "3f4c61a13ceaa1ed9ecb28f86241a8a478a6757d6a44b46f432f73c0226bba7f",
+      "migrated_sha256": "3f4c61a13ceaa1ed9ecb28f86241a8a478a6757d6a44b46f432f73c0226bba7f",
+      "equal": true
+    },
+    {
+      "table": "lhb_institution_daily",
+      "original_count": 47,
+      "migrated_count": 47,
+      "original_sha256": "1f847eac34d2ba576b429da208667f3b67b591d36ee66800803605bbc447970c",
+      "migrated_sha256": "1f847eac34d2ba576b429da208667f3b67b591d36ee66800803605bbc447970c",
+      "equal": true
+    },
+    {
+      "table": "seat_aliases",
+      "original_count": 0,
+      "migrated_count": 0,
+      "original_sha256": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
+      "migrated_sha256": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
+      "equal": true
+    },
+    {
+      "table": "stock_master",
+      "original_count": 5535,
+      "migrated_count": 5535,
+      "original_sha256": "8656e2d189d3520433fb3552e17998e4bf17bcf6838403cddc6719282b23e792",
+      "migrated_sha256": "8656e2d189d3520433fb3552e17998e4bf17bcf6838403cddc6719282b23e792",
+      "equal": true
+    }
+  ]
+}
@@ -1,6 +1,6 @@
 {
  "schema_version": 1,
-  "updated_at": "2026-07-31T01:57:00+08:00",
+  "updated_at": "2026-07-31T02:42:00+08:00",
  "status": "active",
  "migration_mode": "behavior_preserving_source_migration",
  "source_of_truth": "current_original_webapp_runtime_and_source",
@@ -9,10 +9,10 @@
  "failed_roots": [
    "next"
  ],
-  "current_slice": "slice-05-auction-themes-popularity-dragon-tiger",
-  "last_completed_slice": "slice-04-ladder-rotation",
-  "last_checkpoint": "xiaobai-preservation-slice-04-20260731",
-  "next_action": "capture_slice-05_auction_theme_popularity_dragon_tiger_contracts_then_move_original_implementations",
+  "current_slice": "slice-06-screener-custom-tracking",
+  "last_completed_slice": "slice-05-auction-themes-popularity-dragon-tiger",
+  "last_checkpoint": "xiaobai-preservation-slice-05-20260731",
+  "next_action": "capture_slice-06_screener_custom_selection_and_tracking_contracts_then_move_original_implementations",
  "authoritative_documents": [
    "AGENTS.md",
    "docs/migration/原版保真迁移总纲.md",
@@ -1,6 +1,6 @@
 # 小白复盘保真迁移账本

-> 当前状态：正式迁移，切片04“市场天梯与板块轮动”已完成
+> 当前状态：正式迁移，切片05“集合竞价、题材库、人气热榜与龙虎榜”已完成

 本账本是上下文恢复和人工审计的连续记录。任何迁移提交必须在同一提交中更新本文件及
 `保真迁移状态.json`。
@@ -24,6 +24,7 @@
 | 2026-07-31 | `xiaobai-preservation-slice-02-20260731` | 公共行情、搜索、详情、图表与数据适配原实现归位 | 自动与浏览器差分通过，进入切片03 |
 | 2026-07-31 | `xiaobai-preservation-slice-03-20260731` | 情绪周期、五类股池与涨停表现原实现归位 | 自动、API与浏览器差分通过，进入切片04 |
 | 2026-07-31 | `xiaobai-preservation-slice-04-20260731` | 市场天梯与板块轮动原实现归位 | 自动、API与浏览器差分通过，进入切片05 |
+| 2026-07-31 | `xiaobai-preservation-slice-05-20260731` | 集合竞价、题材库、人气热榜与龙虎榜原实现归位 | 自动、API、数据库与浏览器差分通过，进入切片06 |

 ## 资产处置登记

@@ -43,6 +44,10 @@
 | `ReviewDatabase`原因覆盖方法 | 持久化 | 股池原因人工覆盖 | 按职责机械移动 | `app/backend/features/pools/repository.py` | 2个方法AST与原版一致；数据库schema哈希一致 | 已移动 |
 | `DashboardService`板块轮动方法 | 业务服务 | 板块轮动页 | 按职责机械移动 | `app/backend/features/rotation/service.py` | 2个方法AST、真实API与原版一致 | 已移动 |
 | Tushare天梯与轮动构造函数 | 公共数据计算 | 市场天梯、板块轮动 | 原位置保持唯一实现 | `app/backend/data/providers/tushare_client.py` | 2个构造函数AST与原版一致 | 已归位 |
+| `MarketInsightsService` | 共享市场洞察服务 | 集合竞价、题材库、人气热榜 | 整体机械移动，保留唯一共享实现 | `app/backend/features/market/insights.py` | 22个方法AST与原版一致；根级模块为同一类对象别名 | 已移动 |
+| `DashboardService`竞价、题材、人气与龙虎榜方法 | 业务服务 | 切片05四类页面与API | 按职责机械移动 | `app/backend/features/auction/`、`themes/`、`popularity/`、`dragon_tiger/` | 8个方法AST、7个真实API与原版一致 | 已移动 |
+| `ReviewDatabase`竞价、人气与龙虎榜方法 | 持久化 | 市场洞察及后续智能选股 | 按职责机械移动并保持Mixin原接口 | `app/backend/features/auction/repository.py`、`popularity/repository.py`、`dragon_tiger/repository.py` | 7个方法AST一致；62个schema对象及5张关键表逐行一致 | 已移动 |
+| Tushare游资名录与龙虎榜实现 | 公共数据计算 | 龙虎榜与游资档案 | 原位置保持唯一实现 | `app/backend/data/providers/tushare_client.py` | 2个方法AST与原版一致 | 已归位 |

 处置只允许：`原样保留`、`移动`、`合并重复`、`待定`、`确认废弃`。

@@ -100,6 +105,16 @@
 - 回档：标签`xiaobai-preservation-slice-04-20260731`。
 - 完整证据：`docs/migration/evidence/slice-04/README.md`。

+已完成切片：`slice-05-auction-themes-popularity-dragon-tiger`。
+
+- 原版基线：提交`814e757`，即切片04回档点。
+- 迁移范围：共享市场洞察服务、竞价/题材/人气入口、龙虎榜与游资档案服务、7个相关持久化方法。
+- 兼容边界：根级`market_insights.py`保留同一类对象别名；竞价与人气共用候选热度逻辑，不复制第二套实现。
+- API与数据库：7个真实API逐字段一致，仅排除每次请求必然变化的`request_id`；62个schema对象与5张关键表完全一致。
+- 验收：258项Python测试、6项切片源码等价测试、45项Playwright测试及四个真实页面流程通过。
+- 回档：标签`xiaobai-preservation-slice-05-20260731`。
+- 完整证据：`docs/migration/evidence/slice-05/README.md`。
+
 ## 决策记录

 | 日期 | 决策 | 原因 |