/** * 活动服务(API_INVENTORY 行 92-96, 98) * * 封装:活动列表 / 详情 / 报名 / 我的活动 / 反馈 / 互选意向提交。 * 关键不变量(AGENTS.md): * - 第 6 条:活动单向意向保密——A 选 B 但 B 没选 → B 不知道。 * 前端调用 interests 提交后,结果接口只返回"匹配成功"的双向交集, * 不返回对方是否单独选了我。 * - 第 1 条:用户永久免费——feeType=paid 仅作为后端字段,前端展示以"公益免费"为主标识。 * 报名与互选均走幂等键防重(AGENTS 第 12 条:参数配置化)。 */ const api = require('../utils/api'); /** * 活动列表(API_INVENTORY 行 92) * @param {{ status?: string, cursor?: string, pageSize?: number }} params * @returns {Promise<{ items: Array, nextCursor: string|null }>} */ function getActivities(params = {}) { return api.get('/activities', params); } /** * 活动详情(API_INVENTORY 行 93) * @param {string} activityId * @returns {Promise} */ function getActivityDetail(activityId) { return api.get(`/activities/${encodeURIComponent(activityId)}`); } /** * 报名活动(API_INVENTORY 行 94) * @param {string} activityId * @param {{ remark?: string }} [payload] * @returns {Promise<{ registrationStatus: 'pending', registrationId: string }>} */ function register(activityId, payload = {}) { const idempotencyKey = `activity-register:${activityId}:${Date.now()}`; return api.post(`/activities/${encodeURIComponent(activityId)}/register`, payload, undefined, idempotencyKey); } /** * 取消报名(Phase 15) * 后端:DELETE /activities/{activityId}/register * * 说明:后端为 UNIQUE(activity_id, user_id) 设计,取消后原记录保留为 cancelled, * 再次报名会**复用**该记录(不会撞唯一键),因此取消不是不可逆操作。 */ function cancelRegistration(activityId) { return api.delete(`/activities/${encodeURIComponent(activityId)}/register`); } /** * 我的活动(API_INVENTORY 行 95) * @param {{ status?: string, cursor?: string, pageSize?: number }} params * @returns {Promise<{ items: Array, nextCursor: string|null }>} */ function getMyActivities(params = {}) { return api.get('/my-activities', params); } /** * 提交活动反馈(API_INVENTORY 行 96) * @param {string} activityId * @param {{ rating: number, content: string }} payload * @returns {Promise<{ submitted: true }>} */ function submitFeedback(activityId, payload) { const idempotencyKey = `activity-feedback:${activityId}:${Date.now()}`; return api.post(`/activities/${encodeURIComponent(activityId)}/feedback`, payload, undefined, idempotencyKey); } /** * 提交活动互选意向(API_INVENTORY 行 98,AGENTS 第 6 条:单向意向保密) * @param {string} activityId * @param {{ likedUserIds: string[] }} payload * @returns {Promise<{ submitted: true, matchedUserIds: string[] }>} * matchedUserIds 仅包含双向匹配成功的人;未匹配的人不会泄露是否被对方选择。 */ function submitInterests(activityId, payload) { const idempotencyKey = `activity-interests:${activityId}:${Date.now()}`; return api.post(`/activities/${encodeURIComponent(activityId)}/interests`, payload, undefined, idempotencyKey); } module.exports = { getActivities, getActivityDetail, register, cancelRegistration, getMyActivities, submitFeedback, submitInterests, };