BrainClash.aiPresentación técnica1/1
Presentación técnica

Cómo funciona por dentro

Arquitectura, Árbitro IA, RAG, generación del Informe, seguridad y compliance.

Qué es

Plataforma de debate estratégico moderado por IA

Salas de debate en tiempo real donde un Árbitro IA interviene, hace RAG sobre la documentación del proyecto y genera veredictos e informes estructurados. Multi-tenant: organización → proyectos → contextos, ideas y sesiones.

Tiempo real (WebSocket)RAG con pgvectorMulti-tenant + RBACVeredictos IAAuditable
Arquitectura

Stack

Frontend
Next.js 15 · App Router · TypeScript · Tailwind
Backend
FastAPI (async) · SQLAlchemy · Alembic
Base de datos
PostgreSQL + pgvector (búsqueda vectorial)
Tiempo real
WebSocket para la sala del Árbitro
LLM
Modelo por tier · RAG + veredictos + Árbitro + Informe
Auth
JWT en cookies httpOnly · refresh rotativo
El Árbitro

Intervención en tiempo real con contexto

Vigila cada mensaje

Interviene por cadencia configurable o al detectar una propuesta concreta.

RAG sobre el contexto

Recupera los fragmentos relevantes de la documentación del proyecto (pgvector) y cita evidencia.

Tres modos

Exigente (impacto), Adversarial (punto ciego), Imparcial (evidencia).

Veredicto al cerrar

Sintetiza propuesta recomendada, supuestos, riesgos, indicadores y próximos pasos.

Pipeline RAG

De documento a evidencia citable

01
Ingesta
PDF / Word · extracción de texto
02
Chunking
Fragmentos + embeddings
03
pgvector
Índice vectorial por contexto
04
Retrieval
Top-k por similitud en la sesión
05
Árbitro
Responde citando la evidencia
Generación del Informe de Mejora

Dos etapas, con RAG multifacético

El Informe se genera con un esquema Pydantic fijo y se persiste como JSON, lo que garantiza una estructura repetible y exportable a PDF de marca por organización.

Etapa A

Diagnóstico y priorización

Una llamada JSON: indicadores, mapeo del proceso y áreas ordenadas por impacto/esfuerzo.

Etapa B

Detalle por área

Iniciativas en paralelo (Semaphore) con canvas de 6 cajas y cronograma; degradación elegante.

Salida

PDF de marca

fpdf2 + fuente Unicode vendorizada. Colores y logo por organización.

Tenencia

Aislamiento en tres niveles

1

Organización

Agrupa proyectos y miembros. Roles: owner · admin · member. Facturación por tier.

2

Proyecto

Unidad de aislamiento de datos. Roles: owner · admin · editor · viewer.

3

Datos

Contextos, ideas, sesiones e informes, scoped al proyecto.

Seguridad y compliance

Confianza por diseño

Sin datos de pacientes

Escenarios sintéticos. Nunca datos clínicos identificables.

Trazabilidad

Histórico append-only de eventos e ideas; sesiones auditables.

Aislamiento y RBAC

Acceso por roles, datos aislados por organización y proyecto.

Anti prompt-injection

Delimitación de contenido de usuario; la IA aconseja, el humano decide.

Rate-limiting

En login, registro y operaciones sensibles.

Despliegue EU

On-prem / VPS en la UE, sin dependencias de object storage externas.

Integraciones

Encaja en el flujo de trabajo

Notificaciones

In-app y email en eventos clave.

Webhooks

Salientes con firma HMAC · Slack.

Export

JSON / Markdown / PDF de sesiones, veredictos e informes.

OAuth

Google / Microsoft (SSO).

Listo para un piloto técnico

Desplegable en la UE, sobre datos sintéticos, con trazabilidad completa. Se puede montar un entorno de evaluación aislado para el equipo.

BrainClash.ai

↑ ↓ o rueda para navegar