rckrdmrd
26f0e52ca7
Template base para proyectos SaaS multi-tenant. Estructura inicial: - apps/backend (NestJS API) - apps/frontend (React/Vite) - apps/database (PostgreSQL DDL) - docs/ (Documentación) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
487 lines
12 KiB
Markdown
487 lines
12 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)
|
|
|
|
---
|
|
|
|
## TAREAS PENDIENTES
|
|
|
|
| ID | Tarea | Prioridad | SP | Dependencias |
|
|
|----|-------|-----------|-----|--------------|
|
|
| - | Backend Fase 1 + Stripe completado | - | - | - |
|
|
|
|
---
|
|
|
|
## METRICAS
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| Modulos creados | 9 (auth, tenants, users, health, rbac, notifications, billing, audit, feature-flags) |
|
|
| Endpoints | 63+ |
|
|
| Entities | 17 |
|
|
| DTOs | 29 |
|
|
| Guards | 2 (JwtAuth, Permissions) |
|
|
| Decorators | 5 |
|
|
| Interceptors | 1 (Audit) |
|
|
| Services | 10 (incluyendo StripeService) |
|
|
| Tests | 25+ |
|
|
| SP completados | 33/33 (100% Backend Fase 1 + Stripe) |
|
|
|
|
---
|
|
|
|
## 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:** Backend-Agent
|