[CLAUDE] App+Infra+Api+FE: SignalR realtime notifications E2E
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 2m43s

Clean-arch split:
- Application: IRealtimeNotifier (PushToUserAsync, abstraction)
- Api: NotificationHub (/hubs/notifications, [Authorize]) +
  SignalRNotifier impl với IHubContext<NotificationHub>, uses
  Clients.User(userId) (default provider resolves NameIdentifier="sub")
- Infrastructure: NotificationPushInterceptor — SaveChangesInterceptor
  capture Notification entities state=Added trong SavingChanges,
  push qua IRealtimeNotifier trong SavedChanges sau khi commit thành
  công. Zero caller changes — handlers chỉ cần db.Add(Notification).
  Attached vào ApplicationDbContext cùng với AuditingInterceptor.

Auth:
- JWT config thêm OnMessageReceived event: read ?access_token= từ
  query string khi path = /hubs/* (WebSockets không set headers).
- SignalRNotifier singleton (stateless, chỉ delegate IHubContext).

FE (both apps):
- @microsoft/signalr 8.0.7 vào package.json.
- lib/realtime.ts: singleton connection với lazy start + automatic
  reconnect [0,2s,5s,10s,15s] + accessTokenFactory lấy từ localStorage.
- NotificationBell: useEffect subscribe 'notification-created' khi
  isAuthenticated. On push: invalidate query + toast.message. Fallback
  polling giảm từ 30s → 60s (realtime cover gap).
- AuthContext.logout: dynamic import stopConnection() — avoid leaking
  auth'd socket across users.

Result: ERP-grade feel. Contract transition → Drafter nhận toast ngay
trong vòng 100-300ms (same-origin WebSocket), không cần F5 hay polling.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
pqhuy1987
2026-04-21 20:56:37 +07:00
parent 2a851caa92
commit ea9ab5e352
14 changed files with 319 additions and 3 deletions

View File

@ -0,0 +1,15 @@
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.SignalR;
namespace SolutionErp.Api.Hubs;
// JWT-authenticated hub. Users subscribe automatically to their own channel via
// Clients.User(userId) — SignalR resolves userId via IUserIdProvider (default
// uses ClaimTypes.NameIdentifier which our JWT sets to "sub").
[Authorize]
public class NotificationHub : Hub
{
// Client-callable ping for heartbeat/debug. Clients auto-join their user
// channel on connect — no explicit join method needed.
public string Ping() => "pong";
}

View File

@ -0,0 +1,15 @@
using Microsoft.AspNetCore.SignalR;
using SolutionErp.Application.Common.Interfaces;
namespace SolutionErp.Api.Hubs;
public class SignalRNotifier(IHubContext<NotificationHub> hub) : IRealtimeNotifier
{
public async Task PushToUserAsync(Guid userId, string eventName, object payload, CancellationToken ct = default)
{
// Clients.User(userId) uses default IUserIdProvider → reads
// ClaimTypes.NameIdentifier. Our JWT places the user id in "sub"
// which ASP.NET maps to NameIdentifier, so this resolves correctly.
await hub.Clients.User(userId.ToString()).SendAsync(eventName, payload, ct);
}
}