Mappa Componenti e Dipendenze

Vista d’insieme di tutti i componenti del sistema MonosTech — Ultimo aggiornamento: 24/03/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"]
        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 -->|Bot API| TELE
    NOCODB -->|PostgreSQL| SUPA
    TRAEFIK -->|Proxy| N8N
    TRAEFIK -->|Proxy| NOCODB
    TRAEFIK -->|Proxy| DOCS
    TSDIG -.->|Fatture XML| 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	~46 totali, ~25 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.

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)

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	Fatture XML	On demand	REST HTTPS
NocoDB	Supabase	Query/modifiche	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: 24/03/2026