Skip to content

Architettura — Overview ​

Scopo ​

Descrivere lo stack, i confini dell'app ez_factoryos e i principi di integrazione di Ez FactoryOS (MES semplificato per Ortobellina / OP Raggio di Sole, lavorazione insalate IV gamma).

Stack ​

LayerTecnologiaNote
FrameworkFrappe v16App custom, senza ERPNext
BackendPython 3.14DocType, API whitelist, RQ
FrontendFrappe Desk (JS)Workspace Ez FactoryOS
DatabaseMariaDB 11.8Persistenza DocType
Cache / queueRedis 8.8Cache + RQ
Gateway OTNode-RED + MosquittoRete Docker privata
Dev / deployDocker Compose + CoolifyVPS Netcup
CI/CDGitHub Actions → GHCRPromozione digest staging→main
DocsVitePressdocs.factoryos.ezbit.it

Diagramma di contesto ​

mermaid
flowchart TB
  subgraph client [Client]
    Desk[Frappe Desk]
    API[REST / RPC]
  end
  subgraph app [App ez_factoryos]
    DocTypes[DocTypes]
    NodeAPI[integrations/node_red]
    Hooks[hooks / patches]
  end
  subgraph infra [Runtime]
    MariaDB[(MariaDB)]
    Redis[(Redis)]
  end
  subgraph ot [OT privata]
    NR[Node-RED]
    MQTT[Mosquitto]
    Machines[Macchine / PLC]
  end
  Desk --> DocTypes
  API --> DocTypes
  Desk --> NodeAPI
  NodeAPI --> NR
  NR --> MQTT
  NR --> Machines
  DocTypes --> MariaDB
  Hooks --> Redis

Principi ​

PrincipioImplicazione
App autonomaSolo ez_factoryos; no ERPNext
ParametricoConfig via DocType/env, no hardcoded di produzione
OT disaccoppiatoNessun client Modbus/OPC UA in Frappe; solo HTTP verso Node-RED
Audit comandiOgni comando macchina passa da Machine Command + log
Ambienti isolatiDB, Redis, volumi, domini e token per dev / staging / main
Secret fuori repoSolo .env, Coolify, GitHub Environments

Ambienti e domini ​

AmbienteBranchDominio
Locale—http://localhost:8001 (factory.local)
Stagingstaginghttps://staging-factoryos.ezbit.it
Productionmainhttps://factoryos.ezbit.it
Docspath docs/https://docs.factoryos.ezbit.it
Pannello controldev (servizio ez-factoryos-control)https://control.factoryos.ezbit.it

Moduli presenti nel codice ​

AreaContenuto
Anagrafiche + Workspace + Number CardCustomer, Supplier, Product + distinta (materie/packaging/etichette), Category, Label, Raw Material, Packaging, Line + macchine, Machine, Operator, Shift
Factory Work OrderOrdine di lavoro con cliente, prodotto, linea, quantità, stato manuale, campo external_id (Business Cube ID) compilabile a mano
Macchine + Node-REDFactory Machine, Machine Connection Profile, Machine Command con approvazione, Machine Event, Machine Data Log; adapter MQTT/Modbus/OPC UA sul gateway
Dashboard workspaceEntity Cards (get_entity_cards), 5 Number Card, 4 card di navigazione

Tracciabilità lotti, controlli qualità formalizzati e giacenze di magazzino si gestiscono oggi con gli strumenti esistenti: distinta base su Factory Product, note su Work Order, Machine Event / Machine Data Log, filtri ed export CSV delle List View. Vedi le guide in Uso operativo.

Riferimenti ​

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