CPA Manager Plus v1.12.0-rc.3

17 commits · 53 files changed · +8477 / -1126

English ->

Overview

这是 v1.12.0 的第三个 release candidate，聚焦 Manager Server 派生数据维护的启动可用性、在线迁移的可恢复性以及升级期间的读一致性。大表扫描、派生清理和重建不再阻塞 HTTP 服务监听；迁移按有界批次在后台推进并记录 checkpoint，未完成时读取路径回退到 usage_events。同时增加安全的离线收尾命令和 SQLite 进程锁，完善旧 quota snapshot 与 rollup 的生命周期和身份保留。

Highlights

Features

Manager Server 新增 cleanup-derived 离线维护命令，可完成延后索引、过期派生索引、旧 FTS / projection generation 以及超大 legacy quota observation group 的收尾。
GET /status 的 dataMigration 增加 changedRows 和 appliedRows，并持续报告迁移阶段、进度、可重试失败和完成状态。

Fixes

启动阶段仅执行有界的 schema / metadata 工作和安全的空表索引准备；非空表索引、派生数据清理和重建会延后到 HTTP 监听后或显式离线维护。
cache accounting、legacy quota snapshot backfill 和派生清理按有界事务与已提交 checkpoint 分阶段执行，中断或重启后从当前阶段继续，不重复处理已提交批次。
Monitoring、Usage Analytics 和 Dashboard 在 rollup 重建、revision 切换或过期派生行清理期间使用完整 revision 或回退到 raw usage_events，保持读取正确性。
legacy quota snapshot backfill 保留计划与提前重置后的生命周期边界，以及历史记录的 model identity。
Manager Server、admin reset 和离线维护命令通过跨平台 SQLite 进程锁串行访问同一数据库，避免并发维护破坏数据状态。

Upgrade Notes

这是预发布版本；稳定 Docker 标签和 latest 不会更新，请显式使用 v1.12.0-rc.3 对应的发布资产或镜像。
升级旧数据库时，后台迁移会在 HTTP 服务可用后继续执行；升级前请同时备份 SQLite 数据库、WAL、SHM 与 data.key。
如果日志出现 deferred index preparation、cleanup requires offline finalization 或 offline cleanup required，请停止所有使用该数据库的 Manager Server 进程，再使用同版本二进制运行 cpa-manager-plus cleanup-derived --db-path /data/usage.sqlite；默认原生路径可省略 --db-path。
cleanup-derived 会在数据库锁仍被持有时拒绝执行；锁文件会持久保留，无需手工删除。不要启动第二个 Manager Server 连接同一 SQLite 或 CPA queue 来加速迁移。
usage_events 仍是权威输入，派生数据重建不会修改或删除它；迁移未完成期间的 raw-event fallback 会继续提供正确读取。

Full Changelog: v1.12.0-rc.2...v1.12.0-rc.3

seakee/CPA-Manager-Plus v1.12.0-rc.3 on GitHub