How pabloyanez5/joyeria-xavier works
Joyería Xavier integra atención conversacional por canales Meta, un catálogo con cotizador web y gestión de órdenes para el taller. El flujo principal va del mensaje entrante, por el webhook y el servicio conversacional, hasta la respuesta enviada por el canal; el panel web también permite consultar conversaciones y seguir órdenes. El README documenta además métricas y gestión administrativa. Las conexiones no visibles en los extractos se omiten; las funciones de panel y métricas se incluyen según la documentación y el índice, sin atribuirles llamadas no verificadas.
Main entry points: main.py API FastAPI · servicio.py Servicio conversacional · webhook.py Webhook Meta · db.py PostgreSQL
Components 27
Experiencia web
- Catálogo y cotizador
02_codigo_fuente/frontend/web/src/App.jsx - Chat web
02_codigo_fuente/frontend/web/src/Chat.jsx - Panel administrativo
02_codigo_fuente/frontend/web/src/Panel.jsx - Conversaciones UI
02_codigo_fuente/frontend/web/src/Conversaciones.jsx - Resumen y tablero
02_codigo_fuente/frontend/web/src/Tablero.jsx
Atención conversacional
- Webhook Meta
02_codigo_fuente/backend/app/webhook.py - Servicio conversacional
02_codigo_fuente/backend/app/agente/servicio.py - Rutas del agente
02_codigo_fuente/backend/app/agente/rutas.py - Agente LangChain
02_codigo_fuente/backend/app/agente/lc_agente.py - Clasificador de intención
02_codigo_fuente/backend/app/agente/intenciones.py - Proveedor LLM
02_codigo_fuente/backend/app/agente/llm.py - Formato saliente
02_codigo_fuente/backend/app/mensajes.py - Envío Meta
02_codigo_fuente/backend/app/meta_envio.py
Catálogo y órdenes
- Catálogo y cotizador
02_codigo_fuente/backend/app/catalogo.py - Contacto asesor
02_codigo_fuente/backend/app/contacto.py - Órdenes de producción
02_codigo_fuente/backend/app/ordenes.py
Datos y operaciones
- API FastAPI
02_codigo_fuente/backend/app/main.py - Identidad de clientes
02_codigo_fuente/backend/app/clientes.py - Conversaciones y mensajes
02_codigo_fuente/backend/app/conversaciones.py - Métricas
02_codigo_fuente/backend/app/metricas.py - Modelos de dominio
02_codigo_fuente/backend/app/models.py - PostgreSQL
02_codigo_fuente/backend/app/db.py - Caché identidad
02_codigo_fuente/backend/app/cache.py
Other components
- Cliente web
- Cliente Meta
- Gemini
- Meta Business API
Connections 30
- Cliente web → Catálogo y cotizador: explora
02_codigo_fuente/frontend/web/src/App.jsx - Catálogo y cotizador → Catálogo y cotizador: consulta catálogo
02_codigo_fuente/frontend/web/src/App.jsx - Catálogo y cotizador → Contacto asesor: solicita contacto
02_codigo_fuente/frontend/web/src/App.jsx - Cliente web → Chat web: conversa
02_codigo_fuente/frontend/web/src/Chat.jsx - Panel administrativo → Conversaciones UI: muestra
02_codigo_fuente/frontend/web/src/Panel.jsx - Panel administrativo → Resumen y tablero: muestra
02_codigo_fuente/frontend/web/src/Panel.jsx - API FastAPI → Webhook Meta: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Catálogo y cotizador: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Contacto asesor: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Rutas del agente: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Órdenes de producción: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Conversaciones y mensajes: registra rutas
02_codigo_fuente/backend/app/main.py - API FastAPI → Métricas: registra rutas
02_codigo_fuente/backend/app/main.py - Cliente Meta → Webhook Meta: envía mensaje
README.md - Webhook Meta → Servicio conversacional: procesa entrante
02_codigo_fuente/backend/app/webhook.py - Servicio conversacional → Identidad de clientes: identifica cliente
02_codigo_fuente/backend/app/agente/servicio.py - Servicio conversacional → Clasificador de intención: clasifica mensaje
02_codigo_fuente/backend/app/agente/servicio.py - Servicio conversacional → Agente LangChain: genera respuesta
02_codigo_fuente/backend/app/agente/servicio.py - Servicio conversacional → Conversaciones y mensajes: guarda mensajes
- Servicio conversacional → Caché identidad: consulta identidad
02_codigo_fuente/backend/app/agente/servicio.py - Agente LangChain → Proveedor LLM: consulta modelo
- Proveedor LLM → Gemini: genera texto
02_codigo_fuente/backend/app/agente/llm.py - Webhook Meta → Envío Meta: envía respuesta
02_codigo_fuente/backend/app/webhook.py - Envío Meta → Meta Business API: publica mensaje
README.md - Envío Meta → Formato saliente: formatea salida
02_codigo_fuente/backend/app/meta_envio.py - Catálogo y cotizador → PostgreSQL: consulta datos
02_codigo_fuente/backend/app/catalogo.py - Órdenes de producción → PostgreSQL: persiste etapas
02_codigo_fuente/backend/app/ordenes.py - Conversaciones y mensajes → PostgreSQL: persiste historial
02_codigo_fuente/backend/app/conversaciones.py - Identidad de clientes → Caché identidad: consulta y guarda
02_codigo_fuente/backend/app/clientes.py - Modelos de dominio → PostgreSQL: define esquema
02_codigo_fuente/backend/app/models.py