WorkBuddy
8dee67040c
1) 幂等键（配合后端机制）
原写法把 Date.now() 拼进幂等键，每次调用都生成新键，即使后端实现了幂等
也永远不会命中 —— 声明端与实现端各自都坏。
api.idempotencyKey(scope, subject)：键缓存在 _pendingIdempotency（TTL 10min），
同一逻辑操作在成功之前复用同一把键，收到 200+success 才释放；失败（含网络错误）
不释放，下次重试沿用同一把键。25 处调用点（8 个 service + 2 个 TS 页面）全部替换，
Date.now 幂等键写法残留经 grep 为 0。
2) 删除死代码 submitInterests
它请求 POST /activities/{id}/interests —— 后端从未实现该端点
（Phase 16 已把表达意向合并进 /activities/{id}/feedback 的
interestTargetUserIds）。全仓确认无任何页面/组件调用方。
两个文件各留注释说明删除原因与恢复条件：若产品确认需要独立的
「提交互选」端点，应先定义语义并补后端实现，再恢复前端方法。
store 头部关于 AGENTS 第 6 条（单向意向保密）的注释同步改为引用
submitFeedback 返回的 newMutuals。
41 lines
1.7 KiB
JavaScript
41 lines
1.7 KiB
JavaScript
/**
|
||
* 举报与安全服务（API_INVENTORY 行 110-111）
|
||
*
|
||
* 封装：提交举报 / 我的举报列表。
|
||
* 关键不变量（AGENTS.md）：
|
||
* - 第 8 条：敏感数据默认拒绝——本层不接受身份证号、手机号等敏感字段，
|
||
* 举报内容只接收 reason + 证据图片 URL（已上传至 OSS）。
|
||
* - 第 4 条：Block 优先级最高——举报不会自动 Block，是否 Block 由用户主动调用
|
||
* matchService.block；举报后由运营人工处置。
|
||
*/
|
||
const api = require('../utils/api');
|
||
|
||
/**
|
||
* 提交举报（REST §81 章 POST /reports）
|
||
*
|
||
* 请求体字段对齐 REST 规范：targetUserId / reportType / description / evidenceFileIds。
|
||
* evidenceFileIds 为已上传至 OSS 的文件 ID 列表（由调用方先上传图片获取 fileId）。
|
||
*
|
||
* @param {{ targetUserId: string, reportType: import('../types').ReportType, description: string, evidenceFileIds?: string[] }} payload
|
||
* @returns {Promise<{ reportId: string, status: 'pending', submittedAt: number }>}
|
||
*/
|
||
function submitReport(payload) {
|
||
// 幂等键：目标用户 + 举报类型 + 当前秒，防止用户多次点击重复提交
|
||
const idempotencyKey = api.idempotencyKey('report', `${payload.targetUserId}:${payload.reportType}`);
|
||
return api.post('/reports', payload, undefined, idempotencyKey);
|
||
}
|
||
|
||
/**
|
||
* 我的举报列表（REST §80 章 GET /me/reports）
|
||
* @param {{ cursor?: string, pageSize?: number, status?: string }} params
|
||
* @returns {Promise<{ items: Array<import('../types').Report>, nextCursor: string|null }>}
|
||
*/
|
||
function getMyReports(params = {}) {
|
||
return api.get('/me/reports', params);
|
||
}
|
||
|
||
module.exports = {
|
||
submitReport,
|
||
getMyReports,
|
||
};
|