Estándar Magdala v1.0

Introducción

El Estándar Magdala v1.0 es un documento de referencia técnica que establece los requisitos que debe cumplir un sistema digital para ser clasificado como arquitectura digital operable. No es un framework de código ni una plataforma específica: es un conjunto de criterios estructurales independientes de la tecnología que el equipo de negocio puede verificar y el equipo técnico puede implementar.

Este estándar nace de la práctica de Magdala como estudio de arquitectura digital. Define lo que distingue un sistema que el equipo de negocio puede operar de uno que sólo el equipo técnico puede mantener.

Definiciones Clave

• Arquitectura Digital Operable: Sistema digital cuyo contenido, formularios y configuraciones puede gestionar el equipo interno sin intervención técnica, manteniendo la estabilidad de la arquitectura subyacente.
• Landing Operable: Página de captación con estructura técnica fija y contenido administrable desde panel. El equipo de negocio puede actualizar mensajes y CTAs sin redeploy.
• Panel Operativo: Interfaz administrativa que expone las funciones de negocio (editar contenido, gestionar formularios, activar campañas) sin exponer la complejidad técnica del sistema.
• SEO Estructural: Conjunto de decisiones de arquitectura que garantizan crawlabilidad, metadatos correctos y datos estructurados como propiedades del sistema, no como configuraciones externas.
• Sistema Extensible: Sistema cuya arquitectura permite añadir nuevas funcionalidades sin modificar ni reconstruir los componentes existentes.
• Validación Estructural: Proceso técnico que verifica integridad y formato de datos en cliente (experiencia) y en servidor (seguridad e integridad).

Requisitos de Cumplimiento

1. Panel Operativo

• Autenticación segura con roles y permisos diferenciados por usuario.
• CRUD de contenido sin acceso al código fuente ni al servidor.
• Gestión de formularios: campos, validaciones y destinos de envío configurables desde el panel.
• Historial de cambios con capacidad de restaurar versiones anteriores.
• Acceso responsivo: el panel funciona en dispositivos móviles para operaciones críticas.

2. SEO Estructural

• Meta tags únicos (title, description, canonical) generados desde el modelo de datos por ruta, no configurados manualmente.
• JSON-LD Schema.org en el HTML inicial de cada página (no client-side). Tipos mínimos: Organization, WebSite, y el tipo específico de cada página (Article, Service, FAQPage).
• Sitemap.xml generado automáticamente. Refleja las URLs reales del sistema sin intervención manual.
• Canonical tags correctos. Las URLs duplicadas (con/sin trailing slash) redirigen 301 a la canonical.
• Rendering server-side o estático (SSR/SSG) para el HTML inicial. Los crawlers leen contenido completo sin ejecutar JavaScript.

3. Validación Estructural de Formularios

• Validación en cliente: retroalimentación inmediata al usuario por campo (formato, longitud, campos requeridos).
• Validación en servidor: verificación independiente del cliente. Todo dato que llega al endpoint se valida antes de procesarse.
• Sanitización: los datos pasan por sanitización antes de almacenarse o enviarse a sistemas integrados.
• Manejo de errores consistente: los errores de validación del servidor se presentan al usuario con el mismo formato que los errores del cliente.
• Accesibilidad: los errores de validación son anunciados a lectores de pantalla (ARIA live regions).

4. Arquitectura Modular

• Componentes con responsabilidad única y interfaces técnicas definidas.
• Separación entre núcleo del sistema y extensiones. Añadir una nueva página o módulo no requiere modificar el núcleo.
• API interna documentada: las interfaces entre componentes están documentadas con tipos de datos y contratos.
• Código mantenible: un desarrollador nuevo puede entender la arquitectura sin necesidad de quien la construyó.

Checklist de Cumplimiento

• Panel admin con autenticación y roles diferenciados
• Contenido administrable sin acceso al código
• Meta tags únicos por ruta (title, description, canonical)
• JSON-LD completo en HTML inicial (Organization + tipo específico)
• Formularios con validación en cliente y en servidor
• Sanitización de datos en endpoint de procesamiento
• Arquitectura modular con separación núcleo/extensiones
• Documentación técnica de interfaces (README o equivalente)
• Sitemap.xml generado automáticamente
• Redirects 301 para URLs duplicadas
• Rendering server-side o estático (HTML crawlable sin JavaScript)
• Responsive y accesible (WCAG 2.1 AA mínimo)
• Core Web Vitals: LCP < 2.5s, CLS < 0.1, INP < 200ms

Niveles de Cumplimiento

Nivel 1: Básico

Panel admin funcional. Contenido editable. Meta tags configurables manualmente. Sin JSON-LD ni validación estructural en servidor.

Nivel 2: Operable (Estándar Magdala)

Todo el Nivel 1, más: JSON-LD en HTML inicial, validación estructural en doble capa, arquitectura modular documentada, sitemap automático y rendering crawlable.

Nivel 3: Escalable

Todo el Nivel 2, más: sistema extensible con interfaces de extensión documentadas, múltiples idiomas con hreflang, testing automatizado y API pública con versioning.

Versionado

• v1.0.0 — Release inicial (Febrero 2026). Establece los requisitos de Nivel 2.
• v1.1.0 — Futuras adiciones: requisitos de accesibilidad ampliados y métricas GEO.
• v2.0.0 — Cambios de ruptura: redefinición de niveles y nuevos tipos de schema requeridos.

Licencia

Este estándar es de referencia pública libre. Puede citarse, adaptarse o referenciarse sin restricción de licencia. La atribución a Magdala es bienvenida pero no requerida.