yuxuanhui
3.6 KiB
3.6 KiB
选股模块图表展示迭代
Goal
提升选股模块详情页的信息密度和技术分析能力，使用户可以在查看选股结果时直接核对股票的日线走势、成交量、KDJ 指标，并查看该股票最高相似度案例对应的参考图。
Background
当前需求由用户明确提出，包含列表与详情页布局调整、详情页技术图表扩展，以及最佳匹配案例图片展示。当前桌面工作台实际是左宽右窄的两列布局，详情响应只有目标交易日标量，不包含历史序列。PostgreSQL 已保存按交易日升序的 qfq 日线 OHLCV，selection 领域已有 KDJ 计算，因此完整技术图表的数据基础已经具备，但需要新增只读详情契约。
仓库另有固定的十个图形匹配案例，评分器会把选中股票逐一与十个案例比较并保留最高分案例。对应的十张 2800x1400 JPG 位于 /Users/yuxuanhui/bcc-github/quant-project/zgnb/zgnb-project/docs/references/patterns/b1-cases，文件中的 case_001、case_002、case_003、case_004、case_006 至 case_011 与当前代码案例定义一一对应。用户已明确：每只股票只展示最高相似度案例对应的一张 JPG；例如药明康德最高匹配方正科技时，展示方正科技 JPG。
Requirements
- 选股模块从现有
md桌面双栏断点起，左侧列表与右侧详情区域的宽度比例调整为1:3，更小视口保持现有移动布局。 - 右侧详情区域增加一张完整技术图表，至少包含日线 K 线、成交量和 KDJ 三部分。
- 技术图表下方展示当前股票最高相似度案例对应的一张 JPG，并同时保留可读的案例名称和评分信息。
- 每个已完成评分的股票都应返回最高相似度分数和最佳案例，即使该分数低于业务匹配阈值；评分失败或未执行时不伪造案例图片。
- 可以引入与现有前端技术栈兼容的第三方图表库，但应控制新增依赖和改动范围。
- 图表行情必须使用目标交易日及之前的 qfq 日线，不能读取目标日之后的数据。
- 详情接口最多返回目标交易日前 250 个交易日；图表默认聚焦最近 120 个交易日，并允许用户缩放查看接口返回的全部数据。
Acceptance Criteria
- 从
md双栏断点起，左侧列表和右侧详情区域呈现1:3的可用宽度比例，且不存在更大断点覆盖回旧比例。 - 选中一只股票后，右侧能够展示与该股票对应的日线 K 线、成交量和 KDJ 指标，三部分时间轴或数据窗口保持一致。
- 图表数据不超过目标交易日前 250 个交易日，首屏聚焦最近 120 个交易日；缩放操作同步作用于日线、成交量和 KDJ 三个区域。
- 图表下方只展示当前股票最高相似度案例对应的一张 JPG；图片、案例名称和评分属于同一个最佳案例，药明康德匹配方正科技的场景会展示方正科技 JPG。
- 低于阈值但评分成功的股票仍展示实际最高分、最佳案例及对应 JPG；未执行或失败时展示明确状态且不显示错误图片。
- 页面在加载、空数据和接口失败时不会崩溃，并给出符合现有页面风格的状态反馈。
- 相关前后端静态检查和自动化测试通过，且没有破坏现有选股列表与详情交互。
Out of Scope
- 暂不改变选股算法、图形相似度评分规则或股票筛选逻辑。
- 暂不增加用户自定义技术指标、画线工具或交易下单能力。
- 暂不动态生成案例图片，也不展示最佳案例之外的其他九张 JPG。