docs(api): 回归补登记 活动报名/签到/问卷/名册/审核中心接口与口径

T18 回归门禁：为今日（2026-10-23）T15/T16/T17 工作链路中新增或变更、
但此前未登记的接口统一补录：
- ActivityController: /register, /checkin, /checkin-review
- AdminActivityCheckinController: /list, /add, /review
- RelationshipQuestionnaireController: /generate, /submit, /snapshot, /history
- registration-roster 名册数据口径（approved_count 原子维护）
- ReviewCenterController 审核统计 real_name 过滤口径

docs/superpowers/api/API_REFERENCE.md

@@ -1879,6 +1879,52 @@ Web 管理端定义活动海报模板（迁移381 `activity_poster_templates`
 
 *文档更新：2026-10-22（活动详情页新增报名情况）*
 
+### 4.55 活动报名/签到/问卷（本次回归补登记）
+
+> 以下接口在 2026-10-23 的 T15/T16/T17 任务链路中新增或变更，此前未在本文档登记，此处统一补录。
+
+#### 4.55.1 活动报名（`ActivityController`，前缀 `/api/activity`）
+
+| 路径 | 说明 |
+|---|---|
+| `POST /api/activity/register` | 活动报名（body: `activityId`；批量报名历史字段 `registrants`）。活动 `requireReview=1`（默认免审）→ 报名记录为 `pending` 不占名额；免审即 `approved` 并原子占用名额 |
+
+#### 4.55.2 活动签到与签到审核（`ActivityController`）
+
+| 路径 | 说明 |
+|---|---|
+| `POST /api/activity/checkin` | 活动签到（body: `activityId`）。活动级 `requireCheckinReview=1` 时签到进入 `pending_review`，审核通过才发奖励；免审直接发放 |
+| `POST /api/activity/checkin-review` | 签到审核（仅活动管理员/平台管理员）。通过发放积分/能量/CF，驳回不发放 |
+
+#### 4.55.3 管理端签到（`AdminActivityCheckinController`，前缀 `/api/admin/activity-checkins`）
+
+| 路径 | 说明 |
+|---|---|
+| `POST /api/admin/activity-checkins/list` | 按活动分页查询签到记录 |
+| `POST /api/admin/activity-checkins/add` | 手动补录签到（幂等，桥接触发课时入账） |
+| `POST /api/admin/activity-checkins/review` | 修改签到审核状态（通过发放课时/奖励） |
+
+**与规划师课时桥接**：签到审核通过会触发课时发放，与 `AdminPlannerOfflineCourseController` 的活动↔类别映射联动（见第五章）。
+
+#### 4.55.4 家庭关系问卷（`RelationshipQuestionnaireController`，前缀 `/api/family/questionnaire`）
+
+| 路径 | 说明 |
+|---|---|
+| `POST /api/family/questionnaire/generate` | AI 生成关系问卷快照（body: `memberId`；`respondentId` 由后端按登录用户覆盖，校验调用人与目标成员同家庭），返回题目集与 `snapshotId` |
+| `POST /api/family/questionnaire/submit` | 提交答卷（body: `snapshotId` + 答案），写入响应记录 |
+| `POST /api/family/questionnaire/snapshot/{memberId}` | 查询某成员当前快照 |
+| `POST /api/family/questionnaire/history/{memberId}` | 某成员问卷历史提交记录 |
+
+#### 4.55.5 报名名册数据口径（2026-10-23 本次回归涉及）
+
+`POST /api/activity/registration-roster` 的 `approvedCount` 现直接读 `activities.approved_count`（迁移回填），不再实时统计；剩余名额 = `max - approved`，下单/退款链路（`register`/`cancel`/`OrderTimeoutCancelTask`）通过原子 SQL 维护该计数，防超卖。
+
+#### 4.55.6 审核中心统计口径变更（2026-10-23）
+
+`ReviewCenterController` 的 `guidePending` / `nutritionistPending` 统计新增 `real_name IS NOT NULL` 过滤，与列表接口口径一致（commit `f61547a21`）；前端 `ArticleAudit.vue` 驳回原因字段由 `row.reason` 修正为 `row.rejectReason`。
+
+*文档更新：2026-10-23（T15/T16/T17 回归补登记：活动报名、签到与签到审核、管理端签到、家庭关系问卷、名册口径、审核中心统计口径）*
+
 ---
 
 ## 4.48 组织管理（机构/企业组织）