博客系统自文档 · RPG 技术实现

博客系统自文档 · 第 10/16 篇
目录 · 上一篇：RPG 玩法全览 · 下一篇：事件驱动与模块解耦

写在前面

第 9 篇讲了 RPG 玩什么；本篇讲 怎么搭：模块目录、实时推送、异步经验三条线。

功能与体验（技术视角）

Home 端：use-rpg-realtime-handlers.ts 把 WS 事件映射为 Toast / 全屏动画。

设计与实现

模块目录（按领域）

rpg/
├── core/          rpg.service, rpg-notify.service, punishment
├── level/         sign, article-level
├── social/        tip, social-interact, reputation
├── lottery/       lottery
├── listeners/     rpg-event.consumer  ← 消费 blog:events
└── entity/        17+ 表

单一 RpgModule 注册全部 provider，API 前缀 /rpg/*。

实时推送链

• 网关统一在 core/realtime，不是独立 /rpg namespace
• 事件名见 ws-events.ts：levelUp、expGain、achievementComplete 等
• Nginx：/socket.io/ → :5000

异步：Redis Stream

Comment/Like/Article → BlogEventPublisher → blog:events
    → rpg-event.consumer → 加经验/成就/任务进度

解耦原因：评论接口快速返回，RPG 计算与 DB 写入在 consumer 里重试、聚合。

物品配置单一数据源

rpg_item_config + 启动种子 COSMETIC_ITEM_SEEDS；C 端展示字段 API 下发，Home 不硬编码物品 map。

踩坑与取舍

1. RpgNotifyService 防抖：连续 exp 合并推送，避免 WS 风暴。
2. BanGuard：禁言用户 RPG 接口 403，与 banStatus WS 联动。
3. PM2 多实例：Socket.IO 靠 Redis Adapter 同步 room。

系列导航

• 导读 · 第 0 篇
• 玩法：第 9 篇 · 下一篇：11 事件驱动

延伸阅读

• RPG-TECH.md、table.md
• core/realtime/README.md