Mappa Componenti e Dipendenze

Vista d’insieme di tutti i componenti del sistema MonosTech — Ultimo aggiornamento: 19/08/2026

1. Architettura Componenti

graph TD
    subgraph FORNITORI["Fornitori FTP/CSV"]
        IMA["IMA"]
        FOC["Focelda"]
        TDS["TD Synnex"]
        XPR["Xpress"]
        ESP["Esprinet"]
    end

    subgraph VPS["VPS Hostinger"]
        N8N["n8n\nAutomazioni"]
        NOCODB["NocoDB\nInterfaccia DB"]
        DOCS["Docs\nnginx:alpine"]
        TRAEFIK["Traefik\nReverse Proxy + SSL"]
    end

    subgraph CLOUD["Servizi Cloud"]
        SUPA[("Supabase\nPostgreSQL")]
        SHOPIFY["Shopify\nStore"]
        KEEPA["Keepa API\nPrezzi Amazon"]
        SPAPI["Amazon SP-API\nOrdini, catalogo, fee"]
        BCE["BCE\nFeed tassi di cambio"]
        TELE["Telegram Bot\nAlert"]
        TSDIG["TS Digital\nFatturazione"]
    end

    FORNITORI -->|CSV via FTP| N8N
    N8N -->|SQL import/query| SUPA
    N8N -->|GraphQL API| SHOPIFY
    N8N -->|REST API| KEEPA
    N8N -->|REST API OAuth| SPAPI
    N8N -->|REST API| BCE
    N8N -->|Bot API| TELE
    NOCODB -->|PostgreSQL| SUPA
    TRAEFIK -->|Proxy| N8N
    TRAEFIK -->|Proxy| NOCODB
    TRAEFIK -->|Proxy| DOCS
    TSDIG -.->|Fatture XML giornaliere| N8N
    DOCS -->|Webhook Tool Ordini Amazon| N8N

2. Dettaglio Componenti

Supabase (Database PostgreSQL)

URL	supabase.com/dashboard
Regione	EU West (Ireland)
Dimensione DB	~346 MB
Connection pooling	PgBouncer (transaction mode)
Tabelle principali	`prodotti` (398K), `prodotti_shopify` (47.7K MV)
Backup	Automatico (Supabase)
Dipende da	— (componente centrale)
Chi dipende	n8n, NocoDB, Shopify sync

Limiti noti REFRESH MATERIALIZED VIEW non supporta CONCURRENTLY con PgBouncer transaction pooler. Connection limit: 60 dirette, illimitate via pooler.

n8n (Automazione)

URL	n8n.srv1203683.hstgr.cloud
Hosting	Docker su VPS Hostinger
DB interno	PostgreSQL 16 (container locale)
Workflow	68 totali, 44 attivi — cartella “Viviana Pardo”
Backup	Sync automatica in `workflows/` (Git)
Dipende da	Supabase, FTP fornitori, Shopify API, Keepa API, Telegram API

Credenziali configurate: 4 FTP (fornitori), 1 PostgreSQL (Supabase), 1 Supabase API, 1 Telegram Bot, 1 SMTP. Shopify: token gestito via workflow dedicato.

NocoDB (Interfaccia Database)

URL	nocodb.srv1203683.hstgr.cloud
Hosting	Docker su VPS Hostinger (stesso server di n8n)
Uso	Consultazione e modifica dati via interfaccia tabellare
Dipende da	Supabase (connessione PostgreSQL diretta)

Shopify (E-commerce)

Store	0zzi2q-mt.myshopify.com (MonosTech)
API	GraphQL Admin API 2025-10
Autenticazione	Client Credentials Grant (token 24h)
Scope attivi	`read_products`, `write_products`, `read_orders`
Prodotti	~47.700 — 9 collezioni
Stato	Pre-lancio (password-protected)

Limiti noti Token scade ogni 24h (workflow automatico di rinnovo). Rate limit API: 50 punti/secondo. productSet richiede productOptions. Dev Dashboard su dev.shopify.com (NON partners.shopify.com).

Keepa (Prezzi Amazon)

Endpoint	`GET https://api.keepa.com/product`
Piano	€49/mese
Rate limit	20 token/min, max 28.800 prodotti/giorno
Dominio	8 (Italia)
Formato prezzi	Centesimi di euro

Limiti noti Rifiuta intero batch se un EAN non è numerico. Può restituire più ASIN per stesso EAN (deduplicazione necessaria). Parametri history=0 e offers=0 causano errore.

Amazon SP-API (Ordini, catalogo, commissioni)

Auth	App privata self-authorized, token in cache (`amazon_spapi_token`), rinnovo automatico
Cosa usa	Reports API (All Orders Report), Catalog Items (risoluzione ASIN), Orders API (`getOrders`, promise date), Product Fees API (commissione reale)
Workflow	`ZyM50qRv5BD3vb35` Ottieni Token · `giqf40VGF1weKj50` Scarica Report Ordini · risoluzione catalogo/promise/fee dentro `EYb73mtnwJihyPgM` Amazon Ordini - Analizza

Limiti noti Ogni fase ha un interruttore dedicato in tool_amazon_soglie, regolabile da NocoDB senza deploy. Rate limit reale getMyFeesEstimateForASIN 1 rps; searchCatalogItems paginato a 10 item anche chiedendone 20. Dettagli in docs/architecture/tool-raccomandatore-amazon.md.

Tassi di cambio BCE

Fonte	Feed ufficiale Banca Centrale Europea, 29 valute
Workflow	`Tl0H891mq6CpGjUe` Tassi Cambio - Aggiorna da BCE, ogni notte all’01:00
Tabella	`tassi_cambio`
Usato da	Tool Ordini Amazon, per convertire gli ordini in valuta estera

Nessun ripiego cablato Se il workflow si ferma oltre tassi_cambio_stantio_giorni, il tool non converte le righe estere: le porta in verifica, per non calcolare un margine su un cambio vecchio. Il workflow stesso invia una mail d’errore.

Telegram Bot (Alert)

Bot	@monostestacv_bot
Credenziale n8n	“Telegram Shopify”
Uso	Report pricing, alert anti-errore, notifiche peak mode

TS Digital Invoice (Fatturazione)

Servizio	TeamSystem TS Digital
Codice SDI	M5UXCR1
P.IVA	05159410876
API	B2BRead / B2BWrite
Token	Non scade (finché chiave non modificata)
Uso automatico	Import fatture di acquisto → carico del ledger magazzino (giornaliero 06:00) e fatture di vendita → scarico (giornaliero 06:15)

Tool Ordini Amazon (pagina web)

URL	docs.srv1203683.hstgr.cloud/ordini-amazon.html
Backend	Webhook n8n — workflow “Amazon Ordini - Analizza” (analisi) e “Amazon Ordini - Salva Scelta” (scelte manuali motivate)
Uso	Analisi All Orders Report: per ogni riga tutte le opzioni fonte merce (fornitori, conto deposito, sede Monos) × modalità spedizione, con profitto e margine netti IVA, prezzo effettivo (listino con eco-contributi / promozione valida / prezzo BID), freschezza dei dati e scelta manuale registrata
Configurazione	Da NocoDB: `regole_fonte_spedizione` (combinazioni, accessori, lead time), `fornitori_spedizione` (tariffe), `tool_amazon_soglie` (soglie freschezza e interruttori SP-API: `spapi_import_report`, `spapi_catalog_risoluzione`, `spapi_promise_date`), `tool_amazon_scelte` (storico scelte), `prezzi_bid` (prezzi riservati: TD Synnex importati dal file ShipAndDebit, inserimento manuale per gli altri fornitori)
Dipende da	n8n, Supabase, Amazon SP-API (scarico report, catalogo, promise date, commissioni), Keepa (ripiego risoluzione ASIN), feed BCE (tassi di cambio)
Guida operativa	Guida completa all’interfaccia · Runbook §4 (procedura rapida)

VPS Hostinger

Host	srv1203683.hstgr.cloud
Accesso	SSH (root)
Servizi	n8n, NocoDB, Docs, Traefik, PostgreSQL (locale n8n)
Docker	4 container (traefik, postgres:16, n8n, nginx:alpine)
SSL	Let’s Encrypt via Traefik (rinnovo automatico)
Directory	`/docker/n8n/`

3. Flusso Dati tra Componenti

Da	A	Tipo di dato	Frequenza	Protocollo
Fornitori (FTP)	n8n	CSV listini prodotti	Giornaliero	FTP/SFTP
n8n	Supabase	Dati prodotti (UPSERT)	Dopo ogni import	PostgreSQL
Supabase	n8n	Dati per pricing/sync	2x/giorno	PostgreSQL
n8n	Shopify	Prodotti, prezzi, stock	2x/giorno	GraphQL HTTPS
n8n	Keepa	Richiesta prezzi Amazon	Ogni 5 min, 100 EAN	REST HTTPS
Keepa	n8n → Supabase	Prezzi Amazon	Ogni 5 min	REST HTTPS
n8n	Telegram	Alert e report	Dopo ogni pricing	Bot API HTTPS
TS Digital	n8n → Supabase	Fatture di acquisto → carico ledger magazzino	Giornaliero (06:00)	REST HTTPS
TS Digital	n8n → Supabase	Fatture di vendita → scarico ledger magazzino (abbinamento prodotto + coda di revisione)	Giornaliero (06:15)	REST HTTPS
Esprinet API	n8n → Supabase	Giacenze conto deposito	Ogni 6h	REST HTTPS
Esprinet API	n8n → Supabase	Spedizioni dal deposito (DDT) → quadratura valorizzazione	Giornaliero (06:30)	REST HTTPS
Tool Ordini Amazon (browser)	n8n → Supabase	Report ordini → analisi opzioni fonte/spedizione	On demand	Webhook HTTPS
NocoDB	Supabase	Query/modifiche (tariffe, regole, commissioni, valorizzazione)	On demand	PostgreSQL

4. Dipendenze Critiche

Se Supabase va giù

Tutto il sistema si ferma (import, pricing, sync Shopify). Lo store Shopify continua a funzionare con i dati dell’ultimo sync. Recovery: attendere ripristino, poi rieseguire pricing + sync.

Se n8n va giù

Nessun import, nessun pricing, nessun sync. I dati in Supabase e Shopify restano invariati. Recovery: riavviare container Docker sulla VPS (docker compose restart).

Se Shopify va giù

Store non raggiungibile, sync fallisce. Il sistema continua a funzionare (import, pricing), i dati si accumulano. La prossima sync allinea tutto.

Se Keepa va giù / quota esaurita

Prezzi Amazon non aggiornati. Il pricing funziona ugualmente, usa gli ultimi prezzi disponibili. Recovery automatico al ripristino.

Se un FTP fornitore va giù

Dati di quel fornitore non aggiornati. Il pricing usa i dati dell’ultimo import riuscito. Recovery automatico al prossimo import schedulato.

5. Riepilogo Costi Servizi

Servizio	Costo	Note
Supabase	Free / $25/mese (Pro)	Dipende dal piano scelto
Keepa	€49/mese	20 token/min
VPS Hostinger	~€10/mese	n8n + NocoDB
Shopify	Piano merchant	Costo standard Shopify
TS Digital	Incluso nel contratto TeamSystem	—
Telegram	Gratuito	Bot API
GitHub	Gratuito	Repository privato

MonosTech — Mappa Componenti e Dipendenze — Ultimo aggiornamento: 19/08/2026