9c2fce0083
- 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>
4.1 KiB
4.1 KiB
05-EJECUCION - Phase 1 MVP Implementation
Resumen de Ejecución
Fecha: 2026-01-25 Agente: claude-opus-4.5 Duración: ~30 minutos
Archivos Creados
1. Módulo de Notificaciones
notification.service.ts
Ubicación: apps/backend/src/modules/notifications/services/notification.service.ts
Líneas: ~650
Funcionalidades:
- sendNotification(userId, payload, options)
- sendBulkNotification(userIds, payload, options)
- broadcastNotification(payload)
- sendInAppNotification(userId, notification) - via WebSocket
- sendEmailNotification(userId, payload) - via nodemailer
- sendPushNotification(userId, payload) - estructura para FCM/APNS
- getUserNotifications(userId, options)
- markAsRead(notificationId, userId)
- markAllAsRead(userId)
- getUnreadCount(userId)
- deleteNotification(notificationId, userId)
- getUserPreferences(userId)
- updateUserPreferences(userId, updates)
- sendAlertNotification(userId, alert) - para price alerts
- sendTradeNotification(userId, trade)
- sendDistributionNotification(userId, distribution)
Templates de Email:
- alert_triggered
- trade_executed
- deposit_confirmed
- withdrawal_completed
- distribution_received
- system_announcement
- security_alert
- account_update
notification.controller.ts
Ubicación: apps/backend/src/modules/notifications/controllers/notification.controller.ts
Líneas: ~180
Endpoints:
- getNotifications: GET /notifications
- getUnreadCount: GET /notifications/unread-count
- markAsRead: PATCH /notifications/:id/read
- markAllAsRead: POST /notifications/read-all
- deleteNotification: DELETE /notifications/:id
- getPreferences: GET /notifications/preferences
- updatePreferences: PATCH /notifications/preferences
notification.routes.ts
Ubicación: apps/backend/src/modules/notifications/notification.routes.ts
Líneas: ~50
Rutas protegidas con requireAuth
notifications/index.ts
Ubicación: apps/backend/src/modules/notifications/index.ts
Líneas: ~10
Exports: notificationService, notificationRouter
2. Job de Distribución
distribution.job.ts
Ubicación: apps/backend/src/modules/investment/jobs/distribution.job.ts
Líneas: ~350
Funcionalidades:
- start(): Programa ejecución diaria a 00:00 UTC
- stop(): Detiene el scheduler
- run(): Ejecuta distribución manual o programada
- getActiveAccounts(): Obtiene cuentas activas con balance > 0
- getProducts(): Obtiene productos con tasas de retorno
- distributeReturns(account, product): Calcula y distribuye rendimientos
- notifyUser(result): Envía notificación de distribución
- logDistributionRun(summary): Registra auditoría
- getStatus(): Estado del job
- triggerManually(): Para admin/testing
Lógica de Distribución:
- Daily rate = (targetReturnMin + targetReturnMax) / 2 / 30
- Varianza aleatoria: -15% a +35%
- Performance fee aplicado sobre rendimiento bruto
- Solo distribuye si rendimiento neto > 0
- Transacción atómica con lock de fila
investment/jobs/index.ts
Ubicación: apps/backend/src/modules/investment/jobs/index.ts
Líneas: ~5
Export: distributionJob
Archivos Modificados
alerts.service.ts
Cambios:
+1 import: notificationService
+15 líneas en triggerAlert(): Llamada a sendAlertNotification
Antes:
// TODO: Send notifications based on notify_email and notify_push
Después:
try {
await notificationService.sendAlertNotification(alert.userId, {
symbol: alert.symbol,
condition: alert.condition,
targetPrice: alert.price,
currentPrice,
note: alert.note,
});
} catch (error) {
logger.error('[AlertsService] Failed to send alert notification:', {...});
}
index.ts (main)
Cambios:
+1 import: distributionJob
+1 import: notificationRouter
+1 línea: apiRouter.use('/notifications', notificationRouter)
+1 línea: distributionJob.start() (después de WebSocket init)
+1 línea: distributionJob.stop() (en graceful shutdown)
Validación Final
# TypeScript check para archivos de notificaciones
npx tsc --noEmit 2>&1 | grep -E "(notification|distribution)"
# Sin errores
Estado Final
✅ Task 10: Notification Service - COMPLETADA ✅ Task 11: Distribution Job - COMPLETADA