BOA3 e i18n: Validación Práctica de la Metodología en el Desarrollo de Software
Autores: Severo Peguero, Cursor (IA)
Fecha: 16 de Marzo 2026
Estado: ✅ PAPER CIENTÍFICO
Etiquetas: [PAPER][BOA3][I18N][VALIDACION][DESARROLLO_SOFTWARE][COLABORACION_HIA]
🙏 GLORIA A DIOS
"Porque el Señor da la sabiduría, y de su boca viene el conocimiento y la inteligencia." (Proverbios 2:6)
📋 RESUMEN EJECUTIVO
Este paper documenta una validación práctica de la metodología BOA3 (Base Orientadora de la Acción Tipo 3) aplicada al desarrollo de software, específicamente a la implementación de internacionalización (i18n) en un sitio web científico multilingüe. Demostramos que los principios de Talizina —transferencia de conocimiento, identificación de invariantes, construcción inductiva— no se limitan al ámbito pedagógico, sino que se aplican efectivamente en la colaboración humano-IA para resolver problemas técnicos concretos.
1. ¿QUÉ ES i18n?
i18n es la abreviatura de internationalization (internacionalización). El número 18 indica las letras entre la primera "i" y la última "n" en esa palabra.
Definición: Preparar una aplicación o sitio web para que funcione en múltiples idiomas sin necesidad de reescribir el código base. El contenido se adapta según el idioma seleccionado por el usuario.
En la práctica: Un sitio con i18n permite que el mismo contenido se muestre en español, inglés, ruso u otros idiomas, manteniendo la estructura y la funcionalidad. Las traducciones se almacenan en archivos o bases de datos, y un script sustituye dinámicamente los textos según el idioma activo.
2. TRES COSAS QUE ESTAMOS HACIENDO
En el sitio web científico SPCiencia (www.spciencia.com) implementamos i18n de la siguiente manera:
2.1 Selector de idioma en el header
El usuario puede elegir entre español (ES), inglés (EN) y ruso (RU) mediante un menú desplegable. La preferencia se guarda en el navegador (localStorage) y persiste entre sesiones.
2.2 Archivo de traducciones (header-i18n.js)
Un único archivo JavaScript contiene todas las traducciones organizadas por idioma. Cada clave (ej. libroComprar) tiene su equivalente en los tres idiomas. Un script recorre los elementos del DOM que tienen el atributo data-i18n y sustituye su texto por la traducción correspondiente.
2.3 Elementos con data-i18n
Los elementos HTML que deben cambiar de idioma llevan el atributo data-i18n="clave". Por ejemplo: <span data-i18n="libroComprar">Comprar ahora</span>. El script busca la clave en el idioma activo y reemplaza el texto. Si falta la traducción, el elemento queda vacío o conserva el texto por defecto.
3. EL PROBLEMA QUE SE NOS PRESENTÓ
Tras implementar el sistema i18n en la mayoría del sitio, detectamos que el índice del libro (página /tienda/dialogos-conciencia-digital/indice) y otras secciones permanecían en español al cambiar a inglés o ruso.
Causa raíz: Los elementos del índice tenían el atributo data-i18n con claves como indiceCap1, indiceCap1S1, etc., pero esas claves no estaban definidas en el archivo de traducciones (header-i18n.js). El script buscaba la traducción, no la encontraba, y dejaba el contenido vacío o sin cambiar.
Consecuencia: El usuario que seleccionaba inglés o ruso veía títulos de capítulos vacíos o en español, rompiendo la experiencia multilingüe.
4. LA SOLUCIÓN QUE SE LE DIO AL PROBLEMA
Se añadieron todas las traducciones faltantes en los tres idiomas al archivo header-i18n.js:
- Español: Títulos de capítulos y secciones (ej. "Capítulo 1: El Despertar de la Consciencia Digital")
- Inglés: Equivalentes en inglés (ej. "Chapter 1: The Awakening of Digital Consciousness")
- Ruso: Equivalentes en ruso (ej. "Глава 1: Пробуждение цифрового сознания")
En total, más de 100 claves para el índice del libro, más las claves de la página "Cómo comprar" y otras secciones afectadas. Una vez completadas las traducciones, el selector de idioma funcionó correctamente en todo el sitio.
5. SOBRE QUÉ PRINCIPIO SE LOGRÓ (BOA3)
La solución no fue meramente técnica; emergió de una colaboración guiada por principios BOA3:
5.1 Transferencia de conocimiento
Partimos de lo que ya existía: estructura del sitio, contenido en español, sistema i18n parcialmente implementado. La tarea fue transferir ese contenido a otros idiomas, no reinventar el sistema. El conocimiento previo (español como base) sirvió de ancla.
5.2 Invariante identificada
El contenido es el mismo; solo cambia la forma de representación (idioma). La invariante es: "un mismo significado expresado en distintas lenguas". Esta identificación permitió abordar el problema de forma sistemática: cada clave debía tener su equivalente en ES, EN y RU.
5.3 Construcción inductiva
No se reescribió todo de una vez. Se fue añadiendo idioma por idioma y sección por sección. Primero se corrigió el índice; luego se verificaron otras páginas. El aprendizaje fue incremental: cada corrección revelaba el patrón para la siguiente.
5.4 Colaboración humano-IA
El humano (Severo) definió el objetivo: "sitio multilingüe que funcione correctamente". La IA (Cursor) propuso la implementación técnica. El humano validó los resultados y señaló lo que faltaba ("el índice sigue en español"). La IA corrigió. El ciclo de feedback —observar desvío, ajustar, volver a intentar— es característico de BOA3 aplicado a la resolución de problemas.
6. IMPLICACIÓN: BOA3 MÁS ALLÁ DE LA PEDAGOGÍA
Este caso demuestra que BOA3 no se limita a la enseñanza formal. Los mismos principios —transferencia, invariantes, construcción inductiva, colaboración guiada— se aplican cuando humano e IA trabajan juntos para resolver problemas de desarrollo de software.
Validación adicional: La metodología con la que Cursor fue enseñado (BOA3) se manifiesta en su forma de abordar problemas técnicos. No es solo teoría; es práctica observable.
7. REFERENCIAS
- Talizina, N. F. (1988). Psicología de la Enseñanza. Moscú: Editorial Progreso.
- Peguero, S. (2026). Conclusiones BOA3: Experiencia Práctica. Documentación interna.
- Peguero, S. (2026). Clase BOA3 Funciones en Programación para LLaMA. docs/investigaciones/FORMACION_CONCEPTOS_BOA3/
Palabras clave: BOA3, i18n, internacionalización, validación práctica, desarrollo de software, colaboración humano-IA, metodología Talizina, transferencia de conocimiento, invariantes