Accesso e Desk
Scopo
Accedere a Ez FactoryOS, orientarsi nel Desk Frappe, usare Awesome Bar, workspace, List/Form view, filtri ed export. Prerequisito per tutte le altre guide operative.
Prerequisiti
- Utenza Frappe con uno dei ruoli: Factory Admin, Production Manager, Line Operator, Warehouse Operator (o Administrator).
- URL ambiente: locale
http://localhost:8001, staginghttps://staging-factoryos.ezbit.it, produzionehttps://factoryos.ezbit.it.
Procedura — primo accesso
- Aprire l'URL ambiente → pagina login Frappe.
- Inserire utente e password → Login.
- Se è il primo accesso locale: utente
Administrator, password =ADMIN_PASSWORDin.env. - Dopo il login si apre il Desk (
/desk). Click sull'icona app Ez FactoryOS (logo navy/lime) oppure navigare a/desk/ez-factoryos.
Lingua interfaccia
Desk → avatar utente (alto a destra) → My Settings → Language → it. Le label dei DocType Factory restano in inglese (nomi tecnici), la documentazione operativa è in italiano.
Il Desk in 5 elementi (da documentazione Frappe)
Frappe Desk è l'interfaccia admin generata dai metadati DocType (Desk).
| Elemento | Dove | Uso in FactoryOS |
|---|---|---|
| Awesome Bar | Barra ricerca in alto (Ctrl/Cmd + K) | Cercare DocType (Factory Product), aprire record, creare nuovi documenti (Awesomebar) |
| Workspace | /desk/ez-factoryos | Entity Cards, Number Card, card di navigazione (vedi Dashboard) |
| List view | Click su card o ricerca DocType | Elenco record con filtri, ordinamento, export CSV |
| Form view | Click su riga List o Nuovo | Creazione/modifica record con validazioni server |
| Ruoli e permessi | Assegnati su User | Determinano cosa si vede e cosa si può modificare (Users and Permissions) |
Ruoli FactoryOS — cosa può fare chi
Permessi definiti nei JSON DocType (permissions) + has_app_permission in ez_factoryos.ez_factoryos.api.permission.
| Ruolo | Anagrafiche / WO | Macchine lettura | Macchine comandi | Connection Profile |
|---|---|---|---|---|
| Factory Admin | Crea, modifica, elimina | Sì | Richiede + approva | Lettura + scrittura |
| Production Manager | Crea, modifica (no elimina) | Sì | Richiede + approva | Solo lettura |
| Line Operator | Solo lettura | Sì (read_machine_data) | Solo richiesta (request_machine_command) | Nessun accesso |
| Warehouse Operator | Solo lettura | Lettura anagrafica macchina | Nessuna | Nessun accesso |
| Administrator | Tutto | Tutto | Tutto | Tutto |
Verifica rapida: Awesome Bar → User → aprire il proprio utente → tab Roles.
Procedura — navigare con Awesome Bar
- Premere
Ctrl/Cmd + Koppure click sulla barra in alto. - Digitare il nome DocType: es.
Factory Work Order,Machine Event,Machine Connection Profile. - Selezionare il DocType → si apre la List view.
- Digitare invece un codice record (es.
FWO-2026-00003) → apertura diretta del Form. - Per i DocType non nel workspace (Machine Command/Event/Data Log, Connection Profile) l'Awesome Bar è l'unico accesso rapido.
Procedura — List view: filtri, ordinamento, export
La List view è generata automaticamente dal DocType (List view).
- Aprire un DocType dal workspace o da Awesome Bar.
- Filtri: click su Filtri → aggiungere condizioni (
status = In Progress,is_active = Sì,notes like %LOTTO%). I filtri standard (in_standard_filter) sono quelli suggeriti da Frappe. - Ordinamento: click sull'intestazione colonna o menu ordinamento (default Factory:
creation DESC, prima i più recenti). - Colonne: solo i campi con
in_list_view = 1nel JSON DocType sono visibili in lista. - Export CSV: menu ⋮ (alto a destra) → Export → selezionare campi → scarica CSV. Usare per audit tracciabilità/qualità/magazzino.
- Refresh dopo Entity Card: il click su un conteggio Entity Card apre la List già filtrata (es. "Senza distinta base").
Procedura — Form view: creare e modificare
Il layout del Form segue l'ordine campi del DocType (Form view).
- List view → Nuovo (alto a destra) oppure Awesome Bar →
Nuovo <DocType>. - Compilare i campi obbligatori (contrassegnati
*,reqd = 1nel JSON). - Campi Link (es.
product,customer): digitare per cercare, selezionare dalla dropdown. - Tabelle figlie (es. materie su Product): Aggiungi riga → compilare → la riga si salva col documento padre.
- Salva (o
Ctrl/Cmd + S). Le validazioni server (validatein*.py) bloccano il salvataggio con messaggio in italiano se i dati sono incoerenti. - Dopo il salvataggio il codice (es.
FWO-2026-00004) è generato dalla naming series e non è modificabile.
Track changes
Tutti i DocType Factory hanno track_changes = 1: in fondo al Form, la timeline mostra chi ha modificato cosa e quando. Utile per audit senza report dedicati.
Verifica
- [ ] Login riuscito e app Ez FactoryOS visibile tra le app.
- [ ] Workspace
/desk/ez-factoryoscon Entity Cards e 5 Number Card. - [ ] Awesome Bar trova
Factory Work OrdereMachine Event. - [ ] Export CSV da una List view scarica correttamente.
Troubleshooting
| Sintomo | Azione |
|---|---|
| App Ez FactoryOS non visibile | Verificare ruolo utente (solo i 4 ruoli Factory + Administrator hanno has_app_permission) |
| Bottone Nuovo/Salva mancante | Permesso create/write negato al ruolo — chiedere a Factory Admin |
| List vuota ma record esistenti | Rimuovere filtri attivi; verificare is_active |
| Sessione scaduta dopo inattività | Rieseguire login; in locale controllare Redis up (make logs) |
| Errore validazione in italiano al salvataggio | Leggere il messaggio (es. quantità negativa, date incoerenti) e correggere i campi |
Riferimenti
- Fondamenti Frappe — DocType, permessi, naming, API.
- Dashboard — dettaglio workspace.
- Anagrafiche — procedure per ogni DocType.
- Ordini di lavoro — ciclo WO.
- Documentazione ufficiale: Desk, List view, Form view, Users and Permissions.
