v1.0 · Abril 2026Confidencial · Solo socios
← Volver a arquiflow.com
Documento técnico y funcional
ArquiFlow —
Arquitectura técnica
y plan de implementación

Referencia completa para socios, inversores y equipo técnico. Describe el sistema, las integraciones, la arquitectura de datos, los protocolos de seguridad y el plan de escalado del primer sistema multiagente IA B2B para el sector de la construcción en España.

Versión
1.0 · Abril 2026
Estado
Fase 0 completada
Servidor
Hetzner AX102
Dominio
arquiflow.com
Documento interno · Uso exclusivo socios y colaboradores autorizados · No distribuir
00 · Resumen ejecutivo

Qué es y por qué
importa ahora

ArquiFlow es el primer sistema multiagente IA B2B diseñado exclusivamente para el sector de la construcción en España. No es un chatbot sobre arquitectura. Es una plataforma de gestión documental inteligente donde todos los actores de un proyecto trabajan sobre los mismos documentos desde un único expediente compartido.

El problema que resuelve es concreto: el caos documental. En un proyecto típico, los documentos están dispersos en email, WhatsApp, Dropbox, Google Drive y varios portales. Nadie tiene el cuadro completo. Las versiones se descontrolan. Los actores pierden horas buscando datos que ya existen en algún lado.

6
Modelos IA integrados
8+
Tipos de actores
4
Agentes especializados
#1
En España · Sector

01 · Visión del producto

El expediente que
todos necesitan

La metáfora central es el expediente de obra. ArquiFlow lo lleva al entorno digital con una diferencia fundamental: una IA que conoce el contenido de cada documento y puede responder preguntas sobre él en lenguaje natural.

ActorProblema que resuelveValor inmediato
ArquitectoCentro de coordinación, fuente única de documentosElimina reenvíos, versiones duplicadas, consultas repetidas
AparejadorAcceso a documentación técnica sin depender del arquitectoPlanos y memorias siempre en su versión actual
PromotoraVisibilidad del estado real del proyectoDashboard de estado, alertas de plazos
NotarioDatos técnicos verificados sin consultasMetros, referencias, certificados al instante
AbogadoContexto completo sin repetir explicacionesExpediente completo con un enlace
PeritoHistorial documental completo y trazableInformes con datos verificados
AseguradoraDocumentación técnica para análisis de riesgoPólizas vinculadas al expediente
InmobiliariaDatos técnicos para due diligenceFichas técnicas generadas automáticamente

02 · Funcionalidades core

Lo que hace el
sistema

Expediente compartido · Consulta natural · Generación de docs

Cada proyecto tiene un expediente que contiene todos sus documentos, el historial de interacciones con el agente IA, los actores invitados con sus permisos, y el estado de cada documento. Cualquier actor puede preguntar al agente en lenguaje natural y recibir respuestas con datos verificados y fuentes concretas.

Ejemplos de consultas reales: "¿Cuántos metros tiene el trastero nº3?" · "¿Está aprobada la licencia?" · "¿Qué documentos faltan para la escritura notarial?" · "¿Cumple el aislamiento con el CTE DB-HE para la zona B3?"

Expediente público para concursos

El propietario puede publicar el expediente total o parcialmente. Una promotora publica las bases de un concurso para que varias constructoras concurran con acceso exactamente a la misma documentación. El agente IA responde preguntas de todos. Ninguna constructora tiene ventaja informacional. El proceso queda auditado de forma completa.


03 · Sistema multiagente

Cuatro agentes.
Un resultado.

Input
Consulta en lenguaje natural
Documentos del expediente
Agente 01
Documental
Indexación semántica · Extracción de entidades · Vinculación entre documentos
Agente 02
Normativo
CTE · PGOU · Normativas autonómicas · Verificación de cumplimiento
Agente 03
Redactor
Generación con contexto real · Estilo personalizado · Datos verificados
Agente 04
Auditor
Verificación cruzada · Detección de inconsistencias · Control de calidad
Output
Respuesta verificada + fuentes
Documento generado → Drive

El Modo Combinado activa los cuatro agentes: el Redactor genera, el Auditor revisa antes de entregar. Es el nivel de fiabilidad más alto disponible actualmente en cualquier plataforma de generación de documentos técnicos.


04 · Modelos IA

Sin atarse
a uno.

ModeloProveedorCaso de uso óptimo en ArquiFlow
Claude SonnetAnthropicRazonamiento jurídico y técnico complejo. Análisis de normativa.
GPT-4oOpenAIRedacción natural. Memorias descriptivas, cartas, comunicaciones.
Gemini 1.5 ProGoogleContextos muy largos (1M tokens). Expedientes de gran volumen.
PerplexityPerplexity AIBúsqueda y síntesis con fuentes web. Normativa actualizada.
DeepSeek V3DeepSeekEficiencia en consultas de alto volumen.
Llama 3.3Meta (self-hosted)Privacidad máxima. Sin envío de datos a terceros.
⚡ Modo CombinadoMulti-proveedorDocumentos oficiales, pliegos, escrituras. Máxima fiabilidad.

05 · Stack técnico

Arquitectura del
sistema

CapaServicioFunciónEstado
FrontendNext.js 14+ · TypeScriptFramework web, SSR, rutas protegidasFase 1
Deploy F1VercelDeploy automático en push a mainFase 1
Deploy F2Docker · Hetzner :3003Servidor dedicado, control totalFase 2
Base de datosSupabase · PostgreSQLAuth, expedientes, permisosFase 1
StorageSupabase StorageAlmacenamiento de documentosFase 1
IA principalAnthropic APIMotor del agente IAFase 1
Vector DBPineconeEmbeddings y búsqueda semántica (RAG)Fase 1
DriveGoogle Drive API v3Lectura/escritura en carpetas compartidasFase 1
AuthSupabase AuthLogin email + magic link + OAuth GoogleFase 1
PagosStripeSuscripciones + pay-per-projectFase 1
EmailResendNotificaciones transaccionalesFase 1
DNS + CDNCloudflareDNS proxy, WAF, cachéActivo
AnalyticsPostHogComportamiento de usuarioFase 1
ErroresSentrySeguimiento de errores en producciónFase 1

06 · Integración Google Drive

Drive como fuente
de verdad

ArquiFlow no reemplaza Drive — se conecta a él. Cada expediente tiene una carpeta de Drive asociada. Los documentos subidos se indexan automáticamente. Los documentos generados por el agente se guardan directamente en esa carpeta.

Flujo completo

  1. Al crear un expediente, ArquiFlow crea o vincula una carpeta en Google Drive
  2. Se comparte con los actores invitados según sus permisos
  3. Un webhook notifica a ArquiFlow cada vez que se sube, modifica o elimina un archivo
  4. ArquiFlow descarga el archivo, extrae texto, genera embeddings y actualiza Pinecone
  5. El contexto del agente se actualiza automáticamente
  6. Los documentos generados se guardan en la carpeta del expediente
Seguridad · No almacenamiento de documentos

Los archivos se descargan temporalmente para procesamiento. Solo se almacenan embeddings (vectores numéricos) en Pinecone. Los documentos originales permanecen en Google Drive bajo control del usuario.


07 · Sistema RAG

Respuestas verificadas.
No inventadas.

El sistema RAG permite responder sobre documentos específicos con alta precisión. Busca primero los fragmentos más relevantes y solo incluye esos en la consulta al modelo. Si ningún fragmento supera el umbral de confianza, el agente indica que no tiene información suficiente — nunca inventa.

Pipeline de indexación: Extracción de texto → Chunking (~500 tokens) → Embedding (1536 dimensiones) → Almacenamiento en Pinecone con metadatos (expediente, actor, fecha, versión).

Pipeline de consulta: Embedding de la pregunta → Búsqueda semántica → Filtrado por permisos → Construcción del contexto → Generación con fuentes citadas.


08 · Permisos y seguridad

Control granular.
Sin excepciones.

El sistema opera en tres capas: permisos por expediente (qué puede hacer el actor), permisos por documento (qué documentos puede ver), y visibilidad pública controlada (expedientes de concurso).

  • Cifrado en tránsito: TLS 1.3. Cloudflare como primera línea de protección.
  • Cifrado en reposo: Supabase cifra todos los datos. Embeddings en Pinecone sin texto original.
  • Aislamiento por expediente: Filtros de Pinecone garantizan que un expediente no accede a embeddings de otro.
  • Auditoría completa: Cada consulta, documento y cambio de permisos en log inmutable.
  • RGPD estructural: Servidor en Núremberg, Supabase en Frankfurt, Pinecone en EU.
  • Derecho al olvido: Eliminar un expediente borra todos los embeddings y metadatos.
Crítico · Separación de datos

La base de datos de ArquiFlow es completamente independiente de cualquier otro proyecto en el servidor Hetzner. Cuentas CyberPanel distintas por dominio. Sin excepciones.


09 · Infraestructura

Servidor dedicado.
Escala real.

ComponenteEspecificación
ModeloHetzner AX102 · Servidor dedicado bare metal
ProcesadorAMD Ryzen 9 5950X · 16 núcleos / 32 hilos
RAM128 GB DDR4 ECC
Almacenamiento2× 1.92 TB NVMe SSD (RAID 1)
Red1 Gbit/s simétrico · 20 TB tráfico/mes
UbicaciónNúremberg, Alemania · RGPD estructural
Puerto asignado:3003 (exclusivo ArquiFlow · Fase 2)
Decisión técnica firme

Fase 1: Vercel + Supabase. No mover a Hetzner hasta estabilización completa del servidor.
Fase 2: Docker en Hetzner :3003. BD siempre separada e independiente.


10 · Despliegue CI/CD

Del código al
servidor

Fase 1 · Vercel (automático)

Push a main → Vercel detecta → despliega en menos de 2 minutos. Preview deployments en cada Pull Request.

Fase 2 · Docker + Hetzner

docker build -t ghcr.io/usuario/arquiflow:latest .
docker push ghcr.io/usuario/arquiflow:latest
ssh -p 2222 [email protected]
docker compose -f docker-compose.prod.yml up -d --force-recreate

GitHub Actions (CI/CD automático en Fase 2)

on: { push: { branches: [main] } }
jobs:
  deploy:
    steps:
      - Build Docker image + push to GHCR
      - SSH to Hetzner → docker pull + compose up

11 · Modelo B2B público

El expediente como
plataforma pública

Una promotora puede publicar un expediente con las bases documentales de un concurso. Todas las constructoras concurrentes acceden exactamente a la misma información, en el mismo estado, sin ventajas informacionales entre ellas. El agente IA responde preguntas de todos por igual. Todo queda auditado.

El mismo modelo aplica a licitaciones de organismos públicos, cumpliendo con la Ley 9/2017 de Contratos del Sector Público: documentación técnica disponible para cualquier empresa interesada, con trazabilidad completa del proceso.

Efecto de red

Cada expediente público que una promotora publica lleva consigo a todas las constructoras que concurren — que se convierten en usuarios del sistema. Los clientes de pago generan usuarios no de pago que eventualmente se convierten en clientes de pago para sus propios proyectos.


12 · Planes y proyección

Tres planes.
Escala predecible.

PlanPrecioTarget
Proyecto puntual100€ · pago únicoPrueba sin compromiso · 1 expediente · 5 actores
Estudio250€/mesEstudios 1–10 personas · Expedientes ilimitados · Todos los modelos
Promotora550€/mesPromotoras y constructoras · Multi-estudio · Expedientes públicos · API · SLA
Escenario6 meses12 meses24 meses
Estudios (250€/mes)5 → 1.250€/mes20 → 5.000€/mes60 → 15.000€/mes
Promotoras (550€/mes)2 → 1.100€/mes5 → 2.750€/mes15 → 8.250€/mes
MRR total~2.850€~9.250€~27.250€

13 · Roadmap

De aquí a
tracción real

Abr 2026
Fase 0 · Completada
Landing + infraestructura + documentos técnicos
Landing publicada. DNS Cloudflare. SSL. Demo interactiva. Arquitectura técnica y análisis de mercado para socios.
May 2026
Fase 1A · En curso
MVP del agente IA con primer estudio piloto
Auth + dashboard + expedientes + Drive API + Pinecone + interfaz de chat. Primer estudio real usando el sistema.
Jun 2026
Fase 1B
Sistema multiactor + Stripe + compartir expediente
Invitación de actores por rol. Row Level Security. Stripe integrado para los tres planes.
Sep 2026
Fase 2A
Multi-modelo + generación + expediente público
GPT-4o, Gemini, DeepSeek. Modo Combinado. Generación de docs. Expediente público para concursos. 10+ estudios.
Dic 2026
Fase 2B
Hetzner + CTE completo + escala
Docker en Hetzner :3003. CTE completo + PGOU principales ciudades. Primeros concursos públicos. 20+ estudios.
2027
Fase 3
Expansión nacional e institucional
50+ estudios. Normativa 17 CCAA. Partnerships colegios de arquitectos. Integración BIM. Mercado hispanohablante.

14 · Riesgos y mitigaciones

Lo que puede
salir mal

RiesgoImpactoMitigación
Respuesta incorrecta del agenteCríticoFuentes obligatorias en toda respuesta. Umbral mínimo de confianza. Auditor en Modo Combinado.
Dependencia de un único proveedor IAAltoArquitectura multi-modelo desde Fase 1. Fallback automático.
Adopción lenta del sectorAltoDemo interactiva. Plan de proyecto puntual (100€) sin compromiso. Estudio piloto validado.
Seguridad documentalCríticoSolo embeddings almacenados. Cifrado completo. Auditoría. RGPD por diseño.
Normativa desactualizada en RAGAltoActualización trimestral. Fecha visible en cada respuesta normativa.

15 · Variables de entorno

Configuración
del sistema

Crítico

.env.local NUNCA se sube a Git. Solo .env.example sin valores reales.

VariableDescripciónVisibilidad
NEXT_PUBLIC_SUPABASE_URLURL del proyecto SupabasePública
NEXT_PUBLIC_SUPABASE_ANON_KEYClave anónima SupabasePública
SUPABASE_SERVICE_ROLE_KEYAcceso total a BD⚠ Solo servidor
ANTHROPIC_API_KEYClaude API⚠ Solo servidor
OPENAI_API_KEYGPT-4o + embeddings⚠ Solo servidor
GOOGLE_CLIENT_IDOAuth Google DrivePública
GOOGLE_CLIENT_SECRETOAuth Google Drive⚠ Solo servidor
PINECONE_API_KEYBase de datos vectorial⚠ Solo servidor
STRIPE_SECRET_KEYClave secreta Stripe⚠ Solo servidor
STRIPE_WEBHOOK_SECRETSecret del webhook⚠ Solo servidor
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEYClave publicable StripePública
RESEND_API_KEYEmails transaccionales⚠ Solo servidor
NEXT_PUBLIC_APP_URLURL base de la aplicaciónPública
ArquiFlow · Arquitectura Técnica v1.0 · Abril 2026

Uso interno · Confidencial · Solo socios y colaboradores autorizados

Análisis de mercado → ← Volver a arquiflow.com
Promovido por BARREJON LTD London · Diseñado y gestionado por nucleoworld.com · Desarrollado por l4t.io