微信小程序页面迁移校验之前 P5任务处理之前

apps/backend/docs/API-REFERENCE.md

@@ -51,8 +51,8 @@
 }
 ```
 说明：
-- 首次登录自动创建 `auth.users` 记录（status=pending）
-- pending 用户获得受限令牌（`limited=True`），仅可访问申请相关端点
+- 首次登录自动创建 `auth.users` 记录（status=new），前端引导至申请页
+- new/pending/rejected 用户获得受限令牌（`limited=True`），仅可访问申请相关端点
 - approved 用户获得完整令牌，包含 `site_id` 和 `roles`
 
 ### POST `/api/xcx-auth/apply`
@@ -114,6 +114,17 @@
 { "refresh_token": "..." }
 ```
 
+### POST `/api/xcx-auth/dev-login`
+开发模式 mock 登录（仅 `WX_DEV_MODE=true` 时注册）。
+
+请求体：
+```json
+{ "openid": "模拟openid", "status": "approved" }
+```
+说明：
+- `status` 可选，为空时保留已有用户当前状态，新用户默认 `new`
+- 仅开发/测试环境可用
+
 ---
 
 ## 3. 任务配置 `/api/tasks`
@@ -326,8 +337,90 @@ MVP 全链路验证端点，从 `test."xcx-test"` 表读取数据。
 ### GET/POST `/api/wx-callback`
 微信消息推送回调。GET 用于签名验证，POST 用于接收消息。
 
-### POST `/api/member-birthday`
-助教手动补录会员生日。
+---
+
+## 11. 管理端申请审核 `/api/admin/applications`
+
+### GET `/api/admin/applications`
+获取待审核申请列表。需管理后台 JWT。
+
+### POST `/api/admin/applications/{id}/approve`
+批准申请。
+
+### POST `/api/admin/applications/{id}/reject`
+拒绝申请。
+
+---
+
+## 12. 营业日配置 `/api/business-day`
+
+### GET `/api/business-day/config`
+获取营业日分割点配置（`BUSINESS_DAY_START_HOUR`）。
+
+---
+
+## 13. 小程序任务 `/api/xcx/tasks`
+
+所有端点需 JWT（approved 状态）。
+
+### GET `/api/xcx/tasks`
+获取当前助教的活跃任务列表。
+
+响应：`TaskListItem[]`
+
+### POST `/api/xcx/tasks/{id}/pin`
+置顶任务。
+
+### POST `/api/xcx/tasks/{id}/unpin`
+取消置顶。
+
+### POST `/api/xcx/tasks/{id}/abandon`
+放弃任务（需填写原因）。
+
+请求体：
+```json
+{ "reason": "放弃原因" }
+```
+
+### POST `/api/xcx/tasks/{id}/cancel-abandon`
+取消放弃，恢复为活跃状态。
+
+---
+
+## 14. 小程序备注 `/api/xcx/notes`
+
+所有端点需 JWT（approved 状态）。
+
+### POST `/api/xcx/notes`
+创建备注（含星星评分，可选关联任务）。
+
+请求体：
+```json
+{
+  "target_type": "member",
+  "target_id": 1,
+  "content": "备注内容",
+  "task_id": null,
+  "rating_service_willingness": 4,
+  "rating_revisit_likelihood": 3
+}
+```
+
+### GET `/api/xcx/notes`
+查询某目标的备注列表（按创建时间倒序）。
+
+查询参数：
+- `target_type`：目标类型（默认 `member`）
+- `target_id`：目标 ID（必填）
+
+### DELETE `/api/xcx/notes/{id}`
+删除备注（验证归属后硬删除）。
+
+---
+
+## 15. 维客线索 `/api/member-retention-clue`
+
+替代原 `member-birthday` 端点，提供维客线索管理能力。
 
 ### WebSocket `/ws/logs/{execution_id}`
 实时日志推送。连接后自动接收指定执行的日志流。