A 股尾盘雷达是一款面向个人研究与学习的 A 股数据分析工具，帮助用户把盘中观察、盘后复盘和个股研究整理成有日期、有来源、有规则证据的工作流程。
项目提供分区式研究页面，涵盖每日研究、涨停板复盘、竞价与开盘观察、个股规则诊断及量化因子研究。系统按明确的规则分析行情与历史数据，展示筛选条件、数据时间、来源和逐项证据；对数据缺失或来源不可用的情况保留“未知”状态，不以默认值补造结论。报告支持按日期查询和历史归档，便于复核不同模块的数据时点与依赖关系。
项目使用 Python、FastAPI、SQLite 和 Docker Compose 构建，并通过 Tushare 等数据接口获取所需行情或研究数据。它不连接券商账户、不自动下单，也不承诺投资收益；分析结果仅供个人学习和研究参考，不构成投资建议或交易指令。
### 1. 今日工作台
汇总可用的研究报告和模块状态，帮助用户快速了解当天哪些内容已生成、哪些数据缺失，以及各模块对应的数据日期。报告索引按日期展示模块的可用情况，避免把不同交易日的数据误认为同一批结果。
### 2. 盘后与涨停复盘
围绕涨停股票提供盘后研究视图，包括涨停表现、封板与历史证据、公开信息复核，以及按板块组织的结果。每日研究和候选后续表现可以按指定日期查询；指定日期没有对应归档时，页面明确显示缺失，不自动回退到其他日期的数据。
### 3. 竞价与开盘观察
展示竞价候选及开盘阶段的观察证据，包括竞价指标、分钟数据、观测阶段和来源时间。没有可验证的行情字段时保留未知状态，不把昨日数据当作当日盘中数据。
### 4. 个股研究与规则诊断
支持按股票代码或名称查询个股，查看八条口诀对应的规则分类和逐项证据。页面以状态图展示哪些条件通过、未通过或暂时无法判断，便于理解规则含义；诊断结果不是买卖指令。
### 5. 量化因子研究
提供趋势动量、质量稳健、流动性活跃和低波动防守四类研究组合，展示组合分位、覆盖率、因子原始值、截面百分位和历史变化。不同覆盖率的组合不应直接比较分数；缺失因子不以 0 代替，也不将排名解释为上涨概率。
### 6. 运行质量与数据状态
记录报告生成结果、来源可用性和运行质量，辅助识别数据迟到、空响应或模块未更新等问题。各报告保留自身日期和来源信息，便于排查“页面有结果但日期不一致”等情况。
### 技术架构
- **后端 API：** Python + FastAPI，负责报告查询、个股诊断、数据校验和页面接口。
- **数据采集：** 通过 Provider 适配不同数据来源；项目以 Tushare 数据接口为主要行情与研究数据来源，具体接口能否返回字段取决于数据权限和上游可用性。
- **策略与研究逻辑：** 规则集中在策略和服务模块中，接口返回逐条证据，而不只返回股票代码或汇总结论。
- **数据存储：** 报告文件与 SQLite 历史索引并存；SQLite 保存报告历史及报告依赖信息。当前项目并非所有业务数据都已迁移到 PostgreSQL。
- **前端页面：** 静态 HTML、CSS 和 JavaScript 由 FastAPI 提供，按工作区组织入口，并保留原有页面路由。
- **定时运行与部署：** 使用 Docker Compose 运行 API 和调度器，配置行情密钥通过部署端秘密文件挂载，不写入代码或镜像。
- **测试：** 使用 pytest 覆盖后端逻辑，并对前端 JavaScript 和部署配置进行检查。
评论