
Quiero crear una aplicación Web de tipo responsiva para ser usada en un navegador o en el celular.
La aplicación se utiliza para el despacho y seguimiento de [BULTOS](Bultos.md). Es utilizado por una empresa que realiza envíos entre los distintos depósitos que posee.

Debe tener la capacidad de utilizar la cámara de los dispositivos donde se utiliza para la lectura de códigos de barra

La aplicación debe incluir el armado de los distintos documentos del sistema, su seguimiento y un modulo de estadísticas para hacer el seguimiento de los envíos y el estado de cada uno de los bultos despachados.

**Stack tecnológico**
La aplicación será construida en Next.js contra una base de datos MariaDB.

---
### Configuración y Administración de la aplicación

Debemos tener una sección de:
 **alta de sucursales**, los datos de cada una son:
- Código de Sucursal
- Nombre
- Correo electrónico para enviar información relativa a los envíos a los depósitos de cada una de las sucursales

**alta de depósitos** en los que se especifica:
- código del deposito
- nombre del deposito
- sucursal a la que pertenece ( se debe seleccionar del listado de sucursales existentes)

**alta de usuarios** cuyos datos son:
- código de usuario
- nombre del usuario
- sucursal a la que pertenece ( se debe seleccionar del listado de sucursales existentes)

**permisos usuario**
Cada usuario debe tener asignada al menos una sucursal ( pueden ser varias)
Los usuarios tienen acceso a todos los depósitos de la sucursal a la que pertenecen
Cada usuario debe tener asignado un rol ( pueden ser varios)

**roles por usuario**
Los usuarios tendrán roles que les serán asignados de acuerdo a la función que desempeñen.
Los roles de usuarios estarán definidos en una pantalla de carga con los campos:
- código del rol
- detalle de los módulos a los que puede acceder. Pueden ser pantallas individuales o grupos de pantallas agrupadas en un submenú, usando los ítems del menú de la aplicación como forma de asignarlos.

> Los ítems de los menú de aplicaciones se pueden agrupar para asociarlos a un rol de manera que la asignación de un rol automáticamente habilita los ítem del menú a los que accede
> 
> Debemos generar una pantalla en la que se puedan seleccionar los usuarios y en un panel lateral seleccionar los ítems de menú a los que tendrá acceso un usuario, que podrán ser no solo los que define su perfil, sino que podrá tener además otros adicionales

---
### Definición de los documentos del sistema
El elemento base de trabajo del sistema son los [BULTOS](Bultos.md), cada bulto tendrá su origen al momento de ser escaneado dentro de un documento del sistema.
### - [**Orden de Preparación**](OP%20-%20OrdenDePreparacion.md)
Los bultos pueden ser agregados o eliminados de la orden de preparación mientras que la misma se encuentre en el estado de armado.
### - [**Hojas de ruta**](HR%20-%20HojasDeRuta.md)
La creación de una hoja de ruta se lleva a cabo con una patalla que contiene un calendario en donde se selecciona la fecha y se establece el deposito de origen de la hoja de ruta - coincide con la sucursal del usario x defecto, pero se puede cambiar.
Este comprobante contiene todos los bultos que son despachados en un mismo camión.
Las HR pueden llegar en forma desordenada o incompleta al depósito de destino, esto es porque pueden ser consolidadas o divididas por la empresa de transporte.

Las HR no pueden ser modificadas una vez que pasaron al estado *despachada*

**modificacion de una hoja de ruta**
Las HR SI pueden ser modificadas luego de estar en el estado *cerrada*, para ello primero deberá cambiarse su estado a *preparación*, esto lo hace un usuario con rol de *supervisor*.
- Para **agregar** bultos de una HR: Solo si está en el estado *preparación*, mediante el agregado de una OP, no pueden ser bultos suetos.
- Para **sacar** bultos de una HR: Solo si está en estado *preparación*, se hace sacando una OP de la HR y asignando la OP a otra HR en estado *preparación*
### - [**Despacho**](DS%20-%20Despacho.md)
El despacho se puede generar cuando una HR está en el estado *carga* .
Este comprobante contiene los datos del remito de mercadería que se genera para enviar junto con la HR. Es necesario para presentar en los controles de la ruta.
 Una HR no puede pasar al estado de *despachada*, sino no existe el DS correspondiente
### - [**Recepción**](RC%20-%20Recepcion.md)
La recepción es un comprobante que se genera al momento de recibir los bultos en el depósito de destino, esto lo hace un usuario con rol de *recepción*.
Este comprobante sirve para poder hacer el rastreo de los bultos recibidos en el depósito de destino.
Deberá hacer el control de que todos los bultos recibidos estén destinados al deposito del usuario, en caso de no ser el caso, deberá quedar registrado en las observaciones del comprobante

#### Estados de los comprobantes - orden de secuencia
La mayoría de los comprobantes que existen en el sistema tiene un estado que varía entre distintos valores.
Los comprobantes cambian de un estado a otro siguiendo la secuencia de los estados. Esta secuencia está dada por el primer dígito del nombre del estado. 
La numeración es independiente para cada tipo de documento y por regla general no deberían cambiar a un estado anterior.

Por ejemplo: si una HR está en el estado 2- Preparación, el próximo estado será 3 - Cerrada, luego 4 - Carga, etc.

Para facilitar esto, el sistema deberá utilizar una lista desplegable que contenga el estado anterior y el próximo de un comprobante, debe "sugerir" - poniendo como seleccionado - el próximo estado al que debería pasar el comprobante que está siendo editado, pero no debería permitir que se salten estados de esa secuencia. 
En caso que el usuario opte por seleccionar el estado anterior, se informará de la situación, pidiendo que lo confirme y en caso de ser afirmativo, presentará una caja de dialogo para que ingrese el motivo de esta acción. Esa campo debe ser obligatorio.

---
### Secuencia de Procesos del Sistema
#### 1. Creación de HR - Hojas de Ruta
   *rol de usuario*: Supervisor
   Se crean las HR de acuerdo a la fecha que será despachada, el depósito de destino, y el horario - mañana o tarde.
   Es posible que se generen más de una HR para una fecha y horario determinado.
   En caso que una HR no sea utilizada - como el caso de la cancelación de la carga - la misma pasa al estado *cancelada*. Puede ser que lo haga un usuario o de forma automática al día siguiente. En todos los casos la HR debe estar vacía para ser *cancela*
#### 2. Creación de OP - Ordenes de Preparación
   *rol de usuario*: Supervisor
   Se crean las OP para que se procesen los bultos de mercadería de un determinado proveedor.
   Se consigna además al cantidad de bultos que conforman el pedido.
   Es posible asignar la OP a una hoja de ruta en la que será enviada o dejarla sin asignar a una HR concreta. 
   El usuario asignado es opcional y por defecto se deja vació para que pueda ser tomado por cualquier usuario de rol *preparación*
#### 3. Armado de una OP
   *rol de usuario*: Preparación
   El usuario accede a una pantalla en la que visualiza las OP de las cuales es el *usuario asignado* o dicha propiedad está vacía
   El primer paso es cambiar el estado de la OP a *preparación*, de manera de indicar que ya hay alguien trabajando el ella.
   Usando el scanner o la cámara del dispositivo utilizado se deberán escanear los códigos de bulto - EAN13 - para incluirlos en la OP.
   Luego de terminar la carga de los bultos el usuario cambiará el estado de la OP a *terminada*
#### 4. Carga de una HR
   *rol de usuario*: Supervisor
   Una HR está formada por el listado de las OP que están incluidas en ella.
   Por lo general las HR tendrán determinada cantidad de OP pre - asignadas al momento de la creación de las OP, o agregarle OP que no están asignadas a una HR.
   Es posible modificar la inclusión de una OP para pasarla a una HR diferente, para ello la HR de origen no podrá estar en un estado superior al de *preparación*. 
#### 5. Despacho de una HR
   *rol de usuario*: Despacho
   Cuando se va a despachar una HR, se la selecciona para hacer el control de los bultos que la componen.
   Se escanea cada uno de los bultos para validar que sea uno incluído en la HR y se cambia el estado del bulto a *despachado*.
   En caso que se escanee un bulto que no corresponde deberá informar de la novedad e impedir el cambio de estado del bulto.
   Una vez que todos los bultos de la HR se hayan escaneado, será posible crear el DS ingresando los datos de la matricula del camión y generar el remito de carga que consignará los remitos que lo componen y el valor declarado. Esta información la carga el usuario.
   La impresión del remito se hace en un formulario pre-impreso. El prefijo y numero son datos que se ingresan.
   Luego de que todos los bultos están en estado *despachado* y creado el remito se podrá cambiar el estado de la HR a *despachada* 
#### 6. Recepción de HR
   *rol de usuario*: Recepción
   Se crea un documento RC en el cual se incluirán todos los bultos que se escanean con la cámara del dispositivo usado o un scanner.
   La aplicación deberá validar que el bulto ingresado esté destinado al deposito al que está asignado el operador y cambiar su estado a *recepcionado*.
   En caso que se detecte que el bulto no pertenece a ese depósito la aplicación deberá informar al usuario y consignar el nro. de bulto en las observaciones de la RC.
   Si un bulto llegara abierto, el estado del bulto pasará a *abierto* y se consignará en el campo observaciones de la RC.
   De la misma manera si el bulto llegara dañado o mojado, el estado del bulto pasará a *dañado* y también se consignará el el campo de observaciones.

---
#### Paneles de seguimiento

- Estado de HR y OP 
  Muestra los comprobantes: 
  OP generados en la sucursal del usuario.
  HR generadas en la sucursal y las que tienen la sucursal del usuario como destino con estado *despachada* en adelante, excepto las de estado *cancelada*
  Acceso: roles de Despacho, Recepción y Supervisor
  Filtros: por tipo, deposito de origen y estado de los comprobantes

- Detalle de las RC 
  Muestra los comprobantes: 
  RC originadas en la sucursal, y el detalle de los comprobantes HR asociados a estos y los bultos que los componen
  Acceso: roles de Recepción y Supervisor
  Filtros: por tipo, deposito de origen y estado de los comprobantes

- Detalle de los DS 
  Muestra los comprobantes: 
  DS originadas en la sucursal, y el detalle de los comprobantes HR asociados a estos y los bultos que los componen
  Acceso: roles de Despacho y Supervisor
  Filtros: por tipo, deposito de origen y estado de los comprobantes

- Detalle de Bultos Abiertos o Dañados
  Muestra el detalle de los bultos  en estado *abierto*, *dañado* y los datos de la HR a la que pertenecen
  Acceso: roles de Supervisor
  Filtros: RC, deposito de origen y HR 

Para todos los paneles se deben aplicar los filtros por la sucursal y el depósito a los que pertenece el usuario.
La excepción son los usuarios con rol de supervisor de la sucursal 10, los cuales pueden ver TODOS los comprobantes sin limitación de sucursal.
