⚡ Electrics-App: El Gemelo Digital en tu bolsillo

Cálculo, diseño y normativa unificado bajo el REBT.
"Deja el Excel para la oficina. Lleva la ingeniería al campo de trabajo."

Electrics-App no es solo una calculadora eléctrica. Es un Gemelo Digital diseñado para ingenieros e instaladores que necesitan precisión técnica y validación normativa (REBT/RAT) en tiempo real, sin necesidad de un ordenador.

🛠️ ¿Por qué Electrics-App?

Como ingenieros, nos enfrentamos a un mar de normativas y cálculos complejos en entornos donde no puedes abrir un portátil. El flujo de trabajo actual está roto:

1. Tomas datos en papel o móvil.
2. Llegas a casa cansado tras la jornada de campo.
3. Pasas horas en Excel legalizando y presupuestando.

Electrics-App rompe este ciclo. Diseña, mide y presupuesta in situ. Para que cuando llegues a casa, tu único trabajo sea descansar.

📱 Tour Visual por la App

Aquí puedes ver el flujo de trabajo real de un ingeniero usando Electrics-App:

Diagrama Unifilar	Sistema de Salud
Organiza tus obras	Diagnóstico en tiempo real

Biblioteca	Mediciones de Campo
Componentes inteligentes	Ingresa resultados

✨ Funcionalidades Estrella

🧬 Motor de Física Avanzado

Cálculos precisos de caída de tensión, intensidades de cortocircuito y suma vectorial de impedancias. Un núcleo robusto que entiende la física real detrás de los cables.

A diferencia de otras aplicaciones, Electrics-App no es una "caja negra". El motor de cálculo ha sido programado siguiendo estrictamente el compendio de normas técnicas vigentes en España y Europa, las cuales puedes consultar directamente en la carpeta /normas del repositorio.

📚 Normativas Integradas

• Cálculo de Caída de Tensión e Intensidades Admisibles: Basado en la UNE-HD 60364-5-52:2014.
• Cálculo de Corrientes de Cortocircuito: Implementación de la norma IEC 60909-0:2016.
• Protecciones y Curvas de Disparo: Siguiendo la IEC 60898-1 para interruptores magnetotérmicos.
• Reglamento Nacional: Cumplimiento íntegro del REBT (RD 842/2002) y sus Guías Técnicas de Aplicación.

💻 Implementación en Código

Si eres ingeniero o desarrollador, puedes auditar nuestra lógica en:

• electrical_math.dart: Fórmulas base de suma vectorial de impedancias y potencias.
• rebt_rules.dart: Mapeo de las restricciones legales del Reglamento Electrotécnico.
• iz_constants.dart: Tablas de intensidades máximas según el método de instalación y tipo de aislamiento.
• trip_curve_calculator.dart: Motor de renderizado y cálculo de tiempos de disparo para curvas B, C y D.

🏥 Sistema de Diagnóstico (Health Check)

Introduce las mediciones reales de tus herramientas y la app las comparará con el modelo teórico. ¿Desviación excesiva? La app te avisa antes de que sea un problema.

🤖 Base de Datos impulsada por IA

Añadir componentes nunca fue tan fácil. Gracias a nuestra integración con IA, puedes solicitar nuevos componentes electricos de la biblioteca directamente desde GitHub Issues.

• ¿Necesitas un magnetotérmico específico? Abre un Issue con: [COMPONENT REQUEST] M9U11206 Schneider Electric o [COMPONENT REQUEST] Diferencial bipolar 40A R9 2P SCHNEIDER ELECTRIC y la IA se encargará de mapear sus características técnicas a la app. En la próxima actualización estará disponible para su uso. También existen ya componente sgenerales o puedes crear tus propios componentes.

📄 Presupuestos al Instante (En desarrollo)

Genera reportes y presupuestos listos para imprimir y entregar al cliente antes de salir de la instalación.

🚀 Cómo empezar

El proyecto está diseñado para no requerir conexión y no requiere configuración de servidores externos. Simplemente, descárgate la última actualización

Pre Release v1.0.0

🌐 Live Demo & Documentation

Puedes explorar el catálogo de componentes y la documentación técnica del código en los siguientes enlaces:

Recuerda hecharle un vistazo a la Wiki!

🤝 Buscamos Talento (Contribuir)

Este proyecto es público porque la ingeniería eléctrica merece herramientas modernas. Buscamos dos perfiles:

1. Ingenieros Eléctricos: Ayúdanos a verificar los algoritmos de cálculo, añadir lógica de normativas internacionales y testear el motor físico.
2. Desarrolladores Flutter: Mejora de la UI/UX, optimización de base de datos local (Isar) y pulido de animaciones.

Consulta nuestra Wiki para entender la arquitectura del motor físico.

🤖 Automatización y DevOps

Contamos con un flujo de trabajo moderno:

• AI Code Review: Revisión automática de Pull Requests.
• Automated Releases: Cada mejora llega a tus manos sin esperas.
• AI Component Agent: Generación automática de plantillas de componentes mediante procesamiento de lenguaje natural.
• Documentation Automation: Dartdoc y Storybook se actualizan automáticamente en cada push.

📚 Documentación

API Documentation (Dartdoc)

Documentación técnica completa generada automáticamente con Dartdoc, organizada por capas de Clean Architecture (Core, Domain, Data, Presentation).

Component Library (Storybook)

Explora y prueba componentes UI de forma aislada. Útil para desarrolladores y diseñadores que quieran entender el Design System.

Ejecutar localmente:

# Storybook
flutter run -d chrome -t storybook/main.dart

# Dartdoc
dart doc . && start doc/api/index.html

Consulta DOCUMENTATION.md para más detalles.

📊 Project Analytics

⭐ Star History

--

Hecho con ❤️ por ingenieros, para ingenieros.

© 2025 Ruben Ortiz, Electrics App Team