# 1. MyToDo

**Table of Content**

- [1. MyToDo](#1-mytodo)
- [2. Progetto generale pagina MyToDo](#2-progetto-generale-pagina-mytodo)
- [3. Utilizzo della pagina](#3-utilizzo-della-pagina)
  - [3.1 Assegnazione ruoli](#31-assegnazione-ruoli)
  - [3.2 Creazione lista (Contenitore task)](#32-creazione-lista-contenitore-task)
  - [3.3 Creazione task](#33-creazione-task)
  - [4. Document revision](#4-document-revision)




# 2. Progetto generale pagina MyToDo

La pagina MyToDo all'interno del progetto MAPO-MONO permetterà di avere un sistema di schede per inserire dei promemoria basati a tempo e che abbiano uno schema colori basato sulla scadenza o sullo stato.

# 3. Utilizzo della pagina 

## 3.1 Assegnazione ruoli
Il SuperAdmin dovrà assegnare l'amministratore dell'azienda che potrà a sua volta gestire gli utenti interni all'azienda di cui fa parte

**Tabella dei ruoli**
| Ruolo | Livello |Permessi |
|---|---|---|
| Utente azienda | 0 |Possono vedere solo le proprie attività (o crearne una per se) e segnarle come fatte
| Admin azienda | 1 | Può creare, modificare ed eliminare i tasks per se o per gli utenti azienda, e gestire gli utenti interni (Creare modificare o eliminare un utente).
| Superadmin | 2 | Può visualizzare tutti i dati degli utenti e delle varie aziende.


E' prevista la possibilità **per tutti** di: 
- Creare un task.
- Assegnare ALTRI UTENTI ad un task (1/+), nessun limite (di conseguenza modifiche punti seguenti)
- Modificare un task .
- Eliminare un task  .
- Dichiarare un task concluso.
- Assegnare 1/+ etichette ai task.
- Archiviare un task.
- Copiare un task.

OGNI UTENTE PUO' OPERARE SU OGNI TASK (non c'è limite in base a chi crea/chi modifica)

L'eliminazione del task sarà sempre una cancellazione logica per evitare cancellazioni errate se lo stato è successivo a quello iniziale (creato).



**Ipotesi**: L'utente può richiedere di ricevere notifiche sul task selezionato (Mail o altro...) 

## 3.2 Creazione lista (Contenitore task)
Per creare una lista è necessario assegnare un titolo.

Si possono aggiungere collaboratori direttamente alla lista così da poter condividere automaticamente tutti i task presenti nel contenitore.

## 3.3 Creazione task

Per ogni task vanno definiti: 
 - Titolo
 - Data e ora di inizio
 - Data e ora di scadenza
 - Descrizione del task
 - Etichetta (che può magari indicare l'area di produzione che riguarda il task o il nome del cliente ecc..)

Inoltre si potranno aggiungere collaboratori al task oppure assegnare un task ad un dipendente.

Un task può essere nei seguenti stati:
- Creato
- Avviato
- In esecuzione
- Completato

Inoltre in merito all'indicazione della "coordinata tempoarel", il task può essere nei seguenti stati
- Due in "xxx" (in scadenza in x mesi/settimane/giorni/ore...)
- Prossimo alla scadenza (< soglia minima, tipicamente 3 gg)
- Scaduto (e da quanto)

E' utile anche un indicazione con icona del fatto che il task abbia 1 o + assegnatari: 1 -> icona singolo user, tanti --> icona multi utente


In caso di scadenza superata verrà indicato sul task.

Ogni task può avere delle "sotto attività" che permettono di suddividere il lavoro in maniera più organizzata.

---

**Esempio**

MainTask: Effettuare l'inventario del magazzino.

SottoTask1: Sistemare tutti gli scatoloni in ordine di grandezza.

SottoTask2: Preparare tutti gli scanner per i barcode.

SottoTask3: Scansionare tutti i barcode.

---

E' possibile spostare i vari task nelle liste liberamente.

I colori utilizzati per gli stati dei task saranno:

- ![#3498DB](https://placehold.co/15x15/3498DB/3498DB.png) `Creato`
- ![#3949AB](https://placehold.co/15x15/3949AB/3949AB.png) `Avviato`
- ![#8E24AA](https://placehold.co/15x15/8E24AA/8E24AA.png) `In Esecuzione`
- ![#2ECC71](https://placehold.co/15x15/2ECC71/2ECC71.png) `Completato`


Inoltre si possono avere colori x la "prossimità a scedenza" temporale
- (verde) `Scadenza tra xxxx`
- ![#F1C40F](https://placehold.co/15x15/F1C40F/F1C40F.png) `Prossimo alla scadenza`
- ![#C0392B](https://placehold.co/15x15/C0392B/C0392B.png) `Scaduto`

## 4. Document revision
 
| Date       | Edit           | Version |             Note |
|------------|----------------|:-------:|-----------------:|
| 2023.06.22 | S.E. Locatelli | 0.2 | Modifica stato calcolato a tempo vs stati, riduzione differenza "per se/eper altri"|
| 2023.06.22 | Z. Majid |   0.1   | Prima versione|