Skip to content
Lincol15Public

About

Proyecto grupal de Ingeniería de Software 1

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

4bytes — Sistema de Gestión para el Acopio de Leche

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.

Problema que resuelve

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.

Público objetivo

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.

Funcionalidades previstas

  • 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.

Entidad principal del CRUD

Productor

La entidad principal del CRUD será Productor, debido a que representa a las personas que entregan leche al centro de acopio.

Atributos tentativos

  • idProductor
  • nombres
  • apellidos
  • dni
  • telefono
  • direccion
  • comunidad
  • estado

La entidad Productor estará relacionada posteriormente con las entregas y registros de recolección realizados durante el proceso de acopio.

Capacidad nativa prevista

Ubicación

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.

Equipo 4bytes

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

Tecnologías

  • 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.

Targets

  • Android
  • Desktop

iOS preparado: requiere macOS para compilar.


Estructura del proyecto

Modo sin conexión (offline-first)

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.

Cómo levantarlo

  1. 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
  2. URL de la API en local.properties de 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/
  3. App: abrir en Android Studio y ejecutar androidApp, o ./gradlew :androidApp:installDebug.
  4. 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.

Comandos útiles

# 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:iosSimulatorArm64Test

Learn more about Kotlin Multiplatform

About

Proyecto grupal de Ingeniería de Software 1

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages