todo.md

OpenCRHTracker TODO

P0 - 优先补齐

• 新增“按日期浏览”页面 对接现有 /api/v1/records/daily 接口，支持查看某一天的全部担当记录。

• 在车次 / 车组详情页增加时间范围筛选 对接现有历史接口的 start / end 参数，让用户可以按日期区间过滤历史记录。

• 为日报提供前端导出入口 对接现有 /api/v1/exports/daily/[date] 接口，支持下载 csv / jsonl。

• 在查询结果页展示数据新鲜度 显示最后更新时间、调度周期、数据可能存在延迟的提示，提升结果可信度。

• 增加“最近查询”能力 在首页和详情页保留最近搜索过的车次 / 车组，便于快速回访。

• 为详情页补充结果摘要卡片 不只展示原始历史列表，还展示最近一次换组、近 7 天高频担当、连续担当次数、是否存在重联等信息。

P1 - 体验增强

• 增加“收藏 / 置顶”功能 支持收藏常查车次 / 车组，并在首页或个人设置中快速访问。

• 优化反馈链路 不只保留 GitHub Issues 跳转，补一个站内反馈表单，并自动附带当前查询上下文。

• 在设置页展示 API 配额信息 显示当前剩余额度、额度上限、恢复节奏，增强开发者面板的实用性。

• 补充账户管理能力 增加修改密码、查看当前会话、管理历史会话等基础账户功能。

• 提供更明确的空状态 / 错误状态引导 例如无记录时推荐相近编码，加载失败时提供重试和排查建议。

P2 - 开发者 / 运维增强

• 新增 API 文档或调试页 提供鉴权方式、接口列表、示例请求和返回格式，降低外部接入成本。

• 增加系统状态页 展示健康检查、任务调度状态、最近一次导出时间、数据源刷新状态等信息。

• 为数据采集链路增加可见性 例如显示最近一次成功抓取时间、最近失败原因、当前任务队列长度。

• 提供面向自部署场景的运维说明 包括配置项说明、数据库文件用途、任务调度机制、常见故障排查。

暂时不要优先做

• 推送通知 / 订阅提醒 有价值，但应在查询、筛选、日报浏览和数据透明度补齐后再做。

• 复杂统计大盘 在基础摘要能力做扎实之前，不要过早投入重型图表页。