tick-stock-panel/backend/app/services/stock_reports.py

"""AI 个股分析报告持久化存储。

与 ai_reports.py(财务分析报告)完全独立 —— 单独的文件、字段、上限,
互不影响。存储机制委托给共享的 JsonReportStore(原子写 + 实例锁),
本模块只固化 个股分析报告 的文件名 / 上限 / id 前缀, 对外保持原有函数签名不变。

存储位置: data/user_data/ai_stock_reports.json (数组,按 created_at 降序)
保留最近 MAX_REPORTS 条;超出自动裁剪最旧的。

每条报告结构:
{
  "id": "sar_xxx",           # 唯一 id(stock-analysis-report)
  "symbol": "600519.SH",
  "name": "贵州茅台",
  "focus": "",               # 用户追加的关心点(可为空)
  "content": "# ...markdown", # 报告正文
  "summary": "当前价 12.3 · 压力位...",  # 价位/数据摘要
  "levels": {...},           # 报告生成时的关键价位(供图表回放)
  "close": 12.3,             # 报告生成时的收盘价
  "created_at": "2026-06-26T10:00:00"
}
"""
from __future__ import annotations

from app.services.json_report_store import JsonReportStore

MAX_REPORTS = 50

_store = JsonReportStore("ai_stock_reports.json", MAX_REPORTS, id_prefix="sar")


def list_reports() -> list[dict]:
    """返回全部报告(按 created_at 降序)。"""
    return _store.list_reports()


def save_report(report: dict) -> dict:
    """新增一条报告并持久化。返回保存后的报告(含 id / created_at)。"""
    return _store.save_report(report)


def delete_report(report_id: str) -> bool:
    """删除指定报告。返回是否删除成功。"""
    return _store.delete_report(report_id)