feat: add student video and profile experience

docs/migration-roadmap.md

@@ -10,6 +10,7 @@
 - [`docs/migration/phase-3-tenant-isolation-and-shared-question-bank.md`](migration/phase-3-tenant-isolation-and-shared-question-bank.md)
 - [`docs/migration/phase-4-external-provider-decoupling.md`](migration/phase-4-external-provider-decoupling.md)
 - [`docs/migration/phase-5-backoffice-worker-operations.md`](migration/phase-5-backoffice-worker-operations.md)
+- [`docs/migration/phase-7-student-experience-and-content-consumption.md`](migration/phase-7-student-experience-and-content-consumption.md)
 
 迁移原则：
 
@@ -65,9 +66,10 @@
 - 公开 catalog：Banner、FAQ、公告、考试日期、商品、SVIP 套餐等。
 - 内容导航、题库、词汇、手册、视频、资源公开查询。
 - 资源上传签名、确认、下载/预览签名。
-- 学生个人中心、通知、徽章、反馈。
+- 学生端视频搜索、播放授权、观看进度、题目解析视频查询。
+- 学生个人中心、签到、积分流水、通知、徽章、反馈。
 - 学习统计、排行榜、错题/单词复习。
-- 题目管理、内容导入骨架、词汇/手册/分数线/视频后台管理。
+- 题目管理、内容导入预览、同步导入、异步导入任务、导入详情、词汇/手册/分数线/视频后台管理。
 - 商品下单、微信/支付宝/manual 支付、支付回调、权益发放。
 - 积分任务、积分领取、积分兑换。
 - 优惠券领取、校验、下单抵扣、零元订单发权益。
@@ -78,106 +80,9 @@
 
 ## 剩余迁移范围
 
-剩余部分不建议再按“旧接口数量”机械推进。旧 NestJS 里还有大量平台运营、自动化、审计、对账、AI 推荐等后段能力，应该按业务风险和依赖关系分批迁移。
+剩余部分不建议再按“旧接口数量”机械推进。第六阶段已经把平台后台、租户后台、交易运营和 Worker 最小闭环打通；第七阶段补齐了学生端视频、签到积分流水和内容导入异步化。后续应按“能上线运营”和“体验增强”拆分。
 
-### 1. 高级交易运营
-
-建议下一批优先迁移。
-
-旧版相关模块：
-
-- `commerce-adjustments.module.ts`
-- `commerce-reconciliation.module.ts`
-- 部分 `commerce-payments.module.ts`
-
-目标能力：
-
-- 退款申请、审核、处理、退款事件。
-- 支付/订单调账凭证。
-- 对账批次、对账明细、对账异常。
-- 对账问题创建、分配、状态流转、处理事件。
-- provider bill jobs 账单下载任务骨架。
-- 管理侧交易异常报表。
-
-为什么优先：
-
-- 当前系统已经能下单、支付、发权益、算佣金。
-- 真实运营里最先遇到的是退款、支付差异、人工调账。
-- 相关数据库模型基本已经存在，适合继续在交易边界内补完整。
-
-建议提交拆分：
-
-1. `feat: add commerce refund operations`
-2. `feat: add commerce reconciliation queries`
-3. `feat: add commerce reconciliation issue workflow`
-4. `feat: add commerce adjustment voucher operations`
-
-### 2. 租户内容导出与 Worker 骨架
-
-旧版相关模块：
-
-- `tenant-content-exports.module.ts`
-- 内容导入/统计/资源扫描相关 worker 逻辑。
-
-目标能力：
-
-- 内容导出任务查询。
-- 创建导出任务。
-- 导出文件落 OSS。
-- 导入任务异步化。
-- 资源安全扫描任务骨架。
-- 统计聚合 worker 骨架。
-
-注意：
-
-- 不要把 worker 和 API 写成一坨。
-- API 只负责创建任务、查询状态、下载结果。
-- Worker 独立处理重试、幂等、失败记录。
-
-### 3. 平台后台基础
-
-旧版相关模块：
-
-- `platform-admin-overview.module.ts`
-- `platform-admin-tenants.module.ts`
-- `platform-admin-question-banks.module.ts`
-
-目标能力：
-
-- 平台总览。
-- 平台权限摘要。
-- 平台员工查询与状态管理。
-- 租户列表、租户状态调整。
-- 租户账单资料。
-- 公库题库授权/采纳管理。
-
-注意：
-
-- 这块是 SaaS 平台运营，不是学生端主链路。
-- 需要先明确平台管理员权限模型，避免继续用粗粒度 `TenantAdmin`。
-
-### 4. 平台账单、催缴、审计告警
-
-旧版相关模块：
-
-- `platform-admin-billing.module.ts`
-- `platform-admin-dunning.module.ts`
-- `platform-admin-audit.module.ts`
-
-目标能力：
-
-- SaaS 套餐和租户订阅。
-- 用量记录与账单生成。
-- 发票、发票明细、收款记录。
-- 催缴提醒与通知渠道。
-- 审计告警规则、告警查询、确认、解决。
-
-注意：
-
-- 这块涉及平台财务和自动化，不建议和学生交易混在一起。
-- 自动生成账单、催缴、告警扫描应放到 Worker。
-
-### 5. AI 推荐报告
+### 1. AI 推荐报告，独立阶段
 
 旧版相关模块：
 
@@ -189,33 +94,67 @@
 - 推荐详情。
 - 推荐报告导出。
 - 推荐生成任务。
+- 租户级 AI Provider 配置、API Key 密钥托管和调用审计。
 
-注意：
+阶段约定：
 
-- 不建议直接照搬旧版。
-- 需要结合分数线动态字段、用户画像、目标院校、志愿规则重新设计。
-- 应等核心数据和 worker 稳定后再做。
+- 默认基于 Microsoft Semantic Kernel 设计 Kernel / Plugin / AI Service 编排。
+- AI Provider 使用 `TenantExternalProvider(capability=ai)`。
+- 租户 API Key 存入 `TenantSecret`，不进入业务 DTO。
+- `Microsoft.SemanticKernel` 只允许出现在 Infrastructure AI provider 实现中。
+- Application 层只暴露业务抽象，例如 `IAiRecommendationProvider` / `IAiKernelFactory`。
+- 不直接照搬旧 prompt 或推荐算法，先结合分数线动态字段、用户画像、目标院校和志愿规则重新设计。
 
-### 6. 零散补齐项
+### 2. 内容导出和导入处理器增强
 
-这些可以穿插迁移，但不建议打断主线：
+当前已经支持导入预览、同步小批量导入、异步 `content_import` job 和导入详情查询。后续增强：
+
+- 内容导出任务查询和创建。
+- 题库、题目、学生数据导出到对象存储。
+- 导入 preview/result/issue 更细化。
+- 大文件导入解析进度、失败行回放和重试。
+- 导入、导出输出资产统一走对象存储 provider，不暴露 bucket/key。
+
+### 3. Worker 处理器补强
+
+当前 Worker 已有统一任务模型、租户 scope 和部分实处理器。后续增强：
+
+- `content_export` 完整导出。
+- `asset_security_scan` 接真实扫描 provider。
+- `statistics_aggregation` 增量聚合。
+- `commerce_reconciliation` 接真实 provider bill downloader。
+- `tenant_domain_recheck` 增加周期调度和告警联动。
+
+### 4. 后台运营细化
+
+平台后台、租户后台和交易运营已有主线能力，后续按运营优先级补：
 
-- 学生端视频搜索、视频观看进度。
 - 租户 secrets 通用后台管理。
-- 租户监督规则。
+- 租户监督规则和跟进报表细化。
 - 租户洞察报表。
 - 更细粒度 RBAC 权限点。
-- 管理后台操作审计补全。
+- 管理后台操作审计覆盖率补齐。
+- 发票、催缴、佣金联动调账。
+
+### 5. 旧路径兼容评估
+
+默认不迁旧 URL，只迁行为能力。只有前端明确依赖且重写成本高时，才增加薄兼容 Controller；兼容层不得恢复旧 Supabase、旧 grant/adoption 公共题库授权模型、旧 `QuestionIds` JSON 或旧 Provider 配置表。
+
+明确不再迁移为主接口：
+
+- `/api/profile/activity-tasks`，由 `/api/points/tasks` 替代。
+- `/api/profile/exchange-items` 和 `/api/profile/exchange-items/redeem`，由 `/api/points/exchange-items`、`/api/points/exchange-orders` 替代。
+- 公共题库 adopt/sync/grant，已被平台公共题库所有权 + `TenantQuestionReference` 模型替代。
+- Supabase 相关任何路径。
 
 ## 推荐后续顺序
 
 ```text
-1. 高级交易运营：退款、对账、调账
-2. 租户内容导出 + Worker 骨架
-3. 平台后台基础：总览、租户、平台员工、公库授权
-4. 平台账单/发票/催缴/审计告警
-5. AI 推荐报告
-6. 零散体验与后台增强
+1. AI 推荐报告独立阶段：Semantic Kernel + 租户自带 API Key
+2. 内容导出 + 导入处理器增强
+3. Worker 统计、扫描、对账、域名复验处理器补强
+4. 后台运营细化：secrets、监督、洞察、审计、发票/催缴
+5. 按前端实际依赖做旧路径兼容评估
 ```
 
 ## 每批固定验收
@@ -225,36 +164,32 @@
 ```bash
 dotnet restore TIKU-BACKEND.slnx
 dotnet build TIKU-BACKEND.slnx --no-restore
-dotnet test TIKU-BACKEND.slnx --no-build
-dotnet format TIKU-BACKEND.slnx --verify-no-changes --no-restore
+dotnet test Tiku.UnitTests/Tiku.UnitTests.csproj --no-build
+dotnet test Tiku.IntegrationTests/Tiku.IntegrationTests.csproj --no-build
 git diff --check
 dotnet ef migrations script \
   --project Tiku.Infrastructure \
   --startup-project Tiku.DbMigrator
+dotnet ef migrations has-pending-model-changes \
+  --project Tiku.Infrastructure \
+  --startup-project Tiku.DbMigrator
 ```
 
 如果某批不涉及数据库 migration，也仍然运行 migration script，确认当前模型快照和迁移链没有损坏。
 
 ## 下一批建议
 
-下一批建议执行：
+下一批建议执行独立 AI 阶段，但先只做架构底座和一个最小推荐报告闭环，不直接接生产模型：
 
-```text
-高级交易运营：退款、对账、调账
-```
-
-建议目标：
-
-- 学生/管理员可查询退款状态。
-- 租户管理员可创建、审核、处理退款申请。
-- 支付回调和退款事件保持幂等。
-- 对账批次、明细、异常问题可查询。
-- 对账异常可创建 issue、流转状态、记录事件。
-- 调账凭证可创建、审核、作废，并影响后续报表口径。
+- 增加 `TenantExternalProviderCapability.Ai` 和密钥配置校验。
+- 增加 Application AI 抽象，不让 Controller 直接接触 SK。
+- Infrastructure 引入 Semantic Kernel provider，实现 fake/local stub 和真实 provider 边界。
+- 设计推荐报告数据模型、任务模型、调用审计和成本记录。
+- 完成报告生成任务、列表、详情和导出骨架。
 
 建议暂缓：
 
-- 自动下载真实微信/支付宝账单。
-- 自动退款真实网关请求。
-- 平台级财务审批流。
-- 发票、催缴、佣金联动调账。
+- 复杂 RAG。
+- 自动志愿填报决策。
+- 多模型路由优化。
+- 生产 API Key 托管 UI 之外的手工配置方案。

docs/migration/contracts/operation-inventory.csv

@@ -1,8 +1,8 @@
 method,path,status,legacy_operation_id,legacy_summary,target_operation_id,target_summary
-GET,/api/ai/school-recommendations,legacy_only,AiController_list,查询院校推荐报告,,
-GET,/api/ai/school-recommendations/detail,legacy_only,AiController_detail,获取院校推荐报告详情,,
-GET,/api/ai/school-recommendations/export,legacy_only,AiController_exportReport,导出院校推荐报告,,
-POST,/api/ai/school-recommendations/generate,legacy_only,AiController_generate,生成院校推荐报告,,
+GET,/api/ai/school-recommendations,legacy_only,AiController_list,查询院校推荐报告,,AI 延后到 Semantic Kernel + 租户自带 API Key 独立阶段
+GET,/api/ai/school-recommendations/detail,legacy_only,AiController_detail,获取院校推荐报告详情,,AI 延后到 Semantic Kernel + 租户自带 API Key 独立阶段
+GET,/api/ai/school-recommendations/export,legacy_only,AiController_exportReport,导出院校推荐报告,,AI 延后到 Semantic Kernel + 租户自带 API Key 独立阶段
+POST,/api/ai/school-recommendations/generate,legacy_only,AiController_generate,生成院校推荐报告,,AI 延后到 Semantic Kernel + 租户自带 API Key 独立阶段
 GET,/api/assets/{assetId}/download,target_only,,,,获取资源下载地址
 GET,/api/assets/{assetId}/preview,target_only,,,,获取资源预览地址
 POST,/api/auth/login/password,target_only,,,,手机号密码登录
@@ -181,22 +181,22 @@ POST,/api/points/exchange-orders,target_only,,,,创建积分兑换订单
 GET,/api/points/summary,target_only,,,,查询当前用户积分摘要
 GET,/api/points/tasks,target_only,,,,查询当前可领取积分任务
 POST,/api/points/tasks/claim,target_only,,,,领取积分任务奖励
-GET,/api/profile/activity-tasks,legacy_only,ProfileController_tasks,查询积分活动任务,,
-POST,/api/profile/activity-tasks/claim,legacy_only,ProfileController_claimTask,领取活动任务奖励,,
+GET,/api/profile/activity-tasks,legacy_only,ProfileController_tasks,查询积分活动任务,,由 /api/points/tasks 替代
+POST,/api/profile/activity-tasks/claim,legacy_only,ProfileController_claimTask,领取活动任务奖励,,由 /api/points/tasks/claim 替代
 GET,/api/profile/badges,exact_match,ProfileController_badges,查询徽章列表,,查询徽章列表
-POST,/api/profile/check-in,legacy_only,ProfileController_checkIn,每日签到,,
+POST,/api/profile/check-in,exact_match,ProfileController_checkIn,每日签到,,每日签到
 GET,/api/profile/exam-countdowns,exact_match,ProfileController_countdowns,查询考试倒计时,,查询考试倒计时
-GET,/api/profile/exchange-items,legacy_only,ProfileController_exchangeItems,查询积分兑换商品,,
-POST,/api/profile/exchange-items/redeem,legacy_only,ProfileController_redeem,兑换积分商品,,
+GET,/api/profile/exchange-items,legacy_only,ProfileController_exchangeItems,查询积分兑换商品,,由 /api/points/exchange-items 替代
+POST,/api/profile/exchange-items/redeem,legacy_only,ProfileController_redeem,兑换积分商品,,由 /api/points/exchange-orders 替代
 GET,/api/profile/feedbacks,exact_match,ProfileController_feedbacks,查询反馈记录,,查询反馈记录
 POST,/api/profile/feedbacks,exact_match,ProfileController_submitFeedback,提交意见反馈,,提交意见反馈
 GET,/api/profile/me,exact_match,ProfileController_me,获取当前学生资料,,获取当前学生资料
 PATCH,/api/profile/me,exact_match,ProfileController_updateMe,更新当前学生资料,,更新当前学生资料
 GET,/api/profile/notifications,exact_match,ProfileController_notificationList,查询用户通知,,查询用户通知
 POST,/api/profile/notifications/status,exact_match,ProfileController_notificationStatus,更新通知状态,,更新通知状态
-GET,/api/profile/score-events,legacy_only,ProfileController_scoreEvents,查询积分流水,,
-GET,/api/questions/videos,legacy_only,QuestionVideoController_list,查询单道题目的解析视频,,
-POST,/api/questions/videos/batch,legacy_only,QuestionVideoController_batch,批量查询题目解析视频,,
+GET,/api/profile/score-events,exact_match,ProfileController_scoreEvents,查询积分流水,,查询当前用户积分流水
+GET,/api/questions/videos,exact_match,QuestionVideoController_list,查询单道题目的解析视频,,查询单道题目的解析视频
+POST,/api/questions/videos/batch,exact_match,QuestionVideoController_batch,批量查询题目解析视频,,批量查询题目解析视频
 POST,/api/referral/bind,exact_match,ReferralPublicController_bind,绑定当前用户的推荐归属,,绑定当前用户推荐归属
 GET,/api/referral/conversion-report,exact_match,ReferralManagementController_conversion,查询推荐转化与佣金报告,,查询推荐转化报告
 POST,/api/referral/invite-code,exact_match,ReferralPublicController_invite,生成或查询当前成员邀请码,,生成或查询当前成员邀请码
@@ -346,24 +346,24 @@ PUT,/api/tenant-content/handbook-subjects,exact_match,HandbookManagementControll
 GET,/api/tenant-content/import-jobs,target_only,,,,查询内容导入任务
 GET,/api/tenant-content/import-jobs/{jobId},target_only,,,,查询内容导入任务详情
 GET,/api/tenant-content/imports,legacy_only,TenantContentImportsController_jobs,查询内容导入任务,,
-GET,/api/tenant-content/imports/detail,legacy_only,TenantContentImportsController_detail,查询内容导入任务详情,,
+GET,/api/tenant-content/imports/detail,exact_match,TenantContentImportsController_detail,查询内容导入任务详情,,查询内容导入任务详情
 GET,/api/tenant-content/imports/field-mapping,exact_match,TenantContentImportsController_fieldMapping,查询导入字段映射说明,,查询导入字段映射
-POST,/api/tenant-content/imports/handbook,legacy_only,TenantContentImportsController_importHandbook,执行或排队知识手册导入,,
+POST,/api/tenant-content/imports/handbook,legacy_only,TenantContentImportsController_importHandbook,执行或排队知识手册导入,,由 /api/tenant-content/imports/{importType} 替代
 GET,/api/tenant-content/imports/issues,exact_match,TenantContentImportsController_issues,查询内容导入问题明细,,查询内容导入问题明细
 GET,/api/tenant-content/imports/post-check,exact_match,TenantContentImportsController_postCheckStatus,查询内容导入后检查状态,,查询内容导入后检查状态
 POST,/api/tenant-content/imports/post-check,exact_match,TenantContentImportsController_runPostCheck,执行内容导入后完整性检查,,执行内容导入后完整性检查
-POST,/api/tenant-content/imports/preview/handbook,legacy_only,TenantContentImportsController_previewHandbook,预览知识手册导入数据,,
-POST,/api/tenant-content/imports/preview/questions,legacy_only,TenantContentImportsController_previewQuestions,预览题目导入数据,,
-POST,/api/tenant-content/imports/preview/scoreline,legacy_only,TenantContentImportsController_previewScoreline,预览分数线导入数据,,
-POST,/api/tenant-content/imports/preview/videos,legacy_only,TenantContentImportsController_previewVideos,预览视频解析导入数据,,
-POST,/api/tenant-content/imports/preview/vocabulary,legacy_only,TenantContentImportsController_previewVocabulary,预览词汇导入数据,,
+POST,/api/tenant-content/imports/preview/handbook,legacy_only,TenantContentImportsController_previewHandbook,预览知识手册导入数据,,由 /api/tenant-content/imports/preview/{importType} 替代
+POST,/api/tenant-content/imports/preview/questions,legacy_only,TenantContentImportsController_previewQuestions,预览题目导入数据,,由 /api/tenant-content/imports/preview/{importType} 替代
+POST,/api/tenant-content/imports/preview/scoreline,legacy_only,TenantContentImportsController_previewScoreline,预览分数线导入数据,,由 /api/tenant-content/imports/preview/{importType} 替代
+POST,/api/tenant-content/imports/preview/videos,legacy_only,TenantContentImportsController_previewVideos,预览视频解析导入数据,,由 /api/tenant-content/imports/preview/{importType} 替代
+POST,/api/tenant-content/imports/preview/vocabulary,legacy_only,TenantContentImportsController_previewVocabulary,预览词汇导入数据,,由 /api/tenant-content/imports/preview/{importType} 替代
 POST,/api/tenant-content/imports/preview/{importType},target_only,,,,预览内容导入数据
-POST,/api/tenant-content/imports/questions,legacy_only,TenantContentImportsController_importQuestions,执行或排队题目导入,,
-POST,/api/tenant-content/imports/scoreline,legacy_only,TenantContentImportsController_importScoreline,执行或排队分数线导入,,
+POST,/api/tenant-content/imports/questions,legacy_only,TenantContentImportsController_importQuestions,执行或排队题目导入,,由 /api/tenant-content/imports/{importType} 替代
+POST,/api/tenant-content/imports/scoreline,legacy_only,TenantContentImportsController_importScoreline,执行或排队分数线导入,,由 /api/tenant-content/imports/{importType} 替代
 GET,/api/tenant-content/imports/templates,exact_match,TenantContentImportsController_template,获取内容导入模板,,获取内容导入模板
-POST,/api/tenant-content/imports/videos,legacy_only,TenantContentImportsController_importVideos,执行或排队视频解析导入,,
-POST,/api/tenant-content/imports/vocabulary,legacy_only,TenantContentImportsController_importVocabulary,执行或排队词汇导入,,
-POST,/api/tenant-content/imports/{importType},target_only,,,,执行同步内容导入
+POST,/api/tenant-content/imports/videos,legacy_only,TenantContentImportsController_importVideos,执行或排队视频解析导入,,由 /api/tenant-content/imports/{importType} 替代
+POST,/api/tenant-content/imports/vocabulary,legacy_only,TenantContentImportsController_importVocabulary,执行或排队词汇导入,,由 /api/tenant-content/imports/{importType} 替代
+POST,/api/tenant-content/imports/{importType},target_only,,,,执行同步或异步内容导入
 GET,/api/tenant-content/media-analytics/asset-events,legacy_only,TenantContentAssetsController_assetAnalytics,查询媒体资产访问明细,,
 GET,/api/tenant-content/media-analytics/summary,legacy_only,TenantContentAssetsController_summary,查询媒体访问分析汇总,,
 GET,/api/tenant-content/media-analytics/video-events,legacy_only,TenantContentAssetsController_videoAnalytics,查询媒体视频播放明细,,
@@ -409,7 +409,7 @@ PUT,/api/tenant-content/vocabulary-words,exact_match,VocabularyManagementControl
 GET,/api/tenant/current-public,target_only,,,,获取公开租户配置
 GET,/api/tenant/resolve,exact_match,TenantController_resolve,解析当前租户,,解析当前租户
 GET,/api/tenants/current,target_only,,,,
-POST,/api/videos/play,legacy_only,VideoController_play,申请视频播放地址,,
-POST,/api/videos/progress,legacy_only,VideoController_progress,上报视频播放进度,,
-GET,/api/videos/search,legacy_only,VideoController_search,搜索通用解析视频,,
+POST,/api/videos/play,exact_match,VideoController_play,申请视频播放地址,,申请视频播放地址
+POST,/api/videos/progress,exact_match,VideoController_progress,上报视频播放进度,,上报视频播放进度
+GET,/api/videos/search,exact_match,VideoController_search,搜索通用解析视频,,搜索通用解析视频
 GET,/health,legacy_only,HealthController_check,检查 API 与数据库健康状态,,

docs/migration/phase-7-student-experience-and-content-consumption.md

@@ -0,0 +1,75 @@
+# 第七阶段：学生端体验与内容消费闭环
+
+第七阶段只补齐学生端和内容消费闭环，不实现 AI 推荐报告。AI 后续单独进入 Semantic Kernel 阶段，租户自己的模型 API Key 通过 `TenantExternalProvider` + `TenantSecret` 配置，业务 DTO、Controller 和普通 Service 不直接接触密钥或 `Microsoft.SemanticKernel` namespace。
+
+## 已实现范围
+
+### 视频消费
+
+新增学生端视频接口：
+
+- `GET /api/videos/search`
+- `POST /api/videos/play`
+- `POST /api/videos/progress`
+- `GET /api/questions/videos`
+- `POST /api/questions/videos/batch`
+
+设计边界：
+
+- 播放接口只返回当前租户可访问的视频播放信息。
+- API 不暴露 OSS bucket、真实 object key 或 provider 细节。
+- 公共题关联视频和租户私题关联视频都必须先通过当前租户可见性校验。
+- 播放行为写入 `ContentAssetAccessEvent`。
+- 播放进度写入 `VideoPlaybackProgress`，同一租户、用户、视频、题目维度幂等更新。
+
+### Profile 与积分
+
+新增学生侧体验接口：
+
+- `POST /api/profile/check-in`
+- `GET /api/profile/score-events`
+
+设计边界：
+
+- 签到复用积分任务与积分流水，不另起一套奖励体系。
+- 同一用户、同一租户、同一天只能成功签到一次。
+- 积分任务领取和积分兑换会同步产生 `UserScoreEvent`，学生端统一从 `score-events` 查询积分变化。
+- 旧 `/api/profile/activity-tasks`、`/api/profile/exchange-items` 不恢复为主接口；对应能力由 `/api/points/tasks`、`/api/points/exchange-items`、`/api/points/exchange-orders` 替代。
+
+### 内容导入异步化
+
+保留统一导入入口：
+
+- `POST /api/tenant-content/imports/preview/{importType}`
+- `POST /api/tenant-content/imports/{importType}`
+- `GET /api/tenant-content/imports/detail`
+
+设计边界：
+
+- `questions`、`vocabulary`、`handbook`、`scoreline`、`videos` 这些旧专用导入语义统一映射为 `importType`。
+- 小批量可以同步执行。
+- 请求显式 `async=true` 或大批量导入时创建 `content_import` 后台任务。
+- Worker 通过 `ITenantExecutionScope` 初始化租户 scope 后执行导入，不在请求线程内跑重任务。
+- 导入结果写回 import job，可通过 detail 接口查询。
+
+## AI 延后约定
+
+本阶段不新增 `/api/ai/**`，不引入 `Microsoft.SemanticKernel` NuGet 包，也不实现真实模型调用、prompt、RAG、导出或推荐算法。
+
+后续 AI 阶段默认方向：
+
+- AI Provider 使用 `TenantExternalProvider(capability=ai)`。
+- 租户 API Key 存入 `TenantSecret`，通过 `SecretRef` 关联。
+- Semantic Kernel SDK 只允许出现在 Infrastructure AI provider 实现中。
+- Application 层只暴露 `IAiRecommendationProvider`、`IAiKernelFactory` 等业务抽象。
+- Controller 和业务 Service 不直接读取 API Key，不直接引用 SK namespace。
+
+## 验收重点
+
+- 租户 A 不能播放租户 B 视频。
+- 公共题关联视频和租户私题关联视频都按当前租户权限返回。
+- 播放进度重复上报幂等更新。
+- 每日签到同一天只能成功一次。
+- 签到、积分任务和兑换产生可查询的积分流水。
+- 异步导入创建 `content_import` job，Worker 成功写入结果。
+- 本阶段不得新增 `Microsoft.SemanticKernel` 引用。