🔮 El Oráculo del I Ching

📖 Descripción

El Oráculo del I Ching es una aplicación web moderna y elegante que permite consultar el antiguo oráculo chino del I Ching (Libro de las Mutaciones). Esta aplicación combina la sabiduría milenaria con tecnología web moderna para ofrecer una experiencia única e inmersiva.

✨ Características Principales

• 🎲 Consulta al Oráculo: Sistema de consulta tradicional con tres monedas
• 📚 Biblioteca Completa: Los 64 hexagramas con sus interpretaciones detalladas
• 🎨 Diseño Premium: Interfaz moderna con paleta de colores tradicionales chinos
• 📱 PWA: Instalable como aplicación nativa en dispositivos móviles
• 🌐 Multiidioma: Optimizado para español
• 💾 Historial: Guarda tus consultas anteriores
• 🔄 Compartir: Comparte tus consultas en redes sociales
• 🎯 SEO Optimizado: Meta tags y structured data para mejor posicionamiento
• ⚡ Performance: Carga rápida y optimizada
• 🔒 Seguridad: Headers de seguridad configurados

🚀 Demo en Vivo

Visita la aplicación en: https://iching-librodemutaciones.web.app

🛠️ Tecnologías Utilizadas

Frontend

• HTML5: Estructura semántica y accesible
• CSS3: Diseño responsive con variables CSS y animaciones
• JavaScript (Vanilla): Lógica de la aplicación sin frameworks
• Font Awesome: Iconografía moderna
• Google Fonts: Tipografías Noto Serif SC y Noto Sans SC

Backend & Hosting

• Firebase Hosting: Hosting rápido y seguro
• Service Worker: Funcionalidad offline
• PWA: Progressive Web App

Herramientas de Desarrollo

• Git: Control de versiones
• Firebase CLI: Despliegue automatizado
• http-server: Servidor de desarrollo local

📂 Estructura del Proyecto

I-Ching/
├── assets/
│   └── images/
│       ├── favicon/          # Iconos para diferentes dispositivos
│       ├── logo.png          # Logo principal
│       └── logo.jpeg         # Logo alternativo
├── index.html                # Página principal
├── hexagramas.html          # Biblioteca completa de hexagramas
├── hexagrama.html           # Vista detallada de hexagrama individual
├── blog.html                # Blog sobre I Ching
├── styles.css               # Estilos principales
├── script.js                # Lógica de la aplicación
├── share-functions.js       # Funciones para compartir
├── share-styles.css         # Estilos para compartir
├── hexagramas.json          # Base de datos de hexagramas
├── articulos.json           # Artículos del blog
├── manifest.json            # Configuración PWA
├── service-worker.js        # Service Worker para PWA
├── firebase.json            # Configuración Firebase
├── .firebaserc              # Proyecto Firebase
├── robots.txt               # SEO
├── sitemap.xml              # Mapa del sitio
└── README.md                # Este archivo

🎨 Paleta de Colores

La aplicación utiliza una paleta de colores inspirada en la tradición china:

• Rojo Imperial: #8c1c13 - Color principal
• Beige Papel Antiguo: #e8d8c5 - Fondos secundarios
• Dorado Suave: #d4b483 - Acentos
• Marrón Oscuro: #2c1e16 - Textos y elementos oscuros
• Beige Claro: #f5f2e9 - Fondos principales

🔧 Instalación y Uso Local

Prerrequisitos

• Node.js (v14 o superior)
• npm o npx
• Git

Pasos de Instalación

1. Clonar el repositorio

   git clone https://github.com/JoseAlvarezDev/I-Ching.git
   cd I-Ching

2. Iniciar servidor local

   npx http-server -p 3000

3. Abrir en el navegador

   http://localhost:3000
   

🚀 Despliegue en Firebase

Configuración

1. Instalar Firebase CLI

   npm install -g firebase-tools

2. Iniciar sesión en Firebase

   firebase login

3. Desplegar

   firebase deploy --only hosting

📱 Características PWA

La aplicación es una Progressive Web App (PWA) que ofrece:

• ✅ Instalable en dispositivos móviles y escritorio
• ✅ Funciona offline
• ✅ Carga rápida con Service Worker
• ✅ Icono en pantalla de inicio
• ✅ Splash screen personalizada

Instalar como App

1. Visita el sitio web en tu navegador
2. Busca el icono de "Instalar" en la barra de direcciones
3. Haz clic en "Instalar"
4. La app aparecerá en tu pantalla de inicio

🎯 Funcionalidades Principales

1. Consulta al Oráculo

• Sistema tradicional de tres monedas
• Generación de hexagramas con líneas mutantes
• Interpretación completa (Juicio, Imagen, Líneas)
• Opción de formular pregunta personalizada
• Entrada por voz disponible

2. Biblioteca de Hexagramas

• Vista de los 64 hexagramas completos
• Búsqueda y filtrado
• Vista detallada de cada hexagrama
• Información sobre trigramas

3. Compartir Resultados

• Compartir en WhatsApp, Twitter, Facebook, Telegram
• Descargar como imagen
• Formato visual atractivo

4. Historial de Consultas

• Guarda consultas anteriores
• Acceso rápido a resultados pasados
• Almacenamiento local

🔐 Seguridad

La aplicación implementa las siguientes medidas de seguridad:

• HSTS: Strict-Transport-Security
• CSP: Content-Security-Policy
• X-Frame-Options: Protección contra clickjacking
• X-Content-Type-Options: Prevención de MIME sniffing
• Referrer-Policy: Control de información de referencia

📊 SEO y Rendimiento

• ✅ Meta tags optimizados
• ✅ Open Graph para redes sociales
• ✅ Twitter Cards
• ✅ Structured Data (Schema.org)
• ✅ Sitemap.xml
• ✅ Robots.txt
• ✅ Canonical URLs
• ✅ Lazy loading de imágenes
• ✅ Minificación de recursos

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📝 Licencia

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

👨‍💻 Autor

Jose Alvarez - Amarcord Software

• GitHub: @JoseAlvarezDev
• Email: ichinglibrodemutaciones@gmail.com

🙏 Agradecimientos

• Richard Wilhelm por su traducción del I Ching
• La comunidad de desarrolladores web
• Firebase por el hosting gratuito
• Font Awesome por los iconos
• Google Fonts por las tipografías

📚 Recursos Adicionales

• I Ching - Wikipedia
• Firebase Hosting Docs
• PWA Documentation

---

☯️ Desarrollado y Diseñado por Jose Alvarez Dev

© 2025 El Oráculo del I Ching