NANOn3uralia

Technical contract

Cómo funciona N3uralia Nano

Esta documentación describe lo que el código implementa hoy. No convierte demos, planes comerciales o capacidades futuras en hechos de producción.

1. Autenticación
Las superficies de ejecución requieren una sesión válida de Supabase. El middleware bloquea las rutas protegidas antes de llegar a la interfaz.
2. Autorización por agente
Un usuario normal sólo puede ejecutar agentes presentes en user_agents. Los administradores se validan contra admins. La comprobación se repite en el servidor.
3. Validación
Los endpoints limitan tamaño y estructura de payload antes de invocar proveedores externos o realizar operaciones privilegiadas.
4. Ejecución
Los agentes de texto usan una ruta server-side de OpenAI. Los tres agentes visuales usan generación de imagen. Las claves permanecen fuera del navegador.

Catálogo canónico

El mismo catálogo de 21 agentes alimenta las páginas públicas, el panel admin y las APIs de ejecución. Los IDs 1–21 son la identidad persistida en user_agents.

01 · Diseño

Generador de Diseño IA

02 · Diseño

Brandbook IA

03 · Creativo

N3uralia Art IA

04 · Diseño

Image Editor Agent

05 · Contenido

Creador de Contenido IA

06 · Marketing

SEO & LLMO IA

07 · Marketing

Email Campaign Agent

08 · Marketing

Social Media Manager

09 · Datos

Analytics Dashboard

10 · Soporte

Customer Support Bot

11 · Personas

HR Automation

12 · Operaciones

Inventory Manager

13 · Finanzas

Invoice Generator

14 · Datos

Data Analyzer

15 · Desarrollo

Code Assistant

16 · Desarrollo

API Manager

17 · Seguridad

Security Auditor

18 · Infraestructura

Performance Monitor

19 · Documentos

Document Processor

20 · Multimedia

Video Generator

21 · Audio

Voice Assistant

Fronteras de seguridad

Usuario
/api/agents y /api/chat vuelven a validar sesión y entitlement antes de consumir inferencia.
Administración
El service-role de Supabase sólo se usa del lado servidor, después de requireAdmin(), para listar usuarios o cambiar asignaciones.

Documentos

/api/documents/analyze y /api/documents/scan no implementan OCR real en este estado del producto. Validan la solicitud y responden explícitamente 501 Not Implemented; no fabrican RUT, confidence, compliance ni extracción.

Deployment

El repositorio incluye un gate de GitHub Actions con TypeScript y build de producción. Un deployment real debe además validar RLS/constraints de Supabase, flujo autenticado, denial de agentes no asignados y logs de runtime.

Abrir agentesVer catálogo