Saltar al contenido
EngineerSoftware
Menú
Diseño
Español

Engineer / Software / Portafolio

Motor de 268 controles para el repositorio

Desarrollé el motor de comprobaciones del repositorio — 268 controles de commit registrados, 277 reglas de análisis estático y 15 reglas ESLint propias —, además de 146 pruebas de los propios controles, para que la compilación haga cumplir el criterio de calidad.

Situación. Las normas escritas en una guía de contribución son sugerencias. Todo el mundo está de acuerdo con ellas, hasta que llega el viernes, el cambio es pequeño y la guía acaba perdiendo. El criterio de cero advertencias solo iba a mantenerse si lo sostenía algo más que la buena voluntad. Además, los analizadores que acompañan a cada lenguaje se quedan muy lejos de las reglas propias del proyecto que realmente importan: las que definen cómo debe funcionar este código en concreto.

Tarea. Las reglas importantes para el proyecto debían poder ejecutarse, de modo que incumplir una hiciera fallar el commit en lugar de esperar a que una persona revisora tuviera tiempo y se acordara de detectarlo.

Acción. De ahí surgió un motor de controles. Hay 274 scripts de comprobación, 268 registrados en los hooks de commit, junto con 277 analizadores JavaScript, 96 validadores Shell y 17 Python. Cubren lo que las herramientas generales no examinan: que una migración pueda revertirse, que una clave de traducción exista en ambos idiomas, que una ruta registrada aparezca en la descripción OpenAPI o que nadie añada discretamente una supresión en línea. Quince reglas ESLint propias mantienen los patrones del proyecto en TypeScript. Una regla merece mencionarse por separado: cualquier commit con prefijo fix: debe incluir una prueba que falle sin la corrección, lo que proporciona una comprobación ejecutable de esa regresión. Y como un control averiado es peor que ninguno — lo aprueba todo sin que nadie lo descubra —, los controles tienen 146 pruebas propias.

Resultado. Las personas revisoras podían dedicar más tiempo al diseño porque las comprobaciones automáticas se ocupaban de las reglas mecánicas que codificaban antes de enviar la rama al remoto. La contrapartida es real y debe decirse: confirmar cambios es lento y trabajar alrededor de un control mal escrito puede resultar realmente exasperante. Esas 146 pruebas existen porque eso ocurrió.

Contacto

¿Aún está definiendo lo que necesita?

Cuéntenos qué está fallando o qué intenta construir. Le diremos qué haría falta, cuánto costaría aproximadamente y si somos las personas adecuadas.

Desde 1.400 DKK por hora, sin IVA; y un precio por hora menor en una contratación más larga.

welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca