# Gap Analysis - Base de Datos

**Proyecto:** michangarrito
**Fecha:** 2026-01-13
**Tipo:** Analisis de gaps post-integracion template-saas
**Estado:** COMPLETADO

---

## Resumen Ejecutivo

La integracion de epicas desde template-saas (MCH-029 a MCH-035) requiere objetos de base de datos que actualmente no existen en el proyecto.

| Categoria | Existentes | Requeridos | Gap |
|-----------|------------|------------|-----|
| Schemas | 8 | 13 | 5 nuevos |
| Tablas auth | 3 | 4 | 1 nueva |
| Archivos DDL | 17 | 22 | 5 nuevos |
| EXPECTED_SCHEMAS | 9 | 14 | 5 nuevos |

---

## 1. Estado Actual de la Base de Datos

### 1.1 Schemas Existentes (01-schemas.sql)

```sql
auth         -- Autenticacion y usuarios
catalog      -- Productos y categorias
sales        -- Ventas, pagos y cortes
inventory    -- Stock y movimientos
customers    -- Clientes y fiados
orders       -- Pedidos y entregas
subscriptions -- Planes y tokens IA
messaging    -- WhatsApp y notificaciones
```

### 1.2 Archivos DDL Actuales

```
database/schemas/
├── 00-extensions.sql
├── 01-schemas.sql
├── 02-functions.sql
├── 03-public.sql
├── 04-auth.sql         <- Falta: oauth_connections
├── 05-catalog.sql
├── 06-sales.sql
├── 07-inventory.sql
├── 08-customers.sql
├── 09-orders.sql
├── 10-subscriptions.sql
├── 11-messaging.sql
├── 12-integrations.sql
├── 13-referrals.sql
├── 14-codi-spei.sql
├── 15-invoices.sql
└── 16-marketplace.sql
```

### 1.3 EXPECTED_SCHEMAS en recreate-database.sh (linea 148)

```bash
EXPECTED_SCHEMAS=("public" "auth" "catalog" "sales" "inventory" "customers" "orders" "subscriptions" "messaging")
```

---

## 2. Requerimientos por Epica

### MCH-029: Infraestructura SaaS Avanzada

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| Storage | storage | storage.files, storage.buckets | FALTA |
| Webhooks | webhooks | webhooks.endpoints, webhooks.deliveries, webhooks.events | FALTA |
| Rate Limiting | public | public.rate_limits | FALTA |
| Redis Cache | N/A | Solo codigo, no DDL | N/A |

### MCH-030: Auth Social (OAuth 2.0)

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| OAuth Connections | auth | auth.oauth_connections | FALTA |

### MCH-031: Auditoria Empresarial

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| Audit Logs | audit | audit.logs, audit.events | FALTA |
| Retention | audit | audit.retention_policies | FALTA |

### MCH-032: Feature Flags por Plan

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| Features | features | features.flags, features.tenant_flags | FALTA |

### MCH-034: Analytics y Metricas

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| Metricas | analytics | analytics.metrics, analytics.aggregations | FALTA |
| Events | analytics | analytics.events | FALTA |

### MCH-035: Sistema de Reportes

| Componente | Schema | Tablas Requeridas | Estado |
|------------|--------|-------------------|--------|
| Reportes | analytics | analytics.reports, analytics.report_exports | FALTA |

---

## 3. Plan de Acciones DDL

### 3.1 Actualizar 01-schemas.sql

Agregar los siguientes schemas:

```sql
-- Schema de almacenamiento
CREATE SCHEMA IF NOT EXISTS storage;
COMMENT ON SCHEMA storage IS 'Almacenamiento de archivos';

-- Schema de webhooks
CREATE SCHEMA IF NOT EXISTS webhooks;
COMMENT ON SCHEMA webhooks IS 'Sistema de webhooks salientes';

-- Schema de auditoria
CREATE SCHEMA IF NOT EXISTS audit;
COMMENT ON SCHEMA audit IS 'Logs de auditoria empresarial';

-- Schema de features
CREATE SCHEMA IF NOT EXISTS features;
COMMENT ON SCHEMA features IS 'Feature flags por plan/tenant';

-- Schema de analytics
CREATE SCHEMA IF NOT EXISTS analytics;
COMMENT ON SCHEMA analytics IS 'Metricas y reportes';

-- Permisos
GRANT USAGE ON SCHEMA storage TO michangarrito_dev;
GRANT USAGE ON SCHEMA webhooks TO michangarrito_dev;
GRANT USAGE ON SCHEMA audit TO michangarrito_dev;
GRANT USAGE ON SCHEMA features TO michangarrito_dev;
GRANT USAGE ON SCHEMA analytics TO michangarrito_dev;
```

### 3.2 Actualizar 04-auth.sql

Agregar tabla oauth_connections:

```sql
-- Conexiones OAuth (Google, Apple)
CREATE TABLE IF NOT EXISTS auth.oauth_connections (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL REFERENCES auth.users(id) ON DELETE CASCADE,

    provider VARCHAR(20) NOT NULL,  -- 'google', 'apple'
    provider_user_id VARCHAR(255) NOT NULL,

    access_token TEXT,
    refresh_token TEXT,
    token_expires_at TIMESTAMPTZ,

    email VARCHAR(255),
    name VARCHAR(255),
    avatar_url TEXT,

    raw_data JSONB DEFAULT '{}',

    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW(),

    UNIQUE(provider, provider_user_id),
    UNIQUE(user_id, provider)
);

CREATE INDEX idx_oauth_connections_user ON auth.oauth_connections(user_id);
CREATE INDEX idx_oauth_connections_provider ON auth.oauth_connections(provider, provider_user_id);
```

### 3.3 Crear 17-storage.sql

```sql
-- Buckets de almacenamiento
CREATE TABLE IF NOT EXISTS storage.buckets (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    name VARCHAR(100) NOT NULL UNIQUE,
    public BOOLEAN DEFAULT false,
    file_size_limit INTEGER,
    allowed_mime_types TEXT[],
    created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Archivos almacenados
CREATE TABLE IF NOT EXISTS storage.files (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
    bucket_id UUID NOT NULL REFERENCES storage.buckets(id) ON DELETE CASCADE,

    name VARCHAR(255) NOT NULL,
    path VARCHAR(500) NOT NULL,
    mime_type VARCHAR(100),
    size INTEGER NOT NULL,

    metadata JSONB DEFAULT '{}',

    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW(),

    UNIQUE(bucket_id, path)
);
```

### 3.4 Crear 18-webhooks.sql

```sql
-- Endpoints de webhook
CREATE TABLE IF NOT EXISTS webhooks.endpoints (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    url VARCHAR(500) NOT NULL,
    secret VARCHAR(255) NOT NULL,
    events TEXT[] NOT NULL,

    is_active BOOLEAN DEFAULT true,
    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- Entregas de webhook
CREATE TABLE IF NOT EXISTS webhooks.deliveries (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    endpoint_id UUID NOT NULL REFERENCES webhooks.endpoints(id) ON DELETE CASCADE,

    event_type VARCHAR(100) NOT NULL,
    payload JSONB NOT NULL,

    status VARCHAR(20) DEFAULT 'pending',
    response_code INTEGER,
    response_body TEXT,

    attempts INTEGER DEFAULT 0,
    next_retry_at TIMESTAMPTZ,

    created_at TIMESTAMPTZ DEFAULT NOW(),
    delivered_at TIMESTAMPTZ
);
```

### 3.5 Crear 19-audit.sql

```sql
-- Logs de auditoria
CREATE TABLE IF NOT EXISTS audit.logs (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    user_id UUID,
    action VARCHAR(50) NOT NULL,
    resource_type VARCHAR(50) NOT NULL,
    resource_id UUID,

    old_values JSONB,
    new_values JSONB,

    ip_address VARCHAR(45),
    user_agent TEXT,

    created_at TIMESTAMPTZ DEFAULT NOW()
);

CREATE INDEX idx_audit_logs_tenant ON audit.logs(tenant_id);
CREATE INDEX idx_audit_logs_created ON audit.logs(created_at DESC);
CREATE INDEX idx_audit_logs_action ON audit.logs(action);

-- Politicas de retencion
CREATE TABLE IF NOT EXISTS audit.retention_policies (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    retention_days INTEGER NOT NULL DEFAULT 90,
    created_at TIMESTAMPTZ DEFAULT NOW()
);
```

### 3.6 Crear 20-features.sql

```sql
-- Feature flags globales
CREATE TABLE IF NOT EXISTS features.flags (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),

    key VARCHAR(100) NOT NULL UNIQUE,
    name VARCHAR(255) NOT NULL,
    description TEXT,

    default_value BOOLEAN DEFAULT false,

    plans_enabled TEXT[] DEFAULT '{}',

    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- Feature flags por tenant (override)
CREATE TABLE IF NOT EXISTS features.tenant_flags (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
    flag_id UUID NOT NULL REFERENCES features.flags(id) ON DELETE CASCADE,

    enabled BOOLEAN NOT NULL,

    created_at TIMESTAMPTZ DEFAULT NOW(),
    updated_at TIMESTAMPTZ DEFAULT NOW(),

    UNIQUE(tenant_id, flag_id)
);
```

### 3.7 Crear 21-analytics.sql

```sql
-- Metricas agregadas
CREATE TABLE IF NOT EXISTS analytics.metrics (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    metric_type VARCHAR(50) NOT NULL,
    period_type VARCHAR(20) NOT NULL, -- 'daily', 'weekly', 'monthly'
    period_start DATE NOT NULL,

    value DECIMAL(15, 2) NOT NULL,
    metadata JSONB DEFAULT '{}',

    created_at TIMESTAMPTZ DEFAULT NOW(),

    UNIQUE(tenant_id, metric_type, period_type, period_start)
);

CREATE INDEX idx_analytics_metrics_tenant ON analytics.metrics(tenant_id);
CREATE INDEX idx_analytics_metrics_period ON analytics.metrics(period_start DESC);

-- Eventos de analytics
CREATE TABLE IF NOT EXISTS analytics.events (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    event_type VARCHAR(100) NOT NULL,
    properties JSONB DEFAULT '{}',

    created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Reportes generados
CREATE TABLE IF NOT EXISTS analytics.reports (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    tenant_id UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,

    report_type VARCHAR(50) NOT NULL,
    name VARCHAR(255) NOT NULL,

    parameters JSONB DEFAULT '{}',

    status VARCHAR(20) DEFAULT 'pending',
    file_url TEXT,
    file_format VARCHAR(10), -- 'pdf', 'xlsx', 'csv'

    created_at TIMESTAMPTZ DEFAULT NOW(),
    completed_at TIMESTAMPTZ,
    expires_at TIMESTAMPTZ
);
```

### 3.8 Actualizar recreate-database.sh

```bash
# Linea 148 - Actualizar array
EXPECTED_SCHEMAS=("public" "auth" "catalog" "sales" "inventory" "customers" "orders" "subscriptions" "messaging" "storage" "webhooks" "audit" "features" "analytics")
```

---

## 4. Matriz de Trazabilidad

| Archivo DDL | Epica | Schemas | Tablas Nuevas |
|-------------|-------|---------|---------------|
| 01-schemas.sql | MCH-029,031,032,034 | storage,webhooks,audit,features,analytics | - |
| 04-auth.sql | MCH-030 | auth | oauth_connections |
| 17-storage.sql | MCH-029 | storage | buckets, files |
| 18-webhooks.sql | MCH-029 | webhooks | endpoints, deliveries |
| 19-audit.sql | MCH-031 | audit | logs, retention_policies |
| 20-features.sql | MCH-032 | features | flags, tenant_flags |
| 21-analytics.sql | MCH-034,035 | analytics | metrics, events, reports |

---

## 5. Checklist de Ejecucion

- [x] Actualizar 01-schemas.sql con 5 nuevos schemas
- [x] Agregar auth.oauth_connections a 04-auth.sql
- [x] Crear 17-storage.sql (111 lineas)
- [x] Crear 18-webhooks.sql (142 lineas)
- [x] Crear 19-audit.sql (201 lineas)
- [x] Crear 20-features.sql (182 lineas)
- [x] Crear 21-analytics.sql (290 lineas)
- [x] Actualizar EXPECTED_SCHEMAS en recreate-database.sh
- [x] Ejecutar scripts DDL directamente en PostgreSQL
- [x] Verificar schemas y tablas creados

**Ejecucion:** Scripts ejecutados directamente via psql (2026-01-13)

---

**Generado por:** Sistema SIMCO - Agente Orquestador
**Fecha:** 2026-01-13
**Version:** 1.0.0