Skip to content

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, staging https://staging-factoryos.ezbit.it, produzione https://factoryos.ezbit.it.

Procedura — primo accesso ​

  1. Aprire l'URL ambiente → pagina login Frappe.
  2. Inserire utente e password → Login.
  3. Se è il primo accesso locale: utente Administrator, password = ADMIN_PASSWORD in .env.
  4. 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).

ElementoDoveUso in FactoryOS
Awesome BarBarra ricerca in alto (Ctrl/Cmd + K)Cercare DocType (Factory Product), aprire record, creare nuovi documenti (Awesomebar)
Workspace/desk/ez-factoryosEntity Cards, Number Card, card di navigazione (vedi Dashboard)
List viewClick su card o ricerca DocTypeElenco record con filtri, ordinamento, export CSV
Form viewClick su riga List o NuovoCreazione/modifica record con validazioni server
Ruoli e permessiAssegnati su UserDeterminano 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.

RuoloAnagrafiche / WOMacchine letturaMacchine comandiConnection Profile
Factory AdminCrea, modifica, eliminaSìRichiede + approvaLettura + scrittura
Production ManagerCrea, modifica (no elimina)SìRichiede + approvaSolo lettura
Line OperatorSolo letturaSì (read_machine_data)Solo richiesta (request_machine_command)Nessun accesso
Warehouse OperatorSolo letturaLettura anagrafica macchinaNessunaNessun accesso
AdministratorTuttoTuttoTuttoTutto

Verifica rapida: Awesome Bar → User → aprire il proprio utente → tab Roles.

Procedura — navigare con Awesome Bar ​

  1. Premere Ctrl/Cmd + K oppure click sulla barra in alto.
  2. Digitare il nome DocType: es. Factory Work Order, Machine Event, Machine Connection Profile.
  3. Selezionare il DocType → si apre la List view.
  4. Digitare invece un codice record (es. FWO-2026-00003) → apertura diretta del Form.
  5. 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).

  1. Aprire un DocType dal workspace o da Awesome Bar.
  2. 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.
  3. Ordinamento: click sull'intestazione colonna o menu ordinamento (default Factory: creation DESC, prima i più recenti).
  4. Colonne: solo i campi con in_list_view = 1 nel JSON DocType sono visibili in lista.
  5. Export CSV: menu ⋮ (alto a destra) → Export → selezionare campi → scarica CSV. Usare per audit tracciabilità/qualità/magazzino.
  6. 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).

  1. List view → Nuovo (alto a destra) oppure Awesome Bar → Nuovo <DocType>.
  2. Compilare i campi obbligatori (contrassegnati *, reqd = 1 nel JSON).
  3. Campi Link (es. product, customer): digitare per cercare, selezionare dalla dropdown.
  4. Tabelle figlie (es. materie su Product): Aggiungi riga → compilare → la riga si salva col documento padre.
  5. Salva (o Ctrl/Cmd + S). Le validazioni server (validate in *.py) bloccano il salvataggio con messaggio in italiano se i dati sono incoerenti.
  6. 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-factoryos con Entity Cards e 5 Number Card.
  • [ ] Awesome Bar trova Factory Work Order e Machine Event.
  • [ ] Export CSV da una List view scarica correttamente.

Troubleshooting ​

SintomoAzione
App Ez FactoryOS non visibileVerificare ruolo utente (solo i 4 ruoli Factory + Administrator hanno has_app_permission)
Bottone Nuovo/Salva mancantePermesso create/write negato al ruolo — chiedere a Factory Admin
List vuota ma record esistentiRimuovere filtri attivi; verificare is_active
Sessione scaduta dopo inattivitàRieseguire login; in locale controllare Redis up (make logs)
Errore validazione in italiano al salvataggioLeggere il messaggio (es. quantità negativa, date incoerenti) e correggere i campi

Riferimenti ​

Ez FactoryOS — MES per Ortobellina / OP Raggio di Sole · App Frappe v16 ez_factoryos