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。
38 lines
1.4 KiB
JavaScript
38 lines
1.4 KiB
JavaScript
/**
|
||
* 申诉服务(REST §80 章 POST /appeals)
|
||
*
|
||
* 封装:提交申诉 / 我的申诉列表。
|
||
* 关键不变量(AGENTS.md):
|
||
* - 第 8 条:敏感数据默认拒绝——本层不接受身份证号、手机号等敏感字段,
|
||
* 申诉内容只接收 reason + 证据图片 URL(已上传至 OSS)。
|
||
* - 第 4 条:Block 优先级最高——申诉不会自动恢复账号或解除拉黑,
|
||
* 是否解封由运营人工处置。
|
||
*/
|
||
const api = require('../utils/api');
|
||
|
||
/**
|
||
* 提交申诉(REST §81 章)
|
||
* @param {{ appealType: 'ban_appeal'|'suspend_appeal', relatedActionId?: string, reason: string, evidenceFileIds?: string[], contactMethod?: string }} payload
|
||
* @returns {Promise<{ appealId: string, status: 'pending', submittedAt: number }>}
|
||
*/
|
||
function submitAppeal(payload) {
|
||
// 幂等键:申诉类型 + 关联处置 ID + 当前秒,防止用户多次点击重复提交
|
||
const actionKey = payload.relatedActionId || 'no_action';
|
||
const idempotencyKey = api.idempotencyKey('appeal', `${payload.appealType}:${actionKey}`);
|
||
return api.post('/appeals', payload, undefined, idempotencyKey);
|
||
}
|
||
|
||
/**
|
||
* 我的申诉列表
|
||
* @param {{ cursor?: string, pageSize?: number, status?: string }} params
|
||
* @returns {Promise<{ items: Array<import('../types').Appeal>, nextCursor: string|null }>}
|
||
*/
|
||
function getMyAppeals(params = {}) {
|
||
return api.get('/me/appeals', params);
|
||
}
|
||
|
||
module.exports = {
|
||
submitAppeal,
|
||
getMyAppeals,
|
||
};
|