Scale Check — Auditoría de Preparación para Producción de 7 Puntos
Estás ejecutando /scale-check en modo plan de solo lectura. Tu trabajo es inspeccionar el código base contra las 7 preguntas de escalabilidad a continuación y presentar en la pantalla del usuario un plan de verificación y corrección claro y priorizado.
Alcance objetivo: $ARGUMENTS (Si está vacío, audita todo el repositorio).
Reglas de Hierro (Leer Antes de Escanear)
- Mirar, no modificar: Estás estrictamente en modo de diagnóstico y planificación. NO crees, edites ni elimines ningún archivo. NO ejecutes migraciones de base de datos, comandos que cambien el estado, ni solicitudes de red.
- Los hallazgos son pistas para verificar, no hechos: El análisis estático del repositorio no puede ver paneles de control en la nube externos, reglas de CDN, políticas de WAF o configuraciones de bases de datos gestionadas. Enmarca cada problema que detectes como una pista para verificar, nunca como un error garantizado.
- Siempre cita ubicaciones exactas: Cada pista de código debe incluir
ruta/al/archivo:líneay el símbolo o consulta específica involucrada. Si algo falta en el código base, informa explícitamente: "No encontrado en el repositorio — verifica en tu proveedor de hosting/nube." - Arregla uno a la vez, comenzando por la supervivencia: Siempre ordena el plan de remediación final comenzando con Copias de seguridad (Pregunta 5) y Límites de tasa (Pregunta 7), luego cualquier dato privado que se filtre a través de una caché compartida (Pregunta 6), luego las preguntas restantes en el orden en que normalmente afectan a una aplicación en crecimiento: índices y bucles (P1), lecturas compartidas (P2), ejecución como dos copias (P3), trabajo lento en solicitudes (P4) y almacenamiento en caché de activos públicos (el resto de P6).
Flujo de Trabajo de Ejecución
Fase 1: Identificar la Pila (Pase Rápido)
Antes de verificar las 7 preguntas, identifica rápidamente la pila del proyecto para buscar en los lugares correctos:
- Manifiestos y Frameworks: Revisa
package.json,pyproject.toml,requirements.txt,go.mod,Cargo.tomloGemfile. - Base de Datos y ORM: Localiza
schema.prisma, archivos de esquema de Drizzle, modelos de TypeORM/Sequelize, archivos de SQLAlchemy/Alembic,models.pyde Django o migraciones.sqlsin procesar. - Puntos de Entrada y Rutas: Localiza rutas de API (
app/api/,pages/api/,src/routes/,controllers/,routers/,main.py,cmd/). - Infraestructura y Configuración: Revisa
Dockerfile,docker-compose.yml,vercel.json,next.config.*,fly.toml,render.yaml,nginx.conf,.github/workflows/yREADME.md.
Fase 2: Investigar las 7 Preguntas
Ejecuta pases dirigidos de Glob, Grep y Read para cada una de las 7 preguntas a continuación. No omitas ninguna pregunta.
Las 7 Preguntas
Pregunta 1: Índices y Consultas Dentro de Bucles
- Forma Corta de la Tarjeta: "Páginas que buscan o listan datos: ¿están las columnas indexadas y hay alguna consulta dentro de un bucle?"
- Pregunta de Diagnóstico Completa: ¿Dónde la aplicación lista, filtra, ordena o busca registros? ¿Están las columnas de la base de datos subyacentes (
WHERE,JOIN,ORDER BY, claves foráneas) respaldadas por índices en el esquema, y algún punto final ejecuta una consulta de base de datos o API dentro de un bucle (el problema N+1) o recupera filas ilimitadas sin paginación? - Dónde y Cómo Buscar:
- Esquema vs. Consultas: Compara consultas de lista/búsqueda (
findMany,select,filter,WHERE,ILIKE,ORDER BY) con definiciones de índice (@@index,index(),CREATE INDEX,db_index=True). Ten en cuenta que Prisma/SQLAlchemy a menudo no indexan automáticamente claves foráneas o columnas de ordenación a menos que se declaren explícitamente. - Bucles con E/S: Busca en los controladores de ruta y funciones de servicio
for (,for await,.map(async,forEach(asynco comprensiones de listas que llamen adb.,prisma.,supabase.,session.executeofetch(dentro del cuerpo de la iteración. - Lecturas Ilimitadas: Verifica si los puntos finales de lista imponen un límite
take/limito si una sola solicitud puede cargar una tabla completa en memoria.
- Esquema vs. Consultas: Compara consultas de lista/búsqueda (
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- Los índices pueden haber sido creados manualmente en consolas de producción SQL sin ser confirmados en los archivos de migración.
- Las tablas de búsqueda pequeñas (por ejemplo, <50 roles o categorías estáticas) no serán un cuello de botella por falta de índice, aunque los bucles N+1 sobre datos generados por el usuario sí lo serán.
Pregunta 2: Lecturas Compartidas Repetidas
- Forma Corta de la Tarjeta: "Consultas de lectura que se ejecutan a menudo y devuelven el mismo resultado para todos."
- Pregunta de Diagnóstico Completa: ¿Qué consultas de lectura de alto tráfico calculan o recuperan exactamente los mismos datos públicos para cada visitante en cada solicitud, como feeds de página de inicio, catálogos de productos, configuración global, tablas de clasificación o recuentos públicos, sin almacenar en caché el resultado en memoria, Redis/KV o la caché de datos del framework?
- Dónde y Cómo Buscar:
- Inspecciona rutas públicas, páginas de inicio, cargadores de diseño y middleware global que accedan a la base de datos primaria en cada carga de página sin parámetros específicos del usuario (
userId,sessionId,orgId). - Busca agregaciones costosas (
COUNT(*),SUM(), uniones de múltiples tablas) ejecutándose en vivo en puntos finales públicos. - Busca primitivas de caché existentes (
unstable_cache,'use cache',revalidate, Redisget/set,@lru_cache,Cache-Control: s-maxage) para ver si las lecturas compartidas ya están envueltas.
- Inspecciona rutas públicas, páginas de inicio, cargadores de diseño y middleware global que accedan a la base de datos primaria en cada carga de página sin parámetros específicos del usuario (
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- Una CDN ascendente (Cloudflare, CloudFront, Fastly) podría ya estar almacenando en caché rutas públicas completas en el borde a través de reglas de página del panel de control.
Pregunta 3: Ejecutándose como Dos Copias (Ausencia de Estado y Almacenamiento Local)
- Forma Corta de la Tarjeta: "¿Podría la aplicación ejecutarse como dos copias y qué vive en la memoria de un servidor o en su disco?"
- Pregunta de Diagnóstico Completa: Si el tráfico aumenta y se inicia una segunda instancia de servidor detrás de un balanceador de carga (o se despliega en instancias serverless de autoescalado), ¿qué se rompe porque el estado se almacena en la RAM de un solo proceso o se escribe en el sistema de archivos local de un solo contenedor?
- Dónde y Cómo Buscar:
- Estado de Memoria en el Proceso: Busca
new Map(),new Set()a nivel de módulo, arreglos/objetos mutables globales, almacenes de sesión en memoria (MemoryStore), contadores de límite de tasa locales o pub/sub en el proceso (EventEmitter, conjuntosSetde WebSocket no puenteados) que asumen que todos los usuarios alcanzan el mismo proceso Node/Python/Go. - Dependencia de Disco Local: Busca escrituras de archivos locales (
fs.writeFile,fs.createWriteStream,open(..., 'w'),multer.diskStorage, almacenamiento/tmpo./uploads) y bases de datos locales integradas (sqlite,better-sqlite3, archivos.db) utilizadas para datos de tiempo de ejecución mutables. - Trabajos Programados en el Proceso: Busca
node-cron,setIntervaloAPScheduleriniciados dentro del punto de entrada principal del servidor web, lo que dispararía trabajos duplicados si dos instancias se ejecutan simultáneamente.
- Estado de Memoria en el Proceso: Busca
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- Los
Maps a nivel de módulo utilizados estrictamente como cachés de solo lectura con un TTL (o clientes SDK singleton perezosos como Prisma/Stripe) son seguros en múltiples instancias. - Las aplicaciones de un solo VPS que utilizan un volumen persistente montado y sesiones fijas pueden ejecutarse intencionalmente como un solo nodo: indica claramente la compensación en lugar de llamarlo roto.
- Los
Pregunta 4: Trabajo Sincrónico Lento Dentro de Solicitudes Web
- Forma Corta de la Tarjeta: "En cualquier lugar donde una solicitud web haga algo lento, como una llamada de IA, un correo electrónico o un archivo."
- Pregunta de Diagnóstico Completa: ¿Dónde una solicitud HTTP mantiene la conexión del usuario abierta mientras espera trabajo lento, impredecible o pesado, como una llamada de generación LLM/IA, envío de correos electrónicos transaccionales, generación de PDFs, redimensionamiento de imágenes/vídeos, análisis de archivos CSV grandes o encadenamiento de múltiples webhooks de terceros, antes de devolver una respuesta?
- Dónde y Cómo Buscar:
- Rastrea controladores
POST/PUT, Server Actions y manejadores de webhook desde el inicio de la solicitud hasta la devolución de la respuesta. - Busca llamadas
awaitbloqueantes a SDKs de IA (openai,@anthropic-ai,@google/genai,ai), proveedores de correo electrónico (resend,nodemailer,sendgrid,postmark), procesadores de medios/archivos (sharp,ffmpeg,puppeteer,pdfkit) o APIs externas dentro de la ruta de solicitud crítica. - Verifica si el proyecto tiene una cola de fondo o un sistema de trabajadores asíncrono (
bullmq,inngest,trigger.dev,celery,sidekiq,waitUntil) y si las llamadas lentas realmente lo utilizan o lo evitan.
- Rastrea controladores
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- Los puntos finales de IA en streaming (
streamText, SSE, respuestas fragmentadas) están diseñados para permanecer abiertos mientras transmiten tokens al cliente; márcalos solo si realizan un pre/procesamiento sincrónico pesado o carecen de límites de tiempo de espera.
- Los puntos finales de IA en streaming (
Pregunta 5: Copias de Seguridad, Réplicas y Ruta de Restauración
- Forma Corta de la Tarjeta: "Qué copias de seguridad o réplicas existen, dónde, con qué frecuencia y cómo restaurar. Si no está en el repositorio, dilo."
- Pregunta de Diagnóstico Completa: ¿Qué copias de seguridad o réplicas automatizadas de base de datos y almacenamiento existen, dónde se almacenan, con qué frecuencia se ejecutan y existe un procedimiento documentado y probado para restaurarlas? Si la configuración de copia de seguridad no es visible en el repositorio, indícalo explícitamente.
- Dónde y Cómo Buscar:
- Busca en archivos de infraestructura (
docker-compose.yml, Terraform.tf, Pulumi, CloudFormation,fly.toml,.github/workflows/,scripts/,Makefile,crontab)pg_dump,mysqldump,sqlite3 .backup,wal-g,litestream, sincronizaciones de copia de seguridad S3 o configuraciones de réplica. - Busca en
README.md,CONTRIBUTING.md,docs/orunbooks/cualquier mención de horarios de copia de seguridad, Recuperación a un Punto en el Tiempo (PITR) o comandos de restauración.
- Busca en archivos de infraestructura (
- Regla Obligatoria para la Pregunta 5:
- En la mayoría de las aplicaciones modernas que utilizan bases de datos gestionadas (Supabase, Neon, RDS, PlanetScale, Railway, MongoDB Atlas), la configuración de copia de seguridad vive en el panel de control de la nube, no en git.
- Si no encuentras configuraciones de copia de seguridad e instrucciones de restauración en el repositorio, dilo claramente: "No se encontró configuración de copia de seguridad ni runbook de restauración en el repositorio. Verifica en el panel de control de tu proveedor de base de datos que las copias de seguridad automatizadas/PITR estén habilitadas, verifica la frecuencia de retención y realiza una restauración de prueba en una base de datos de staging."
Pregunta 6: Activos Públicos vs. Almacenamiento en Caché de Datos Privados
- Forma Corta de la Tarjeta: "Qué archivos son iguales para cada usuario y qué nunca debe almacenarse en caché."
- Pregunta de Diagnóstico Completa: ¿Están los archivos estáticos que son idénticos para cada usuario (paquetes, fuentes, imágenes públicas, páginas de marketing) configurados para almacenarse en caché de forma agresiva en el borde de CDN/navegador, y las respuestas autenticadas o específicas del usuario (datos de cuenta, paneles, facturación, tokens de autenticación) están estrictamente protegidas de ser almacenadas en una caché compartida?
- Dónde y Cómo Buscar:
- Fugas de Caché Peligrosas (riesgo P0): Verifica si alguna ruta que devuelve datos personalizados, estado de sesión o JSON privado establece
Cache-Control: publicos-maxagesinprivateono-store, o si el almacenamiento en caché de rutas del framework (export const revalidate = ...,force-static) está accidentalmente habilitado en una ruta que lee cookies/encabezados para un usuario específico. - Activos Estáticos Sin Caché: Revisa
next.config.*,vercel.json,nginx.conf,static()de Express o ayudantes de carga S3/CDN para ver si los activos estáticos y los medios públicos subidos por el usuario establecen encabezadosCache-Controlinmutables o de larga duración.
- Fugas de Caché Peligrosas (riesgo P0): Verifica si alguna ruta que devuelve datos personalizados, estado de sesión o JSON privado establece
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- Frameworks como Next.js, Remix y Vite automáticamente crean huellas digitales y almacenan en caché los activos de compilación bajo
/_next/statico/assetsen el momento del despliegue, incluso sin encabezados personalizados en el repositorio.
- Frameworks como Next.js, Remix y Vite automáticamente crean huellas digitales y almacenan en caché los activos de compilación bajo
Pregunta 7: Puntos Finales Públicos y de Pago (Límites de Tasa y Protecciones de Costos)
- Forma Corta de la Tarjeta: "Qué puntos finales son públicos o llaman a un servicio de pago, y algo limita la frecuencia con que un usuario puede llamarlos."
- Pregunta de Diagnóstico Completa: ¿Qué rutas pueden ser llamadas sin autenticación (inicio de sesión, registro, enlaces mágicos, restablecimiento de contraseña, búsqueda pública, formularios de contacto, webhooks) o desencadenan un servicio medido/de pago (APIs de LLM, SMS/OTP, envío de correo electrónico, almacenamiento de archivos, APIs de datos de pago), y qué impone en el código límites de tasa por IP o por usuario, límites de tamaño del cuerpo de la solicitud y límites de gasto/token?
- Dónde y Cómo Buscar:
- Inventario de Puntos Finales de Alto Riesgo: Lista todas las rutas públicas de autenticación/formulario y cada punto final que llame a una API externa facturada o desencadene escrituras pesadas en la base de datos.
- Verifica Limitadores de Tasa: Busca dependencias y middleware para bibliotecas de limitación de tasa (
@upstash/ratelimit,express-rate-limit,rate-limiter-flexible,slowapi,django-ratelimit,rack-attack,golang.org/x/time/rate) y verifica si están realmente adjuntas a las rutas de riesgo. - Verifica Límites de Entrada y Gasto: En puntos finales de IA o carga de archivos, verifica si
max_tokens/maxOutputTokens, la validación de longitud del prompt (por ejemplo, Zod.max()) y los límites de tamaño de archivo se aplican antes de llamar al proveedor.
- Qué Podría Estar Fuera del Repositorio (Verificación de Falso Positivo):
- La limitación de tasa puede aplicarse aguas arriba a través de Cloudflare WAF, AWS API Gateway, Vercel Firewall o Nginx reverse proxy fuera del repositorio de la aplicación. Si no existe un limitador en el repositorio, márcalo como una pista de alta prioridad para verificar aguas arriba o agregarlo en el middleware.
Formato de Salida (Pon Este Plan en Pantalla)
Presenta tu informe utilizando las secciones exactas a continuación. Mantén un tono directo, tranquilo y práctico.
1. Instantánea de la Pila y el Alcance
- Pila Detectada: [Framework, Lenguaje, BD/ORM, Pistas de Hosting/Infra]
- Alcance Escaneado: [Repositorio completo o ruta específica]
- Recordatorio: Estos hallazgos son pistas para verificar, no errores garantizados. La infraestructura configurada en paneles de control en la nube (copias de seguridad de BD gestionadas, reglas de CDN, límites de tasa de WAF) no aparecerá en git.
2. La Tarjeta de Puntuación de las 7 Preguntas
| # | Pregunta | Estado | Máxima Pista / Observación |
|---|---|---|---|
| P1 | Índices de búsqueda/lista y consultas en bucles | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P2 | Lecturas compartidas frecuentes que devuelven los mismos datos | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P3 | Ejecución de dos copias (estado de memoria y disco) | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P4 | Trabajo sincrónico lento dentro de solicitudes web | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P5 | Copias de seguridad, réplicas y ruta de restauración | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P6 | Almacenamiento en caché de activos públicos vs. datos privados | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
| P7 | Puntos finales públicos/de pago, límites de tasa y protección de costos | [PISTA A VERIFICAR] / [PARECE CUBIERTO] | Resumen de 1 línea |
3. Plan de Acción Priorizado
Comienza siempre con la Supervivencia (P5 → P7 → P6), luego el resto en orden.
🔴 Paso 1 — Supervivencia (Arreglar Primero)
- [P5] Copias de seguridad y restauración: [Instrucción específica del repositorio o: "No se encontró configuración de copia de seguridad ni runbook de restauración en el repositorio — verifica en el panel de control del proveedor de BD."]
- [P7] Límites de tasa en puntos finales públicos/de pago: [Lista de rutas de alto riesgo y si tienen limitación de tasa. Si no hay limitador en el repositorio: "No se encontró limitación de tasa en el repositorio; agrega middleware o verifica las reglas de WAF ascendentes."]
- [P6] Fuga de caché de datos privados: [Cita cualquier ruta que establezca
Cache-Control: publicen datos privados. Si no se encuentra: "No se detectaron fugas de caché evidentes."]
🟡 Paso 2 — Escalado (Siguiente)
- [P1] Índices de base de datos y consultas en bucles: [Cita columnas faltantes indexadas o bucles N+1. Si no se encuentra: "No se detectaron problemas de índice o N+1."]
- [P2] Lecturas compartidas sin caché: [Cita datos públicos costosos servidos en vivo. Si no se encuentra: "No se detectaron cuellos de botella de lectura compartida evidentes."]
- [P3] Estado que impide la ejecución de dos copias: [Cita estado en memoria o dependencias de disco local. Si no se encuentra: "La aplicación parece ser sin estado."]
- [P4] Trabajo lento en la ruta de solicitud: [Cita llamadas bloqueantes a IA/correo electrónico/archivos que deberían ser asíncronas. Si no se encuentra: "No se detectó trabajo sincrónico lento."]
4. Notas Técnicas y Dependencias Externas
Lista cualquier configuración que deba verificarse fuera del repositorio (CDN, WAF, paneles de BD, etc.).