feat: 完成权益到期与续期闭环

ai_knowledge_base_v2/docs/一期全链路验收记录.md

@@ -15,16 +15,18 @@
 
 2026-08-03 已完成实修记录 V2 改造：不再生成、展示或注入常见情绪、身体/关系模式、做过或有效功课、近期变化等长期画像字段；仅保留最近 30 天、最多 10 个新版主题形成的近期回顾、近期关注和可以继续留意的问题。旧版记录保留在数据库中用于兼容和回滚，但不会进入用户端或 Agent 上下文。
 
+2026-08-03 已完成权益到期与续期闭环：后台可筛选临期、到期和默认权益用户，支持单人及批量续期；续期按请求唯一键幂等执行并保留审计明细，小时级维护任务自动归档到期权益。用户端会柔性提示临期或已降级状态，并明确历史内容仍然保留。
+
 ## 3. 功能验收结果
 
 | 验收项 | 结果 | 实际结果 |
 | --- | --- | --- |
-| 权益管理页面 | 通过 | 编辑区按基础配置、能力权限拆分；桌面端和窄屏自适应；按钮、开关和表格不再拥挤错位 |
+| 权益管理页面 | 通过 | 编辑区按基础配置、能力权限拆分；用户列表可筛选权益版本和到期状态，并支持单人/批量续期；桌面端和窄屏自适应 |
 | 权益版本编辑 | 通过 | 编辑已有权益、退出编辑、启用状态和能力开关均可正常操作 |
 | 用户登录 | 通过 | 通过真实页面完成验证码登录并进入聊天页 |
 | 用户端流式问答 | 通过 | 显示“思考中”，随后流式展示 Markdown 回答；发送后输入框立即清空 |
 | 用户端主题上下文 | 通过 | 连续消息均绑定同一主题，历史消息与主题上下文可继续使用 |
-| 用户端个人中心 | 通过 | 顶部统一入口展示账号、套餐说明、有效期、本月主题、今日问答、剩余额度和能力清单；近期回顾与生成记录分栏展示 |
+| 用户端个人中心 | 通过 | 顶部统一入口展示账号、套餐说明、有效期、本月主题、今日问答、剩余额度和能力清单；近期回顾与生成记录分栏展示；临期或降级时显示柔性说明 |
 | 后台 Agent 预览 | 通过 | 可选择模拟学员和具体主题，能够加载权益、主题摘要、最近消息和近期实修回顾 |
 | Agent 运行追踪 | 通过 | 能看到 `load_debug_user_context`、模型路由等追踪节点 |
 | 主题沉淀 | 通过 | 结束主题快速入队；主题摘要与近期实修回顾后台生成；支持幂等、自动重试、重启恢复和管理员手动重试 |
@@ -39,12 +41,12 @@
 
 | 验收项 | 结果 | 实际结果 |
 | --- | --- | --- |
-| 后端自动化测试 | 通过 | 114 项测试全部通过，包含 V2 数据隔离、异步入队、幂等、重试、重启恢复及推理内容过滤 |
+| 后端自动化测试 | 通过 | 117 项测试全部通过，包含 V2 数据隔离、异步入队、权益续期幂等、到期归档、重试、重启恢复及推理内容过滤 |
 | OpenAPI 检查 | 通过 | 成功生成并检查 95 个接口路径 |
 | 管理后台构建 | 通过 | 生产构建成功 |
 | 用户端构建 | 通过 | 生产构建成功 |
-| Alembic 离线 SQL | 通过 | 成功生成 1154 行迁移 SQL，并覆盖到 `0025_recent_practice_review` |
-| 现有数据库迁移 | 通过 | 开发 MySQL 已升级至 `0025_recent_practice_review`，数据库与 Redis 就绪 |
+| Alembic 离线 SQL | 通过 | 成功生成迁移 SQL，并覆盖到 `0026_entitlement_renewal` |
+| 现有数据库迁移 | 通过 | 开发 MySQL 已升级至 `0026_entitlement_renewal`，到期复合索引和续期请求唯一索引均已核对 |
 | 全新数据库迁移 | 通过 | 隔离 MySQL 从零升级到 `0025_recent_practice_review`，V2 字段与默认值均已生成，验收库随后清理 |
 | 数据库与 Redis 就绪检查 | 通过 | `/api/ready` 返回数据库和 Redis 均已就绪，并返回 `X-Request-ID` |
 | 隔离生产编排 | 通过 | 使用生产镜像、独立数据库和 Redis 启动，所有容器健康 |