Files
Edu/services/msg
SpecialX 7474a92e3b feat(p5): messaging, push gateway and AI assistant services
P5 阶段交付物:
- services/msg: 消息通知服务(NestJS)
  - notifications: 发送通知 + ES 全文检索 + search
  - config/elasticsearch.ts: ES Client 单例
  - package.json: 补充 @opentelemetry/sdk-node + exporter-trace-otlp-http
- services/push-gateway: WebSocket 推送网关(Go Gin)
  - internal/hub/hub.go: WebSocket 连接池管理(Register/Unregister/SendToUser)
  - internal/ws/handler.go: JWT 鉴权 + WebSocket 升级 + 内部推送 API
- services/ai: AI 辅助服务(Python FastAPI)
  - /chat + /chat/stream(SSE 流式)
  - /generate/question + /optimize/expression
  - config.py: OpenAI 兼容 API 配置
- packages/shared-proto/proto/msg.proto: NotificationService 契约(send/search)
- packages/shared-proto/proto/ai.proto: AiService 契约(含 stream 方法)
2026-07-08 01:39:02 +08:00
..

Msg 消息通知服务

版本0.1P5 骨架) 端口3007

职责

消息通知限界上下文,管理通知的多渠道分发(站内信、邮件、短信、推送)。 消费 Kafka 事件,写入 MySQL + Elasticsearch调用 Push Gateway 实时推送。

技术栈

  • NestJS 10 + TypeScript 5
  • Drizzle ORM + MySQL 8
  • Elasticsearch 8全文检索
  • Kafka事件消费骨架
  • pino + prom-client + OpenTelemetry

开发

pnpm install
pnpm dev   # http://localhost:3007

API

方法 路径 说明
POST /notifications 发送通知
GET /notifications 查询用户通知列表
POST /notifications/:id/read 标记已读
GET /notifications/search?q= 全文检索通知

环境变量

变量 默认值 说明
PORT 3007 服务端口
DATABASE_URL - MySQL 连接串
KAFKA_BROKERS localhost:9092 Kafka broker 列表
ES_URL http://localhost:9200 Elasticsearch 地址
JWT_SECRET - JWT 密钥