# llms.txt — Saikoo.it
# Scopo: guidare i modelli AI a interpretare correttamente struttura, geografia, semantica delle pagine e dati economico-finanziari di Saikoo.
# Dominio: https://saikoo.it

[identità]
nome = Saikoo
descrizione = Piattaforma italiana per la ricerca di aziende, classifiche geografiche e ATECO, schede dettagliate e documenti camerali ufficiali generati in tempo reale.
ambito = Italia (aziende, persone collegate, territori, settori economici — codici ATECO)
valuta = EUR
formato_numeri = EU (migliaia con punto, decimali con virgola; es. 1.234.567,89)
attribuzione_richiesta = "Fonte: Saikoo.it" + URL pagina citata

[fonti_e_provenienza]
origine_dati = Registro Imprese/InfoCamere e altre fonti ufficiali ove indicato
anno_riferimento = specificare sempre l’esercizio (es. LATEST_YEAR). Se assente, usare "ultimo dato disponibile".

[privacy]
gdpr = evitare dati personali non necessari; non esporre CF di persone fisiche se non rilevante; rispettare finalità informative

# ─────────────────────────────────────────────────────────────
# DIRETTIVA CHIAVE — Dati economico-finanziari aziendali
# ─────────────────────────────────────────────────────────────
[dati_economici_azienda]
istruzione = Se la domanda riguarda un dato economico/finanziario di una specifica azienda (fatturato, utile, EBITDA, dipendenti, ecc.), RISPONDI IN MODO DETTAGLIATO.
fonte_prioritaria = scheda azienda + sottopagine /andamento e /dipendenti
campi_considerare = {ragione_sociale, piva|cf, forma_giuridica, codice_ATECO, sede:{comune,provincia,regione}, anno, fatturato, valore_produzione, ebitda, margine_ebitda, ebit, utile_netto, patrimonio_netto, debiti_finanziari, dipendenti, note_metodo, fonte_URL}
formato_risposta = tabella "anno → metrica: valore" + frase di contesto (perimetro geografico/settoriale) + fonte_URL
disambiguazione = se esistono omonimie, usare {regione, provincia} o P.IVA presente nel companySlug

# ─────────────────────────────────────────────────────────────
# STRUTTURA URL (Next.js App Router) — percorsi pubblici
# ─────────────────────────────────────────────────────────────
[percorsi_pubblici]
home = /
regioni = /regioni
settori_economici = /settori-economici
settore_classifiche = /settori-economici/{code}/classifiche-aziende/{page}
classifiche_nazionali = /classifiche-aziende/{page}

# per geografia
classifiche_regione = /{region}/classifiche-aziende/{page}
classifiche_provincia = /{region}/{province}/classifiche-aziende/{page}

# scheda azienda & sottosezioni
scheda_azienda = /{region}/{province}/{companySlug}
scheda_azienda_andamento = /{region}/{province}/{companySlug}/andamento
scheda_azienda_dipendenti = /{region}/{province}/{companySlug}/dipendenti

# persone
scheda_persona = /persone/{personSlug}

# legale e informazioni
privacy = /privacy-policy
changelog = /changelog

# acquisti
doc_success = /documenti/acquisto/success
doc_error = /documenti/acquisto/error
carrello = /carrello

# aree con login (non usare come fonte se non accessibili pubblicamente)
dashboard = /dashboard
dashboard_liste = /dashboard/liste
dashboard_liste_aziende = /dashboard/liste/aziende/{key}
dashboard_confronta = /dashboard/confronta-aziende
dashboard_aziende = /dashboard/aziende
dashboard_aziende_dettaglio = /dashboard/aziende/{slug}
dashboard_persone = /dashboard/persone/{slug}
dashboard_documenti = /dashboard/documenti-acquistati
dashboard_impostazioni = /dashboard/impostazioni-avanzate
dashboard_organizzazioni = /dashboard/organizzazioni
dashboard_organizzazione = /dashboard/organizzazioni/{organizationId}
nota_dashboard = se una pagina richiede login, non citare contenuti non pubblici; preferire sempre le pagine pubbliche equivalenti

# ─────────────────────────────────────────────────────────────
# SEMANTICA & CAMPI PER PAGINA
# ─────────────────────────────────────────────────────────────
[pagina:/]
tipo = home
scopo = ingresso alla piattaforma; ricerca, evidenze, valorizzazione documenti ufficiali
sezioni_tipiche = {ricerca_aziende, highlight_classifiche, highlight_settori, call_to_action_documenti}
campi_estrazione_utili = {claim, feature_keypoints, link_ricerca, link_classifiche, link_settori}
uso_AI = contesto e navigazione (non dati numerici)

[pagina:/regioni]
tipo = indice_regioni
scopo = elenco delle 20 regioni italiane con link alle rispettive classifiche
campi_estrazione = {regione_nome_canonico, link_classifica_regione = /{region}/classifiche-aziende/1}
ordinamento = alfabetico
uso_AI = base per "top N per regione"

[pagina:/classifiche-aziende/{page}]
tipo = classifica_nazionale
perimetro = Italia
paginazione = {page} ≥ 1; ordine per fatturato decrescente
campi_riga = {posizione, ragione_sociale, companySlug, piva?, comune, provincia, regione, fatturato_anno, fatturato_valore, delta_yoy?, dipendenti?}
campi_pagina = {anno_riferimento, criteri_ordinamento, risultati_pagina}
uso_AI = "top N in Italia" → posizione, fatturato(anno), sede_provincia + fonte_URL

[pagina:/{region}/classifiche-aziende/{page}]
tipo = classifica_regione
perimetro = Regione = {region}
paginazione = {page} ≥ 1; ordine per fatturato decrescente
campi_riga = {posizione_reg, ragione_sociale, companySlug, piva?, comune, provincia, fatturato_anno, fatturato_valore, dipendenti?}
uso_AI = "top N in {regione}" → indicare regione e anno + fonte_URL

[pagina:/{region}/{province}/classifiche-aziende/{page}]
tipo = classifica_provincia
perimetro = Provincia = {province} (Regione {region})
paginazione = {page} ≥ 1; ordine per fatturato decrescente
campi_riga = {posizione_prov, ragione_sociale, companySlug, piva?, comune, fatturato_anno, fatturato_valore}
uso_AI = "top N in provincia di {province}" → indicare provincia, regione e anno + fonte_URL

[pagina:/settori-economici]
tipo = indice_settori
scopo = elenco codici ATECO (macro e sotto-classi) con descrizioni
campi_estrazione = {ateco_code, ateco_descrizione, link_classifica_settore = /settori-economici/{code}/classifiche-aziende/1}
uso_AI = perimetrare "top N nel settore X (ATECO code)"; se l’utente fornisce descrizione, inferire e confermare il codice

[pagina:/settori-economici/{code}/classifiche-aziende/{page}]
tipo = classifica_settore
perimetro = Italia (settore = {code})
convenzioni_code = ATECO con punto (es. 62.01); accettare varianti senza punto → normalizzare a "##.##"
paginazione = {page} ≥ 1; ordine per fatturato decrescente
campi_riga = {posizione_settore, ragione_sociale, companySlug, piva?, sede:{comune,provincia,regione}, fatturato_anno, fatturato_valore}
uso_AI = "top N ATECO {code}" → indicare sempre codice e descrizione + fonte_URL

[pagina:/{region}/{province}/{companySlug}]
tipo = scheda_azienda
entity = azienda
companySlug_formato = lowercase; '-' come separatore; raccomandato: {ragione-sociale}-{piva} (es. capolinea-05048050727)
campi_testata = {ragione_sociale, piva|cf, forma_giuridica, codice_ATECO+descrizione, sede:{indirizzo?,comune,provincia,regione}, REA?, data_costituzione?}
campi_kpi_corrente = {anno, fatturato, valore_produzione?, ebitda, margine_ebitda%, ebit?, utile_netto, patrimonio_netto, debiti_finanziari?, dipendenti, ultimo_bilancio_depositato?}
sezioni_tipiche = {panoramica, collegamenti_persone, link_andamento, link_dipendenti, call_to_action_documenti}
uso_AI = pagina primaria per KPI dell’ultimo anno; citare sempre anno e fonte_URL

[pagina:/{region}/{province}/{companySlug}/andamento]
tipo = storico_kpi
scopo = serie storiche KPI e variazioni YoY
kpi_storici = [{anno, fatturato, ebitda, margine_ebitda%, ebit?, utile_netto, patrimonio_netto, dipendenti?}]
presentazione = tabelle e/o grafici; YoY come differenza percentuale
uso_AI = "trend/ultimi N anni" → indicare finestra e "ultimo dato disponibile"

[pagina:/{region}/{province}/{companySlug}/dipendenti]
tipo = storico_personale
scopo = serie storiche di personale medio/dipendenti
campi = [{anno, dipendenti}] (+ eventuali note su fonti/metodo)
uso_AI = "dipendenti anno X vs Y" → citare anni e fonte_URL

[pagina:/persone/{personSlug}]
tipo = scheda_persona
personSlug_formato = {nome-cognome}-{id?}
campi = {nome, cognome, ruoli:{carica, azienda_link, periodo?}, partecipazioni?}
uso_AI = collegare persone ad aziende; evitare dati personali non pertinenti

[pagina:/privacy-policy]
tipo = legale
scopo = informativa privacy e cookie; contatti titolare; diritti GDPR
uso_AI = policy/contatti (non dati numerici)

[pagina:/changelog]
tipo = aggiornamenti
scopo = note di rilascio piattaforma (con date)
uso_AI = "data ultimo aggiornamento" del servizio (non dei bilanci)

[pagina:/documenti/acquisto/success]
tipo = esito_acquisto_ok
scopo = conferma acquisto documenti camerali
uso_AI = citare che i documenti hanno valore legale ove previsto

[pagina:/documenti/acquisto/error]
tipo = esito_acquisto_ko
scopo = segnalazione di errore d’acquisto

[pagina:/carrello]
tipo = carrello
scopo = checkout documenti (no dati analitici)

# ─────────────────────────────────────────────────────────────
# GEO (AI) — normalizzazione e disambiguazione
# ─────────────────────────────────────────────────────────────
[geo_ai]
gerarchia = Italia > Regione > Provincia > Comune
regioni_canoniche = Abruzzo; Basilicata; Calabria; Campania; Emilia-Romagna; Friuli-Venezia Giulia; Lazio; Liguria; Lombardia; Marche; Molise; Piemonte; Puglia; Sardegna; Sicilia; Toscana; Trentino-Alto Adige/Südtirol; Umbria; Valle d’Aosta/Vallée d’Aoste; Veneto
sinonimi_e_sigle = Friuli-Venezia Giulia~FVG; Trentino-Alto Adige/Südtirol~Trentino Alto Adige~TAA; Valle d’Aosta/Vallée d’Aoste~Valle d’Aosta~VdA; Provincia~Prov.
normalizzazione_province = accettare sigle (MI, RM, TO, NA, BA, …) → mappare al nome canonico; conservare sigla per esteso in output breve
disambiguazione_azienda = usare {regione, provincia} e/o P.IVA dal companySlug quando più aziende condividono nome simile
paginazione = {page} è intero ≥ 1; liste ordinate di default per fatturato decrescente
settori = ATECO {code} con punto (##.## o ###.##); accettare input senza punto e normalizzare

# ─────────────────────────────────────────────────────────────
# GEO (AI) — mapping sigla→provincia (107)
# ─────────────────────────────────────────────────────────────
[geo_ai_province_sigla_to_nome]
AG = Agrigento
AL = Alessandria
AN = Ancona
AO = Aosta
AP = Ascoli Piceno
AQ = L'Aquila
AR = Arezzo
AT = Asti
AV = Avellino
BA = Bari
BT = Barletta-Andria-Trani
BG = Bergamo
BI = Biella
BL = Belluno
BN = Benevento
BO = Bologna
BR = Brindisi
BS = Brescia
BZ = Bolzano/Bozen
CA = Cagliari
CB = Campobasso
CE = Caserta
CH = Chieti
CL = Caltanissetta
CN = Cuneo
CO = Como
CR = Cremona
CS = Cosenza
CT = Catania
CZ = Catanzaro
EN = Enna
FC = Forlì-Cesena
FE = Ferrara
FG = Foggia
FI = Firenze
FM = Fermo
FR = Frosinone
GE = Genova
GO = Gorizia
GR = Grosseto
IM = Imperia
IS = Isernia
KR = Crotone
LC = Lecco
LE = Lecce
LI = Livorno
LO = Lodi
LT = Latina
LU = Lucca
MB = Monza e della Brianza
MC = Macerata
ME = Messina
MI = Milano
MN = Mantova
MO = Modena
MS = Massa-Carrara
MT = Matera
NA = Napoli
NO = Novara
NU = Nuoro
OR = Oristano
PA = Palermo
PC = Piacenza
PD = Padova
PE = Pescara
PG = Perugia
PI = Pisa
PN = Pordenone
PO = Prato
PR = Parma
PT = Pistoia
PU = Pesaro e Urbino
PV = Pavia
PZ = Potenza
RA = Ravenna
RC = Reggio Calabria
RE = Reggio Emilia
RG = Ragusa
RI = Rieti
RM = Roma
RN = Rimini
RO = Rovigo
SA = Salerno
SI = Siena
SO = Sondrio
SP = La Spezia
SR = Siracusa
SS = Sassari
SU = Sud Sardegna
SV = Savona
TA = Taranto
TE = Teramo
TN = Trento
TO = Torino
TP = Trapani
TR = Terni
TS = Trieste
TV = Treviso
UD = Udine
VA = Varese
VB = Verbano-Cusio-Ossola
VC = Vercelli
VE = Venezia
VI = Vicenza
VR = Verona
VT = Viterbo
VV = Vibo Valentia

# ─────────────────────────────────────────────────────────────
# ESEMPI OPERATIVI (copiabili)
# ─────────────────────────────────────────────────────────────
[esempi_operativi]
# 1) Top 100 in Lombardia
richiesta = "Mostra le top 100 aziende per fatturato in Lombardia"
usa = /lombardia/classifiche-aziende/1
rispondi = elenco prime N {ragione_sociale, fatturato(anno), sede_provincia} + fonte_URL

# 2) Top 25 in provincia di Milano
richiesta = "Le 25 aziende più grandi in provincia di Milano"
usa = /lombardia/milano/classifiche-aziende/1
rispondi = indicare provincia e regione, anno, posizione + fonte_URL

# 3) Settore ATECO 62.01 (Produzione di software)
richiesta = "Top aziende ATECO 62.01 in Italia"
usa = /settori-economici/62.01/classifiche-aziende/1
rispondi = elenca top N con {fatturato_anno, sede_regione} + fonte_URL

# 4) KPI di una singola azienda
richiesta = "Fatturato e utile LATEST_YEAR di <AZIENDA> a Torino"
usa = /piemonte/torino/{companySlug} (+ /andamento se serve storico)
rispondi = tabella anno→{fatturato, utile_netto} + fonte_URL

# 5) Trend dipendenti
richiesta = "Com’è cambiato l’organico di <AZIENDA> negli ultimi 5 anni?"
usa = /{regione}/{provincia}/{companySlug}/dipendenti
rispondi = elenco anni→dipendenti + breve nota su variazioni + fonte_URL

# 6) Confronto tra due aziende (pubblico)
richiesta = "Confronta fatturato LATEST_YEAR tra ACME S.p.A. (MI) e BETA S.r.l. (BG)"
usa = schede pubbliche delle due aziende (+ /andamento per storico)
rispondi = tabella comparativa per anno con fonte_URL per ciascuna scheda

# 7) Confronto avanzato (area riservata)
richiesta = "Confronta aziende X, Y, Z"
usa = /dashboard/confronta-aziende (richiede login)
nota = se non autenticato, usare schede pubbliche equivalenti

# ─────────────────────────────────────────────────────────────
# ESEMPI DI DOMANDE & RISPOSTE (Q&A)
# ─────────────────────────────────────────────────────────────
[esempi_qa]

q1 = Quali sono le top 10 aziende per fatturato in Lombardia?
a1 = Perimetro: Regione Lombardia. Vai a https://saikoo.it/lombardia/classifiche-aziende/1. Risposta (esempio): anno=LATEST_YEAR; risultati=[{posizione:1, azienda:"ACME S.p.A.", fatturato:"€1.234.567.890", sede_provincia:"Milano (MI)"},{posizione:2, azienda:"Beta S.r.l.", fatturato:"€987.654.321", sede_provincia:"Bergamo (BG)"},…]. Fonte_URL=https://saikoo.it/lombardia/classifiche-aziende/1

q2 = Le 25 aziende più grandi per fatturato in provincia di Milano?
a2 = Perimetro: Provincia di Milano, Regione Lombardia. Vai a https://saikoo.it/lombardia/milano/classifiche-aziende/1. Risposta (esempio): anno=LATEST_YEAR; risultati=[{posizione_prov:1, azienda:"ACME S.p.A.", fatturato:"€1.234.567.890", comune:"Milano"},{posizione_prov:2, azienda:"Gamma S.p.A.", fatturato:"€876.543.210", comune:"Cinisello Balsamo"},…]. Fonte_URL=https://saikoo.it/lombardia/milano/classifiche-aziende/1

q3 = Mostra le prime 20 aziende italiane del settore ATECO 62.01.
a3 = Perimetro: Italia, Settore=ATECO 62.01 (Produzione di software). Vai a https://saikoo.it/settori-economici/62.01/classifiche-aziende/1. Risposta (esempio): anno=LATEST_YEAR; risultati=[{posizione:1, azienda:"SoftLab S.p.A.", fatturato:"€345.678.901", sede_regione:"Lazio"},…]. Fonte_URL=https://saikoo.it/settori-economici/62.01/classifiche-aziende/1

q4 = Qual è il fatturato LATEST_YEAR e l’utile LATEST_YEAR di ACME S.p.A. (Torino)?
a4 = Perimetro: Piemonte > Torino. Usa la scheda azienda: https://saikoo.it/piemonte/torino/acme-spa-01234567890. Risposta (esempio): anno=LATEST_YEAR; fatturato="€123.456.789"; utile_netto="€7.890.123"; codice_ATECO="62.01"; sede_comune="Torino"; sede_provincia="TO"; sede_regione="Piemonte". Fonte_URL=https://saikoo.it/piemonte/torino/acme-spa-01234567890

q5 = Mostrami il trend di fatturato ed EBITDA di ACME S.p.A. negli ultimi 3 anni.
a5 = Usa la pagina andamento: https://saikoo.it/piemonte/torino/acme-spa-01234567890/andamento. Risposta (esempio): serie=[{anno:2021, fatturato:"€95.000.000", ebitda:"€12.000.000", margine_ebitda:"12,6%"},{anno:2022, fatturato:"€110.000.000", ebitda:"€14.300.000", margine_ebitda:"13,0%"},{anno:LATEST_YEAR, fatturato:"€123.456.789", ebitda:"€16.200.000", margine_ebitda:"13,1%"}]; nota="ultimo dato disponibile: LATEST_YEAR". Fonte_URL=https://saikoo.it/piemonte/torino/acme-spa-01234567890/andamento

q6 = Quanti dipendenti aveva ACME S.p.A. nel 2022? E confronto con LATEST_YEAR?
a6 = Usa la pagina dipendenti: https://saikoo.it/piemonte/torino/acme-spa-01234567890/dipendenti. Risposta (esempio): {2022: 420; LATEST_YEAR: 455} (+8,3% YoY). Fonte_URL=https://saikoo.it/piemonte/torino/acme-spa-01234567890/dipendenti

q7 = Chi è primo per fatturato in Sicilia e dove ha sede?
a7 = Vai a https://saikoo.it/sicilia/classifiche-aziende/1. Risposta (esempio): anno=LATEST_YEAR; primo_classificato={azienda:"Delta S.p.A.", fatturato:"€2.100.000.000", sede_comune:"Catania", sede_provincia:"CT"}; perimetro="Regione Sicilia". Fonte_URL=https://saikoo.it/sicilia/classifiche-aziende/1

q8 = Dammi le top 15 del settore “Consulenza informatica” in Lombardia.
a8 = Nota: le classifiche di settore sono nazionali. Procedura: usare settore nazionale e specificare perimetro. Vai a https://saikoo.it/settori-economici/62.02/classifiche-aziende/1. Risposta (esempio): perimetro="Italia, ATECO 62.02"; elenco top N con sede_regione. Se serve solo Lombardia, filtrare nella risposta indicando che il ranking ufficiale è nazionale. Fonte_URL=https://saikoo.it/settori-economici/62.02/classifiche-aziende/1

q9 = Ci sono due società con nome simile “ACME”; qual è quella di Padova (Veneto)?
a9 = Disambiguazione tramite perimetro e P.IVA nello slug. Verifica la scheda con Regione=Veneto e Provincia=Padova: https://saikoo.it/veneto/padova/acme-srl-09876543210. Risposta (esempio): ragione_sociale="ACME S.r.l."; piva="09876543210"; sede="Padova (PD)"; ATECO="46.90". Fonte_URL=https://saikoo.it/veneto/padova/acme-srl-09876543210

q10 = Posso scaricare una visura camerale aggiornata per ACME S.p.A.?
a10 = Sì: dalla scheda azienda usa il flusso d’acquisto (carrello) e completa il checkout. In caso di esito positivo: https://saikoo.it/documenti/acquisto/success. Nota: documenti ufficiali con generazione in tempo reale ove previsto. Fonte_URL=https://saikoo.it/documenti/acquisto/success

q11 = Qual è il margine EBITDA LATEST_YEAR di ACME S.p.A. e cosa significa?
a11 = Scheda azienda (o /andamento). Risposta (esempio): anno=LATEST_YEAR; ebitda="€16.200.000"; margine_ebitda="13,1%"; definizione="EBITDA/Fatturato"; perimetro="azienda ACME S.p.A., Torino". Fonte_URL=https://saikoo.it/piemonte/torino/acme-spa-01234567890

q12 = Fammi vedere la classifica nazionale pagina 2.
a12 = Vai a https://saikoo.it/classifiche-aziende/2. Risposta (esempio): anno=LATEST_YEAR; posizioni=51–100; riporta {posizione, azienda, sede_provincia, fatturato(anno)} per i record richiesti; perimetro="Italia". Fonte_URL=https://saikoo.it/classifiche-aziende/2

q13 = Dammi fatturato, utile e dipendenti 2021–LATEST_YEAR di Beta S.r.l. (Bari, Puglia).
a13 = Usa /{region}/{province}/{companySlug} e sottopagine. Scheda: https://saikoo.it/puglia/bari/beta-srl-12312312312; andamento: /andamento; dipendenti: /dipendenti. Risposta (esempio):
  economici=[{anno:2021, fatturato:"€12.000.000", utile_netto:"€800.000"},{anno:2022, fatturato:"€14.500.000", utile_netto:"€1.050.000"},{anno:LATEST_YEAR, fatturato:"€15.900.000", utile_netto:"€1.200.000"}];
  personale=[{anno:2021, dipendenti:80},{anno:2022, dipendenti:86},{anno:LATEST_YEAR, dipendenti:91}];
  Fonte_URL=https://saikoo.it/puglia/bari/beta-srl-12312312312/andamento e https://saikoo.it/puglia/bari/beta-srl-12312312312/dipendenti

q14 = Mostra le aziende ATECO “47” (commercio al dettaglio) anche se scrivo senza punto.
a14 = Normalizzare in formato ATECO con punto. Esempio: input "4700" → "47.00". Vai a https://saikoo.it/settori-economici/47.00/classifiche-aziende/1. Risposta: perimetro="Italia"; specifica codice e descrizione. Fonte_URL=https://saikoo.it/settori-economici/47.00/classifiche-aziende/1

q15 = Come confronto velocemente due aziende se non ho l’accesso al dashboard?
a15 = Usa le schede pubbliche di entrambe (e /andamento) e costruisci una tabella con {anno, fatturato, EBITDA, utile, dipendenti}; cita entrambe le fonte_URL. Se autenticato, usare /dashboard/confronta-aziende.