1. Resumen
STATUS: borrador (v1) Estimación: 1 página
Quetzy ERP es una plataforma de gestión interna para consultoras tecnológicas que operan apoyándose en inteligencia artificial generativa. El sistema unifica en una sola aplicación los flujos habitualmente fragmentados en consultoría (clientes, proyectos, tickets, chat, llamadas WebRTC, control horario, contexto técnico validado y notificaciones) y los orienta a un mismo objetivo: que el desarrollo asistido por IA sea trazable, auditable y reproducible.
El proyecto parte de una pregunta de investigación concreta: cuál es la manera más óptima de gestionar productos digitales potenciando el desarrollo por IA sin desplazar el rol del programador, sino integrándolo en el flujo convencional de versionado y revisión por pares. Para responderla, Quetzy se construye desde el principio como un ERP self-hosted, con CI/CD automático, máquina de estados explícita para tickets, una capa diferencial de context_items (memoria validada por humanos para alimentar a los modelos) y una metodología de trabajo basada en ingeniería de contexto: cada PR se planifica con investigación previa, plan de commits atómicos y validación post-deploy.
A nivel cuantitativo, la implementación cuenta con 46.755 líneas de TypeScript repartidas en 311 archivos, 10 features funcionales, 44 endpoints API, 22 tablas en base de datos y 827 tests unitarios pasando con un 82,22 % de coverage en sentencias y un 68,93 % en ramas. La aplicación está desplegada en producción sobre un VPS Hetzner CX33 (4 vCPU AMD EPYC, 7,6 GB RAM, 75 GB SSD, Ubuntu) con pipeline CI/CD en GitHub Actions, despliegue automático tras merge a main y TLS gestionado vía Caddy. La arquitectura está diseñada para ser modificable sin reescribir el frontend gracias a una capa de contratos Zod e interfaces de repositorio con doble implementación (mock y producción).
Palabras clave: ERP, Next.js, React 19, WebRTC, LiveKit, PostgreSQL, Insforge BaaS, Repository Pattern, Realtime, Self-hosting, Ingeniería de contexto, Desarrollo asistido por IA.
