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.
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.
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.
| Actor | Problema que resuelve | Valor inmediato |
|---|---|---|
| Arquitecto | Centro de coordinación, fuente única de documentos | Elimina reenvíos, versiones duplicadas, consultas repetidas |
| Aparejador | Acceso a documentación técnica sin depender del arquitecto | Planos y memorias siempre en su versión actual |
| Promotora | Visibilidad del estado real del proyecto | Dashboard de estado, alertas de plazos |
| Notario | Datos técnicos verificados sin consultas | Metros, referencias, certificados al instante |
| Abogado | Contexto completo sin repetir explicaciones | Expediente completo con un enlace |
| Perito | Historial documental completo y trazable | Informes con datos verificados |
| Aseguradora | Documentación técnica para análisis de riesgo | Pólizas vinculadas al expediente |
| Inmobiliaria | Datos técnicos para due diligence | Fichas técnicas generadas automáticamente |
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.
Cuatro agentes.
Un resultado.
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.
Sin atarse
a uno.
| Modelo | Proveedor | Caso de uso óptimo en ArquiFlow |
|---|---|---|
| Claude Sonnet | Anthropic | Razonamiento jurídico y técnico complejo. Análisis de normativa. |
| GPT-4o | OpenAI | Redacción natural. Memorias descriptivas, cartas, comunicaciones. |
| Gemini 1.5 Pro | Contextos muy largos (1M tokens). Expedientes de gran volumen. | |
| Perplexity | Perplexity AI | Búsqueda y síntesis con fuentes web. Normativa actualizada. |
| DeepSeek V3 | DeepSeek | Eficiencia en consultas de alto volumen. |
| Llama 3.3 | Meta (self-hosted) | Privacidad máxima. Sin envío de datos a terceros. |
| ⚡ Modo Combinado | Multi-proveedor | Documentos oficiales, pliegos, escrituras. Máxima fiabilidad. |
Arquitectura del
sistema
| Capa | Servicio | Función | Estado |
|---|---|---|---|
| Frontend | Next.js 14+ · TypeScript | Framework web, SSR, rutas protegidas | Fase 1 |
| Deploy F1 | Vercel | Deploy automático en push a main | Fase 1 |
| Deploy F2 | Docker · Hetzner :3003 | Servidor dedicado, control total | Fase 2 |
| Base de datos | Supabase · PostgreSQL | Auth, expedientes, permisos | Fase 1 |
| Storage | Supabase Storage | Almacenamiento de documentos | Fase 1 |
| IA principal | Anthropic API | Motor del agente IA | Fase 1 |
| Vector DB | Pinecone | Embeddings y búsqueda semántica (RAG) | Fase 1 |
| Drive | Google Drive API v3 | Lectura/escritura en carpetas compartidas | Fase 1 |
| Auth | Supabase Auth | Login email + magic link + OAuth Google | Fase 1 |
| Pagos | Stripe | Suscripciones + pay-per-project | Fase 1 |
| Resend | Notificaciones transaccionales | Fase 1 | |
| DNS + CDN | Cloudflare | DNS proxy, WAF, caché | Activo |
| Analytics | PostHog | Comportamiento de usuario | Fase 1 |
| Errores | Sentry | Seguimiento de errores en producción | Fase 1 |
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
- Al crear un expediente, ArquiFlow crea o vincula una carpeta en Google Drive
- Se comparte con los actores invitados según sus permisos
- Un webhook notifica a ArquiFlow cada vez que se sube, modifica o elimina un archivo
- ArquiFlow descarga el archivo, extrae texto, genera embeddings y actualiza Pinecone
- El contexto del agente se actualiza automáticamente
- Los documentos generados se guardan en la carpeta del expediente
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.
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.
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.
La base de datos de ArquiFlow es completamente independiente de cualquier otro proyecto en el servidor Hetzner. Cuentas CyberPanel distintas por dominio. Sin excepciones.
Servidor dedicado.
Escala real.
| Componente | Especificación |
|---|---|
| Modelo | Hetzner AX102 · Servidor dedicado bare metal |
| Procesador | AMD Ryzen 9 5950X · 16 núcleos / 32 hilos |
| RAM | 128 GB DDR4 ECC |
| Almacenamiento | 2× 1.92 TB NVMe SSD (RAID 1) |
| Red | 1 Gbit/s simétrico · 20 TB tráfico/mes |
| Ubicación | Núremberg, Alemania · RGPD estructural |
| Puerto asignado | :3003 (exclusivo ArquiFlow · Fase 2) |
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.
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
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.
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.
Tres planes.
Escala predecible.
| Plan | Precio | Target |
|---|---|---|
| Proyecto puntual | 100€ · pago único | Prueba sin compromiso · 1 expediente · 5 actores |
| Estudio | 250€/mes | Estudios 1–10 personas · Expedientes ilimitados · Todos los modelos |
| Promotora | 550€/mes | Promotoras y constructoras · Multi-estudio · Expedientes públicos · API · SLA |
| Escenario | 6 meses | 12 meses | 24 meses |
|---|---|---|---|
| Estudios (250€/mes) | 5 → 1.250€/mes | 20 → 5.000€/mes | 60 → 15.000€/mes |
| Promotoras (550€/mes) | 2 → 1.100€/mes | 5 → 2.750€/mes | 15 → 8.250€/mes |
| MRR total | ~2.850€ | ~9.250€ | ~27.250€ |
De aquí a
tracción real
Lo que puede
salir mal
| Riesgo | Impacto | Mitigación |
|---|---|---|
| Respuesta incorrecta del agente | Crítico | Fuentes obligatorias en toda respuesta. Umbral mínimo de confianza. Auditor en Modo Combinado. |
| Dependencia de un único proveedor IA | Alto | Arquitectura multi-modelo desde Fase 1. Fallback automático. |
| Adopción lenta del sector | Alto | Demo interactiva. Plan de proyecto puntual (100€) sin compromiso. Estudio piloto validado. |
| Seguridad documental | Crítico | Solo embeddings almacenados. Cifrado completo. Auditoría. RGPD por diseño. |
| Normativa desactualizada en RAG | Alto | Actualización trimestral. Fecha visible en cada respuesta normativa. |
Configuración
del sistema
.env.local NUNCA se sube a Git. Solo .env.example sin valores reales.
| Variable | Descripción | Visibilidad |
|---|---|---|
| NEXT_PUBLIC_SUPABASE_URL | URL del proyecto Supabase | Pública |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | Clave anónima Supabase | Pública |
| SUPABASE_SERVICE_ROLE_KEY | Acceso total a BD | ⚠ Solo servidor |
| ANTHROPIC_API_KEY | Claude API | ⚠ Solo servidor |
| OPENAI_API_KEY | GPT-4o + embeddings | ⚠ Solo servidor |
| GOOGLE_CLIENT_ID | OAuth Google Drive | Pública |
| GOOGLE_CLIENT_SECRET | OAuth Google Drive | ⚠ Solo servidor |
| PINECONE_API_KEY | Base de datos vectorial | ⚠ Solo servidor |
| STRIPE_SECRET_KEY | Clave secreta Stripe | ⚠ Solo servidor |
| STRIPE_WEBHOOK_SECRET | Secret del webhook | ⚠ Solo servidor |
| NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY | Clave publicable Stripe | Pública |
| RESEND_API_KEY | Emails transaccionales | ⚠ Solo servidor |
| NEXT_PUBLIC_APP_URL | URL base de la aplicación | Pública |
Uso interno · Confidencial · Solo socios y colaboradores autorizados