Architettura - Overview

Stack

Layer	Tecnologia
Framework	Frappe v16
Backend	Python 3.14
Frontend	Frappe Desk (JS)
Database	MariaDB 11.8
Cache/Queue	Redis 8.8
Dev/Deploy	Docker Compose
CI/CD	GitHub Actions
VCS	Git (dev/staging/main)

Diagramma

flowchart TB
  subgraph client [Client Layer]
    Desk[Frappe Desk]
    API[REST API]
  end
  subgraph app [Ez FactoryOS App]
    DocTypes[DocTypes]
    Hooks[Hooks/Jobs]
    Reports[Reports]
  end
  subgraph infra [Infrastructure]
    MariaDB[(MariaDB)]
    Redis[(Redis)]
  end
  subgraph future [Integrazioni Future]
    BC[Business Cube]
    NR[Node-RED]
    Machines[Macchine 4.0]
  end
  Desk --> DocTypes
  API --> DocTypes
  DocTypes --> MariaDB
  Hooks --> Redis
  API --> BC
  NR --> API
  Machines --> NR

Principi

• App custom autonoma (ez_factoryos), no ERPNext
• Configurazione parametrica via UI (no hardcoded)
• Integrazioni disaccoppiate via API/webhook
• Ogni evento macchina loggato (Fase 3+)
• Audit trail su modifiche produttive