# continuation.md

## 当前项目状态

djapi — Django 5.2 金融数据 API 项目，2026-06-17 已部署。

服务器：`simon@doorcome.cn`，路径 `/home/simon/myquant/djapi/`，虚拟环境 `/opt/miniconda/envs/django/`。

## 已完成

### 1. 安全：密钥统一管理
- 所有密钥 → 环境变量，`.env` 统一管理
- `djapi/env_loader.py`（Django 端）+ `api/video/env.py`（video 端）双加载器
- 共享 `MySQLDB` → `api/utils/mysql_handler.py`
- `.env.example`、`.gitignore`

### 2. 代码质量
- `api/views.py`：227 → ~130 行，消除重复
- `api/stock/stock_utils.py`：`viewFunc_singleParam()` 包装器
- `api/stock/config.py`：拆分为 config / strategy_config / scan_config

### 3. drf-spectacular 集成
- 14 端点 `@api_view` + `@extend_schema`，8 tag 分组
- 13 Serializer，Swagger `/api/docs/`

### 4. 股息率 API 优化
- **删除** `api/stock/getDivData_AK.py`（akshare 版），`/api/getdivak/` 路由移除
- **优化** `api/stock/getStockDiv2.py`：
  - TTM 计算：`calculate_ttm_div` 行级循环 O(n²) → `rolling('360D').sum()` O(n)
  - 删除向前填充逻辑（~30 行），避免与毛刺平滑冲突
- **修复** `api/stock/smoothBrush.py`：if/elif 分支中 prev_valid/next_valid 赋值反了

### 5. video 模块重构与 Bug 修复
- 新增 `api/video/env.py` — .env 加载
- `newsRedo.py` 重写 — 三分支智能重处理
- **P0 修复**：`getVideo5.py` 日期校验 bug（`start_date > start_date` → `start_date > end_date`）
- **P1 清理**：删除 `ai.py`（两个函数均为死代码），清理 `newsProcess.py` 冗余 import
- **P2 修复**：`audioRead.py` — `transcribe_audio` 异常时返回 `['', '']` 统一类型；`analyze_and_correct_text` 防御 None
- **P3 修复**：`newsProcess.py` — `news_to_db()` JSON 解析自适应 dict/list（DeepSeek json_object 模式返回 dict 包装）

### 6. 文档与测试
- `CLAUDE.md`、`README.md`、`continuation.md`
- 18 个单元测试

## video 目录文件现状（10 个 .py）

| 文件 | 职责 |
|------|------|
| `env.py` | .env 加载 |
| `getVideo5.py` | 主流程：抓取→下载→ASR→入库 |
| `audioRead.py` | 音频转换、分割、ASR 识别、文本纠错 |
| `deepseek.py` | DeepSeek API 封装（类 + `deepseek_text` 函数，支持 `response_format`） |
| `newsProcess.py` | AI 新闻分割+标题提取，JSON 自适应解析 |
| `newsRedo.py` | 手动重处理（三分支） |
| `main.py` | 定时任务入口（当天） |
| `main_videos.py` | 批量补缺（扫描缺失日期） |
| `mysqlHandle.py` | MySQLDB 重新导出 |

## 所有 API 端点（14 个）

| 端点 | 数据源 | 说明 |
|------|--------|------|
| `stockbasic/` | Tushare | 日线行情 |
| `stockinfo/` | Tushare | 个股基本信息 |
| `industrys/` | Tushare | 行业股票列表 |
| `stockparam/` | Tushare | 个股参数 |
| `stockep/` | Tushare | TTM EPS |
| `quarterlyEps/` | Tushare | 季度 EPS |
| `indexByName/` | Tushare | 指数查询 |
| `indexDatas/` | Tushare | 指数行情 |
| `dailymargin/` | Tushare | 每日融资融券汇总 |
| `stockmargin/` | Tushare | 个股融资融券 |
| `finance/` | Tushare | 财务报表分析 |
| `getdiv/` | Tushare | 股息率（TTM rolling + 毛刺平滑） |
| `xwlbNews/` | MySQL | 新闻联播原始文本 |
| `xwlbFine/` | MySQL | 新闻联播 AI 精编 |

## 部署

```bash
# 全量同步
rsync -avz --delete \
  --exclude='.env' --exclude='db.sqlite3' \
  --exclude='*.log' --exclude='uwsgi.pid' \
  --exclude='__pycache__/' --exclude='*.pyc' \
  --exclude='xwlb_video/' --exclude='audio_processing/' \
  /Users/summer/Downloads/cc-cursor/djapi/ \
  simon@doorcome.cn:/home/simon/myquant/djapi/

# 单文件同步必须写完整路径
# 正确：rsync api/views.py simon@...:/.../djapi/api/views.py

# 重启
ssh simon@doorcome.cn "kill \$(lsof -ti:5004); sleep 2; /opt/miniconda/envs/django/bin/uwsgi --ini /home/simon/myquant/djapi/uwsgi.ini"
```

## 关键设计决策

- video 模块保护、向后兼容优先、不使用 python-dotenv
- rsync 陷阱：多文件源会展平路径
- `.env` 双加载：Django 端 `djapi/env_loader.py` + video 端 `api/video/env.py`
- 股息率 TTM 用 `rolling('360D').sum()` 向量化，不手动循环
- DeepSeek json_object 模式返回 dict，newsProcess 自适应提取 list