Skip to content

⛏️ Calculadoras de voladura y fragmentación para minería a cielo abierto. 🧮 Powder Factor (métrico/imperial), 📊 teoría de fragmentación, �� Kb, 💰 costos. ⚛️ React + ⚡ Vite + 🎨 Tailwind, 🧭 rutas con HashRouter, SPA responsiva con visualizaciones y entradas en tiempo real.

Notifications You must be signed in to change notification settings

devcast42/00018-pervo-app

Repository files navigation

⛏️ PERVO — Calculadoras de Voladura y Fragmentación (React + Vite)

Aplicación web interactiva para explorar, visualizar y calcular parámetros clave relacionados con el factor de potencia (Powder Factor), teoría de fragmentación, determinación de Kb y estimación de costos en minería a cielo abierto.


🧭 Módulos / Rutas principales

  • / — Presentación general de la aplicación.
  • /powder-factor-mether — Cálculos de Powder Factor en sistema métrico.
  • /powder-factor-imperial — Cálculos de Powder Factor en sistema imperial.
  • /determination-kb — Determinación del parámetro Kb y derivados.
  • /costs — Estimación y análisis de costos relacionados.
  • /fragment-theory — Teoría de fragmentación y visualización de resultados.

🌟 Características

  • Navegación fluida con HashRouter y rutas dedicadas.
  • Cálculos en tiempo real con entradas editables.
  • Visualizaciones y diagramas integrados con estilos CSS.
  • Diseño responsivo y moderno con Tailwind CSS.
  • Componentes reutilizables para mostrar resultados de forma clara.

🖼️ Vista previa

(Agrega aquí una imagen o GIF de la app cuando tengas una build estable)

![Demo](./src/assets/preview.png) 

🚀 Demo en Vivo

💡 Próximamente (Netlify deployment en progreso).


🛠️ Tecnologías utilizadas

  • React 18 — Biblioteca para interfaces de usuario.
  • Vite 5 — Bundler rápido para proyectos modernos.
  • Tailwind CSS — Utilidades de estilo para diseño responsivo.
  • React Router DOM 6 — Enrutamiento SPA con HashRouter.
  • ESLint — Reglas y buenas prácticas para React.

📁 Estructura general del proyecto

00018-pervo-app/ 
├── src/ 
│   ├── assets/               # Imágenes y recursos 
│   ├── components/           # Navbar y componentes de resultado 
│   │   ├── nav-bar/ 
│   │   └── result-item/ 
│   ├── pages/                # Módulos: PF métrico/imperial, Kb, costos, fragmentación 
│   │   ├── costs/ 
│   │   ├── determination-kb/ 
│   │   ├── fragment-theory/ 
│   │   ├── powder-factor-imperial/ 
│   │   ├── powder-factor-mether/ 
│   │   └── presentation/ 
│   ├── styles/               # Estilos para visualizaciones (gráficos) 
│   ├── App.jsx               # Enrutamiento principal 
│   ├── main.jsx              # Entry point 
│   └── index.css             # Tailwind y estilos base 
├── public/ 
├── package.json 
├── vite.config.js 
└── index.html 

⚙️ Instalación y uso

Requisitos: Node.js >= 18 y npm.

  1. Instalar dependencias:

    npm install 
  2. Iniciar servidor de desarrollo:

    npm run dev 

    Abre http://localhost:5173 en tu navegador.

  3. Construir para producción:

    npm run build 
  4. Previsualizar build local:

    npm run preview 
  5. Linter (opcional):

    npm run lint 

🎯 Funcionalidades clave

  • Cálculo de Powder Factor en sistemas métrico e imperial.
  • Visualización de parámetros y resultados con componentes reutilizables.
  • Determinación de Kb y variables derivadas.
  • Teoría de fragmentación con soporte de entradas dinámicas.
  • Módulo de costos para estimaciones básicas.

⚠️ Consideraciones y límites actuales

  • Los cálculos son demostrativos, basados en parámetros ingresados por el usuario.
  • No se conecta con ninguna API externa: los cálculos son locales en el navegador.

🔧 Posibles mejoras

  • Validar rangos y unidades de entrada.
  • Añadir modo oscuro.
  • Mostrar unidades y fórmulas en tooltips.
  • Exportar resultados a CSV o PDF.
  • Guardar presets con localStorage.
  • Gráficos de curvas y ángulos (Plotly/Recharts).
  • Internacionalización (ES/EN).
  • Tests unitarios.
  • Memoización para mejorar rendimiento.
  • Documentar supuestos y referencias.

💡 Aprendizajes

  • Integración de React Router con HashRouter para despliegues estáticos.
  • Optimización de cálculos en tiempo real con useState.
  • Diseño modular por rutas para escalar nuevos cálculos.
  • Mejora de la semántica visual mediante componentes reutilizables.

📄 Licencia

Actualmente sin licencia. Si deseas reutilizar, puedes aplicar la licencia MIT y añadir el archivo LICENSE.


🤝 Contribuciones

Las contribuciones son bienvenidas:

  1. Fork del repositorio.
  2. Crea una rama: git checkout -b feature/mi-mejora.
  3. Commit: git commit -m "feat: añade mejora X".
  4. Push: git push origin feature/mi-mejora.
  5. Abre un Pull Request.

👨‍💻 Autor

Charles Castillo (FROSTYLAN)


Si te resultó útil, considera dar una estrella al repositorio. 🚀 ¡Explora, visualiza y calcula con precisión parámetros de voladura y fragmentación!

About

⛏️ Calculadoras de voladura y fragmentación para minería a cielo abierto. 🧮 Powder Factor (métrico/imperial), 📊 teoría de fragmentación, �� Kb, 💰 costos. ⚛️ React + ⚡ Vite + 🎨 Tailwind, 🧭 rutas con HashRouter, SPA responsiva con visualizaciones y entradas en tiempo real.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published