Arquitectura del Sistema

Visión General

CAPI App sigue una arquitectura cliente-servidor con backend serverless usando Firebase. La aplicación Flutter se comunica con Firebase para todas las operaciones de backend, y Firebase se integra con servicios externos para funcionalidades adicionales.

Diagrama de Arquitectura

graph TB
    subgraph Cliente["Cliente Flutter"]
        iOS[iOS App]
        Android[Android App]
        Web[Web App]
    end
    
    subgraph Firebase["Firebase Backend"]
        Firestore[(Firestore)]
        Auth[Firebase Auth]
        Storage[Firebase Storage]
        Functions[Cloud Functions]
        FCM[Cloud Messaging]
    end
    
    subgraph Servicios["Servicios Externos"]
        Stripe[Stripe API]
        Zoom[Zoom API]
        RevenueCat[RevenueCat]
        N8N[N8N Workflows]
        Places[Google Places]
    end
    
    iOS --> Firebase
    Android --> Firebase
    Web --> Firebase
    
    Firebase --> Servicios
    
    Firestore --> Functions
    Functions --> Stripe
    Functions --> Zoom
    Functions --> N8N

Flujo de Datos

Autenticación

sequenceDiagram
    participant U as Usuario
    participant App as Flutter App
    participant Auth as Firebase Auth
    participant FS as Firestore
    
    U->>App: Login
    App->>Auth: signInWithEmailAndPassword
    Auth-->>App: User Credential
    App->>FS: Obtener UsersRecord
    FS-->>App: Datos del Usuario
    App->>App: Validar Rol
    App-->>U: Redirigir según Rol

Operaciones CRUD

sequenceDiagram
    participant App as Flutter App
    participant FS as Firestore
    participant Audit as Audit Logger
    participant Functions as Cloud Functions
    
    App->>FS: Create/Update/Delete
    FS->>Audit: Registrar Acción
    Audit->>FS: Guardar en audit_logs
    FS-->>App: Confirmación
    FS->>Functions: Trigger (si aplica)
    Functions->>Functions: Procesar Evento

Estructura de Base de Datos

Colecciones Principales

• users - Usuarios del sistema (doctores, pacientes, asistentes)
• clinicas - Información de clínicas
• citas - Citas médicas
• consultas - Consultas médicas e historial clínico
• chats - Conversaciones de chat
• servicios - Servicios médicos ofrecidos
• audit_logs - Logs de auditoría
• business_metrics - Métricas de negocio

Relaciones

class="highlight">

clinicas (1) ──< (N) users
users (1) ──< (N) citas
users (1) ──< (N) consultas
users (1) ──< (N) chats
clinicas (1) ──< (N) servicios