Softbee es una solución integral diseñada para el control y monitoreo avanzado de apiarios y colmenas. Desarrollada con los más altos estándares de ingeniería en Flutter, la aplicación permite a los apicultores gestionar su producción, salud de las colmenas y realizar un seguimiento detallado del entorno de manera eficiente y escalable.
Actualmente, el proyecto se encuentra en la Fase de Desarrollo de Funcionalidades Core. Se ha implementado la base arquitectónica y los módulos fundamentales:
- Arquitectura Base: Estructura de Clean Architecture establecida.
- Core System: Gestión de red (Dio), Rutas (GoRouter) y Tematización.
- Módulo de Autenticación: Integración con seguridad local y almacenamiento persistente.
- Gestión de Apiarios: Visualización y lógica de dominio básica.
- UI/UX Premium: Implementación de animaciones (Lottie) y carga interactiva.
El proyecto sigue los principios de Clean Architecture, separando las responsabilidades en capas para garantizar un código testeable, mantenible y desacoplado:
- Data: Repositorios físicos, fuentes de datos (locales/remotas) y modelos (Mappers).
- Domain: La "verdad" del negocio. Contiene Entidades puras, Casos de Uso (Usecases) y definiciones de Repositorios (Interfaces).
- Presentation: Lógica de UI, Widgets, y gestión de estado.
- Core: Utilidades transversales, manejo de errores, temas y configuración global.
| Herramienta | Propósito |
|---|---|
| Flutter/Dart | Framework de desarrollo UI y lenguaje base. |
| Riverpod | Gestión de estado reactivo y Inyección de Dependencias. |
| GoRouter | Navegación declarativa y manejo de rutas profundas. |
| Dio | Cliente HTTP avanzado para peticiones API. |
| Lottie | Animaciones vectoriales interactivas (JSON). |
| Shared Preferences / Secure Storage | Persistencia de datos local y almacenamiento sensible. |
| Local Auth | Autenticación biométrica (Huella/Rostro). |
| Equatable / Either Dart | Programación funcional y comparaciones de objetos. |
lib/
├── core/ # Configuración global, temas, rutas y servicios compartidos.
│ ├── error/ # Definición de fallos y excepciones.
│ ├── network/ # Cliente Dio y configuración de red.
│ ├── router/ # AppRouter y definiciones de rutas.
│ └── theme/ # Colores, fuentes y estilos de la app.
├── feature/ # Módulos basados en funcionalidades (Screaming Architecture).
│ ├── apiaries/ # Dominio, Datos y Presentación de Apiarios.
│ ├── auth/ # Lógica de ingreso y seguridad.
│ ├── beehive/ # Gestión individual de colmenas.
│ └── monitoring/ # Visualización de datos y sensores.
└── main.dart # Punto de entrada de la aplicación.
Sigue estos pasos para ejecutar el proyecto en tu entorno local:
-
Clonar el repositorio:
git clone https://github.com/SoffiaSanchezz/Softbee-App.git cd Softbee -
Configurar variables de entorno: Crea un archivo
.envbasado en.env.exampley añade tus credenciales/API keys. -
Instalar dependencias:
flutter pub get
-
Generar código automático (si aplica):
dart run build_runner build --delete-conflicting-outputs
-
Ejecutar la aplicación:
flutter run
La aplicación utiliza una paleta de colores inspirada en la naturaleza y la apicultura profesional, con componentes personalizados como el Honeycomb Loader para una experiencia de usuario inmersiva.
- Tipografía: Google Fonts (Roboto/Oswald).
- Animaciones:
lottie,flutter_animate.
La documentación oficial de Softbee explica la arquitectura, módulos y funcionamiento interno de la aplicación. Está diseñada para desarrolladores que deseen entender, mantener o contribuir al proyecto.
| Sección | Descripción |
|---|---|
| 🚀 Introduction | Visión general del proyecto |
| 🏗 Architecture | Explicación de Clean Architecture |
| 🧩 Features | Módulos principales del sistema |
| 🔌 API Integration | Manejo de servicios HTTP |
| 🛠 Development Guide | Cómo ejecutar y contribuir |
Desarrollado con ❤️ para la comunidad apícola.