浅念
85b2da3db5
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>
56 lines
1.7 KiB
JSON
56 lines
1.7 KiB
JSON
{
|
|
"name": "@photo/api-cn",
|
|
"version": "0.1.0",
|
|
"private": true,
|
|
"description": "CN NestJS API service (P1a skeleton: bootstrap, /v1/health, request-id, error envelope)",
|
|
"scripts": {
|
|
"build": "tsc -p tsconfig.build.json",
|
|
"build:watch": "tsc -p tsconfig.build.json --watch",
|
|
"start": "tsc -p tsconfig.build.json && node dist/main-cn.js",
|
|
"start:ov": "tsc -p tsconfig.build.json && node dist/main-ov.js",
|
|
"seed": "tsc -p tsconfig.build.json && node dist/scripts/seed-admin.js",
|
|
"typecheck": "tsc --noEmit",
|
|
"lint": "eslint .",
|
|
"test": "jest",
|
|
"test:e2e": "jest --config jest.e2e.config.ts"
|
|
},
|
|
"dependencies": {
|
|
"@nestjs/common": "^10.4.6",
|
|
"@nestjs/core": "^10.4.6",
|
|
"@nestjs/event-emitter": "^3.1.0",
|
|
"@nestjs/platform-express": "^10.4.6",
|
|
"@nestjs/platform-ws": "^10.4.6",
|
|
"@nestjs/websockets": "^10.4.6",
|
|
"@node-rs/argon2": "^2.2.1",
|
|
"@photo/contracts": "workspace:*",
|
|
"@photo/db-cn": "workspace:*",
|
|
"@photo/db-ov": "workspace:*",
|
|
"@photo/storage": "workspace:^",
|
|
"bullmq": "^6.3.6",
|
|
"class-transformer": "^0.5.1",
|
|
"class-validator": "^0.15.1",
|
|
"ioredis": "^6.0.0",
|
|
"nestjs-pino": "^4.6.1",
|
|
"pino": "^10.0.0",
|
|
"pino-http": "^11.0.0",
|
|
"reflect-metadata": "^0.2.2",
|
|
"rxjs": "^7.8.1",
|
|
"ws": "^8.18.0"
|
|
},
|
|
"devDependencies": {
|
|
"@aws-sdk/client-s3": "^3.700.0",
|
|
"@nestjs/testing": "^10.4.6",
|
|
"@types/jest": "^29.5.13",
|
|
"@types/node": "^22.10.0",
|
|
"@types/supertest": "^6.0.2",
|
|
"@types/ws": "^8.5.12",
|
|
"dotenv": "^16.4.5",
|
|
"jest": "^29.7.0",
|
|
"sharp": "^0.35.0",
|
|
"supertest": "^7.0.0",
|
|
"ts-jest": "^29.2.5",
|
|
"ts-node": "^10.9.2",
|
|
"typescript": "^5.6.0"
|
|
}
|
|
}
|