Aplicación multiplataforma para gestionar y controlar el proceso de acopio de leche desde la recolección de los productores hasta su recepción en planta.
La empresa dedicada al acopio de leche trabaja con productores de la zona y realiza actividades de recolección, traslado y recepción de la leche. Parte de esta información se registra manualmente o se encuentra dispersa, dificultando el control de los productores, las cantidades recolectadas, las rutas y las incidencias durante el proceso.
4bytes busca centralizar esta información y facilitar el seguimiento de la leche recolectada en campo hasta su llegada y recepción en la planta.
La aplicación está dirigida a empresas o centros de acopio de leche que trabajan con productores de la zona.
Los principales usuarios serán:
- Personal encargado de la recolección.
- Personal encargado de la recepción en planta.
- Administradores del centro de acopio.
- Responsables del control de calidad.
La aplicación podrá utilizarse principalmente durante las actividades de recolección en campo y recepción de la leche en planta.
- F1: Registrar, listar, editar y eliminar productores.
- F2: Registrar y consultar las entregas de leche realizadas por cada productor.
- F3: Registrar las cantidades de leche recolectadas durante cada jornada.
- F4: Registrar y consultar las rutas de recolección.
- F5: Registrar la recepción de leche en la planta.
- F6: Comparar la cantidad recolectada con la cantidad recibida en planta.
- F7: Registrar incidencias ocurridas durante la recolección o traslado.
- F8: Registrar información básica del control de calidad.
- F9: Permitir el inicio de sesión de los usuarios.
- F10: Permitir trabajar sin conexión a Internet y sincronizar la información cuando vuelva la conexión.
- F11: Consultar el historial de entregas y recolecciones.
- F12: Mostrar información básica sobre las cantidades recolectadas y recibidas.
La entidad principal del CRUD será Productor, debido a que representa a las personas que entregan leche al centro de acopio.
idProductornombresapellidosdnitelefonodireccioncomunidadestado
La entidad Productor estará relacionada posteriormente con las entregas y registros de recolección realizados durante el proceso de acopio.
La aplicación utilizará la ubicación del dispositivo para registrar o consultar la ubicación de los puntos de recolección y apoyar el seguimiento de las rutas.
Esta capacidad permitirá relacionar una recolección con su ubicación y facilitar el control de las actividades realizadas en campo.
| Integrante | Código | Rol semana 1 |
|---|---|---|
| LINCOL WERNER YUJRA CALLA | 202411737 | Coordinación |
| GUIDO DANIEL MAYTA SUAÑA | 202413212 | QA y documentación |
| RONALD CONDORI OLAZABAL | 202410814 | Lógica y datos |
| DILWER JHONATAN AGUILAR PAJA | 202414021 | UI |
- Kotlin Multiplatform
- Compose Multiplatform
- Kotlin
- Android
- Desktop
- Git
- GitHub
La aplicación será desarrollada utilizando Kotlin Multiplatform y Compose Multiplatform, de acuerdo con las tecnologías establecidas para el proyecto.
- Android
- Desktop
iOS preparado: requiere macOS para compilar.
- /androidApp — entrada de la app Android
- /shared/src/commonMain — código compartido entre plataformas
- /shared/src/androidMain — código específico Android
- /shared/src/iosMain — código específico iOS
- /shared/src/jvmMain — código JVM / Desktop (incluye Playground)
La app usa una base SQLite local (SQLDelight, archivo acopio.db) con tres tablas:
| Tabla | Para qué |
|---|---|
cache_respuesta |
Copia de cada respuesta GET de la API, por usuario. Con internet se actualiza; sin internet las pantallas la usan. |
recoleccion_pendiente |
Recolecciones registradas en el teléfono que todavía no llegan al servidor. |
sesion |
Usuario y tokens, para abrir la app sin internet aunque se reinicie el celular. |
- Registrar sin internet: la recolección se guarda en SQLite como pendiente y se ve en la lista con la etiqueta "Sin enviar".
- Al volver el internet: un sincronizador (cada 20–60 s mientras la app está abierta) sube las pendientes con su
client_uuid(Laravel no duplica si se reenvía) y la hora real de la recolección, y descarga los datos del rol para llenar la base local. - Rechazos: si el servidor rechaza una pendiente (p. ej. productor ya no asignado), queda "No sincronizado" con el motivo y botones Reintentar / Descartar.
- Tokens: el login entrega un access token (60 min) y un refresh token (30 días). Cuando el access vence, la app lo renueva sola; si el refresh vence o se revoca, vuelve al login.
El primer inicio de sesión necesita internet. Solo las recolecciones se pueden registrar sin conexión; el resto de acciones (pagos, usuarios, análisis…) requieren internet, aunque sus pantallas se pueden consultar con los datos guardados.
- Backend (carpeta
web_acopio, con MySQL de Laragon encendido):php artisan migrate # aplica las migraciones nuevas php artisan serve --host=0.0.0.0 --port=8000 - URL de la API en
local.propertiesde este proyecto (no se sube a git):# Emulador de Android: no hace falta, es el valor por defecto api.baseUrl.debug=http://10.0.2.2:8000/api/v1/ # Celular físico en la misma red WiFi: IP de tu PC (ipconfig) # api.baseUrl.debug=http://192.168.1.50:8000/api/v1/
- App: abrir en Android Studio y ejecutar
androidApp, o./gradlew :androidApp:installDebug. - Probar el modo sin conexión: iniciar sesión como acopiador (
00000003/acopiador123), activar el modo avión, registrar una recolección y volver a activar la red.
# Compilar app Android
./gradlew :androidApp:assembleDebug
# Correr Playground (JVM)
./gradlew :shared:jvmRun
# Tests
./gradlew :shared:testAndroidHostTest
./gradlew :shared:jvmTest # incluye las pruebas del modo sin conexión con SQLite
./gradlew :shared:iosSimulatorArm64TestLearn more about Kotlin Multiplatform