rckrdmrd/trading-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fe380858c4
trading-platform/orchestration/tareas/TASK-2026-01-25-PHASE1-MVP/03-PLANEACION.md
Adrian Flores Cortes 9c2fce0083 docs: Complete documentation for notifications system implementation 
- Create TASK-2026-01-25-NOTIFICACIONES-COMPLETAS with full CAPVED docs
- Update DATABASE_INVENTORY with auth.notifications, auth.user_push_tokens,
  investment.distribution_history, investment.distribution_runs tables
- Update BACKEND_INVENTORY with push-token endpoints, firebase.client,
  and unit tests
- Update FRONTEND_INVENTORY with notification components, store, service
- Update MASTER_INVENTORY with updated totals
- Update _INDEX.yml with new task entry

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 04:10:09 -06:00

2.3 KiB
Raw Blame History

03-PLANEACION - Phase 1 MVP Implementation

Plan de Implementación

Task 10: Servicio de Notificaciones

Archivos a Crear

  1. notification.service.ts (~500 líneas)

    • Clase NotificationService
    • Métodos: sendNotification, sendBulkNotification, broadcastNotification
    • Canales: in_app (WebSocket), email, push
    • Preferencias de usuario (quiet hours, disabled types)
    • Templates de email por tipo

  2. notification.controller.ts (~180 líneas)

    • getNotifications, getUnreadCount
    • markAsRead, markAllAsRead
    • deleteNotification
    • getPreferences, updatePreferences

  3. notification.routes.ts (~50 líneas)

    • GET /notifications
    • GET /notifications/unread-count
    • GET /notifications/preferences
    • PATCH /notifications/preferences
    • POST /notifications/read-all
    • PATCH /notifications/:id/read
    • DELETE /notifications/:id

  4. index.ts (exports)

Modificaciones

  1. alerts.service.ts: Integrar con notificationService en triggerAlert()
  2. index.ts: Agregar notificationRouter a API routes

Task 11: Distribution Job

Archivos a Crear

  1. distribution.job.ts (~300 líneas)

    • Clase DistributionJob
    • Scheduler: setInterval para 00:00 UTC
    • Métodos: run, getActiveAccounts, distributeReturns
    • Cálculo de retornos diarios basado en producto
    • Aplicación de performance fees
    • Registro en distribution_history
    • Notificación a usuarios

  2. index.ts (exports)

Modificaciones

  1. index.ts: Inicializar distributionJob.start() al arrancar servidor

Orden de Implementación

1. notification.service.ts     [Core]
2. notification.controller.ts  [API]
3. notification.routes.ts      [Routing]
4. notifications/index.ts      [Exports]
5. Modificar alerts.service.ts [Integración]
6. distribution.job.ts         [Core]
7. investment/jobs/index.ts    [Exports]
8. Modificar main index.ts     [Startup]

Criterios de Aceptación

  • Notificaciones en tiempo real via WebSocket
  • Emails enviados con templates correctos
  • API REST funcional para gestión de notificaciones
  • Alertas de precio envían notificaciones automáticamente
  • Distribution job programado para 00:00 UTC
  • Cálculo correcto de rendimientos por producto
  • Historial de distribuciones registrado
  • TypeScript compila sin errores