Etiqueta “engineering”
8 artículos
Pide el permiso, no la llave: conecta servicios sin el secreto
Copiar la variable de entorno al otro servidor cuesta una línea menos. Pedirle al servicio dueño un link firmado, que abre una sola pantalla y caduca, quita un lugar donde se puede filtrar la llave que abre todas. El criterio y las tres reglas que lo sostienen.
Reintentos sin duplicados: la clave de idempotencia sale del contenido, no del reloj
Un reintento es normal en cualquier fetch; un post duplicado en el feed de una marca, no. Cómo armar una Idempotency-Key para que el segundo clic devuelva lo ya creado, y por qué la validación tiene que ser todo o nada cuando publicas en varios canales.
Tarjeta de WhatsApp para una página estática, sin navegador en el servidor
Nuestras propuestas se publican como carpetas estáticas, y pegadas en WhatsApp salían como un link pelado. WhatsApp no muestra SVG, y no queríamos un navegador headless en el contenedor para dibujar una miniatura. Un rasterizador nativo con las fuentes adentro ahora escribe un PNG de 1200×630 en cada publicación. El circuito, los dos ajustes de Next.js que pide y qué pasa cuando falla.
Dale a tu sitio un endpoint que diga de qué commit salió
Treinta líneas en una ruta de Next.js y la pregunta "¿qué versión está en vivo?" se contesta con un curl y un git rev-parse. Cómo lo armamos en vendear, de dónde sale el commit y por qué la respuesta dice también cómo se publicó.
Cómo dejar los links compartidos con el dominio correcto: canonical, og:url y barra final
Una variable con una barra de más o con el host de Vercel, y cada link que se comparte sale con el dominio equivocado. La función de seis líneas que lo normaliza en vendear, dónde se usa y por qué apunta a www y no al dominio desnudo.
Cómo decidimos qué probar después en el retrieval: una cola de predicciones escritas
Nuestra hoja de ruta de retrieval es una cola de hipótesis, cada una con su predicción y el resultado que la refutaría escritos antes de medir. Cómo un número ordenó la cola, y cómo la cola se reordenó sola cuando perdió la primera apuesta.
Cómo evaluamos el retrieval: un golden set, una fila sin fuga y un banco de pruebas que se niega a correr
Tres decisiones de diseño de nuestro banco de pruebas de retrieval que no son obvias y que cualquiera que lo herede necesita entender. De dónde sale el set de prueba, qué configuración puede decidir y cuándo el banco dice que no.
Una página puede estar caída sin devolver un solo error
Nuestro formulario de contacto respondía, se veía bien y no enviaba nada. Dos rutas indexadas devolvían 200 y estaban vacías. Ningún monitor de disponibilidad lo detecta, porque nada falla — lo que falta es la última milla.