Files
myquant/djapi/.serena/memories/code_style_and_conventions.md
T
simonandClaude Opus 4.7 271a9343a5 Initial commit: cc-cursor 全链路量化研究平台
7 Sprints 全部完成:
  Sprint 0: 基础设施 (DataManager + MariaDB)
  Sprint 1: 因子引擎 (34因子/12分类)
  Sprint 2: VectorBT 回测 (5策略+截面)
  Sprint 3: Optuna 优化 (+Walk-Forward)
  Sprint 4: ML 模型 (LightGBM+CatBoost)
  Sprint 5: Qwen 情绪因子 (三源新闻+日期对齐)
  Sprint 6: Agent 系统 (4Agent+日报.md/.html)

生产加固 (15项): Tushare双源fallback, SSH自动恢复, pool_pre_ping,
  save_daily先删后插, load_dotenv绝对路径, 日报5d/20d修复,
  RiskAgent改上证指数, 昨日对比+数据截止, mac_report utf8mb4,
  CLAUDE-*.md 9条已知Bug, demo全参数化, djapi数据源归一化,
  indexDatas API修正

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-07 15:59:05 +08:00

1.1 KiB

Code Style & Conventions

Python

  • Django app: all business logic in api/stock/, not in views
  • views.py is thin forwarding layer: extract params -> call function -> return Response
  • Double import pattern for standalone scripts: try relative import first, fall back to absolute
  • Use viewFunc_tsCodeAndDate() wrapper for ts_code + date_range endpoints
  • Use viewFunc_singleParam() wrapper for single-param endpoints
  • DRF @api_view(['GET']) + @extend_schema on all views
  • DRF Response (not JsonResponse) — no safe=False parameter
  • Configuration split: config.py (token) / strategy_config.py / scan_config.py

Constraints

  • api/video/ is protected — do NOT modify unless user explicitly asks
  • No python-dotenv dependency — use stdlib env loaders only
  • Backward compatibility: keep re-exports when splitting modules
  • Server .env file manages all secrets; uwsgi.ini only has DJANGO_SETTINGS_MODULE

Secrets

  • All API keys/tokens/passwords via os.getenv()
  • Local: .env file (not committed)
  • Server: /home/simon/myquant/djapi/.env
  • Django loads via djapi/env_loader.py, video loads via api/video/env.py