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。
55 lines
1.9 KiB
JavaScript
55 lines
1.9 KiB
JavaScript
/**
|
||
* 红娘服务(API_INVENTORY 行 102-105)
|
||
*
|
||
* 封装:申请红娘服务 / 我的服务列表 / 服务详情 / 红娘推荐列表。
|
||
* 关键不变量(AGENTS.md):
|
||
* - 第 5 条:红娘不可替用户 Like——红娘只产出推荐,最终 Like/Pass 由用户本人操作。
|
||
* 本层不提供任何"代用户操作"的接口;推荐操作走 matchService.like/pass。
|
||
* - 第 7 条:普通工作人员不能查看私人聊天——本层无聊天接入入口。
|
||
*/
|
||
const api = require('../utils/api');
|
||
|
||
/**
|
||
* 申请红娘服务(API_INVENTORY 行 102)
|
||
* @param {{ requirement: string }} payload 用户对自己择偶需求的进一步描述
|
||
* @returns {Promise<{ serviceId: string, status: 'submitted' }>}
|
||
*/
|
||
function applyService(payload) {
|
||
const idempotencyKey = api.idempotencyKey('matchmaker-apply');
|
||
return api.post('/matchmaker/services', payload, undefined, idempotencyKey);
|
||
}
|
||
|
||
/**
|
||
* 我的服务列表(API_INVENTORY 行 103)
|
||
* @param {{ cursor?: string, pageSize?: number }} params
|
||
* @returns {Promise<{ items: Array<import('../types').MatchmakerService>, nextCursor: string|null }>}
|
||
*/
|
||
function getMyServices(params = {}) {
|
||
return api.get('/matchmaker/services', params);
|
||
}
|
||
|
||
/**
|
||
* 服务详情(API_INVENTORY 行 104)
|
||
* @param {string} serviceId
|
||
* @returns {Promise<import('../types').MatchmakerService>}
|
||
*/
|
||
function getServiceDetail(serviceId) {
|
||
return api.get(`/matchmaker/services/${encodeURIComponent(serviceId)}`);
|
||
}
|
||
|
||
/**
|
||
* 红娘推荐列表(API_INVENTORY 行 105)
|
||
* @param {{ serviceId?: string, cursor?: string, pageSize?: number }} params
|
||
* @returns {Promise<{ items: Array<import('../types').MatchmakerRecommendation>, nextCursor: string|null }>}
|
||
*/
|
||
function getRecommendations(params = {}) {
|
||
return api.get('/matchmaker/recommendations', params);
|
||
}
|
||
|
||
module.exports = {
|
||
applyService,
|
||
getMyServices,
|
||
getServiceDetail,
|
||
getRecommendations,
|
||
};
|