门户 UI 改版（方案 B：侧边导航 + 工作台）

Goal

把首页从「14 张自由高度卡片平铺」改成「左侧分组导航 + 右侧等高工作台」，并加入模块点击埋点与个性化入口，使桌面端对齐、移动端可用、后续加模块只改一处配置。

Architecture

• adata/aohan/quant/portal/registry.py：模块注册表，唯一元数据源（id / 名称 / 图标 / 分组 / 路由 / 关键词 / 子链接 / 栅格跨度）。
• adata/aohan/quant/portal/module_events.py：module_events 表 + 点击写入 + 最近使用 / 常用排行查询。
• adata/aohan/quant/portal/home_page.py：新首页渲染器（侧边栏 + 工作台 + 搜索 + 最近/常用 + 分组全部模块）。
• unified_server.py：

- GET / 改用 render_home(...)，继续复用原有动态片段（截面、推送、余额、系统状态、择时链接）； - 新增 POST /api/track/module-click； - 原有 /api/module-order 保持不变。

• 配色：暗色为默认，墨蓝黑底 + 暖白正文 + 琥珀金强调；保留 --bg/--text/--accent... 变量名，避免动态片段样式失效。

Tech Stack

Python 3.12 · 原生 http.server · SQLite(WAL) · 无前端框架（内联 HTML/CSS/JS）

Tasks

1. 模块注册表

• 新建 portal/registry.py：Module dataclass、MODULES、GROUPS、DEFAULT_ORDER、get_module()、grouped_modules()、search_modules()。
• 覆盖现有 14 个模块 id，顺序与 user_config.DEFAULT_MODULE_ORDER 对齐。
• 测试：id 唯一、分组合法、默认顺序完整。

2. 点击埋点

• 新建 portal/module_events.py：module_events(id, ts, day, username, module_id, source) + 索引。
• record_event() / top_modules(days, username, limit) / recent_modules(username, limit) / cleanup_old()。
• 测试：临时 DB 写入后 top/recent 顺序正确，未知模块 id 被拒绝。

3. 工作台首页

• 新建 portal/home_page.py：render_home(...)。
• 布局：固定侧边栏（桌面）/ 抽屉（移动）+ 顶部栏 + 问候与今日概览 + 最近/常用 chips + 12 列固定行高网格 + 分组全部模块 + 全局搜索。
• 网格行高固定（236px），卡片 overflow:auto，行与行严格对齐。
• 复用动态片段：cs / stock / timing / push / balance / stat / clip。
• 测试：渲染结果包含全部模块名、无 __PLACEHOLDER__ 残留、每张卡有 data-module-id。

4. 接入服务端

• unified_server.py 导入 render_home / record_event / top_modules / recent_modules。
• GET /：组装 stats / blocks，调用 render_home。
• POST /api/track/module-click：校验 module_id，记录事件，返回 {"ok": true}。
• 保留 _edge_cache = True。

5. 前端交互

• 全局点击监听 [data-module-id] → sendBeacon 上报。
• 匿名用户 localStorage 记录最近模块。
• 侧边栏搜索过滤 + 键盘 / 聚焦。
• 移动端抽屉开关、遮罩、Esc 关闭。

6. 验证

• env -u PYTHONHOME -u PYTHONPATH .venv/bin/python -m pytest adata/aohan/quant/portal/test_portal.py -q
• env -u PYTHONHOME -u PYTHONPATH bash restart.sh
• curl -s http://127.0.0.1:8765/ | head 验证 200 且包含新布局
• curl -s -X POST http://127.0.0.1:8765/api/track/module-click -d '{"module_id":"cs"}'
• 浏览器实测桌面端行对齐、移动端抽屉与滚动。