# InSAR Management System TODO（持续维护）

最后更新：2026-02-10  
维护目标：帮助开发者快速定位风险、统一改造节奏、避免“修一处坏一处”。

---

## 一、当前总体状态

- 认证授权：已切换为 `Session + Cookie`，管理员/只读权限可用。
- 用户管理：管理员可创建与管理账号，前端面板已接入。
- 审计日志：高风险写接口审计已接入，前端可查询。
- 雷达源图预览：已进入 **Scheme B（后端预纠正缓存）** 实装阶段。
- 调度模式：当前默认 `Manual-only`，通过手动触发扫描，不启用后台定时任务。

---

## 二、任务看板（按优先级）

## P0（本周优先）

### 1) SEC-01 鉴权与权限边界完善
- **状态**：DONE（首版完成，持续加固）
- **目标**：确保所有写接口只允许管理员，所有新增接口必须复用权限依赖。
- **验收**：
  - 未登录访问受限接口返回 `401`
  - 只读用户写操作返回 `403`
  - 管理员写操作返回 `2xx`

### 2) SEC-01A 审计链路闭环
- **状态**：DONE（首版完成，持续加固）
- **目标**：高风险操作均可追踪“谁、何时、做了什么”。
- **验收**：
  - 后端 `GET /api/auth/audit-logs` 可查关键操作
  - 前端审计面板支持过滤与检索

### SEC-02（新增）部署安全基线收敛
- **状态**：TODO
- **目标**：降低默认配置带来的部署风险，形成可复制的最小安全基线。
- **验收**：
  - 生产环境 `CORS_ORIGINS` 使用明确白名单（不使用 `*`）
  - 部署文档明确 `.env` 密钥管理规范（不入库、不共享）
  - HTTP/HTTPS 场景下 `AUTH_COOKIE_SECURE` 配置策略明确

### 3) GEO-01 Scheme B 纠正缓存主链路
- **状态**：DONE（首版落地）
- **范围**：
  - 双缓存目录：`radar_geo` + `radar_raw`
  - 后端透视纠正生成地理预览缓存
  - `thumb` 接口优先 `radar_geo`，失败回退 `radar_raw`
  - 新增状态与重建接口

### 4) GEO-02 纠正缓存状态可观测
- **状态**：DONE（首版落地）
- **范围**：
  - 数据库记录 `preview_cache_status/version/path/error/updated_at`
  - 前端列表显示状态徽标（纠正/回退/失败/未建）
  - 管理员可“单条重建缓存”

---

## P1（下一阶段）

### 5) GEO-03 真实数据稳定性验证
- **状态**：TODO
- **目标**：验证升轨/降轨/大倾斜场景下叠加稳定性。
- **验收**：
  - 覆盖面与源影像视觉对齐明显改善
  - 地图缩放/平移无明显卡顿
  - 构建失败样本可在日志与状态中定位

### 6) PERF-01 大批量扫描性能压测
- **状态**：TODO
- **目标**：评估 1000+ 场景增量扫描耗时与缓存命中率。
- **验收**：
  - 二次扫描命中率 > 95%
  - 失败重试不影响主扫描完成

### 7) MAINT-01 前端 `App.jsx` 模块化拆分
- **状态**：TODO
- **目标**：降低单文件复杂度，便于持续维护。

---

## 三、里程碑记录

### 2026-02-10（Session 鉴权阶段）
- 完成 Session + Cookie 鉴权首版。
- 完成管理员初始化与用户管理基础链路。
- 修复登录阶段 `MissingGreenlet` 异常。

### 2026-02-10（审计与运维阶段）
- 接入高风险写接口审计日志。
- 前端新增审计日志面板。

### 2026-02-10（Scheme B 首版实装）
- 新增 `radar_geo` 与 `radar_raw` 双缓存策略。
- 扫描流程支持增量构建纠正缓存与回退缓存。
- 新增接口：
  - `GET /api/radar-data/{id}/preview-status`
  - `POST /api/radar-data/{id}/rebuild-preview-cache`
- 前端源影像列表支持状态显示与管理员重建。
- 方向判定升级：优先读取 XML 的 `refRow/refColumn` 映射像素角与地理角，减少方向错位。

### 2026-02-10（文档与实现对齐）
- 明确当前扫描调度模式为 `Manual-only`（非定时守护）。
- 补充部署安全基线项（CORS 白名单、`.env` 密钥管理、Cookie 安全策略）。

---

## 四、开发注意事项（必须遵守）

- 不得破坏 `start_system.bat` 与 `scripts/start_app.ps1` 的建库/校验/修复启动链路。
- 任何数据库结构变更后，必须同步更新 `scripts/init_db.py` 的非破坏性补齐能力。
- 新增功能必须同步更新 `docs/DEPLOYMENT.md` 与本文件。