feat(ov): idempotent batched likes and realtime broadcast
P2 Task 7(点赞批次端点 + ov 实时网关):
- interactions 模块(仅 ov 装配):POST /public/albums/{token}/photos/
{photoId}/likes——相册不可见/照片未发布 404、delta 1..20 与
sessionId/batchId 1..64 校验 400;单事务 like_batches 唯一插入
(P2002=幂等重试,batchAccepted=true 不重加)→ photos_ov.likeTotal/
countVersion 原子自增回读 → outbox_stat_events(kind=likes) 兜底;
Redis ov(REDIS_URL_OV)INCRBY+TTL 会话/IP 双窗口限流(默认
500/2000,超限 429 RATE_LIMITED),幂等重试先于限流不耗额度
- 过期批次重放边界(24h 清理后的 batchId 重插会再次计入):接受该
边界——无永久账本可查(保留全量批次行违背清理策略),会话/IP 窗口
上限即重放天然封顶(同一 sessionId 重放挤占自身额度),偏差已在
likes.service 头注释登记,Task 8 统计侧按清理后语义处理
- realtime:ContractWsAdapter(契约 {type,...} 帧分发,ws 与 HTTP 同
端口挂 /v1/realtime)+ RealtimeGateway 相册房间模型——subscribe 逐
相册校验 isAlbumVisibleOv,失败回 error 帧且连接保持;应用层 ping→
pong 回显 ts;传输层 HEARTBEAT_MS 周期 ping 踢死连接;点赞提交经
EventEmitter2(单进程,多实例 Redis pub/sub 登记 P5)触发
likes.burst 500ms 合并窗(delta 聚合、originBatchIds 供客户端过滤
自身批次);sync-inbox 应用事务提交后发 OV_PHOTO_APPLIED →
photo.published/hidden/deleted 按房间广播(stale/duplicate/暂存/
缺席即撤下不转发)
- 契约:REALTIME_WS_PATH、ServerMessage 增 error 帧(穷尽锁 7 成员
+ 类型测试)、LIKE_SESSION_WINDOW_DELTA/LIKE_IP_WINDOW_DELTA/
LIKE_BURST_MERGE_MS 常量与 .env.example
- e2e(likes-realtime.e2e-spec.ts,6 用例):A09 三批累加/幂等重试/
outbox 行、小额度 429、ping/pong+幽灵 token error 帧连接保持、
A10 双房间隔离(先证非空调订)、合并窗单 burst(delta 求和+双
originBatchIds)、cn 隐藏→房间收 photo.hidden+隐藏后点赞 404;
凡进程内起 AppOvModule 的 spec(sync×2/public-ov/emergency)补装
ContractWsAdapter 与生产 main-ov 一致——api e2e 168(162+6)
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
// services/api/src/redis-ov/ —— OV 侧 Redis(redis-ov 6381)的可注入封装
|
||||
// (P2 Task 7)。与 OvPrismaService 同款约定:非 @Global、独立类名,仅 ov
|
||||
// 角色模块(interactions 等)显式 import,防止 cn 角色模块误注入。首个消费方
|
||||
// 是点赞基础限速(sessionId/IP 滑窗 INCRBY+EXPIRE);P5 多实例部署时本连接
|
||||
// 亦是跨进程实时扇出(pub/sub)的就位基础(见 realtime/ov-events.ts 头注)。
|
||||
//
|
||||
// 生命周期:构造即连接(ioredis 缺省急连 + 自动重连),onModuleDestroy 断开
|
||||
// ——e2e 的 app.close() 不残留句柄。error 事件挂 no-op 监听(同 queue.provider
|
||||
// 约定:未监听的 error 会崩进程,重连风暴交给命令失败语义)。Redis 不可用时
|
||||
// 依赖它的端点 5xx(限速是 ov 互动域的组成环节,不做 fail-open——开放匿名
|
||||
// 写入端点在基础设施故障时的正确姿势是拒绝而非放行)。
|
||||
import {
|
||||
Injectable,
|
||||
Module,
|
||||
type OnModuleDestroy,
|
||||
} from '@nestjs/common';
|
||||
import IORedis from 'ioredis';
|
||||
|
||||
@Injectable()
|
||||
export class OvRedisService
|
||||
extends IORedis
|
||||
implements OnModuleDestroy
|
||||
{
|
||||
constructor() {
|
||||
super(process.env.REDIS_URL_OV ?? 'redis://127.0.0.1:6381', {
|
||||
// 滑窗限速命令的失败要快速上抛(5xx),不做长时间排队重试。
|
||||
maxRetriesPerRequest: 2,
|
||||
});
|
||||
// no-op 监听:吞掉重连期 error 事件(命令层失败已向上传播)。
|
||||
this.on('error', () => undefined);
|
||||
}
|
||||
|
||||
async onModuleDestroy(): Promise<void> {
|
||||
await this.quit().catch(() => undefined);
|
||||
}
|
||||
}
|
||||
|
||||
@Module({
|
||||
providers: [OvRedisService],
|
||||
exports: [OvRedisService],
|
||||
})
|
||||
export class OvRedisModule {}
|
||||
Reference in New Issue
Block a user