Resolve merge conflicts: README + ignore IDE files

This commit is contained in:
David
2026-05-23 07:11:33 -06:00
parent abfbb255fe
commit 6ff72c738d
27 changed files with 2123 additions and 335 deletions

View File

@@ -5,19 +5,73 @@ Una aplicacion para saber si el camion mas sercano es Organico o inorganico junt
=======
# flutter_application_1
A new Flutter project.
Aplicación móvil desarrollada en Flutter como una preview funcional para consulta de rutas de camiones, validación de usuarios y simulación de información local. El proyecto fue construido para mostrar una experiencia completa de usuario sin depender todavía de una base de datos real en producción.
## Getting Started
## Resumen del proyecto
This project is a starting point for a Flutter application.
La app ofrece un flujo completo de inicio de sesión, registro, captura de dirección y acceso a un tablero principal con mapa, calendario, avisos y guía de rutas. La información que se muestra no depende de un backend activo en el frontend: se trabajó con archivos JSON locales como fuente de datos principal para simular usuarios, rutas, eventos y configuraciones.
A few resources to get you started if this is your first Flutter project:
## Qué resuelve
- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
- Inicio de sesión y registro con validación local.
- Captura de dirección del usuario para personalizar la experiencia.
- Visualización de rutas de recolección con información resumida y detalle por ruta.
- Calendario con eventos importantes y notas locales.
- Mapa orientado a la zona del usuario, con comportamiento adaptado por orientación de pantalla.
- Base de datos simulada con JSON para demostrar el flujo completo sin depender de infraestructura externa.
<<<<<<< HEAD
For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
>>>>>>> 8e51b9c (initial commit 2)
=======
## Por qué se puede vender como preview
Esta versión ya permite explicar la idea de negocio al usuario final o a un cliente potencial porque presenta una experiencia realista y navegable. Aunque aún faltan ajustes de producto y una capa de datos más robusta, la aplicación ya comunica claramente el valor principal: ayudar a visualizar rutas, horarios y eventos de recolección desde una interfaz móvil práctica.
La propuesta se puede presentar como una preview comercial porque:
- demuestra el flujo principal de usuario de punta a punta;
- usa datos locales para simular operación real;
- ya integra pantallas funcionales y una navegación completa;
- deja abierta la migración a una base de datos más fluida y escalable.
## Pruebas y validación
Durante el desarrollo se realizaron pruebas con JSON locales en `assets/json/` para simular la base de datos y validar la estructura de la app. Esto permitió probar login, registro, direcciones, rutas, calendario y guía de rutas sin depender de servicios externos.
La idea de base de datos se mantiene pensada de forma más fluida para una siguiente etapa, donde los JSON pueden ser reemplazados por una fuente centralizada, sincronizada y más dinámica.
## Tecnologías usadas
- Flutter / Dart
- `flutter_map`
- `geolocator`
- `latlong2`
- `table_calendar`
- `shared_preferences`
## Estructura funcional
- `lib/screens/auth_screen.dart`: login y registro.
- `lib/screens/address_screen.dart`: captura de dirección local.
- `lib/screens/dashboard_screen.dart`: mapa, calendario, avisos y guía de rutas.
- `lib/services/local_seed_repository.dart`: carga de los JSON locales.
- `assets/json/`: datos de prueba que actúan como preview de base de datos.
## Estado actual
El proyecto ya funciona como una demo presentable y estable para mostrar la propuesta. Aun así, se considera una base en evolución: el siguiente paso natural es conectar una base de datos más flexible, reemplazar la simulación local por datos vivos y pulir algunos detalles de UX.
## Cómo ejecutar
```bash
flutter pub get
flutter run
```
## Nota final
Este proyecto no pretende ser todavía el producto final, sino una preview sólida que demuestra la idea, la navegación y el valor de la solución. Es útil para presentaciones, validación temprana con usuarios y como base para una futura versión con backend y almacenamiento centralizado.
>>>>>>> c9e584a (Proyecto Flutter inicial)