Skip to content

Latest commit

 

History

37 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧮 Calculadora BaZi (八字)

Herramienta web para calcular los Cuatro Pilares del Destino (BaZi), también conocidos como 八字. Este sistema de astrología china tradicional se basa en la fecha y hora de nacimiento para revelar patrones energéticos que influyen en el destino de una persona.


📌 ¿Qué hace esta calculadora?

La aplicación toma una fecha de nacimiento como entrada y calcula los pilares:

  • Año
  • Mes
  • Día
  • Hora

Cada pilar se compone de:

  • Un tronco celeste (天干)
  • Una rama terrestre (地支)

🖼️ Captura de pantalla

Captura de pantalla

(Puedes reemplazar el enlace con una imagen real si la subes a GitHub o a un servicio como Imgur)


🚀 Prueba la demo en línea

👉 https://pepegamboa.github.io/Calculadora-BaZi/


🛠️ Tecnologías utilizadas

  • HTML5
  • CSS3
  • JavaScript (vanilla)

🌟 Calculadora BaZi - Los Cuatro Pilares del Destino

BaZi Logo Demo GitHub Pages

Herramienta web interactiva para calcular los Cuatro Pilares del Destino (BaZi 八字) basada en astrología china tradicional


📋 Tabla de Contenidos

  1. ¿Qué es BaZi?
  2. Características Principales
  3. Demo en Vivo
  4. Conceptos Fundamentales
  5. Cómo Usar la Calculadora
  6. Interpretación de Resultados
  7. Tecnologías Utilizadas
  8. Instalación Local
  9. Estructura del Proyecto
  10. Contribuir
  11. Ejemplos de Uso
  12. FAQ
  13. Licencia

🔮 ¿Qué es BaZi?

BaZi (八字), también conocido como "Los Cuatro Pilares del Destino" o "Four Pillars of Destiny", es un sistema milenario de astrología china que analiza el destino y la personalidad de una persona basándose en su fecha y hora exacta de nacimiento.

🏛️ Historia y Origen

El sistema BaZi tiene más de 1,000 años de antigüedad y se basa en:

  • Calendario Chino Tradicional (Ganzhi 干支)
  • Teoría de los Cinco Elementos (Wu Xing 五行)
  • Filosofía Yin-Yang (阴阳)
  • 10 Troncos Celestiales (天干)
  • 12 Ramas Terrestres (地支)

✨ Características Principales

🎯 Cálculo Preciso: Conversión exacta del calendario gregoriano al chino
🌏 Soporte Global: Compatible con cualquier zona horaria mundial
📱 Responsive: Funciona perfectamente en móviles, tablets y desktop
🎨 Interfaz Intuitiva: Diseño limpio y fácil de usar
Tiempo Real: Cálculos instantáneos sin recargar página
🔢 Completo: Muestra todos los elementos de los cuatro pilares
🎭 Visual: Representación gráfica de elementos y animales


🚀 Demo en Vivo

📅 Ejemplo de Uso:
Fecha: 15 de marzo de 1990
Hora: 14:30
Resultado: Pilares completos con elementos y análisis

📚 Conceptos Fundamentales

🏗️ Los Cuatro Pilares

Los Cuatro Pilares representan diferentes aspectos de la vida:

┌─────────────┬─────────────┬─────────────┬─────────────┐
│    AÑO      │     MES     │     DÍA     │    HORA     │
├─────────────┼─────────────┼─────────────┼─────────────┤
│ Ancestros   │   Padres    │  Persona    │   Hijos     │
│ Juventud    │   Adulto    │ Matrimonio  │  Vejez      │
│ (0-16 años) │ (17-32)     │ (33-48)     │ (49-64)     │
└─────────────┴─────────────┴─────────────┴─────────────┘

🌸 Troncos Celestiales (天干)

Los 10 Troncos Celestiales representan la energía Yang (visible):

Tronco Carácter Elemento Polaridad Significado
Jiǎ Madera Yang Árbol robusto
Madera Yin Hierba flexible
Bǐng Fuego Yang Sol brillante
Dīng Fuego Yin Vela suave
Tierra Yang Montaña sólida
Tierra Yin Campo fértil
Gēng Metal Yang Espada afilada
Xīn Metal Yin Joya preciosa
Rén Agua Yang Océano profundo
Guǐ Agua Yin Rocío matutino

🐲 Ramas Terrestres (地支)

Las 12 Ramas Terrestres representan la energía Yin (oculta) y corresponden a los animales del zodíaco:

Rama Animal Elemento Mes Hora Estación
Rata Agua Dic 23:00-01:00 Invierno
Buey Tierra Ene 01:00-03:00 Invierno
Tigre Madera Feb 03:00-05:00 Primavera
Conejo Madera Mar 05:00-07:00 Primavera
Dragón Tierra Abr 07:00-09:00 Primavera
Serpiente Fuego May 09:00-11:00 Verano
Caballo Fuego Jun 11:00-13:00 Verano
Cabra Tierra Jul 13:00-15:00 Verano
Mono Metal Ago 15:00-17:00 Otoño
Gallo Metal Sep 17:00-19:00 Otoño
Perro Tierra Oct 19:00-21:00 Otoño
Cerdo Agua Nov 21:00-23:00 Invierno

🌊 Los Cinco Elementos (五行)

        🔥 FUEGO
         ↙  ↘
    🌳 MADERA → 🌍 TIERRA
         ↗      ↘
       💧 AGUA ← ⚪ METAL

Ciclo Generativo (生):

  • Madera alimenta al Fuego 🌳 → 🔥
  • Fuego crea Tierra (cenizas) 🔥 → 🌍
  • Tierra contiene Metal 🌍 → ⚪
  • Metal condensa Agua ⚪ → 💧
  • Agua nutre Madera 💧 → 🌳

Ciclo Destructivo (克):

  • Madera agota Tierra 🌳 ⚔️ 🌍
  • Tierra absorbe Agua 🌍 ⚔️ 💧
  • Agua apaga Fuego 💧 ⚔️ 🔥
  • Fuego derrite Metal 🔥 ⚔️ ⚪
  • Metal corta Madera ⚪ ⚔️ 🌳

🎯 Cómo Usar la Calculadora

Paso 1: Ingresar Datos

┌─────────────────────────────────────┐
│  📅 Fecha de Nacimiento             │
│  ┌─────┐ ┌─────┐ ┌──────────┐       │
│  │ DD  │ │ MM  │ │   YYYY   │       │
│  └─────┘ └─────┘ └──────────┘       │
│                                     │
│  🕐 Hora de Nacimiento              │
│  ┌─────┐ : ┌─────┐                  │
│  │ HH  │   │ MM  │                  │
│  └─────┘   └─────┘                  │
│                                     │
│  🌍 Zona Horaria                    │
│  ┌─────────────────────────────────┐ │
│  │ UTC-5 (Bogotá, Lima, Quito)    │ │
│  └─────────────────────────────────┘ │
└─────────────────────────────────────┘

Paso 2: Calcular

Haz clic en "Calcular BaZi" y obtén tus cuatro pilares instantáneamente.

Paso 3: Interpretar

La calculadora mostrará:

  • Troncos Celestiales de cada pilar
  • Ramas Terrestres con sus animales
  • Elementos dominantes
  • Balance energético

📊 Interpretación de Resultados

Ejemplo de Carta BaZi

        AÑO    MES    DÍA    HORA
       ┌────┐ ┌────┐ ┌────┐ ┌────┐
Tronco │ 庚 │ │ 戊 │ │ 乙 │ │ 丁 │
       │Metal│ │Tierra│ │Madera│ │Fuego│
       └────┘ └────┘ └────┘ └────┘
       ┌────┐ ┌────┐ ┌────┐ ┌────┐
Rama   │ 午 │ │ 寅 │ │ 未 │ │ 亥 │
       │Caballo│ │Tigre│ │Cabra│ │Cerdo│
       │Fuego│ │Madera│ │Tierra│ │Agua│
       └────┘ └────┘ └────┘ └────┘

🎭 Significados por Pilar

🏛️ Pilar del Año (Ancestros/Juventud):

  • Influencia familiar y ancestral
  • Primeros años de vida (0-16)
  • Recursos heredados

👨‍👩‍👧‍👦 Pilar del Mes (Padres/Adulto Joven):

  • Relación con padres
  • Carrera y profesión
  • Años adultos tempranos (17-32)

💝 Pilar del Día (Yo/Matrimonio):

  • EL MÁS IMPORTANTE - Representa tu esencia
  • Personalidad nuclear
  • Relaciones matrimoniales (33-48)

👶 Pilar de la Hora (Hijos/Vejez):

  • Relación con hijos y descendientes
  • Años maduros (49-64)
  • Logros a largo plazo

💻 Tecnologías Utilizadas

Frontend

  • HTML5 HTML5 - Estructura semántica
  • CSS3 CSS3 - Estilos responsivos y animaciones
  • JavaScript JavaScript Vanilla - Lógica de cálculo

Características Técnicas

  • Responsive Design - Compatible con todos los dispositivos
  • PWA Ready - Funciona offline
  • SEO Optimizado - Metadatos completos
  • Accesibilidad - WCAG 2.1 compliant
  • Performance - Carga rápida, menos de 2MB

Algoritmos Implementados

// Ejemplo de conversión calendario
function solarToLunar(solarDate) {
    // Algoritmo de conversión Gregoriano → Chino
    // Considera años bisiestos, ajustes de zona horaria
    // Retorna { year, month, day, hour } en formato Ganzhi
}

function calculatePillars(birthData) {
    // Calcula los 4 pilares basado en fecha/hora
    // Aplica correcciones de zona horaria
    // Retorna objeto con troncos y ramas
}

🔧 Instalación Local

Prerrequisitos

  • Navegador web moderno (Chrome 90+, Firefox 88+, Safari 14+)
  • Servidor local (opcional para desarrollo)

Instalación Rápida

# 1. Clonar el repositorio
git clone https://github.com/PepeGamboa/Calculadora-BaZi.git

# 2. Navegar al directorio
cd Calculadora-BaZi

# 3. Cambiar a la rama main2
git checkout main2

# 4. Abrir con servidor local (opcional)
# Opción A: Python
python -m http.server 8000

# Opción B: Node.js
npx serve .

# Opción C: PHP
php -S localhost:8000

# 5. Abrir en navegador
# http://localhost:8000

Instalación con GitHub Pages

# 1. Fork el repositorio
# 2. Ir a Settings → Pages
# 3. Seleccionar rama main2
# 4. Tu calculadora estará en: https://tu-usuario.github.io/Calculadora-BaZi/

📁 Estructura del Proyecto

Calculadora-BaZi/
├── 📄 index.html              # Página principal
├── 📁 css/
│   ├── 🎨 styles.css          # Estilos principales
│   ├── 📱 responsive.css      # Diseño responsivo
│   └── 🌙 dark-theme.css      # Tema oscuro (opcional)
├── 📁 js/
│   ├── ⚙️ calculator.js       # Lógica principal BaZi
│   ├── 🗓️ calendar.js         # Conversiones de calendario
│   ├── 🌊 elements.js         # Lógica de 5 elementos
│   └── 🎭 zodiac.js           # Animales zodiacales
├── 📁 assets/
│   ├── 🖼️ images/
│   │   ├── animals/           # Imágenes de animales zodiacales
│   │   ├── elements/          # Iconos de elementos
│   │   └── backgrounds/       # Fondos decorativos
│   └── 🎵 sounds/             # Sonidos de interfaz (opcional)
├── 📁 data/
│   ├── 📊 ganzhi.json         # Datos de troncos y ramas
│   ├── 🌐 timezones.json      # Zonas horarias mundiales
│   └── 🈸 translations.json   # Traducciones multiidioma
├── 📋 README.md               # Este archivo
├── ⚖️ LICENSE                 # Licencia del proyecto
└── 📋 CHANGELOG.md            # Registro de cambios

🔑 Archivos Principales

📄 index.html - Interfaz de usuario principal

<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="UTF-8">
    <title>Calculadora BaZi - Cuatro Pilares del Destino</title>
    <!-- Meta tags SEO y responsive -->
</head>
<body>
    <!-- Formulario de entrada -->
    <!-- Área de resultados -->
    <!-- Scripts -->
</body>
</html>

⚙️ js/calculator.js - Motor de cálculo

class BaZiCalculator {
    constructor() {
        this.heavenlyStems = [...];
        this.earthlyBranches = [...];
        this.elements = [...];
    }
    
    calculate(birthDate, birthTime, timezone) {
        // Lógica principal de cálculo
    }
}

🤝 Contribuir

¡Las contribuciones son bienvenidas! Sigue estos pasos:

🎯 Cómo Contribuir

  1. Fork el repositorio
  2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)
  3. Commit tus cambios (git commit -m 'Añadir nueva funcionalidad')
  4. Push a la rama (git push origin feature/nueva-funcionalidad)
  5. Abre un Pull Request

🛠️ Áreas de Mejora

  • Traducciones: Añadir más idiomas (inglés, francés, japonés)
  • Interpretaciones: Ampliar análisis automático de cartas
  • Diseño: Mejorar UX/UI con animaciones
  • Features: Añadir compatibilidad de parejas
  • Performance: Optimizar algoritmos de cálculo
  • Testing: Añadir pruebas unitarias
  • PWA: Implementar funcionalidad offline completa

📋 Guías de Contribución

🎨 Estilo de Código:

  • Usar ES6+ moderno
  • Comentarios en español
  • 2 espacios para indentación
  • Nombres de variables descriptivos

🧪 Testing:

# Ejecutar tests (cuando estén implementados)
npm test

# Validar HTML
html-validate index.html

# Linting CSS
stylelint css/*.css

💡 Ejemplos de Uso

Ejemplo 1: Persona Famosa

👤 Ejemplo: Steve Jobs
📅 Fecha: 24 de febrero de 1955
🕐 Hora: 19:15
🌍 Lugar: San Francisco, CA, USA

Resultado:
┌─────────────────────────────────────┐
│  AÑO    MES     DÍA     HORA        │
├─────┬───────┬───────┬───────────────┤
│ 乙  │  戊   │  庚   │    乙         │
│Madera│Tierra │ Metal │  Madera       │
├─────┼───────┼───────┼───────────────┤
│ 未  │  寅   │  戌   │    酉         │
│Cabra │ Tigre │ Perro │   Gallo       │
│Tierra│Madera │Tierra │   Metal       │
└─────┴───────┴───────┴───────────────┘

Análisis: Fuerte elemento Metal en el día,
balance con Madera. Personalidad innovadora
y determinada. ¡Coincide con su perfil!

Ejemplo 2: Análisis de Elementos

👤 Ejemplo: Persona X
📅 Fecha: 15 de marzo de 1990
🕐 Hora: 14:30

Balance de Elementos:
🌳 Madera: ████████░░ (40%)
🔥 Fuego:  ██████░░░░ (30%)
🌍 Tierra: ████░░░░░░ (20%)
⚪ Metal:  ██░░░░░░░░ (10%)
💧 Agua:   ░░░░░░░░░░ (0%)

Recomendaciones:
• Fortalecer elemento Agua 💧
• Evitar exceso de Madera 🌳
• Usar colores azules/negros

Ejemplo 3: Compatibilidad de Pareja

👫 Análisis de Pareja
Persona A: Dragón de Tierra (戊辰)
Persona B: Mono de Metal (庚申)

Compatibilidad: ⭐⭐⭐⭐☆ (80%)
✅ Elementos complementarios (Tierra → Metal)
✅ Animales compatibles (Dragón + Mono)
⚠️ Posible dominancia de Metal sobre Tierra

❓ Preguntas Frecuentes

🤔 Preguntas Generales

¿Qué tan preciso es BaZi? BaZi es un sistema interpretativo basado en patrones energéticos tradicionales chinos. Su "precisión" depende de la interpretación y no debe considerarse predicción absoluta.

¿Necesito la hora exacta de nacimiento? Sí, la hora es crucial. Una diferencia de 2 horas puede cambiar completamente el pilar de la hora. Si no la conoces, usa el horario aproximado.

¿Funciona para cualquier nacionalidad? Sí, BaZi se basa en fenómenos astronómicos universales (posición del sol, luna, planetas) que afectan a todos independientemente del origen.

🛠️ Preguntas Técnicas

¿Por qué usar calendario chino en vez del occidental? El calendario chino (Ganzhi) está sincronizado con ciclos naturales y energéticos que el calendario gregoriano no considera.

¿Cómo maneja las zonas horarias? La calculadora convierte automáticamente la hora local a tiempo solar real, considerando la longitud geográfica específica.

¿Qué pasa con el horario de verano? El algoritmo ajusta automáticamente los cambios de horario según la fecha y ubicación.

🌐 Uso de la Calculadora

¿Guarda mis datos personales? No. Todo el procesamiento es local en tu navegador. No enviamos ni almacenamos información personal.

¿Funciona sin internet? La calculadora básica sí, pero algunas features avanzadas requieren conexión.

¿Es gratis para siempre? Sí, es completamente gratuita y de código abierto.


📈 Roadmap

🎯 Versión 2.0 (Próximamente)

  • 🌍 Multiidioma: Inglés, francés, japonés
  • 🎨 Temas: Modo oscuro, colores personalizables
  • 📊 Gráficos: Visualización avanzada de elementos
  • 🔮 AI Interpretación: Análisis automático con IA

🎯 Versión 2.5

  • 👥 Compatibilidad: Análisis de relaciones
  • 📅 Calendario: Días favorables/desfavorables
  • 🏆 Logros: Sistema de gamificación
  • 📱 App Móvil: Versión nativa iOS/Android

🎯 Versión 3.0

  • 🌟 Premium Features: Interpretaciones detalladas
  • 🎓 Cursos: Tutorial interactivo de BaZi
  • 👨‍⚕️ Consultas: Conexión con expertos
  • 🔗 API: Servicios para desarrolladores

🌟 Reconocimientos

📚 Fuentes de Conocimiento

  • Maestros de BaZi: Tradición milenaria china
  • Textos Clásicos: 滴天髓 (Di Tian Sui), 子平真诠 (Zi Ping Zhen Quan)
  • Comunidad: Foros y grupos de metafísica china

🛠️ Herramientas y Recursos

  • Algoritmos: Basados en cálculos astronómicos precisos
  • Diseño: Inspirado en estética tradicional china
  • Testing: Validado con casos históricos conocidos

🤝 Contribuidores

  • @PepeGamboa - Desarrollador principal
  • Comunidad GitHub - Issues y sugerencias
  • Beta Testers - Usuarios que probaron versiones tempranas

📞 Contacto y Soporte

🐛 Reportar Bugs

¿Encontraste un error? Crea un issue con:

  • Descripción del problema
  • Pasos para reproducir
  • Navegador y versión
  • Capturas de pantalla

💡 Sugerir Features

¿Tienes una idea genial? Abre una solicitud de feature

📧 Contacto Directo


⚖️ Licencia

Este proyecto está bajo la MIT License - ve el archivo LICENSE para detalles.

MIT License

Copyright (c) 2024 PepeGamboa

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...

🔒 Uso Comercial

Permitido: Uso comercial, modificación, distribución
Requerido: Incluir licencia y copyright
Prohibido: Responsabilizar al autor por daños


🎉 Agradecimientos Especiales

"El conocimiento es como el agua: toma la forma del recipiente que lo contiene, pero siempre busca su nivel más bajo para nutrir la tierra."
— Proverbio Chino

Gracias a todos los que han contribuido a preservar y compartir la sabiduría ancestral del BaZi. Esta calculadora es una humilde herramienta para acercar este conocimiento milenario a las nuevas generaciones.


🌟 ¡Dale una estrella si te gusta el proyecto! ⭐

GitHub stars GitHub forks

⬆️ Volver al inicio


Desarrollado con ❤️ por PepeGamboa
Preservando la sabiduría ancestral china para el mundo moderno

About

This repository houses a BaZi (Four Pillars of Destiny) calculator, allowing users to input their birthdate and time to generate insights into their destiny based on the principles of Chinese metaphysics. The calculator determines the Chinese zodiac sign, the associated element, and more.

Topics

Resources

Stars

7 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages