danyang-match/miniapp/services/activityService.js

/**
 * 活动服务（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<import('../types').Activity>, nextCursor: string|null }>}
 */
function getActivities(params = {}) {
  return api.get('/activities', params);
}

/**
 * 活动详情（API_INVENTORY 行 93）
 * @param {string} activityId
 * @returns {Promise<import('../types').Activity & { registrationStatus: import('../types').RegistrationStatus }>}
 */
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 = api.idempotencyKey('activity-register', activityId);
  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<import('../types').Activity & { registrationStatus: import('../types').RegistrationStatus }>, 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 }>}
 */
/**
 * 提交活动反馈（含表达意向 via interestTargetUserIds）
 *
 * 注意：此前的 `submitInterests()` → `POST /activities/{id}/interests`
 * **后端不存在该端点**（Phase 16 已把表达意向合并进本流程），调用必然 404。
 * 全仓确认无页面调用方，属设计残留，已删除。若需要独立的互选提交接口，
 * 须先由产品定义语义并补后端端点。
 */
function submitFeedback(activityId, payload) {
  const idempotencyKey = api.idempotencyKey('activity-feedback', activityId);
  return api.post(`/activities/${encodeURIComponent(activityId)}/feedback`, payload, undefined, idempotencyKey);
}

module.exports = {
  getActivities,
  getActivityDetail,
  register,
  cancelRegistration,
  getMyActivities,
  submitFeedback,
};