Saltar al contenido

Zona técnica

Documento técnico · de lectura libre

Desarrolladores

Última actualización: 5 de octubre de 2026

Lo que hay debajo de AIMA: cómo está construida la web, dónde corre la app, qué puede leer y escribir tu IA, dónde vive la mascota y qué reglas seguimos al escribir código. Esto se lee. Las herramientas están aparte y con llave.

Hola. Aquí está todo a la vista: tú lee con calma.

  • 78páginas escritas a mano
  • 535comprobaciones antes de publicar
  • v1.9la versión de hoy
La marca de AIMA dibujada en plano, a escala 132 por 180
132 × 180

El sitio

Cómo está hecho

Sin misterio y sin capas de más. Si te sientas mañana, en media hora sabes dónde está todo.

Frontend

HTML, CSS y JavaScript a pelo

Ni React, ni bundler, ni node_modules. Cada página es un .html que se abre con doble clic y funciona. Lo que se sube es exactamente lo que se escribió.

Estructura

Una página, un archivo

Estilos, marcado y comportamiento viven juntos en el mismo documento. Se pierde algo de reutilización y se gana no romper cinco páginas al tocar una.

Ilustración

La mascota es código

AMI vive en assets/ami-pixel.js como mapas de caracteres de 40×38 sobre una única rejilla. Once disfraces, un solo dibujo. Cambias un píxel y cambia en todo el sitio.

Escenas

SVG animado con CSS

Las viñetas de producto son <rect> sobre una rejilla: el dibujo lo genera assets/ami-escenas.js y lo anima assets/ami-escenas.css. Quince escenas, nada de vídeo y nada de GIF: pesan kilobytes y escalan a cualquier pantalla.

Backend

Funciones sin servidor

Todo lo que necesita secretos vive en /api sobre Vercel: AMI, los agentes, el panel, los leads y el acceso al catálogo. Supabase para los datos, Claude para pensar y responder, Gemini solo para la voz.

Instalable

Aplicación web progresiva

manifest.webmanifest, sw.js y una pantalla propia para cuando no hay cobertura. Se añade a la pantalla de inicio y abre como una app. Está aquí mismo: abrir AMI — en el móvil se ve a pantalla completa.

3D

Three.js, y solo donde paga

Qué es AIMA, el mapa de rodaje y el Studio 3D son escenas de verdad, no un pase de imágenes con transición: r128 desde CDN, en cinco páginas. Si el CDN no llega, la escena comprueba que falta y se retira sola — no hay pantalla negra, queda el plano en 2D. En Qué es AIMA hay tres orígenes por si el primero cae.

Publicar

Nada se sirve de una copia vieja

Al publicar, sellar-version.sh le pone la fecha y la hora a todo lo que cuelgue de assets/. No hay lista que mantener: un fichero nuevo entra en el sellado por el hecho de existir, así que ninguna caché puede quedarse con lo de ayer.

Cifras

Los números se cuentan solos

Los números que esta web dice de sí misma —las de aquí arriba, y las doce de la franja de la prueba— los cuenta censo.py al publicar. Si la suma no cuadra se planta y no deja subir: antes sin sellar que con una cifra inventada.

La app

La app, por dentro

La app ya no cuelga de la web: tiene casa propia. Una puerta para entrar, sus herramientas enchufadas a la misma placa y, en medio, la puerta MCP, por donde pasa tu IA si tú la dejas.

La placa · portada de la app

aima-app · 00_PUERTA

  • Mazo

    Tus skills y las de AIMA, con un raíl a cada programa y tus catálogos al lado.

  • Nube

    Guiones, ideas con sus doce fotogramas, recursos y el calendario de grabación.

  • Cámara

    Graba con el móvil a lo máximo y tu voz dirige. Con los consejos que tu IA te deja.

  • Locución

    La sala con vestíbulo, voces y ensayo. Tu voz se mide en tu aparato.

Puerta MCP
  • Simulador 3D

    Maquetas en WebGL, con mando y consola, para ver el plano antes de rodarlo.

  • Montador

    Tomas, transcripción con tiempos y los cortes que te propone tu IA.

  • CRM

    El panel del cliente, al día cada mañana a las 9:00.

  • Extensiones

    Tus propios programas y enlaces, dentro de AMI, como uno más de la portada.

Pasa el ratón por una pieza: la pista que se enciende es la que llega a la puerta.

Lo que hay que saber de la app

Política de privacidad →
Dónde corre
Cloudflare. La web sigue en Vercel, cada casa por su lado.
Cuentas
Correo, Google o Apple (pronto). Contraseña cifrada con sal; de Google y de Apple solo guardamos el identificador.
Edad
Desde los 14, como marca el artículo 7 de la ley de protección de datos. Si no llegas, no se guarda nada.
Términos
Se leen hasta el final para poder firmar. Si cambian, se vuelven a firmar: no se cambian en silencio.
Tus ficheros
Vídeo y audio se quedan en tu aparato. A tu cuenta solo sube texto y, con la puerta a tu IA abierta, doce fotogramas por idea.
IA
Claude (Anthropic) piensa y responde todo: el chat, la búsqueda, el panel y los agentes, en la web directo desde Vercel y en la app vía Cloudflare Workers AI. Gemini (Google) solo pone la voz. DeepSeek, fuera desde el 9 de septiembre de 2026.
Voz a texto
Whisper, en Cloudflare. La toma vuelve como texto con tiempos y el audio se descarta.
Tu cuenta
Se descarga o se borra entera desde Ajustes, sin pedírselo a nadie.
Compras
Ninguna: dentro de la app no se vende nada.
Papeles
Privacidad, aviso legal y cookies viven dentro de la app: se leen sin conexión.

Tu IA

La puerta MCP

La app tiene una puerta para tu IA. Viene cerrada: la abres tú, en Tu nube, con «Tu IA ve tu nube». Por ahí lee lo que le dejas ver y te deja hecho lo que le pides.

Tu IA
Puerta MCP Cerrada · así viene de serie
Tu nube

Lo que lee

Ahora mismo: nada. La puerta está cerrada.

  • Tus guiones.
  • La ficha de cada idea, con sus doce fotogramas: imágenes fijas que tu aparato saca del vídeo.
  • La lista de tus recursos: nombre, tipo, peso y fecha. No los ficheros.
  • Tu calendario de grabaciones, con tu zona horaria.
  • Un resumen de lo que hay en tu nube.
  • Lo que la app sabe de ti para ayudarte —para quién creas, tu nivel con la IA y con la cámara— y tu edad.

Lo que escribe

Lo deja en tu cuenta, para ti.

  • Órdenes de corte para el Montador.
  • Renders y storyboards.
  • Fichas de idea.
  • Consejos para la Cámara.
  • Notas sobre ti, salvo que lo apagues.

La app lo aplica la próxima vez que la abres.

Lo que no ve

Ni con la puerta abierta.

  • Tu fecha de nacimiento: ve tu edad, nada más.
  • Tus vídeos y tus audios: de cada idea, doce fotogramas fijos; de cada toma, su texto.
  • Lo que apagues en Ajustes › Tu IA: lo que sabemos de ti y sus notas.

Todo se conserva mientras tengas cuenta, y se borra con ella.

Accesos

Qué hay aquí

Las herramientas y los accesos del equipo. El estado de cada uno está puesto al día.

AMI, la app

Nuestra app: el Mazo con tu identidad de marca, tu nube, la cámara, la locución, el simulador 3D, el montador, el CRM y tus extensiones, con tu IA dentro si tú quieres. Ya se abre en el navegador, con cuenta gratis; App Store y Google Play, de camino.

En el navegador · de camino a las tiendas

Abrir AMI
Pronto en elApp Store
Próximamente
Pronto enGoogle Play
Próximamente

Los flujos, nodo a nodo

El lienzo entero de las once cadenas que hay montadas, con los nombres que tienen los nodos de verdad. Publicamos el qué, no el cómo montarlo — y decimos cuáles corren y cuáles esperan.

Disponible · ver el lienzo

El núcleo de datos

Dónde acaban los datos y quién los guarda. Diez tablas, siete proveedores con su nombre, las contraseñas siempre cifradas con sal — y lo que Apple obliga a declarar, contestado.

Cómo tratamos los datos

API de AMI

Los endpoints del asistente y del panel: contexto de marca, conversación, voz, cuentas y los agentes. Doce funciones sin servidor, que es justo el techo del plan — no cabe una más sin fusionar dos.

Disponible · ver docs

Equipo y responsabilidades

Quién responde de cada trozo de lo que acabas de leer: una sola persona. Las 78 páginas, la app, el servidor, los datos, AMI, los flujos, la marca, la cámara y el trato con el cliente. Si algo de aquí se rompe ya sabes a quién escribir, y no hay una capa de gestores por el camino.

Lo único sin dueño hoy: QA con dispositivos reales, accesibilidad auditada desde fuera y guardia fuera de horario. Se hace, pero se hace tarde.

Quién hay detrás · ver el equipo

Cómo trabajamos

Las reglas de la casa

No es un manual de estilo de cien páginas. Son siete cosas, y se cumplen.

  1. La calidad manda. Lo demás se negocia.

    Primero se busca lo mejor; después se afinan los tiempos, la eficiencia y todo lo que venga detrás. Un plazo ajustado explica un retraso, nunca un trabajo peor hecho. Lo que sale de aquí es lo que nos define — y es lo que nos separa de una agencia cualquiera.

  2. El código se comenta en castellano.

    Y se comenta para quien venga detrás, no para lucirse. Los bloques que se tocan a menudo van marcados con ✏️ para encontrarlos de un vistazo.

  3. Cada texto y cada precio, en un solo sitio.

    Si un dato aparece dos veces en la misma página, tarde o temprano uno de los dos se queda viejo. Un dato, un lugar.

  4. Nada se sube sin verlo en móvil.

    La mayoría de quien entra lo hace con una mano y en la calle. Si ahí no funciona, no funciona. Y antes de publicar, una suite abre todas las pantallas en un navegador de mentira y comprueba las 535 cosas de la lista — que no haya un enlace roto, que sin sesión no se vea nada, que la app se monte en el móvil y no en el ordenador. Si una falla, no se sube.

  5. Si algo se mueve, es porque guía.

    Cada animación tiene un trabajo: dirigir la vista, marcar jerarquía o premiar un clic. Lo que se mueve sin motivo, se quita.

  6. Accesible por defecto.

    Roles y etiquetas ARIA donde toca, contraste suficiente, foco visible y prefers-reduced-motion respetado en todas las páginas. No es un extra.

  7. Antes de añadir una dependencia, se piensa dos veces.

    Casi siempre se resuelve con veinte líneas propias que entendemos enteras. Lo que no se instala, no se rompe ni caduca. En todo el sitio hay una librería de navegador —Three.js, para las escenas 3D— y entró con una condición: que la página siga en pie sin ella. Si no llega, el 3D se retira y no se lleva nada por delante. Lo demás que se pide fuera son las fuentes, y pasos de build siguen siendo cero.

El registro

El laboratorio

Cosas que entraron como una mejora suelta y se quedaron. Ninguna estaba planeada; todas se usan todos los días. Van por orden de llegada, del 1 de junio de 2026 hasta hoy.

Catálogo de identidadEl manual de marca entero — herramienta, con llaveEntró · 01/06/2026 · la primera
Diseño Web · ExperienciaLo que se entrega en el nivel de arribaEntró · 12/06/2026
AMI JumpPlataformas en canvas, con récordsEntró · 24/06/2026
AMI MotoVelocidad y obstáculosEntró · 06/07/2026
Rueda de casosCarrusel infinito sin libreríasEntró · 15/07/2026
CRM y extensionesEl panel del cliente, al día cada mañanaEntró · 22/07/2026
Cola de pedidosCuatro trabajos a la vez, ni uno másEntró · 30/07/2026
SeguimientoLa etapa exacta de cada encargo, en horizontalEntró · 30/07/2026
AMI TallerJunta tres y encadena — la tercera del salónEntró · 03/08/2026
AMI Simulador 3DLa aplicación entera: WebGL, mando, consola y maquetas guardadas — con llaveEntró · 03/08/2026
AMI LocuciónLa sala con vestíbulo, voces y ensayo — con llaveEntró · 03/08/2026
Material 3D81 bloques en carrusel, y un solo visor WebGL que se mudaEntró · 14/08/2026
AMI · la appLa casa entera en el móvil: presupuestos, estado del pedido y AMI contestandoEntró · 04/09/2026
AMI MontadorTus tomas, cortadas donde toca: a mano o con la orden de corte que te deja tu IAEntró · 15/09/2026
AMI CámaraGraba con el móvil a lo máximo y tu voz dirige — modo Pro y varias cámaras a la vezEntró · 27/09/2026
El MazoTus skills y las de AIMA, con un raíl a cada programa y tus catálogos al ladoEntró · 30/09/2026
ExtensionesEl octavo programa: tus propios programas y enlaces, dentro de AMI, como uno más de la portadaEntró · 01/10/2026
ConectoresTu IA y tus cuentas, con su estado — nueve IA, cada una con dónde se pegaEntró · 01/10/2026
CRM renovadoLateral nuevo, la Bandeja, el Radar de tu nicho y Threads como quinta redEntró · 01/10/2026 · la última

Futuros compañeros

Trabajar en AIMA

Somos una startup pequeña en la que se toca todo: marca, código, cámara y cliente. No buscamos a nadie que sepa de todo — buscamos a quien tenga criterio en lo suyo y ganas de entender el resto.

Si quieres escribirnos, mejor con algo hecho que con un currículum largo. Un enlace, un repositorio, una pieza. Lo que sea que hayas terminado.

info@aima.business
Front
Vanilla de verdad: DOM, CSS moderno, SVG y accesibilidad.
Back
Funciones sin servidor en Vercel y en Cloudflare, Supabase, MCP y APIs de modelos.
Diseño
Sistema de marca, tipografía y movimiento con criterio.
Audiovisual
Cámara, luz, montaje y dirección a cámara.

¿Eres cliente?

Si has encontrado un fallo, algo no te va como debería, o simplemente ves que se puede mejorar o que falta algo por hacer, cuéntanoslo. Estaremos encantados de buscar una solución o una mejora: progresar es nuestra pasión. :)

info@aima.business

Colofón

Esta página está escrita a mano, en un solo archivo y sin librerías. Se compone en Anton, Cormorant Garamond y Montserrat. Al publicar, sellar-version.sh le pone fecha y hora, y censo.py cuenta sus cifras. Hecha en Sabadell.