Skip to content

Arquitectura Leapfrog del wiki de conocimiento

Topic

From the PointSav Documentation

El motor app-mediakit-knowledge sirve instancias de wiki desde archivos Markdown planos en repositorios git con elementos de interfaz con forma de Wikipedia, diseñado para alcanzar paridad completa de memoria muscular de Wikipedia antes de agregar una capa de diferenciación que cubra verificación de citas, provenance de rastro de investigación y edición integrada con IA.

Updated 2026-05-14 · HistoryEnglish

[edit]Adaptación estratégica

`app-mediakit-knowledge` es el motor del wiki de conocimiento de PointSav: un binario Rust que sirve tres instancias wiki — documentation.pointsav.com, projects.woodfinegroup.com y corporate.woodfinegroup.com — desde archivos Markdown almacenados en repositorios git. El motor renderiza contenido con la interfaz visual de Wikipedia: tabla de contenidos adherente, resolución de wikilinks con señalización de enlaces rojos, páginas de categoría, historial de edición y búsqueda de texto completo.

En mayo de 2026, el motor implementa aproximadamente el 78 % de la experiencia visual y funcional de Wikipedia. Una hoja de ruta de varios sprints prevé llevar esa cifra a aproximadamente el 95 %, tras lo cual se añade una capa diferenciadora de Leapfrog 2030 que va más allá de lo que ofrece Wikipedia.

[edit]Por qué no se porta MediaWiki

MediaWiki fue diseñado en 2003 para un stack PHP y MySQL. Su parser — el componente que convierte el formato wikitext en HTML — fue descrito por su autor original como "un gran montón de expresiones regulares." El proyecto Parsoid, el intento de MediaWiki de reemplazar ese parser con un convertidor bidireccional HTML↔wikitext, tardó diez años en desplegarse y aún completaba su adopción en 2025.

El sistema de plantillas de MediaWiki acopla el parser a la base de datos, complica el caching y hace difícil operar el sistema sin MySQL. El objetivo arquitectónico de app-mediakit-knowledge es lograr la misma experiencia lectora mediante una pila radicalmente diferente: Markdown con frontmatter YAML en lugar de wikitext; git como registro de versiones; Tantivy (embebido, sin carga operativa) en lugar de Elasticsearch; y tipos de bloque nativos en lugar de expansión de macros recursiva.

[edit]Tipos de bloque nativos

En lugar de implementar un motor de expansión de macros wikitext, app-mediakit-knowledge está diseñado para usar bloques de código cercados que el AST de comrak reconoce y convierte a HTML estructurado. Los principales tipos previstos son:

  • Infobox — tabla resumen de columna derecha (el elemento más reconocible de Wikipedia) definida como bloque YAML cercado que el motor convierte en <table class="infobox">.
  • Navbox — tabla de navegación colapsable en la parte inferior del artículo, que agrupa enlaces a artículos relacionados bajo un título común.
  • Citas con tooltip — la sintaxis de notas al pie de comrak ([^id]) ya parsea correctamente; el trabajo pendiente es el CSS de estilo [1][2][3] y el tooltip JavaScript de vista previa en hover.

La implementación de los tipos infobox y navbox requiere, como paso planificado, actualizar comrak de la versión 0.29 a la 0.52, que incorpora la extensión block_directive.

[edit]Capa Leapfrog 2030

Una vez alcanzada la paridad con Wikipedia, se prevé añadir tres primitivas de diferenciación planificadas:

Cinta de autoridad de citas — indicador visual planificado del estado de verificación de las fuentes citadas, por artículo y eventualmente por afirmación. Las citas resueltas contra citations.yaml están previstas para mostrar una cinta de color: verde para verificadas, ámbar para no verificadas, rojo para impugnadas. Wikipedia trata todas las citas como igualmente fiables sin distinción.

Pie de trayectoria de investigación — cada artículo declara cinco campos de frontmatter (método, profundidad, confianza, fecha, limitaciones) previstos para renderizarse como una sección plegable que hace visible la procedencia de cada afirmación, apoyando las obligaciones de divulgación continua bajo NI 51-102.

Editor con integración de IA — el editor CodeMirror 6 incluye un acceso directo de tres teclas planificado para llamar a app-orchestration-command vía el proxy Doorman. Actualmente son endpoints 501 en espera de la operacionalización de service-slm.

[edit]Diseño móvil primero y mejora progresiva

El wiki está diseñado con enfoque móvil primero: la maquetación, la navegación y la tabla de contenidos se renderizan de forma correcta y usable en una ventana de 375 px antes de cualquier mejora progresiva para pantallas más amplias. Los usuarios de escritorio reciben la maquetación completa de barra lateral más contenido como mejora; los usuarios de móvil reciben la experiencia completa de lectura y edición sin una alternativa reducida.

La disciplina de área táctil sigue el Criterio de Éxito 2.5.8 de las WCAG 2.2: todos los elementos interactivos — entradas del índice, lápices de edición, enlaces de navegación, botones de alternancia — llevan un área táctil mínima de 44 px × 44 px. Las interacciones no dependen de estados hover; toda funcionalidad accesible por hover es igualmente accesible por toque. Se aplica relleno de zona segura (env(safe-area-inset-*)) al cromo del contorno para acomodar pantallas con muesca y dynamic island.

El objetivo de memoria muscular se extiende al móvil. Los patrones de navegación de la aplicación Wikipedia informan la maquetación móvil — volver arriba, deslizar entre categorías, búsqueda en barra inferior — no una "versión móvil" reducida que parezca un recurso de emergencia. Es el mismo principio leapfrog aplicado al factor de forma: alcanzar primero la paridad completa con Wikipedia móvil y luego añadir la capa diferenciadora.

[edit]Véase también

Category:Patterns
Last edited:
Edit this page · View source