chore(data-ana): merge data-ana full implementation into main

Merge feat/data-ana-ai11 with complete data analytics service

docs/troubleshooting/known-issues.md

@@ -339,7 +339,7 @@
 | CDC 水平扩展           | P4 单实例 + 内存 ExamCache LRU → P6 多实例 + Redis ExamCache + partition 扩容 + HPA                                                                     |
 | CDC 手动 commit        | v2 改进：`enable_auto_commit=False` 手动 commit（at-least-once），commit 前确保 ClickHouse 写入成功                                                     |
 | ClickHouse 容量规划    | 5 宽表年增量 ~2.3GB（5000 学生×20 次/月），单节点可承载；P6 按 class_id hash 分片 + ReplicatedMergeTree                                                 |
-| ClickHouse FINAL       | ReplacingMergeTree 查询必须加 `FINAL` 或用 `argMax` 聚合，否则读到重复版本（当前实现未加，P0 整改）                                                     |
+| ClickHouse FINAL       | ReplacingMergeTree 查询必须加 `FINAL` 或用 `argMax` 聚合，否则读到重复版本（clickhouse_repository.py 已实现 P0 整改）                                   |
 | 缓存键命名             | `data_ana:datascope:{user_id}` 5min / `data_ana:exam:{exam_id}` 30day / `data_ana:dedup:{event_id}` 7day                                                |
 | 4 端 Dashboard         | teacher/student/parent/admin 各自 Dashboard API + 权限点 ANALYTICS_*_DASHBOARD（v2 新增 4 端权限）                                                      |
 | SubscribeMasteryUpdate | gRPC server-streaming RPC 为 P5+ AI 个性化推荐预留实时推送通道（analytics.proto v2 提案）                                                               |
@@ -354,6 +354,9 @@
 | 降级模式 4 场景        | ClickHouse/Kafka/Redis/iam gRPC 不可用时返回骨架 + `error.details.degraded=true`，4 错误码 DATA_ANA_*_UNAVAILABLE                                       |
 | Python gRPC 实现       | grpc.aio + betterproto + ServerInterceptor 透传 W3C trace context，与 HTTP 共享同一 Application Service                                                 |
 | structlog API          | 24.x 用 `make_filtering_bound_logger(level)`，旧版 `make_filtering_logger` 已废弃                                                                       |
+| ruff per-file-ignores  | gRPC servicer 方法必须 PascalCase（N802 忽略）/ FastAPI Depends 在参数默认值（B008 忽略），pyproject.toml 配 per-file-ignores                           |
+| Mock 数据脚本          | `scripts/data-ana-mock-data.sql` 提供 5 宽表演示数据（20 学生×2 考试×3 知识点），用 `now()-INTERVAL` 避免硬编码日期                                     |
+| Python 3.12+ 现代化    | ruff UP042 用 StrEnum 替代 `str, Enum` / UP046 用 PEP 695 类型参数 `class Foo[T]` 替代 `Generic[T]`                                                     |
 
 ### 2.7 messaging（TS/NestJS，P5）