Mappa Componenti e Dipendenze

Vista d’insieme di tutti i componenti del sistema MonosTech — Ultimo aggiornamento: 12/10/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)

URLsupabase.com/dashboard
RegioneEU West (Ireland)
Dimensione DB~346 MB
Connection poolingPgBouncer (transaction mode)
Tabelle principaliprodotti (398K), prodotti_shopify (47.7K MV)
BackupAutomatico (Supabase)
Dipende da— (componente centrale)
Chi dipenden8n, NocoDB, Shopify sync
Limiti noti REFRESH MATERIALIZED VIEW non supporta CONCURRENTLY con PgBouncer transaction pooler. Connection limit: 60 dirette, illimitate via pooler.

n8n (Automazione)

URLn8n.srv1203683.hstgr.cloud
HostingDocker su VPS Hostinger
DB internoPostgreSQL 16 (container locale)
Workflow68 totali, 44 attivi — cartella “Viviana Pardo”
BackupSync automatica in workflows/ (Git)
Dipende daSupabase, 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)

URLnocodb.srv1203683.hstgr.cloud
HostingDocker su VPS Hostinger (stesso server di n8n)
UsoConsultazione e modifica dati via interfaccia tabellare
Dipende daSupabase (connessione PostgreSQL diretta)

Shopify (E-commerce)

Store0zzi2q-mt.myshopify.com (MonosTech)
APIGraphQL Admin API 2025-10
AutenticazioneClient Credentials Grant (token 24h)
Scope attiviread_products, write_products, read_orders
Prodotti~47.700 — 9 collezioni
StatoPre-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)

EndpointGET https://api.keepa.com/product
Piano€49/mese
Rate limit60 token/min, riserva massima 3.600 token; ogni EAN richiesto costa circa 2 token
Dominio8 (Italia)
Formato prezziCentesimi 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)

AuthApp privata self-authorized, token in cache (amazon_spapi_token), rinnovo automatico
Cosa usaReports API (All Orders Report, offerte attive, settlement), Catalog Items (risoluzione ASIN), Orders API (getOrders, promise date), Product Fees API (commissione reale)
WorkflowZyM50qRv5BD3vb35 Ottieni Token · giqf40VGF1weKj50 Scarica Report Ordini · risoluzione catalogo/promise/fee dentro EYb73mtnwJihyPgM Amazon Ordini - Analizza · xOl2i2xmTde6bn4i archivio ordini per il magazzino (ogni notte alle 05:00) · sAR2NhyeX0stueA5 / 5vQk9CjBqBdhlsBC monitor offerte in perdita (02:30 e 14:30) · J4GMYfNhrqpsebhU archivio settlement (lunedì 06:00)
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

FonteFeed ufficiale Banca Centrale Europea, 29 valute
WorkflowTl0H891mq6CpGjUe Tassi Cambio - Aggiorna da BCE, ogni notte all’01:00
Tabellatassi_cambio
Usato daTool 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”
UsoSolo avvisi urgenti: oggi il monitor delle offerte Amazon in perdita, inviato a ogni riga di avvisi_destinatari con un chat ID Telegram. Report e avvisi non urgenti vanno per email

TS Digital Invoice (Fatturazione)

ServizioTeamSystem TS Digital
Codice SDIM5UXCR1
P.IVA05159410876
APIB2BRead / B2BWrite
TokenNon scade (finché chiave non modificata)
Uso automaticoImport fatture di acquisto → carico del ledger magazzino (giornaliero 06:00) e fatture di vendita → scarico (giornaliero 06:15)

Tool Ordini Amazon (pagina web)

URLdocs.srv1203683.hstgr.cloud/ordini-amazon.html
BackendWebhook n8n — workflow “Amazon Ordini - Analizza” (analisi) e “Amazon Ordini - Salva Scelta” (scelte manuali motivate)
UsoAnalisi 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
ConfigurazioneDa 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 dan8n, Supabase, Amazon SP-API (scarico report, catalogo, promise date, commissioni), Keepa (ripiego risoluzione ASIN), feed BCE (tassi di cambio)
Guida operativaGuida completa all’interfaccia · Runbook §4 (procedura rapida)

VPS Hostinger

Hostsrv1203683.hstgr.cloud
AccessoSSH (root)
Servizin8n, NocoDB, Docs, Traefik, PostgreSQL (locale n8n)
Docker4 container (traefik, postgres:16, n8n, nginx:alpine)
SSLLet’s Encrypt via Traefik (rinnovo automatico)
Directory/docker/n8n/

3. Flusso Dati tra Componenti

DaATipo di datoFrequenzaProtocollo
Fornitori (FTP)n8nCSV listini prodotti, un fornitore dopo l’altro (orchestratore)Ogni 12h (00:00 e 12:00)FTP/SFTP
n8nSupabaseDati prodotti (UPSERT)Dopo ogni importPostgreSQL
Supabasen8nDati per pricing/sync2x/giornoPostgreSQL
n8nShopifyProdotti, prezzi, stock2x/giornoGraphQL HTTPS
n8nKeepaRichiesta prezzi AmazonOgni 4 min, 100 EANREST HTTPS
Keepan8n → SupabasePrezzi AmazonOgni 4 minREST HTTPS
Amazon SP-APIn8n → SupabaseArchivio ordini → vendite Amazon abbinate dall’ordine nel magazzinoGiornaliero (05:00)REST HTTPS
Amazon SP-APIn8n → SupabaseOfferte attive → margine e monitor offerte in perdita02:30 e 14:30REST HTTPS
Amazon SP-APIn8n → SupabaseSettlement report → rendiconto reale delle commissioniSettimanale (lunedì 06:00)REST HTTPS
n8nTelegramAvviso offerte Amazon in perditaDopo ogni giro del monitor (02:30 e 14:30)Bot API HTTPS
TS Digitaln8n → SupabaseFatture di acquisto → carico ledger magazzinoGiornaliero (06:00)REST HTTPS
TS Digitaln8n → SupabaseFatture di vendita → scarico ledger magazzino (abbinamento prodotto + coda di revisione)Giornaliero (06:15)REST HTTPS
Esprinet APIn8n → SupabaseGiacenze conto depositoOgni 6hREST HTTPS
Esprinet APIn8n → SupabaseSpedizioni dal deposito (DDT) → quadratura valorizzazioneGiornaliero (06:30)REST HTTPS
Tool Ordini Amazon (browser)n8n → SupabaseReport ordini → analisi opzioni fonte/spedizioneOn demandWebhook HTTPS
NocoDBSupabaseQuery/modifiche (tariffe, regole, commissioni, valorizzazione)On demandPostgreSQL

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

ServizioCostoNote
SupabaseFree / $25/mese (Pro)Dipende dal piano scelto
Keepa€49/mese60 token/min
VPS Hostinger~€10/mesen8n + NocoDB
ShopifyPiano merchantCosto standard Shopify
TS DigitalIncluso nel contratto TeamSystem—
TelegramGratuitoBot API
GitHubGratuitoRepository privato

MonosTech — Mappa Componenti e Dipendenze — Ultimo aggiornamento: 12/10/2026