ceb7ffec25
## T-04.3: Archive obsolete documentation - Created _archive/2026-01-07-trazas/ (5 files, 64 KB) - Created _archive/2026-01-10-simco-v37/ (51 files, 524 KB) - Created _archive/2026-01-10-sprint5/ (19 files, 216 KB) - Created _archive/_INDEX-ARCHIVED.md with full inventory - Total: 75 files archived, 816 KB organized ## T-04.4: Consolidate sprint history - Created HISTORICO-SPRINTS.md with 9 sprints documented - Sprint 1-5: Initial implementation (42 SP) - Sprint 6-9: Sales, Commissions, Portfolio, MLM/Goals (218 SP) - Total: 260 SP across 23 modules Directories cleaned: analisis/, analisis-previo/, planes/, trazas/ Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
572 lines
14 KiB
Markdown
572 lines
14 KiB
Markdown
# TRAZA DE TAREAS - BACKEND
|
|
|
|
**Proyecto:** template-saas
|
|
**Capa:** Backend
|
|
**Version:** 1.0.0
|
|
**Inicio:** 2026-01-07
|
|
|
|
---
|
|
|
|
## HISTORIAL
|
|
|
|
### [2026-01-07] SAAS-010-BACKEND-AUTH
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~1h
|
|
**SP:** 5
|
|
|
|
#### Descripcion
|
|
Implementacion del modulo de autenticacion NestJS con JWT, multi-tenant support, y session management.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/
|
|
├── package.json
|
|
├── tsconfig.json
|
|
├── .env.example
|
|
└── src/
|
|
├── main.ts
|
|
├── app.module.ts
|
|
├── config/
|
|
│ ├── env.config.ts
|
|
│ ├── database.config.ts
|
|
│ └── index.ts
|
|
└── modules/
|
|
└── auth/
|
|
├── auth.module.ts
|
|
├── auth.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── user.entity.ts
|
|
│ ├── session.entity.ts
|
|
│ ├── token.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── login.dto.ts
|
|
│ ├── register.dto.ts
|
|
│ ├── reset-password.dto.ts
|
|
│ └── index.ts
|
|
├── services/
|
|
│ ├── auth.service.ts
|
|
│ └── index.ts
|
|
├── strategies/
|
|
│ ├── jwt.strategy.ts
|
|
│ └── index.ts
|
|
├── guards/
|
|
│ ├── jwt-auth.guard.ts
|
|
│ └── index.ts
|
|
└── decorators/
|
|
├── public.decorator.ts
|
|
├── current-user.decorator.ts
|
|
├── tenant.decorator.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades Implementadas
|
|
- Login/Register con validacion
|
|
- JWT Access + Refresh tokens
|
|
- Password reset flow
|
|
- Email verification flow
|
|
- Session management
|
|
- Multi-tenant context via headers
|
|
- Guards y decorators reutilizables
|
|
- Swagger documentation
|
|
|
|
#### Dependencias
|
|
- @nestjs/jwt, @nestjs/passport, passport-jwt
|
|
- bcrypt, class-validator, @nestjs/swagger
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-011-BACKEND-TENANTS
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~20m
|
|
**SP:** 3
|
|
|
|
#### Descripcion
|
|
Modulo basico de tenants con entity y service.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/tenants/
|
|
├── tenants.module.ts
|
|
├── tenants.controller.ts
|
|
├── tenants.service.ts
|
|
├── entities/tenant.entity.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- Entity mapeada a schema tenants.tenants
|
|
- Service para consultas de tenant
|
|
- Controller basico (lectura)
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-012-BACKEND-USERS
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~20m
|
|
**SP:** 3
|
|
|
|
#### Descripcion
|
|
Modulo de usuarios con listado, consulta y actualizacion.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/users/
|
|
├── users.module.ts
|
|
├── users.controller.ts
|
|
├── users.service.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- Listado paginado por tenant
|
|
- Consulta individual
|
|
- Actualizacion de perfil
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-013-BACKEND-HEALTH
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~10m
|
|
**SP:** 1
|
|
|
|
#### Descripcion
|
|
Modulo de health checks para monitoreo.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/health/
|
|
├── health.module.ts
|
|
├── health.controller.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Endpoints
|
|
- GET /api/v1/health - Health check completo
|
|
- GET /api/v1/health/live - Liveness probe
|
|
- GET /api/v1/health/ready - Readiness probe
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-014-BACKEND-RBAC
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~30m
|
|
**SP:** 3
|
|
|
|
#### Descripcion
|
|
Sistema completo de roles y permisos con guards reutilizables.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/rbac/
|
|
├── rbac.module.ts
|
|
├── rbac.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── role.entity.ts
|
|
│ ├── user-role.entity.ts
|
|
│ ├── permission.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── create-role.dto.ts
|
|
│ ├── assign-role.dto.ts
|
|
│ └── index.ts
|
|
├── services/
|
|
│ ├── rbac.service.ts
|
|
│ └── index.ts
|
|
└── guards/
|
|
├── permissions.guard.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- CRUD de roles por tenant
|
|
- Asignacion de roles a usuarios
|
|
- Verificacion de permisos
|
|
- Guard reutilizable @RequirePermissions()
|
|
- Guard reutilizable @RequireRoles()
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-016-BACKEND-NOTIFICATIONS
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~30m
|
|
**SP:** 3
|
|
|
|
#### Descripcion
|
|
Modulo de notificaciones con templates y preferencias de usuario.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/notifications/
|
|
├── notifications.module.ts
|
|
├── notifications.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── notification.entity.ts
|
|
│ ├── notification-template.entity.ts
|
|
│ ├── user-notification-preference.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── create-notification.dto.ts
|
|
│ ├── send-template-notification.dto.ts
|
|
│ ├── update-preferences.dto.ts
|
|
│ └── index.ts
|
|
└── services/
|
|
├── notifications.service.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- Listado de notificaciones por usuario
|
|
- Marcar como leida/todas leidas
|
|
- Preferencias de notificacion
|
|
- Envio desde templates
|
|
- Contador de no leidas
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-015-BACKEND-BILLING
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~40m
|
|
**SP:** 5
|
|
|
|
#### Descripcion
|
|
Modulo de billing con suscripciones, facturas y metodos de pago.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/billing/
|
|
├── billing.module.ts
|
|
├── billing.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── subscription.entity.ts
|
|
│ ├── invoice.entity.ts
|
|
│ ├── payment-method.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── create-subscription.dto.ts
|
|
│ ├── update-subscription.dto.ts
|
|
│ ├── create-payment-method.dto.ts
|
|
│ └── index.ts
|
|
└── services/
|
|
├── billing.service.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- CRUD suscripciones
|
|
- Cambio de plan
|
|
- Cancelacion de suscripcion
|
|
- Listado y detalle de facturas
|
|
- Gestion de metodos de pago
|
|
- Resumen de billing
|
|
- Check de estado de suscripcion
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-017-BACKEND-TESTS
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~30m
|
|
**SP:** 2
|
|
|
|
#### Descripcion
|
|
Tests unitarios para el modulo de autenticacion.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/auth/__tests__/
|
|
├── auth.service.spec.ts
|
|
├── auth.controller.spec.ts
|
|
└── jwt.strategy.spec.ts
|
|
apps/backend/jest.config.js
|
|
```
|
|
|
|
#### Cobertura
|
|
- AuthService: register, login, logout, changePassword, resetPassword, verifyEmail
|
|
- AuthController: todos los endpoints
|
|
- JwtStrategy: validate
|
|
- 25+ test cases
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-018-BACKEND-AUDIT
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~30m
|
|
**SP:** 2
|
|
|
|
#### Descripcion
|
|
Modulo de audit logs con interceptor global para registro automatico.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/audit/
|
|
├── audit.module.ts
|
|
├── audit.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── audit-log.entity.ts
|
|
│ ├── activity-log.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── query-audit.dto.ts
|
|
│ ├── query-activity.dto.ts
|
|
│ ├── create-activity.dto.ts
|
|
│ └── index.ts
|
|
├── services/
|
|
│ ├── audit.service.ts
|
|
│ └── index.ts
|
|
└── interceptors/
|
|
├── audit.interceptor.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- Registro automatico via interceptor global
|
|
- Query de audit logs con filtros y paginacion
|
|
- Activity logs para tracking de usuario
|
|
- Estadisticas de auditoria
|
|
- Historial por entidad
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-019-BACKEND-FEATURE-FLAGS
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~40m
|
|
**SP:** 3
|
|
|
|
#### Descripcion
|
|
Sistema de feature flags con soporte para tenant y user overrides.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/feature-flags/
|
|
├── feature-flags.module.ts
|
|
├── feature-flags.controller.ts
|
|
├── index.ts
|
|
├── entities/
|
|
│ ├── feature-flag.entity.ts
|
|
│ ├── tenant-flag.entity.ts
|
|
│ ├── user-flag.entity.ts
|
|
│ └── index.ts
|
|
├── dto/
|
|
│ ├── create-flag.dto.ts
|
|
│ ├── update-flag.dto.ts
|
|
│ ├── set-tenant-flag.dto.ts
|
|
│ └── index.ts
|
|
└── services/
|
|
├── feature-flags.service.ts
|
|
└── index.ts
|
|
```
|
|
|
|
#### Funcionalidades
|
|
- CRUD de feature flags
|
|
- Toggle global de flags
|
|
- Overrides por tenant
|
|
- Overrides por usuario
|
|
- Evaluacion de flags con contexto
|
|
- Rollout gradual con porcentaje
|
|
- Targeting rules
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-022-STRIPE
|
|
**Estado:** completado
|
|
**Agente:** Backend-Agent
|
|
**Duracion:** ~45m
|
|
**SP:** 5
|
|
|
|
#### Descripcion
|
|
Integracion completa con Stripe para pagos y suscripciones.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/billing/
|
|
├── services/
|
|
│ └── stripe.service.ts (nuevo)
|
|
├── controllers/
|
|
│ ├── stripe.controller.ts (nuevo)
|
|
│ ├── stripe-webhook.controller.ts (nuevo)
|
|
│ └── index.ts (nuevo)
|
|
└── dto/
|
|
└── stripe-webhook.dto.ts (nuevo)
|
|
```
|
|
|
|
#### Funcionalidades Implementadas
|
|
- Gestion de clientes Stripe (crear, buscar, actualizar)
|
|
- Gestion de suscripciones (crear, cancelar, actualizar plan)
|
|
- Checkout sessions para nuevas suscripciones
|
|
- Billing portal para autoservicio
|
|
- Payment methods (listar, adjuntar, configurar default)
|
|
- Setup intents para agregar tarjetas
|
|
- Webhook handler completo con verificacion de firma
|
|
- Sincronizacion automatica de eventos:
|
|
- customer.subscription.* (crear/actualizar/cancelar)
|
|
- invoice.paid / invoice.payment_failed
|
|
- payment_method.attached / payment_method.detached
|
|
- checkout.session.completed
|
|
|
|
#### Configuracion Requerida
|
|
```env
|
|
STRIPE_SECRET_KEY=sk_test_xxx
|
|
STRIPE_PUBLISHABLE_KEY=pk_test_xxx
|
|
STRIPE_WEBHOOK_SECRET=whsec_xxx
|
|
```
|
|
|
|
#### Endpoints Nuevos
|
|
- POST /api/v1/stripe/checkout-session
|
|
- POST /api/v1/stripe/billing-portal
|
|
- POST /api/v1/stripe/setup-intent
|
|
- GET /api/v1/stripe/prices
|
|
- GET /api/v1/stripe/customer
|
|
- POST /api/v1/stripe/customer
|
|
- GET /api/v1/stripe/payment-methods
|
|
- POST /api/v1/webhooks/stripe (publico)
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-FE-010-SUPERADMIN-MODULE
|
|
**Estado:** completado
|
|
**Agente:** Frontend-Agent (con componente backend)
|
|
**Duracion:** ~30m (backend)
|
|
**SP:** 2 (backend)
|
|
|
|
#### Descripcion
|
|
Modulo backend de superadmin para gestion de tenants a nivel plataforma.
|
|
|
|
#### Archivos Creados
|
|
```
|
|
apps/backend/src/modules/superadmin/
|
|
├── superadmin.module.ts
|
|
├── superadmin.controller.ts
|
|
├── superadmin.service.ts
|
|
├── dto/
|
|
│ └── index.ts (CreateTenantDto, UpdateTenantDto, UpdateTenantStatusDto, ListTenantsQueryDto)
|
|
└── index.ts
|
|
```
|
|
|
|
#### Cambios DDL
|
|
**Ninguno** - Utiliza entidades existentes (Tenant, User, Subscription)
|
|
|
|
#### Endpoints Creados
|
|
| Metodo | Ruta | Descripcion |
|
|
|--------|------|-------------|
|
|
| GET | /superadmin/dashboard/stats | Estadisticas del dashboard |
|
|
| GET | /superadmin/tenants | Lista paginada con filtros |
|
|
| GET | /superadmin/tenants/:id | Detalle de tenant |
|
|
| POST | /superadmin/tenants | Crear tenant |
|
|
| PATCH | /superadmin/tenants/:id | Actualizar tenant |
|
|
| PATCH | /superadmin/tenants/:id/status | Cambiar estado |
|
|
| DELETE | /superadmin/tenants/:id | Eliminar tenant |
|
|
| GET | /superadmin/tenants/:id/users | Usuarios del tenant |
|
|
|
|
#### Funcionalidades
|
|
- CRUD completo de tenants
|
|
- Listado con filtros y paginacion
|
|
- Cambio de estado con razon
|
|
- Estadisticas de dashboard (total, activos, trial, suspendidos)
|
|
- Consulta de usuarios por tenant
|
|
- Protegido con JwtAuthGuard + PermissionsGuard
|
|
- Requiere rol 'superadmin'
|
|
|
|
---
|
|
|
|
### [2026-01-07] SAAS-FE-011-SUPERADMIN-METRICS
|
|
**Estado:** completado
|
|
**Agente:** Frontend-Agent (con componente backend)
|
|
**Duracion:** ~20m (backend)
|
|
**SP:** 2 (backend)
|
|
|
|
#### Descripcion
|
|
Endpoints de metricas avanzadas para el portal superadmin.
|
|
|
|
#### Archivos Modificados
|
|
```
|
|
apps/backend/src/modules/superadmin/
|
|
├── superadmin.controller.ts (6 endpoints nuevos)
|
|
└── superadmin.service.ts (6 metodos nuevos)
|
|
```
|
|
|
|
#### Cambios DDL
|
|
**Ninguno** - Utiliza queries sobre tablas existentes (tenants, users, subscriptions)
|
|
|
|
#### Endpoints Creados
|
|
| Metodo | Ruta | Descripcion |
|
|
|--------|------|-------------|
|
|
| GET | /superadmin/metrics | Resumen completo de metricas |
|
|
| GET | /superadmin/metrics/tenant-growth | Crecimiento de tenants por mes |
|
|
| GET | /superadmin/metrics/user-growth | Crecimiento de usuarios por mes |
|
|
| GET | /superadmin/metrics/plan-distribution | Distribucion por plan |
|
|
| GET | /superadmin/metrics/status-distribution | Distribucion por estado |
|
|
| GET | /superadmin/metrics/top-tenants | Top tenants por usuarios |
|
|
|
|
#### Funcionalidades
|
|
- Crecimiento de tenants por mes (configurable 6/12 meses)
|
|
- Crecimiento de usuarios por mes
|
|
- Distribucion de tenants por plan con porcentajes
|
|
- Distribucion de tenants por estado con porcentajes
|
|
- Top tenants ordenados por cantidad de usuarios
|
|
- Resumen completo en un solo endpoint
|
|
|
|
---
|
|
|
|
## TAREAS PENDIENTES
|
|
|
|
| ID | Tarea | Prioridad | SP | Dependencias |
|
|
|----|-------|-----------|-----|--------------|
|
|
| - | Backend Fase 1 + Superadmin completado | - | - | - |
|
|
|
|
---
|
|
|
|
## METRICAS
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| Modulos creados | 10 (auth, tenants, users, health, rbac, notifications, billing, audit, feature-flags, superadmin) |
|
|
| Endpoints | 77+ |
|
|
| Entities | 17 |
|
|
| DTOs | 33 |
|
|
| Guards | 2 (JwtAuth, Permissions) |
|
|
| Decorators | 5 |
|
|
| Interceptors | 1 (Audit) |
|
|
| Services | 11 (incluyendo StripeService, SuperadminService) |
|
|
| Tests | 25+ |
|
|
| SP completados | 37/37 (100% Backend Fase 1 + Stripe + Superadmin) |
|
|
|
|
---
|
|
|
|
## STACK TECNOLOGICO
|
|
|
|
- **Framework:** NestJS 11
|
|
- **ORM:** TypeORM
|
|
- **Auth:** Passport + JWT
|
|
- **Validation:** class-validator
|
|
- **Documentation:** Swagger/OpenAPI
|
|
- **Database:** PostgreSQL con schemas
|
|
|
|
---
|
|
|
|
## CONFIGURACION
|
|
|
|
Variables de entorno requeridas (.env.example):
|
|
- `DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASSWORD`
|
|
- `JWT_SECRET`, `JWT_EXPIRES_IN`, `JWT_REFRESH_EXPIRES_IN`
|
|
- `PORT`, `NODE_ENV`, `CORS_ORIGIN`
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-01-07
|
|
**Actualizado por:** Frontend-Agent (SAAS-FE-011 Superadmin Metrics backend)
|