feat: add feedback checkins exam dates

docs/refactor/taro-frontend-integration.md

@@ -147,7 +147,7 @@ tenant:<tenantId>:theme
 | --- | --- |
 | 启动页 | `GET /api/tenant/resolve` |
 | 登录页 | `POST /api/auth/sms/send`、`POST /api/auth/sms/verify`、`POST /api/auth/oauth/wechat-miniapp`、后续微信网页/QQ provider |
-| 首页 | `/api/catalog/content-entries`、`/api/catalog/banners`、`/api/catalog/announcements`、`/api/profile/me` |
+| 首页 | `/api/catalog/content-entries`、`/api/catalog/banners`、`/api/catalog/announcements`、`/api/catalog/exam-dates`、`/api/profile/me` |
 | 选地区 | `/api/catalog/regions`、`/api/commerce/entitlements/check` |
 | 题库入口 | `/api/catalog/content-entries` |
 | 分类树 | `/api/catalog/content-nodes?entryId=...&parentId=root` |
@@ -160,6 +160,7 @@ tenant:<tenantId>:theme
 | 收藏夹 | `GET/POST /api/learning/favorites/questions` |
 | 练习历史/统计 | `GET /api/learning/practice-sessions/history`、`GET /api/learning/stats`、`GET /api/learning/trend` |
 | 题目视频 | `GET /api/questions/{questionId}/videos`、`POST /api/questions/videos/batch`、`POST /api/videos/play` |
+| 题目反馈 | `POST /api/profile/feedbacks`、`GET /api/profile/feedbacks` |
 | 背单词 | `/api/catalog/vocabulary-units`、`/api/catalog/vocabulary-words` |
 | 单词进度/计划 | `/api/learning/vocabulary/progress`、`/api/learning/vocabulary/stats`、`/api/learning/vocabulary/review-plan`、`POST /api/learning/vocabulary/review` |
 | 单词收藏 | `/api/learning/vocabulary/favorites` |
@@ -169,7 +170,7 @@ tenant:<tenantId>:theme
 | 商城 | `/api/catalog/svip-plans`、`POST /api/commerce/orders`、`POST /api/commerce/payments/create` |
 | 订单/权益 | `/api/commerce/orders`、`/api/commerce/entitlements` |
 | 激活码兑换 | `POST /api/commerce/activation-codes/redeem` |
-| 个人中心 | `GET/PATCH /api/profile/me` |
+| 个人中心 | `GET/PATCH /api/profile/me`、`POST /api/profile/check-in`、`GET /api/profile/score-events`、`GET /api/profile/exam-countdowns` |
 | 销售分享 | `/api/referral/resolve`、`track-event`、`bind` |
 | 租户班级 | `GET/PUT /api/tenant-admin/classes`、`POST /api/tenant-admin/classes/disable` |
 | 班级成员 | `GET/PUT /api/tenant-admin/classes/members`、`POST /api/tenant-admin/classes/members/remove`、`POST /api/tenant-admin/classes/members/bulk-assign` |
@@ -177,6 +178,8 @@ tenant:<tenantId>:theme
 | 学生备注 | `GET/PUT /api/tenant-admin/students/notes` |
 | 学生跟进任务 | `GET/PUT /api/tenant-admin/students/followups` |
 | 租户教师 | `GET /api/tenant-admin/teachers` |
+| 租户考试日期 | `GET/PUT /api/tenant-admin/exam-dates` |
+| 租户反馈处理 | `GET /api/tenant-admin/feedbacks`、`POST /api/tenant-admin/feedbacks/status`、`GET /api/tenant-admin/feedbacks/events` |
 
 ## 练习访问控制契约
 
@@ -416,6 +419,56 @@ GET /api/learning/vocabulary/review-plan?unitId=<unitId>&reviewLimit=30&newLimit
 - 签名 URL 过期后必须重新调用 `/api/videos/play`，不要重试旧 URL。
 - 小程序/H5 不保存对象存储真实 key，不把播放 URL 写入本地持久缓存。
 
+## 考试倒计时、签到积分和反馈
+
+首页可用 `GET /api/catalog/exam-dates?regionId=<regionId>` 展示地区公开考试日期；个人中心优先用 `GET /api/profile/exam-countdowns`，后端会按学生当前 `regionId/selectedSchoolId` 返回匹配倒计时。
+
+签到入口调用：
+
+```http
+POST /api/profile/check-in
+```
+
+返回关键字段：
+
+```json
+{
+  "item": {
+    "checkedIn": true,
+    "alreadyCheckedIn": false,
+    "pointsAdded": 10,
+    "streak": 1,
+    "score": 10,
+    "lastCheckInDate": "2026-06-29"
+  }
+}
+```
+
+前端处理规则：
+
+- `alreadyCheckedIn=true` 时展示今日已签到，不要本地再加分。
+- 积分明细调用 `GET /api/profile/score-events`。
+- 积分最终余额以后端 `score` 和流水为准，前端只做展示。
+
+题目页、资料页或视频页可提交反馈：
+
+```json
+{
+  "questionId": "...",
+  "type": "question_error",
+  "category": "answer",
+  "title": "题目解析有误",
+  "description": "请填写具体问题",
+  "attachments": []
+}
+```
+
+前端处理规则：
+
+- `questionId` 如存在，后端会校验题目必须属于当前租户。
+- 反馈状态由租户后台处理，学生可用 `GET /api/profile/feedbacks` 查看自己的反馈历史。
+- 租户后台处理反馈时，奖励积分由后端 `idempotency_key` 保证不会重复发放，前端不要重复叠加。
+
 ## 题库新模型接入方式
 
 旧项目常按“地区 -> 科目 -> 章节/试卷”固定层级处理。新项目不要写死层级，按下面模型渲染：
@@ -618,6 +671,8 @@ GET /api/commerce/entitlements
 - 题目/单词/知识手册/分数线/视频维护
 - JSON 导入 preview/import/issues
 - Banner/FAQ/公告/激活码/优惠券
+- 考试日期：`GET/PUT /api/tenant-admin/exam-dates`
+- 题目反馈：`GET /api/tenant-admin/feedbacks`、`POST /api/tenant-admin/feedbacks/status`、`GET /api/tenant-admin/feedbacks/events`
 - 销售/代理/CRM 队列
 
 租户后台不应在前端自行决定权限；隐藏菜单只是体验优化，接口仍会校验权限。角色模板用于让租户配置“运营、教师、销售、代理”等自定义后台体验，成员绑定模板后，前端按模板的菜单/模块/字段权限渲染，后端按 permission keys 执行真正的访问控制。班级/学生范围权限由后端根据角色、模板 `dataScope.classIds` 和 `tenant_class_members` 计算，教师默认只能看到自己负责班级。