rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2fb9f3f6b5
michangarrito/orchestration/_archive/analisis/backup-integracion-2026-01-10/ESPECIFICACION-COMPONENTES.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
Details
CI/CD Pipeline / Frontend CI (push) Waiting to run
Details
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
Details
CI/CD Pipeline / Mobile CI (push) Waiting to run
Details
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
Details
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
Details
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure 
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

3.8 KiB
Raw Blame History

Especificación de Componentes - MiChangarrito

Última actualización: 2026-01-05

Resumen de Componentes

Componente Puerto Framework Estado
Frontend Web 3140 React 18 + Vite Implementado
Backend API 3141 NestJS 10.x Implementado
MCP Server stdio MCP SDK Implementado
WhatsApp Service 3143 NestJS 10.x Implementado
Mobile App 8081 React Native Pendiente

Backend API

Ubicación

apps/backend/

Módulos

Módulo Descripción Endpoints Base
AuthModule Autenticación JWT /auth/*
UsersModule Gestión de usuarios /users/*
ProductsModule CRUD productos /products/*
SalesModule Punto de venta /sales/*
CustomersModule Clientes y fiado /customers/*
InventoryModule Stock y movimientos /inventory/*
OrdersModule Pedidos WhatsApp /orders/*
SubscriptionsModule Planes y tokens /subscriptions/*
MessagingModule Conversaciones /messaging/*

Ejecución

cd apps/backend
npm run start:dev    # Desarrollo
npm run build        # Producción

WhatsApp Service

Ubicación

apps/whatsapp-service/

Capacidades

  • Envío de mensajes texto
  • Mensajes interactivos (botones, listas)
  • Templates de WhatsApp
  • Recepción via webhook
  • Procesamiento LLM

Webhook

GET  /webhook/whatsapp  # Verificación Meta
POST /webhook/whatsapp  # Recepción de mensajes

Ejecución

cd apps/whatsapp-service
npm run start:dev

MCP Server

Ubicación

apps/mcp-server/

Herramientas Disponibles

Productos:

  • list_products - Listar productos
  • get_product_details - Detalles de producto
  • check_product_availability - Verificar stock

Pedidos:

  • create_order - Crear pedido
  • get_order_status - Estado de pedido
  • update_order_status - Actualizar estado
  • cancel_order - Cancelar pedido

Fiado:

  • get_fiado_balance - Saldo de cliente
  • create_fiado - Registrar fiado
  • register_fiado_payment - Registrar pago
  • get_fiado_history - Historial
  • check_fiado_eligibility - Verificar elegibilidad

Clientes:

  • get_customer_info - Info de cliente
  • register_customer - Registrar cliente
  • get_customer_purchase_history - Historial compras
  • get_customer_stats - Estadísticas

Inventario:

  • check_stock - Verificar stock
  • get_low_stock_products - Productos con stock bajo
  • record_inventory_movement - Registrar movimiento
  • get_inventory_value - Valor del inventario

Ejecución

cd apps/mcp-server
npm run build
npm start

Frontend Web

Ubicación

apps/frontend/

Stack

  • React 18
  • Vite 7.x
  • TailwindCSS 4.x
  • React Router 6
  • TanStack Query

Páginas

Ruta Página Descripción
/dashboard Dashboard Resumen y estadísticas
/products Products Catálogo de productos
/orders Orders Gestión de pedidos
/customers Customers Lista de clientes
/fiado Fiado Gestión de crédito
/inventory Inventory Control de stock
/settings Settings Configuración

Ejecución

cd apps/frontend
npm run dev      # Desarrollo
npm run build    # Producción

Configuración de Entorno

Variables requeridas en .env:

# Base de datos
DB_HOST=localhost
DB_PORT=5432
DB_NAME=michangarrito_dev
DB_USER=michangarrito_dev
DB_PASSWORD=MCh_dev_2025_secure

# JWT
JWT_SECRET=<secret>

# WhatsApp
WHATSAPP_ACCESS_TOKEN=<token>
WHATSAPP_PHONE_NUMBER_ID=<id>
WHATSAPP_VERIFY_TOKEN=<token>

# LLM
OPENAI_API_KEY=<key>
LLM_MODEL=gpt-4o-mini

Referencias