{"canonical_url":"https://engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/","content_markdown":"# Codificador QR propio en 522 líneas\n\nIncorporé al repositorio un codificador QR — Reed‑Solomon sobre GF(256), disposición fija de módulos y ocho patrones de máscara — en 522 líneas para evitar una tercera dependencia de ejecución, y lo verifiqué leyendo la matriz final con un decodificador desarrollado de forma independiente.\n\nagosto 2026\n\n**Situación.** Los documentos necesitaban un código QR que enlazara con la versión en línea. Cualquier biblioteca disponible lo hace, y adoptar una habría añadido una tercera dependencia en tiempo de ejecución a un proyecto que se había limitado deliberadamente a dos — un motor de plantillas y un generador de PDF — con el argumento de que un generador de documentos debería poder seguir instalándose dentro de varios años.\n\n**Tarea.** Había que aceptar la dependencia o implementar el formato, y verificar que la implementación fuera correcta en lugar de limitarse a producir algo cuadrado y negro.\n\n**Acción.** El codificador consta de 522 líneas e implementa las partes de la especificación que este uso realmente necesita: codificación en modo byte, corrección de errores Reed‑Solomon sobre el cuerpo de Galois de 256 elementos con el polinomio generador construido con el grado requerido, la disposición fija de módulos con sus patrones de localización, temporización y alineación, la información de formato y versión y los ocho patrones de máscara de datos evaluados frente a las cuatro reglas de penalización de la especificación, para elegir la máscara con menor puntuación y no una fija. La verificación es lo que hizo defendible la decisión. Probar un codificador contra su propia lógica no demuestra nada, por lo que la matriz de módulos terminada vuelve a leerse mediante un decodificador escrito de forma independiente a partir del orden de lectura de la especificación, y la prueba verifica que la cadena decodificada sea igual a la entrada. Eso convierte «produce una imagen plausible» en «produce un código que se decodifica en la URL correcta», y se comprueba en cada ejecución, no una sola vez a simple vista con un teléfono.\n\n**Resultado.** El número de dependencias en tiempo de ejecución se mantuvo en dos, y el codificador es el único componente incorporado directamente al código del proyecto. Debe decirse con claridad que no es una implementación de uso general: admite los modos y versiones que utilizan los documentos y nada más, y la justificación honesta es el presupuesto de dependencias, no una afirmación de que el resultado sea mejor que una biblioteca madura.\n\n---\n\n- Función: Ingeniera Python\n- Categorías: [Ingeniería de backend](https://software.engineer.company/es/categories/backend/), [Optimización del rendimiento](https://software.engineer.company/es/categories/performance/), [Pruebas y control de calidad](https://software.engineer.company/es/categories/testing/), [Python](https://software.engineer.company/es/categories/python/), [Documentación](https://software.engineer.company/es/categories/documentation/)\n- Servicios: [Arquitectura de plataformas y soluciones](https://software.engineer.company/es/services/platform-architecture/), [Desarrollo de backend y API](https://software.engineer.company/es/services/backend-development/)\n\n\u003chttps://engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/\u003e\n","date_modified":"2026-11-08T02:20:12Z","description":"El número de dependencias en tiempo de ejecución se mantuvo en dos, y el codificador es el único componente incorporado directamente al código del proyecto.","formats":{"gemtext":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/index.gmi","gopher":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/gophermap","html":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/","json":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/index.json","markdown":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/index.md","pdf":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/index.pdf"},"kind":"page","language":"es","title":"Codificador QR propio en 522 líneas","url":"https://software.engineer.company/es/portfolio/vendored-a-qr-encoder-in-522-lines/","version":1}