Litefs 框架开发任务清单

当前版本: v0.8.3 目标版本: v0.9.0 更新日期: 2026-10-21 基线 Commit: 97d543e

阶段进度：P0 ✅ → P1 ✅ → P2 ✅ → P3 ✅

Generated by TRAE SOLO at 2026-10-20 16:32

项目现状（v0.8.3 基线）

任务	内容	验收标准	状态
core.py 拆分	拆分为 `app/` 包（helpers + 4 个 Mixin + server_cli），core.py 保留装配与再导出	单文件 ≤ 600 行，行为不变	✅ 2026-10-20 完成（1216 → 105 行）
覆盖率提升	新增 20 个测试模块约 640 用例，修复 5 处源码 bug	46% → 70%（v0.9.0），85%（v1.0）	✅ 2026-10-20 完成阶段目标（70%，详见 unit-tests.md）
类型注解完善	核心模块 type hints	mypy 核心目录零错误	✅ 2026-10-20 完成（app/ 包 + core.py，81 → 0，详见 type-hints.md）
静态检查流水线	flake8 + ruff + mypy 纳入 CI	全部通过方可合并	✅ 2026-10-21 完成（`src/` 全量三工具零告警，CI 门禁已上线，详见 static-checks.md）

任务	内容	状态
Prometheus 监控	PrometheusMiddleware、请求计数/延迟直方图/错误率、连接池与缓存命中指标、`/metrics` 端点、可选依赖懒加载	✅ 2026-10-21 完成（指标 7 项、路由模板低基数标签，详见 prometheus-monitoring.md） 2026-10-21 修复原生 Socket 链路指标未采集缺陷
数据库迁移	Alembic 封装（当前 `litefs db` 仅为提示占位），实现 `db init/migrate/upgrade/downgrade/current/history`	✅ 2026-10-21 完成（嵌套子命令 + 保留旧扁平入口，详见 database-migrations.md）

任务	内容	状态
邮件发送	smtplib 封装、Message 类、Mako 模板邮件、附件、Celery 异步发送	✅ 2026-10-21 完成（零新增依赖，MIME 三态结构、TLS/SSL、指数退避重试、Celery 不可用自动降级，详见 mail-service.md）
i18n 国际化	gettext 封装、请求级 locale 协商、模板翻译函数	✅ 2026-10-21 完成（零新增依赖，四级 locale 协商优先级、线程局部隔离、恒等函数保障零行为变化，详见 i18n.md） 2026-10-21 修复原生 Socket 链路 `Content-Language` 与 locale Cookie 未写入缺陷

任务	内容	状态
性能回归基准	以 `benchmarks/` 为基础固化阈值，防止发布回退	✅ 2026-10-21 完成（16 组场景 / 32 项检查，RPS ≥ 基线 85%、P99 ≤ 基线 130%，零新增依赖，详见 performance-regression.md）
示例与文档同步	新功能各配 1 个示例 + 对应 docs 页面，更新 `index.rst`	✅ 2026-10-21 完成（新增 4 个可运行示例，重写 `examples/README.md`，修复 3 处失效交叉引用，详见 project-structure.md）
依赖安全审计	pip-audit 定期扫描	✅ 2026-10-21 完成（`scripts/audit_deps.py` + `make audit` + CI `security` job，审计面收敛至运行时依赖，详见 dependency-audit.md）

文档维护: 开发团队