PIT v3 - Documento Maestro

Visión General

La Plataforma de Interoperabilidad Temporal (PIT) v3 es un sistema modular para la conversión entre múltiples calendarios y sistemas de tiempo.

Arquitectura

Core

• Módulos de conversión: Implementaciones específicas para cada calendario
• Contratos estandarizados: Interfaces consistentes entre módulos
• Configuración por entorno: Variables de entorno para personalización

APIs

• REST endpoints: Interfaces HTTP para integración
• Versionado: Soporte para múltiples versiones de API
• Autenticación: Sistema de claves API

Plugins

• Extensiones: Nuevos calendarios y funcionalidades
• Sistema de registro: Descubrimiento automático de módulos

Módulos Implementados

Calendario 260 (Tzolkin Maya)

• Correlaciones: Dreamspell (ds) y GMT (gmt)
• Cálculo: Basado en JDN (Julian Day Number)
• Salida: kin, tono, sello con metadatos

Estado del Proyecto

• ✅ Core Calendario 260: Implementado y documentado
• ✅ API v1: Endpoints básicos funcionando
• ✅ CI/CD: Validación automática
• 🚧 Endpoint /details: En desarrollo
• 📋 Calendarios adicionales: Planificados

Configuración

Variables de Entorno

• CAL260_CORRELATION: Correlación para Calendario 260 (ds/gmt)
• DEFAULT_TZ: Zona horaria por defecto
• CORS_ORIGIN: Configuración CORS
• RATE_LIMIT_*: Configuración de rate limiting

Despliegue

• API: Cloudflare Pages (pit-api.pages.dev)
• Documentación: Cloudflare Pages (pit-blueprint.pages.dev)
• CI/CD: GitHub Actions

Próximos Pasos

1. Endpoint /details: Información extendida (familia, onda, castillo, portal)
2. Calendarios adicionales: Lunar, otros sistemas mayas
3. API v2: Mejoras en performance y funcionalidad
4. SDKs: Librerías para múltiples lenguajes