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
+    }
+  ]
+}