Arquitectura del Sistema

(Modelo C4 – Nivel 1 y Nivel 2)

Nivel 1 — Contexto del Sistema

Actores Principales

👤 Usuario

• Realiza búsquedas

• Interactúa con resultados

• Puede suscribirse a funciones premium

🏢 Comercio

• Publica listados

• Gestiona equipo

• Compra promociones / suscripciones

• Consulta métricas de rendimiento

👨‍💼 Administrador

• Supervisa operaciones

• Modera contenido

• Consulta analítica global

---

Sistemas Externos Integrados

• Stripe — Procesamiento de pagos y suscripciones

• OpenAI API — Generación de embeddings semánticos

• Firebase Cloud Messaging — Notificaciones push

• Apple / Google Auth — Autenticación social

• Railway — Infraestructura gestionada

---

Rol de Nodo

Nodo actúa como:

• Capa de procesamiento de búsqueda

• Sistema de gestión comercial

• Capturador de señales de intención

• Motor de analítica agregada

Es el sistema central que conecta usuarios, comercios y datos.

---

Nivel 2 — Contenedores

📱 Contenedor 1: Aplicación Móvil

Tecnología:

• React Native

• Apollo Client

• Axios

• Zustand

• MMKV

Responsabilidades:

• Interfaz de búsqueda

• Gestión de perfil

• Publicación de listados

• Visualización de insights

• Suscripciones

Comunicación:

• REST API

• Endpoint GraphQL

---

🖥 Contenedor 2: Backend API

Tecnología:

• Node.js

• Express

• JWT

• Stripe SDK

Módulos principales:

• Search (vectorial + filtros)

• Listings

• Analytics

• Payments

• Auth

• Admin

Responsabilidades:

• Procesamiento de búsquedas

• Generación y almacenamiento de embeddings

• Registro de eventos

• Gestión de suscripciones

• Gestión de promociones

• Control de acceso

---

🗄 Contenedor 3: Base de Datos

Tecnología:

• PostgreSQL

• PGVector

Almacena:

• Usuarios

• Comercios

• Listados

• Embeddings

• Eventos de búsqueda

• Suscripciones

• Promociones

Incluye:

• Índices vectoriales para similitud semántica

• Migraciones automáticas

---

⚡ Contenedor 4: Cache

Tecnología:

• Redis

Usos:

• Cache de embeddings

• Cache de resultados de búsqueda

• Cache de métricas

• Optimización de latencia

---

🔄 Flujo Simplificado

Usuario → App Móvil → Backend → → (Embeddings OpenAI) → PostgreSQL + PGVector → Redis Cache → Respuesta estructurada

Y en paralelo:

Backend → Registro de búsqueda → Tabla de analytics → Agregación programada