Manual Técnico — LegalDoc VE

┌─────────────────────────────────────────────────────────────────┐
│                    NETLIFY CDN (SPA)                            │
│   React 19 + Vite 7 + TypeScript + Tailwind + Framer Motion   │
│                                                                 │
│   ┌───────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────┐  │
│   │ Documents │  │Contracts │  │Compliance│  │ Expedientes │  │
│   │  Module   │  │ E-Sign   │  │  LOTTT   │  │  Judicial   │  │
│   └─────┬─────┘  └─────┬────┘  └─────┬────┘  └──────┬──────┘  │
│         │              │              │              │          │
│   ┌─────┴──────────────┴──────────────┴──────────────┴──────┐  │
│   │              SERVICE LAYER (TypeScript)                  │  │
│   │   auth · document · contract · signature · compliance   │  │
│   │   expediente · honorarios · calendar · flow · audit     │  │
│   │   ai · parameters · notification · report · pdf         │  │
│   └─────────────────────┬───────────────────────────────────┘  │
│                         │                                       │
│              ┌──────────┴──────────┐                           │
│              │  supabase-js 2.93   │                           │
│              │  + Web Crypto API   │                           │
│              └──────────┬──────────┘                           │
└─────────────────────────┼───────────────────────────────────────┘
                          │ HTTPS
┌─────────────────────────┼───────────────────────────────────────┐
│                  SUPABASE CLOUD                                 │
│                         │                                       │
│   ┌──────────┐  ┌───────┴──────┐  ┌────────────────────┐      │
│   │  Auth    │  │  PostgREST   │  │   Edge Functions   │      │
│   │ (JWT)    │  │  (REST API)  │  │  legal-ai-processor│      │
│   └──────────┘  └──────────────┘  │  exchange-rates    │      │
│                                    │  daily-alert       │      │
│   ┌────────────────────────────┐  └────────────────────┘      │
│   │        PostgreSQL 15+                                │      │
│   │  ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ │      │
│   │  │ pgvector│ │ pgcrypto │ │   RLS    │ │Triggers │ │      │
│   │  │ (1536d) │ │ (SHA256) │ │org_isol. │ │ audit   │ │      │
│   │  └─────────┘ └──────────┘ └──────────┘ └─────────┘ │      │
│   │  30+ tablas multi-tenant · Storage (archivos)       │      │
│   └──────────────────────────────────────────────────────┘      │
└─────────────────────────────────────────────────────────────────┘

src/
├── App.tsx                          # Router principal (state-based switch)
├── main.tsx                         # Entry point
├── core/
│   ├── supabase.ts                  # Cliente Supabase
│   ├── auth.service.ts              # Login, logout, sync, permisos
│   ├── user.types.ts                # UserRole, User, Permission, ROLE_PERMISSIONS
│   ├── api.ts                       # Axios (legacy — deprecado)
│   └── rgpd.service.ts              # Consentimiento RGPD
├── ui/layouts/
│   └── MainLayout.tsx               # Shell con sidebar de navegación
├── modules/
│   ├── dashboard/                   # DashboardView.tsx
│   ├── documents/                   # CRUD + análisis IA + workflow aprobación
│   │   ├── types.ts                 # DocumentType, Status, RiskLevel
│   │   ├── documents.service.ts     # CRUD + file upload + signed URLs
│   │   ├── ai.service.ts            # Interfaz IAIService
│   │   ├── openai.service.ts        # Chat vía Edge Function
│   │   └── workflow.service.ts      # Flujo de aprobación por pasos
│   ├── contracts/                   # Contratos + firma electrónica
│   │   ├── types.ts                 # ContractType, Status
│   │   ├── contract.service.ts      # CRUD
│   │   ├── signature.service.ts     # SHA-256, firma, verificación, revocación
│   │   ├── SignaturePanel.tsx        # UI de firma con biometría
│   │   └── ExternalSignView.tsx     # Portal público para firma externa
│   ├── compliance/                  # Cumplimiento regulatorio
│   │   ├── compliance.service.ts    # CRUD + alertas + RGPD audit
│   │   └── RiskMatrixView.tsx       # Matriz de riesgos NIST/ISO
│   ├── expedientes/                 # Expedientes judiciales
│   │   ├── expediente.service.ts    # CRUD + actuaciones + audiencias
│   │   └── ActuacionesTimeline.tsx  # Línea de tiempo procesal
│   ├── honorarios/                  # Facturación legal
│   │   ├── honorarios.service.ts    # 6 sub-servicios (Client, Matter, etc.)
│   │   └── types.ts                 # FeeType, Currency, InvoiceType
│   ├── calendar/                    # Calendario judicial
│   │   ├── calendar.service.ts      # Feriados, días hábiles, lapsos
│   │   └── LapsosWidget.tsx         # Widget de vencimientos
│   ├── flows/                       # Flujos BPM
│   │   └── flow.service.ts          # Templates, stages, instances, tasks
│   ├── legal-team/                  # Equipo de abogados
│   ├── iam/                         # Gestión de usuarios
│   ├── parameters/                  # Parámetros del sistema (42 seeds)
│   └── shared/                      # Servicios transversales
│       ├── audit.service.ts         # Auditoría forense SHA-256
│       ├── bcv-rate.service.ts      # Tasa BCV USD/VES
│       ├── legal-knowledge.service.ts # Seed corpus legal venezolano
│       ├── notification.service.ts  # Notificaciones multi-canal
│       ├── predictive-ai.service.ts # Predicción judicial GPT-4o
│       ├── report.service.ts        # Reportes HTML con pie forense
│       ├── pdf-report.service.ts    # PDFs certificados (jsPDF)
│       ├── terms.service.ts         # Cálculo de plazos judiciales
│       └── i18n.service.ts          # Monedas, conversiones, formatos

Flujo de Login

1. Usuario envía email + password
2. authService.login() → supabase.auth.signInWithPassword()
3. Éxito → query profiles WHERE id = auth.user.id
4. Validar: profile existe, is_active = true, organization_id asignado
5. Mapear a User: { id, email, name, role, organizationId }
6. Guardar en localStorage key 'legal_user'
7. App.tsx: setUser() → renderizar MainLayout
8. En reload: syncSession() → supabase.auth.getSession() → re-fetch profile
9. Check RGPD: rgpdService.hasConsent(userId) → mostrar banner si falta
10. SecurityReminderOverlay mostrado en cada login

Trigger PostgreSQL (pgcrypto)

-- Función trigger: audit_trigger_func
-- Extensión: pgcrypto (SHA-256)

CREATE OR REPLACE FUNCTION audit_trigger_func()
RETURNS TRIGGER AS $$
DECLARE
    v_previous_hash TEXT;
    v_checksum TEXT;
    v_data JSONB;
BEGIN
    -- Obtener hash del registro anterior (cadena)
    SELECT checksum INTO v_previous_hash
    FROM audit_logs
    ORDER BY created_at DESC LIMIT 1;
    
    -- Construir datos para hash
    v_data := jsonb_build_object(
        'action', TG_OP,
        'table', TG_TABLE_NAME,
        'old', CASE WHEN TG_OP IN ('UPDATE','DELETE') 
               THEN row_to_json(OLD)::jsonb ELSE NULL END,
        'new', CASE WHEN TG_OP IN ('INSERT','UPDATE') 
               THEN row_to_json(NEW)::jsonb ELSE NULL END,
        'previous_hash', COALESCE(v_previous_hash, 'GENESIS')
    );
    
    -- Calcular checksum SHA-256
    v_checksum := encode(
        digest(v_data::text, 'sha256'), 'hex'
    );
    
    INSERT INTO audit_logs (
        action, entity_type, entity_id,
        old_data, new_data,
        previous_hash, checksum
    ) VALUES (
        TG_OP, TG_TABLE_NAME, 
        COALESCE(NEW.id, OLD.id),
        CASE WHEN TG_OP IN ('UPDATE','DELETE') 
             THEN row_to_json(OLD)::jsonb END,
        CASE WHEN TG_OP IN ('INSERT','UPDATE') 
             THEN row_to_json(NEW)::jsonb END,
        COALESCE(v_previous_hash, 'GENESIS'),
        v_checksum
    );
    RETURN NEW;
END;
$$ LANGUAGE plpgsql;

Verificación de la Cadena

verifyChain(orgId?, limit = 100):
  1. Fetch últimos N logs ORDER BY created_at DESC
  2. Filtrar solo registros forenses (checksum ≠ 'VIRTUAL_EVENT')
  3. Para cada registro: verificar que previous_hash 
     coincida con el checksum de un registro padre
  4. Tolerar forks naturales (inserciones concurrentes 
     con el mismo padre)
  5. Retornar { healthy: boolean, details: string }

Infraestructura

Función SQL — match_legal_knowledge

-- Búsqueda por similitud coseno en pgvector
CREATE FUNCTION match_legal_knowledge(
    query_embedding vector(1536),
    match_threshold float DEFAULT 0.65,
    match_count int DEFAULT 5,
    p_organization_id uuid DEFAULT NULL
) RETURNS TABLE (
    id uuid, content text, metadata jsonb, similarity float
) AS $$
    SELECT id, content, metadata,
           1 - (embedding <=> query_embedding) AS similarity
    FROM document_vectors
    WHERE 1 - (embedding <=> query_embedding) > match_threshold
      AND (organization_id = p_organization_id 
           OR organization_id = '00000000-0000-0000-0000-000000000000')
    ORDER BY embedding <=> query_embedding
    LIMIT match_count;
$$ LANGUAGE sql;

Corpus Legal Venezolano (Seed)

legalKnowledgeService.seedBaseKnowledge() indexa automáticamente el siguiente corpus con org_id público (00000000-...0000):

Flujo de Indexación

1. aiService.indexLegalKnowledge(entityId, type, content, orgId, metadata)
2. → aiService.generateEmbedding(content)
   → Edge Function 'legal-ai-processor' { action: 'embedding', body: { text } }
   → OpenAI text-embedding-3-small → vector float[1536]
3. → INSERT INTO document_vectors (entity_id, entity_type, content, 
      embedding, metadata, organization_id)
4. Disponible para búsqueda semántica vía match_legal_knowledge()

Invocadas desde el frontend con supabase.rpc('function_name', { params }).

Frontend (.env)

Edge Functions (Supabase Dashboard)