{"status":"ok","module":"system-modules","version":"1.1.0","updated_at":"2026-05-28","system_name":"MaxiQueen OS - Infrastructure Core","purpose":"Registro central de modulos operativos, infraestructura, dependencias, rutas disponibles y estado real de integraciones del ecosistema MaxiQueen OS.","status_legend":{"active":"Funciona actualmente en produccion.","ready":"La estructura existe y esta lista para conectarse.","planned":"Planeado para una siguiente fase.","external_required":"Depende de una cuenta, llave, webhook o servicio externo.","disabled":"No esta habilitado actualmente."},"core_infrastructure":{"frontend":{"provider":"Vercel / Static Web","framework":"HTML5, CSS, JavaScript","ui_system":"Glassmorphism UI, neon accents, responsive layout, chat widget embebible","status":"active","notes":"El frontend puede consumir rutas publicas del backend y mostrar el chat MaxiQueen AI."},"backend":{"provider":"Vercel Serverless / Node.js Express","runtime":"Node.js","entry":"server.js","status":"active","notes":"Sirve rutas API, chat-widget, builder-os y contexto publico desde archivos JSON."},"knowledge_files":{"provider":"GitHub repository / api JSON files","type":"Public safe context","status":"active","files":["api/chat_context.json","api/builder_context.json","api/modules.json","api/portal_links.json","api/client_mode.json","api/manifest.json","api/leads.json"],"notes":"Esta capa es para contexto publico y operativo. No debe incluir llaves, datos privados ni documentos sensibles."},"database":{"provider":"MongoDB Atlas","type":"NoSQL / future vector store","status":"planned","notes":"Recomendada para leads, memoria, historial, conocimiento vectorial y busqueda semantica."},"assets_storage":{"provider":"Cloudinary","type":"Images, video, avatars, media assets","status":"ready","notes":"Puede usarse para almacenar imagenes, videos y recursos visuales del ecosistema."},"ai_provider":{"provider":"Google Gemini","type":"External AI model","status":"external_required","notes":"Se activa cuando las llaves esten configuradas de forma segura en backend o entorno local privado."}},"count":8,"modules":[{"id":"chat-core","name":"MaxiQueen Chat Core","category":"ai_chat","status":"active","description":"Modulo conversacional principal. Opera en modo local con fallback y puede conectarse a Gemini cuando existan llaves activas.","endpoints":["/api/chat-context","/chat-widget"],"capabilities":["Respuesta local","Contexto publico","Diagnostico inicial","Soporte comercial","Fallback si falla IA externa","Preparado para Gemini"],"dependencies":["api/chat_context.json","js/api.js","js/chat.js"],"next_step":"Conectar el chat a busqueda de conocimiento y despues a Gemini desde backend seguro."},{"id":"builder-os","name":"Builder OS","category":"builder","status":"active","description":"Modulo para estructurar soluciones, diagnosticar proyectos, empaquetar servicios y guiar la construccion digital.","endpoints":["/api/builder-context","/builder-os"],"capabilities":["Diagnostico tecnico","Empaquetado de servicios","Rutas de implementacion","Orientacion Google/Gemini","Programacion personalizada"],"dependencies":["api/builder_context.json"],"next_step":"Usarlo como base para propuestas comerciales y rutas de cliente."},{"id":"portal-core","name":"Portal MaxiQueen OS","category":"navigation","status":"active","description":"Mapa de enlaces principales del ecosistema MaxiQueen OS.","endpoints":["/api/portal-links"],"capabilities":["Enlaces del ecosistema","Acceso a chat","Acceso a builder","Acceso a backend","Acceso a WhatsApp"],"dependencies":["api/portal_links.json"],"next_step":"Mantener enlaces actualizados y separar enlaces publicos de enlaces internos."},{"id":"lead-intake","name":"Lead Intake Engine","category":"crm","status":"ready","description":"Modulo para recibir prospectos, capturar datos minimos y preparar seguimiento comercial.","endpoints":["/api/leads"],"capabilities":["Captura de nombre","Captura de email","Fuente del lead","Servicio de interes","Mensaje inicial","Preparado para CRM"],"dependencies":["api/leads.json"],"next_step":"Conectar almacenamiento real en MongoDB Atlas, Google Sheets o CRM propio."},{"id":"client-mode","name":"Client Mode","category":"client_area","status":"ready","description":"Modo cliente para mostrar rutas, enlaces y acceso limpio a Builder OS y Chat Widget.","endpoints":["/api/client-mode"],"capabilities":["URL de builder","URL de chat","Modo cliente","Separacion entre vista interna y vista publica"],"dependencies":["api/client_mode.json"],"next_step":"Crear permisos y vistas diferenciadas cuando exista autenticacion."},{"id":"manifest-core","name":"System Manifest","category":"system_map","status":"active","description":"Mapa general del backend, sistema, modulos y enlaces activos.","endpoints":["/api/manifest","/api/status","/api/health"],"capabilities":["Estado del sistema","Version","Rutas disponibles","Modulos","Enlaces"],"dependencies":["api/manifest.json","server.js"],"next_step":"Agregar versionado y auditoria de cambios."},{"id":"knowledge-base","name":"MaxiQueen Knowledge Base","category":"knowledge","status":"planned","description":"Capa futura para procesar documentos, resumirlos, clasificarlos, dividirlos en chunks y conectarlos al chat mediante busqueda.","endpoints":["/api/knowledge/search","/api/knowledge/ingest","/api/knowledge/sources"],"capabilities":["Clasificacion de documentos","Resumen por fuente","Chunks de conocimiento","Busqueda semantica","RAG para IA"],"dependencies":["MongoDB Atlas Vector Search","Google Drive or Cloud Storage","Document parser","Embedding model"],"next_step":"Empezar con 20 documentos aprobados antes de subir miles de archivos."},{"id":"monetization-core","name":"Monetization and Conversion Core","category":"monetization","status":"planned","description":"Modulo futuro para conversiones, pagos, eventos, embudos, juegos web monetizables e infoproductos.","endpoints":["/api/webhooks/payment","/api/conversions"],"capabilities":["Registro de conversiones","Eventos de pago","Webhooks","Metricas comerciales","Monetizacion H5"],"dependencies":["MercadoPago","Hotmart","Google AdSense","Analytics"],"next_step":"Crear endpoints reales antes de marcar este modulo como active."}],"security_protocols":{"api_keys":{"current_policy":"No exponer llaves API en frontend publico.","recommended_policy":"Guardar llaves en variables de entorno del backend o sistema privado.","status":"required"},"cors_policy":{"current_state":"Permisivo para pruebas y despliegue inicial.","recommended_state":"Restringir a dominios oficiales de MaxiQueen OS cuando el sistema este estable.","status":"needs_hardening"},"rate_limiting":{"current_state":"No confirmado en server.js actual.","recommended_state":"Agregar limite por IP en rutas publicas.","suggested_rule":"100 requests por IP cada 15 minutos para endpoints publicos.","status":"planned"},"data_privacy":{"rule":"No almacenar datos sensibles sin consentimiento, finalidad clara y canal seguro.","restricted_data":["API keys","passwords","tokens","documentos privados","datos bancarios","informacion legal sensible"],"status":"active_policy"}},"roadmap":{"phase_1_now":["Mantener backend online","Leer JSON desde carpeta api","Completar chat_context, builder_context y modules","Probar rutas publicas"],"phase_2_next":["Completar portal_links, client_mode, manifest y leads","Mejorar respuesta del chat usando contexto del backend","Crear estructura de leads real"],"phase_3_later":["Conectar MongoDB Atlas","Crear ingestion de documentos","Implementar busqueda de conocimiento","Conectar Gemini desde backend seguro","Agregar autenticacion y permisos"]}}