# SaaS Base Platform

**ID:** saas-base
**Version:** 1.0.0
**Estado:** production
**Ultima actualizacion:** 2026-01-04

---

## Descripcion

Template generico para aplicaciones SaaS. Incluye arquitectura multi-tenant, sistema de billing, onboarding, y modulos comunes pre-integrados.

## Arquitectura

```
saas-base/
├── backend/
│   ├── modules/
│   │   ├── auth/              # JWT + Multi-tenant
│   │   ├── users/             # Gestion de usuarios
│   │   ├── tenants/           # Gestion de tenants/workspaces
│   │   ├── billing/           # Stripe subscriptions
│   │   ├── onboarding/        # Wizard de onboarding
│   │   └── notifications/     # Email + In-app
│   └── shared/
├── frontend/
│   ├── landing/               # Landing page
│   ├── auth/                  # Login/Register
│   ├── dashboard/             # Dashboard principal
│   ├── settings/              # Configuracion de cuenta
│   └── billing/               # Portal de facturacion
└── database/
    └── schemas/
        ├── core/              # Auth, users, tenants
        └── billing/           # Subscriptions, invoices
```

## Modulos Recomendados

| Modulo | Categoria | Proposito |
|--------|-----------|-----------|
| auth-jwt-nestjs | authentication | Autenticacion |
| auth-multi-tenant | authentication | Aislamiento de tenants |
| payments-stripe-subscriptions | payments | Billing |
| notifications-email-sendgrid | notifications | Emails transaccionales |
| notifications-in-app-websocket | notifications | Notificaciones real-time |
| users-roles-permissions | user-management | RBAC |
| ui-admin-dashboard | ui-components | Dashboard |
| db-multi-tenant-schema | database-patterns | Aislamiento de datos |

## Flujo de Onboarding

```
1. Registro de cuenta
   └── Crear usuario admin
   └── Crear tenant/workspace

2. Seleccion de plan
   └── Free trial / Paid plan
   └── Crear subscription en Stripe

3. Configuracion inicial
   └── Invitar miembros
   └── Configurar preferencias

4. Dashboard
   └── Acceso a la aplicacion
```

## Stack Tecnologico Recomendado

- **Backend:** NestJS + TypeORM
- **Frontend:** React/Next.js + TypeScript
- **Database:** PostgreSQL con RLS
- **Payments:** Stripe
- **Email:** SendGrid
- **Auth:** JWT + Passport

## Personalizacion

Este template es generico. Para un SaaS especifico:

1. Clonar estructura base
2. Definir modulos de negocio
3. Personalizar UI/branding
4. Configurar planes de pricing
5. Implementar features especificas

---

**Mantenedor:** @PERFIL_ARCHITECTURE_ANALYST