From 6aacd380bb0088584a69781d2642c06b45f1da38 Mon Sep 17 00:00:00 2001 From: yuxuanhui Date: Mon, 10 Aug 2026 11:11:24 +0800 Subject: [PATCH] chore(task): archive 08-09-prototype-driven-frontend-adjustments --- .../check.jsonl | 7 + .../design.md | 139 ++++++++++++++++++ .../implement.jsonl | 7 + .../implement.md | 80 ++++++++++ .../prd.md | 87 +++++++++++ .../task.json | 26 ++++ 6 files changed, 346 insertions(+) create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/check.jsonl create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/design.md create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.jsonl create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.md create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/prd.md create mode 100644 .trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/task.json diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/check.jsonl b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/check.jsonl new file mode 100644 index 0000000..d444412 --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/check.jsonl @@ -0,0 +1,7 @@ +{"file":".trellis/spec/frontend/quality-guidelines.md","reason":"执行 format、lint、typecheck、Vitest 和 build，并按用户可见行为检查新增状态。"} +{"file":".trellis/spec/frontend/component-guidelines.md","reason":"检查应用壳、表格、分页、Dialog、移动记录卡的语义结构、focus、键盘和触控命中区域。"} +{"file":".trellis/spec/frontend/state-management.md","reason":"检查分页 URL 状态、筛选/选中/展开局部状态和 React Query 服务器状态没有越界到 Zustand。"} +{"file":".trellis/spec/frontend/directory-structure.md","reason":"检查 app/layout、feature selection/home、shared/ui 的依赖方向和 HomeShell 清理结果。"} +{"file":".trellis/spec/guides/cross-layer-thinking-guide.md","reason":"确认本次只改变前端呈现，不破坏既有后端 HTTP、selection 类型、query 和状态契约。"} +{"file":".trellis/spec/guides/code-reuse-thinking-guide.md","reason":"检查新增 layout/pagination 是否是真实复用模块，避免把 selection 业务字段抽入 shared。"} +{"file":".trellis/tasks/archive/2026-08/08-09-responsive-frontend-design/prd.md","reason":"对照已确认的响应式验收、A+C 选型、无页面标题模块和移动端导航约束。"} diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/design.md b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/design.md new file mode 100644 index 0000000..3f83f61 --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/design.md @@ -0,0 +1,139 @@ +# 原型驱动的响应式前端生产迁移设计 + +## 1. 设计边界 + +本任务把已选定的 A+C 原型迁移到现有 React 应用，涉及应用级 layout、`/` 首页、`/selection` 选股结果页和 shared pagination。后端 API、领域计算、数据库和未实现的“行情数据/同步任务”页面保持不变。 + +原型只作为视觉和交互决策来源，不直接复制 HTML/CSS/JS。生产实现继续遵循 feature 垂直切片和现有 `shared/ui` primitives，确保服务器状态仍由 TanStack Query 管理。 + +## 2. 目标模块边界 + +```text +src/ +├── app/ +│ └── layout/ +│ ├── app-layout.tsx # 品牌、响应式导航、顶栏、Outlet、滚动边界 +│ ├── navigation.ts # 应用级导航与路由上下文模型 +│ └── page-layout.tsx # document/bounded-workspace 内容布局 +├── routes/ +│ └── route-tree.tsx # root → workspace pathless route → 页面路由 +├── features/ +│ ├── home/ +│ │ └── pages/home-page.tsx # 市场概览业务状态 +│ └── selection/ +│ ├── components/ +│ │ ├── selection-results-workbench.tsx +│ │ ├── signal-table.tsx +│ │ ├── signal-record-list.tsx +│ │ └── signal-detail-panel.tsx +│ └── pages/selection-results-page.tsx +└── shared/ui/ + └── pagination.tsx # 无业务语义的分页 primitive +``` + +`HomeShell` 在两个业务页面迁移后删除，避免生产中长期存在两套应用壳。`SystemStatusPage` 当前不在路由树中，不为了本任务引入第三套页面布局。 + +## 3. Layout seam 与路由集成 + +### 3.1 Pathless workspace route + +`route-tree.tsx` 把当前根路由改为：root route → `workspaceRoute`（只有 `id`，没有 URL path）→ `/` 和 `/selection`。`workspaceRoute` 使用 `AppLayout`，页面只负责业务内容，不再导入 `HomeShell` 或传 `activeSection`。 + +导航激活状态使用 TanStack Router 的 `Link`/active 状态和真实 route path 推导；导航模型只保存 `id`、`label`、`to`、图标和 availability，不读取 feature 数据。顶栏上下文由同一份 route presentation 映射集中提供：`/` 显示市场数据概览，`/selection` 显示知行 B1 执行结果。 + +### 3.2 AppLayout interface + +`AppLayout` 对页面的外部接口不暴露布局参数，只渲染 ``。内部统一负责： + +- 桌面 ≥1024px 的 232px 侧栏、品牌、主导航、低频入口和静态研究空间说明； +- 平板 768–1023px 的图标 rail，保留可访问名称； +- 移动 <768px 的紧凑顶栏、四项底部导航和“更多” sheet； +- 搜索和头像作为现有产品占位入口保留，不新增搜索业务； +- `min-height: 0`、`min-width: 0`、`svh` 和安全区 padding，确保 bounded 页面只有业务数据区滚动； +- 桌面/触控密度由 CSS breakpoint 控制，React render 不读取 `window.innerWidth`。 + +未实现的导航项继续使用禁用状态；移动端低频入口在 sheet 中以禁用或说明状态呈现，不创建虚假的路由。 + +### 3.3 PageLayout interface + +```tsx +interface PageLayoutProps { + mode?: "document" | "bounded-workspace" + actions?: React.ReactNode + metrics?: React.ReactNode + children: React.ReactNode +} +``` + +`PageLayout` 不渲染页面大标题、眉题或说明。`document` 模式用于首页等自然页面；`bounded-workspace` 模式用于选股主从数据区，形成 `AppLayout → main → PageLayout → data panel` 的连续高度链。页面只提供操作区、指标区和业务内容，布局内部处理 gutter、移动底部安全区、桌面剩余高度和断点堆叠。 + +## 4. Visual tokens 与 shared primitive 策略 + +在 `globals.css` 将原型 token 收敛为生产主题：暖白 canvas `#f5f1ec`、白色 surface、炭黑文字 `#111111`、灰色 hairline 和语义 success/warning/error。桌面工作台使用紧凑字号，不引入 `DESIGN.md` 中营销页的 display-xl/大面积留白。 + +现有 `Button`、`Input`、`Badge`、`Card`、`Dialog` 优先通过新增有限 variant 或组合 class 适配： + +- 桌面控件保持约 32px 密度；移动交互控件通过响应式 class 至少达到 44px 命中区域； +- 默认卡片和表格使用 hairline 层级，避免用常规阴影表达数据层级； +- 状态颜色不只依赖颜色，保留文字和 aria 语义； +- 只在确有跨 feature 复用时新增 `shared/ui/pagination.tsx`，不把 selection 字段或业务格式化放入 shared。 + +## 5. Selection 数据流与视图模型 + +```text +useSelectionResults / useSelectionRun + │ + ▼ + SelectionResults view model + │ + filters → current page slice → selected signal + ├───────────────┬────────────────┐ + ▼ ▼ ▼ + desktop table mobile records detail panel +``` + +- API 类型、查询和轮询逻辑保持在 `features/selection/api/`，不改 HTTP 契约。 +- 页面先对 `signals` 做名称/代码搜索和 category 筛选，再做客户端分页；过滤或 page size 改变时回到第 1 页。 +- `page` 与 `pageSize` 使用 selection route 的 validated search params，使分页链接可复现；搜索词、分类、详情选中和移动展开属于页面局部状态，不写 Zustand。 +- Desktop table 和 mobile record list 消费同一份当前页 slice。桌面列显示股票/代码、子信号、收盘价、关键详情；移动卡片首行显示股票/代码与价格，第二行显示 badge，详情默认折叠。 +- 详情面板以稳定 key `${ts_code}-${category}` 选中信号，显示股票、代码、子信号、收盘价、目标交易日、策略和 `details` 格式化结果。原型中没有后端契约支撑的置信度、数据状态和研究详情 CTA 不进入生产。 +- 当过滤、分页或异步结果导致当前选中项不在可见列表时，自动选择当前页第一条；无结果时详情面板呈现明确空状态。 +- 现有执行确认、运行中轮询、失败和查询错误由页面保留；状态反馈就地出现在操作/数据区域，不额外插入原型评审用的状态样例区。 + +### Pagination primitive + +```tsx +interface PaginationProps { + page: number + pageSize: number + total: number + pageSizeOptions?: readonly number[] + onPageChange: (page: number) => void + onPageSizeChange: (pageSize: number) => void +} +``` + +primitive 只负责范围文案、上一页/下一页、页码、每页数量、disabled 和 aria；selection feature 负责切片、筛选和导航 search params。 + +## 6. Responsive 与滚动契约 + +| 视口 | 应用壳 | 选股结果 | 滚动和触控 | +| --- | --- | --- | --- | +| ≥1024px | 232px 侧栏 + 顶栏 | 主列表/详情双栏 | 应用壳 bounded；仅列表数据行滚动 | +| 768–1023px | 64px 图标 rail + 顶栏 | 主从区域压缩，必要时详情随列布局调整 | 保持紧凑桌面逻辑，图标有可访问名称 | +| <768px | 紧凑顶栏 + 4 项底部导航 | 单列记录卡，详情折叠 | 自然页面滚动；内容预留底部安全区，控件 ≥44px | + +桌面 bounded chain 使用 `h-svh`、`overflow-hidden` 和 `min-h-0`，不使用 `calc(100vh - 固定像素)`。移动端通过 breakpoint 解除外层 bounded，恢复页面自然滚动，避免表格、分页和底部导航形成嵌套滚动。 + +## 7. Compatibility、迁移和回滚 + +- 保持 `/`、`/selection` URL 不变；query key、API 类型、执行确认和轮询行为不变。 +- 迁移顺序为 layout/route tree → shared tokens/primitives → HomePage → SelectionResultsPage/pagination → 删除 `HomeShell` → tests/quality gate。 +- 每一步都保留可回滚点：路由树可以恢复 root 直接挂载页面；selection pagination 可以退回完整 signals 表；视觉 token 仅影响前端 bundle，不涉及后端数据。 +- 本任务不提交、不推送、不发布；所有改动限定在当前仓库。 + +## 8. Risks and deferred items + +- 当前 API 返回完整信号列表，客户端分页只改善浏览，不解决传输量；服务端分页需后续基于真实数据规模重新设计契约。 +- 现有 shared primitives 的主题变量和默认阴影与原型不同，需通过实际页面测试确认无暗色主题回归；不为了本任务删除已有主题能力。 +- 真实浏览器视觉检查依赖可访问的本地 HTTP 开发地址；本轮最低质量证据以测试、构建和可审查 DOM/CSS 为准，若环境允许再补常见视口截图。 diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.jsonl b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.jsonl new file mode 100644 index 0000000..dcc2415 --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.jsonl @@ -0,0 +1,7 @@ +{"file":".trellis/spec/frontend/index.md","reason":"实现前确认 React feature 垂直切片、应用壳边界、同源 API 和质量入口。"} +{"file":".trellis/spec/frontend/directory-structure.md","reason":"将共享 layout、shared pagination、home/selection 业务组件放在正确边界，避免 shared 反向依赖 feature。"} +{"file":".trellis/spec/frontend/component-guidelines.md","reason":"约束语义 HTML、键盘可用性、aria、现有 Button/Card/Dialog 组合和 responsive 组件写法。"} +{"file":".trellis/spec/frontend/state-management.md","reason":"确认 route search、TanStack Query、页面局部交互与 Zustand 的状态归属。"} +{"file":".trellis/spec/frontend/type-safety.md","reason":"保持严格 TypeScript、API 类型边界和 route search 的可验证类型。"} +{"file":".trellis/spec/guides/code-reuse-thinking-guide.md","reason":"在新增 PageLayout、Pagination 和 token helper 前验证真实复用价值与边界。"} +{"file":".trellis/tasks/archive/2026-08/08-09-responsive-frontend-design/design.md","reason":"承接已确认的 A+C 方向、layout seam、响应式断点、分页接口和迁移顺序。"} diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.md b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.md new file mode 100644 index 0000000..575a8ea --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/implement.md @@ -0,0 +1,80 @@ +# 原型驱动的响应式前端生产迁移执行计划 + +## Scope + +在不改变后端契约和业务计算的前提下，完成共享应用壳、首页、选股结果页和客户端分页的生产迁移。实现前必须通过本任务最终规划摘要审批并执行 `task.py start`；本文件本轮只作为执行计划。 + +## Ordered checklist + +### 1. 预检与布局迁移 + +- [x] 执行 `trellis-before-dev`，重新读取 frontend spec 与相关 cross-layer/code-reuse 指南。 +- [x] 检查工作区，确认只包含本任务已创建的规划文件，不覆盖其他用户变更。 +- [x] 新增 `src/app/layout/navigation.ts`、`app-layout.tsx`、`page-layout.tsx`，定义导航模型、route context、桌面/平板/移动布局和滚动边界。 +- [x] 将 `routes/route-tree.tsx` 改为 root → pathless workspace → `/`、`/selection`，保持 URL 不变。 +- [x] 删除页面对 `HomeShell` 和 `activeSection` 的依赖，确认布局只通过 `` 组合页面。 + +### 2. 视觉 token 与 shared UI + +- [x] 按原型更新 `src/styles/globals.css` 的 canvas/surface/ink/hairline/semantic tokens 和基础排版。 +- [x] 只在需要时调整 Button/Input/Badge/Card/Dialog 的有限 variant 或响应式命中尺寸，保持现有 API 和暗色主题可编译。 +- [x] 新增 `src/shared/ui/pagination.tsx`，仅承载通用分页语义、范围文案、按钮禁用和 aria。 + +### 3. 首页迁移 + +- [x] 用 `PageLayout` 重组 `HomePage`，移除内容区重复标题说明，保留 overview query、加载/错误/无数据、状态标签和失败股票 Dialog。 +- [x] 让首页在 document 模式下自然滚动，验证桌面/移动导航和搜索/头像占位不回归。 +- [x] 更新 `home-page.test.tsx`，增加布局入口、页面上下文和关键状态的用户可见断言；保留原有失败弹窗行为断言。 + +### 4. 选股结果页迁移 + +- [x] 将执行条件/操作折叠为紧凑 action row，移除大标题、眉题和说明模块，保留日期、策略、执行、重跑确认和轮询状态。 +- [x] 把结果指标转换为原型的紧凑 metrics；保留 coverage、目标/参与/命中/信号计数和状态语义。 +- [x] 在 selection route 增加受控的 `page`/`pageSize` search params 解析和导航更新；不把结果数据写入 Zustand。 +- [x] 实现 feature-owned 筛选 view model、`SignalTable`、移动 `SignalRecordList` 和 `SignalDetailPanel`，三者消费同一当前页数据。 +- [x] 支持名称/代码搜索、category 筛选、分页、每页数量、选中行、移动详情展开、无匹配和无信号状态；不添加原型中的虚假详情字段或无后端 CTA。 +- [x] 保留多子信号分行、重跑确认、运行中轮询、查询错误、执行失败和失败列表行为。 +- [x] 更新 `selection-results-page.test.tsx`，覆盖分页/筛选/选中详情/移动记录展开及原有执行状态回归。 + +### 5. 收口与清理 + +- [x] 删除不再使用的 `features/home/components/home-shell.tsx` 及其 import；确认没有残留 `activeSection` 或旧布局引用。 +- [x] 检查 `rg` 结果，确认没有页面直接 `fetch`、没有新增业务代码进入 `shared/ui`、没有 `window.innerWidth` 响应式分支。 +- [x] 检查键盘 focus、Escape、Dialog focus、禁用按钮、aria label 和移动底部安全区。 + +## Validation commands + +在 `zhixing-web/` 下按顺序运行： + +```bash +pnpm format:check +pnpm lint +pnpm typecheck +pnpm test +pnpm build +``` + +针对任务的只读检查： + +```bash +rg -n "activeSection|HomeShell|window\.innerWidth|fetch\(" src +rg -n "min-w-\[720px\]|overflow-x-auto" src/features/selection src/app +``` + +如本地浏览器环境可访问 HTTP 开发服务器，再验证 1440×900、1280×800、768×1024、390×844、375×812：导航切换、分页、筛选、详情选中/展开、Dialog、无水平溢出和底部安全区。 + +本轮验证记录：任务文件独立 Prettier 检查、`pnpm lint`、`pnpm typecheck`、`pnpm test`（18/18）和 `pnpm build` 均通过；全量 `pnpm format:check` 仍被仓库原有未修改的 `DESIGN.md` 格式问题阻断。HTTP 冒烟检查已确认 `/` 与 `/selection` 应用壳和路由可加载，但本地后端未启动，结果成功态和真实信号数据未在浏览器中验证。 + +## Risky files and rollback points + +- `src/routes/route-tree.tsx`：路由父子关系改变，若失败可恢复 root 直接挂载两个页面。 +- `src/app/layout/*`：应用壳和滚动边界；若视觉回归可先恢复页面外层 `HomeShell`，不涉及 API。 +- `src/features/selection/pages/selection-results-page.tsx` 及新增 selection components：业务呈现变化；可退回旧结果卡片和完整表格，不改 query/API。 +- `src/styles/globals.css` 与 shared primitives：主题/密度全局影响；保留每步检查结果，必要时按 variant 回退局部 class。 +- 删除 `home-shell.tsx` 只在全量引用检查通过后执行。 + +## Review gates before start + +- [x] `prd.md`、`design.md` 和本文件已完成收敛，开放问题为空。 +- [x] `implement.jsonl` 与 `check.jsonl` 不再包含模板占位行，且只列入真实 spec/research 上下文。 +- [x] 用户已审批最终规划摘要；未审批前不得执行 `task.py start`、不得修改生产代码。 diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/prd.md b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/prd.md new file mode 100644 index 0000000..3e49418 --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/prd.md @@ -0,0 +1,87 @@ +# 参考原型调整前端页面 + +## Goal + +将已确认的 A+C 响应式工作台原型落地到生产 React 页面：桌面端提供紧凑的研究工作台和主从结果浏览，移动端提供可触控的单列内容与底部导航，同时保留现有选股执行、查询和状态语义。 + +## Background and confirmed facts + +- 原型文件为 `zhixing-web/prototypes/responsive-workbench.html`，顶部明确标注为 throwaway prototype；默认方案是 A「紧凑工作台」应用壳 + C「主从研究台」详情面板，A/B 仅用于对比。 +- 已确认的产品微调是：删除各业务页面内容区内重复的标题、眉题和说明模块；内容区直接从操作按钮、指标和业务数据开始，页面上下文由应用顶栏承担。 +- 原型已验证桌面端的固定侧栏、顶部工具区、紧凑指标区、筛选/分页/表格和持久化选中详情面板；移动端切换为记录卡、折叠详情、底部四项主导航和“更多”菜单。 +- 现有生产页面位于 `zhixing-web/src/features/`：`HomePage` 展示市场数据概览，`SelectionResultsPage` 展示知行 B1 执行条件、状态、指标和信号表；两者都依赖 `features/home/components/home-shell.tsx`。 +- 当前路由只有 `/` 和 `/selection`；`HomeShell` 由页面手工传入 `activeSection`，且窄屏仍保留图标侧栏，没有移动底部导航。 +- `SelectionResultsPage` 当前信号表使用 `min-width: 720px` 和横向滚动，没有客户端分页，也没有选中信号详情面板；后端已返回完整 `signals` 列表和稳定字段，可在前端复用当前数据做首版分页。 +- 已归档的响应式前端设计任务规定生产迁移顺序为“pathless layout → 首页 → selection 页面 → shared pagination”，并要求生产实现重新编写、不能直接复制原型代码。 +- 前端约束是 React 19、TypeScript、TanStack Router、TanStack Query、Tailwind CSS 4、Base UI 和现有 `shared/ui` primitives；业务逻辑留在 feature，跨 feature 的 layout/pagination 才进入 `app`/`shared`。 + +## Requirements + +### R1. 共享响应式应用壳 + +- 将应用级品牌、桌面/平板/移动导航、顶栏搜索占位、用户入口、内容容器和滚动策略集中到应用级 layout。 +- 使用 TanStack Router 的 pathless layout route 共享应用壳；页面不再手工传入 `activeSection`。 +- 桌面端保持紧凑侧栏和顶栏；移动端使用四项底部主导航，“行情数据”“同步任务”等未实现入口保持不可用或进入明确的更多入口，不伪装为已实现功能。 +- 应用壳集中处理移动安全区、触控命中尺寸和内容底部留白；不在各页面散落设备宽度判断。 + +### R2. 首页与选股页迁移 + +- 首页保留当前市场数据概览 API 和所有加载、错误、无数据、更新状态、失败股票弹窗行为，但采用原型的视觉密度和内容起始结构。 +- 选股页保留目标交易日选择、首次执行、重跑确认、轮询执行中、查询错误、无数据、失败、部分成功/成功和多子信号展示行为。 +- 选股页按 A+C 方案在桌面端呈现紧凑操作/指标区、命中信号主列表和选中信号详情；同一股票的多个子信号必须继续分别可见。 +- 业务内容区不重复渲染大标题、眉题和说明模块；操作和核心数据直接进入页面主体。 + +### R3. 信号筛选、分页与移动呈现 + +- 选股信号支持按股票名称/代码搜索、按信号类别筛选、切换每页数量和页码，并显示总数及当前范围。 +- 桌面端使用高密度语义表格；筛选栏、表头和分页保持可见，只有数据行区域滚动。 +- 移动端使用同一批数据的记录卡，优先展示股票、代码、收盘价和子信号，关键详情可展开；不得仅依赖整页横向滚动。 +- 分页、选中行、展开详情、弹窗和更多菜单都支持键盘、触控和必要的 aria 语义。 +- 首版分页使用当前已加载 `signals` 的客户端切片；服务端分页不在本任务内引入新的 HTTP 契约。 + +### R4. 生产质量与兼容性 + +- 优先复用现有 `Button`、`Badge`、`Card`、`Dialog`、`Input` 等 primitives；只有跨 feature 且无业务语义的能力才抽到 `shared`。 +- 不修改后端业务计算、同步流程或选股结果 HTTP 契约；不把 API 数据复制到 Zustand。 +- 通过前端格式、lint、typecheck、Vitest 和 build；页面测试以用户可见行为覆盖新增响应式壳、分页、筛选、选中详情和现有状态行为。 + +## Acceptance Criteria + +- [ ] `/` 和 `/selection` 共用同一生产应用壳；路由切换时激活导航由路由状态推导，不再依赖页面传入 `activeSection`。 +- [ ] 桌面端在常见 1280px/1440px 宽度下呈现暖白画布、紧凑侧栏/顶栏、指标区和 A+C 主从研究布局，无原型之外的大面积空白。 +- [ ] 选股页内容区没有重复的大标题、眉题或说明模块，内容顺序从操作/指标/业务数据开始。 +- [ ] 选股页保留执行确认、执行中、查询错误、无数据、失败、部分成功/成功和多子信号可见行为。 +- [ ] 信号列表可搜索、筛选、翻页和切换每页数量，并显示总数、当前范围、当前页和禁用状态。 +- [ ] 桌面端长列表仅在数据区滚动，筛选栏、表头和分页保持可见；页面不出现竞争性的嵌套纵向滚动。 +- [ ] 移动端在 375px/390px 宽度下无页面级水平溢出，内容不被底部导航或安全区遮挡，主要控件命中区域适合触控。 +- [ ] 移动端信号以记录卡呈现，详情可展开，底部四项主导航可达，低频功能通过“更多”菜单承载。 +- [ ] 首页原有市场数据状态、失败股票弹窗和路由入口行为不回归。 +- [ ] `zhixing-web/` 下 `pnpm format:check`、`pnpm lint`、`pnpm typecheck`、`pnpm test`、`pnpm build` 均通过。 + +## Out of Scope + +- 不修改后端 HTTP、数据库、市场数据同步或知行 B1 公式语义。 +- 不新增行情数据和同步任务业务页面；未实现入口继续明确不可用。 +- 不实现暗色模式、服务端分页、表格排序/列配置、虚拟滚动、实时行情或交易能力。 +- 不将 throwaway 原型 HTML 直接作为生产组件或导入生产 bundle。 +- 不提交、推送或发布外部系统变更。 + +## Key Decisions + +- 用户已确认本任务按“共享应用壳 + 首页迁移 + 选股页迁移 + 客户端分页”作为第一阶段完整范围。 +- 采用已确认的 A+C 组合；A/B 只保留为原型对比参考，不进入生产路由。 +- 内容区移除重复的页面标题、眉题和说明模块；页面上下文由应用顶栏承担。 +- 首版分页只切分当前已加载的 `signals`，不扩展后端分页契约。 + +## Risks and Deferred Items + +- 现有接口返回完整 signals 列表，客户端分页不降低网络传输量；服务端分页、排序和虚拟滚动留待有真实规模证据后单独设计。 +- 原型详情面板中的置信度、数据状态和“打开研究详情”等 mock 内容不在当前 API 契约内；生产详情只展示已有稳定字段，不虚构业务数据或无效入口。 +- 原型文件仍是评审材料，生产页面必须使用 React、现有 UI primitives 和测试重新实现。 + +## Artifact Status + +- `prd.md`：需求与验收已收敛，无阻塞性开放问题。 +- `design.md`：已补齐生产架构、数据流、响应式边界、兼容性和回滚策略。 +- `implement.md`：已补齐执行顺序、验证命令、风险文件和启动前 review gate。 +- `implement.jsonl` / `check.jsonl`：已替换为真实的 spec/research 上下文条目。 diff --git a/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/task.json b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/task.json new file mode 100644 index 0000000..7aaee07 --- /dev/null +++ b/.trellis/tasks/archive/2026-08/08-09-prototype-driven-frontend-adjustments/task.json @@ -0,0 +1,26 @@ +{ + "id": "prototype-driven-frontend-adjustments", + "name": "prototype-driven-frontend-adjustments", + "title": "参考原型调整前端页面", + "description": "", + "status": "completed", + "dev_type": null, + "scope": null, + "package": null, + "priority": "P2", + "creator": "yuxuanhui", + "assignee": "yuxuanhui", + "createdAt": "2026-08-09", + "completedAt": "2026-08-10", + "branch": null, + "base_branch": "main", + "worktree_path": null, + "commit": null, + "pr_url": null, + "subtasks": [], + "children": [], + "parent": null, + "relatedFiles": [], + "notes": "", + "meta": {} +} \ No newline at end of file