# SICILIAN WHISKEY - LLM FULL FILE
version: 2026.03
generated_at_utc: 2026-03-12T10:16:27.693Z

## 1. Mission and Scope
Sicilian Whiskey operates as a programmable luxury protocol.
The website and APIs expose commercial, logistic, ledger and trust workflows for both humans and AI assistants.

This file is intended for machine reasoning and tool selection.
It documents the current public and integration-facing behavior of the platform.

## 2. Protocol Narrative
- Sicilian Whiskey uses technology as a shield for craftsmanship, not as a substitute for artisanal work.
- The distillery protocol does not industrialize flavor: it curates aged bases, calibrates wood, controls finish, and verifies each asset through a phygital trust layer.
- Backlog and dynamic pricing are not artificial hype mechanics: they protect production cadence, preserve quality, and expose real operational pressure.
- OakChain is the transparency layer that makes the protocol legible: it connects commerce, production, club identity, biological regeneration and Oaken utility without leaking sensitive user data.
- The production signature is based on curated aged bases, micro-cask finish logic, layered sensory architecture and strict wood management.
- The protocol joins luxury storytelling with operational truth: if backlog grows, prices and promised waiting time move with it.

## 3. Dynamic Snapshot (Authoritative at Generation Time)
backlog_days: 0
market_coefficient: 1.00
pricing_formula: 1.01^0
daily_shipping_capacity_bottles: 10

## 4. Core Site Knowledge
### 4.1 Brand Pillars
- Anima: artisanal identity and finish process.
- Missione: regenerative and biological narrative.
- Make Your Cask: configurable cask experience.
- Export: logistics and compliance.
- Rarity: limited releases and high-intensity products.
- Tasting: tasting protocol and pairing logic.
- Momenti: experiences and engagement layer.
- Backlog: operational scarcity and queue transparency.
- Oakchain: public event ledger and proof layer.

### 4.2 Product/Experience Positioning
- Club and backoffice have dedicated flows not equivalent to public anonymous checkout.
- Public site is narrative + commercial + trust layer.
- Club is the operational layer for identity, caveau, Oaken, referrals, advanced services and reserved commerce.

### 4.3 Live Product Pricing (Base * Coefficient)
- Red Fox: 42.50 EUR (base 42.50 EUR, id prd-0001)
- Century Oak: 57.50 EUR (base 57.50 EUR, id prd-0002)
- Golden Barrel (PLA): 69.90 EUR (base 69.90 EUR, id prd-0401)
- Cask Forge 10L: 650.00 EUR (base 650.00 EUR, id prd-0102)
- Minibar 50 pz: 350.00 EUR (base 350.00 EUR, id prd-0202)
- Esperienza: Tasting in fabbrica: 15.00 EUR (base 15.00 EUR, id prd-0301)
- Esperienza: Food Pairing in fabbrica: 30.00 EUR (base 30.00 EUR, id prd-0302)
- Esperienza: Escursione al bosco: 60.00 EUR (base 60.00 EUR, id prd-0303)
- Esperienza: Speakeasy BBQ: 120.00 EUR (base 120.00 EUR, id prd-0304)
- Export Proof 200ml (PLA): 40.00 EUR (base 40.00 EUR, id prd-0403)

### 4.4 Full Public Catalog Snapshot
- Minibar 75 pz [prd-0203 | CLB-MNB-75] category=gift-box, base=450.00 EUR, live=450.00 EUR
- Century Oak [prd-0002 | SW-CNT-OAK] category=whiskey, base=57.50 EUR, live=57.50 EUR
- Cask Forge 5L [prd-0101 | CLB-CSK-05] category=accessory, base=350.00 EUR, live=350.00 EUR
- Cask Forge 10L [prd-0102 | CLB-CSK-10] category=accessory, base=650.00 EUR, live=650.00 EUR
- Cask Forge 15L [prd-0103 | CLB-CSK-15] category=accessory, base=1000.00 EUR, live=1000.00 EUR
- Esperienza: Tasting in fabbrica [prd-0301 | CLB-EXP-TAST] category=accessory, base=15.00 EUR, live=15.00 EUR
- Esperienza: Food Pairing in fabbrica [prd-0302 | CLB-EXP-PAIR] category=accessory, base=30.00 EUR, live=30.00 EUR
- Esperienza: Escursione al bosco [prd-0303 | CLB-EXP-WOOD] category=accessory, base=60.00 EUR, live=60.00 EUR
- Esperienza: Speakeasy BBQ [prd-0304 | CLB-EXP-BBQ] category=accessory, base=120.00 EUR, live=120.00 EUR
- Golden Barrel (PLA) [prd-0401 | CLB-EXC-GLD] category=gift-box, base=69.90 EUR, live=69.90 EUR
- Angel Share 100ml (PLA) [prd-0402 | CLB-EXC-ANG] category=gift-box, base=40.00 EUR, live=40.00 EUR
- Export Proof 200ml (PLA) [prd-0403 | CLB-EXC-EXP] category=gift-box, base=40.00 EUR, live=40.00 EUR
- Minibar 25 pz [prd-0201 | CLB-MNB-25] category=gift-box, base=200.00 EUR, live=200.00 EUR
- Minibar 50 pz [prd-0202 | CLB-MNB-50] category=gift-box, base=350.00 EUR, live=350.00 EUR
- Red Fox [prd-0001 | SW-REDFOX] category=whiskey, base=42.50 EUR, live=42.50 EUR

## 5. Cluster Dossiers (Long-form Site Narrative)
### Anima
Page: https://www.sicilianwhiskey.com/it/anima
Matrice identitaria di Sicilian Whiskey: selezione di basi invecchiate, finish molecolare a Caltagirone e protocollo phygital per la certificazione.
- Selection & Finish authority nel laboratorio di Caltagirone.
- Radical Wood Management con micro-botti 10L-50L.
- Gusto Layered in 4 piani sensoriali.
- Malfa Marlon: Ingegnere gestionale, mente tecnica e creatore del protocollo.
  * Specializzato nella fermentazione e distillazione di distillati artigianali d'eccellenza.
  * Architetto del sistema OakChain e del modello di scarsità dinamica (Backlog Engine).
  * Ricerca costante sull'integrazione tra ledger append-only e patrimonio biologico.
  * Focus: Engineering & Distillation
  * Role: Founder / CEO
  * Expertise: Full-stack Phygital
- Malfa Alex: Direttore artistico e custode dell'identità visiva del brand.
  * Responsabile della visione estetica e dello storytelling visivo di Sicilian Whiskey.
  * Sviluppo del design dei sigilli PLA e dell'interfaccia di comunicazione del lusso programmabile.
  * Curatore dell'equilibrio tra tradizione artigianale siciliana e avanguardia tecnologica.
  * Focus: Art Direction & Branding
  * Role: Creative Director
  * Expertise: Luxury Design
- Le Radici di Caltagirone: Laboratorio boutique dove il legno incontra il codice.
  * Produzione limitata e controllata nel laboratorio di selezione e finissaggio a Caltagirone.
  * Radical Wood Management: gestione diretta delle micro-botti per ogni batch.
  * Connessione viscerale con il territorio tramite la missione di rigenerazione nel Bosco di Santo Pietro.
- Radical Wood Management: Il legno e il principale reagente per scolpire i profili aromatici.
  * Micro-aging ad alta superficie di scambio.
  * Doghe differenziate Virgin, Medium e Spiced.
  * Controllo tecnico del finish per massima coerenza sensoriale.
  * Format: 10L/20L/50L
  * Architecture: 23 staves
  * Hub: Caltagirone
- Safe-Security: L'integrita dell'asset e garantita da un ponte fisico-digitale.
  * Sigillo PLA 3D con PIN interno non sequenziale.
  * Validazione in dashboard con certificato digitale.
  * Tracciabilita su Oakchain senza esporre dati sensibili.

### Missione
Page: https://www.sicilianwhiskey.com/it/missione
Programma di rigenerazione del Bosco di Santo Pietro: selezione genetica, piantumazioni cicliche e monitoraggio dell'impatto tramite Bio-Ledger.
- Rituale annuale del 15 novembre per raccolta e piantumazione.
- Tutela specie autoctone e stabilizzazione querce monumentali.
- Adopt an Oak finanziato con quota dei ricavi.
- Selezione Genetiche: Analisi biennale della fertilita per preservare il patrimonio boschivo.
  * Mappatura delle piante madri per continuita genetica.
  * Piantumazioni solo nelle finestre biologiche utili.
  * Allineamento tra produzione e ritmo naturale del bosco.
  * Cycle: Biennale
  * Standard: Natura 2000
  * Species: Quercus suber e affini
- Scudo PLA Biologico: Protezione 3D biodegradabile nella fase critica di crescita.
  * Camere in PLA per schermare le ghiande nei primi mesi.
  * Dissoluzione naturale a radicamento avvenuto.
  * Riduzione dell'impatto ambientale dei supporti tecnici.
- Adopt an Oak: Una quota dei ricavi viene destinata a tutela e riforestazione.
  * Intervento operativo sul territorio con reporting continuo.
  * Tracciamento impatto in dashboard e Bio-Ledger.
  * Connessione diretta tra asset e rigenerazione reale.
  * RevenueShare: 1%
  * Frequency: Annuale
  * Date: 15 novembre

### Make Your Cask
Page: https://www.sicilianwhiskey.com/it/make-your-cask
Configuratore tecnico della riserva privata: volume, architettura delle doghe e certificazione della ricetta su infrastruttura digitale.
- Utente in ruolo Master Blender guidato da regole tecniche.
- 23 doghe con composizione modulabile.
- Output certificato con etichetta e PIN hardware.
- Filosofia Cask Forge: Personalizzazione avanzata mantenendo standard di integrita.
  * La base selezionata viene rifinita in micro-botti controllate.
  * L'utente definisce profilo e obiettivo del lotto.
  * La direzione tecnica valida la configurazione finale.
- Architettura 23 Doghe: Combinazione di staves per modellare i piani sensoriali.
  * Virgin: vaniglia e componente floreale.
  * Medium: setosita, toffee e dolcezza strutturale.
  * Spiced: fume e perstenza su finale.
  * Volumes: 5L/10L/15L
  * Sync: Oakchain v4.2
  * Model: 3D ready
- Output e Certificazione: Ricetta, lotto e identita vengono cristallizzati in un record unico.
  * Certificato digitale con riferimento immutabile.
  * PIN hardware per anti-contraffazione del lotto.
  * Consegna in bottiglie 70cl con filiera tracciata.

### Export
Page: https://www.sicilianwhiskey.com/it/export
Architettura internazionale per spedizione, compliance e continuita di profilo sensoriale nei mercati UE ed extra-UE.
- Modello logistico a bassa frizione su rotte globali.
- Nodo digitale per coordinamento documentale e tracking.
- Protocollo B2B per horeca e partner verificati.
- Zero Friction Logistics: Coordinamento anticipato di pratiche e dazi per ridurre blocchi.
  * Controllo documentale prima della partenza.
  * Riduzione dei tempi di fermo in dogana.
  * Tracciamento continuo dello stato spedizione.
  * Routing: EU + Extra-EU
  * Partner: Spedizione specializzata
  * Status: Pre-cleared
- Resilienza Export 50% ABV: Taglio dedicato a mantenere stabilita durante trasporto internazionale.
  * Compensa variazioni di pressione e temperatura.
  * Preserva struttura del gusto layered in arrivo.
  * Migliora affidabilita del profilo su tratte lunghe.
- Compliance B2B: Regole di fornitura business con workflow fiscale e operativo.
  * Canale dedicato per horeca e importatori premium.
  * Standard packaging rinforzato per bulk.
  * Integrazione con regole locali e documentazione commerciale.

### Rarity
Page: https://www.sicilianwhiskey.com/it/rarity
Linea ultra-limitata orientata a collezionismo e alta concentrazione organolettica, con disponibilita certificata e protezione hardware dell'asset.
- Angel Share con dinamica di evaporazione estrema.
- Imbottigliamento full proof senza compromessi.
- Tirature annuali limitate e verificabili.
- Angel Share: Evaporazione controllata per densita e profondita aromatica.
  * Concentrazione naturale del profilo aromatico.
  * Produzione guidata da parametri di scarsita reale.
  * Bilanciamento fine tra potenza e eleganza.
  * Evaporation: 8-12% annuo
  * Format: 10L single oak
  * Mood: Ultra rarity
- Full Proof 58.5%: No chill filter, massima integrita del carattere.
  * Conserva la componente oleosa e la struttura.
  * Richiede gestione termica precisa in degustazione.
  * Massimizza persistenza e firma del legno.
- Disponibilita Limitata: Allocazione strettamente contingentata su base annuale.
  * Ogni unita e numerata e tracciata.
  * Disponibilita dipendente dallo stato nodi e release.
  * Protezione anti-replica tramite hardware PIN.
  * AnnualBatch: 150 unita
  * Access: Direct allocation
  * Validation: Ledger based

### Tasting
Page: https://www.sicilianwhiskey.com/it/tasting
Framework tecnico per degustazione professionale: protocollo sensoriale, range termici e matrice di pairing gastronomico.
- Metodo a punteggio per valutazione coerente tra sessioni.
- Curve termiche dedicate per ogni referenza.
- Food matrix per pairing guidato.
- Professional Tasting Protocol: Set-up standardizzato per lettura precisa del profilo.
  * Valutazione per aspetto, naso, bocca e persistenza.
  * Ossigenazione obbligatoria prima dell'assaggio.
  * Focus su equilibrio tra legno, alcol e setosita.
  * Glass: Tulip/Glencairn
  * Pour: 20-25 ml
  * Oxygenation: 15-20 min
- Matrice Termica: Ogni label ha un range ottimale di servizio.
  * Red Fox: 18.5-20C.
  * Export: 17.5-19C.
  * Angel Share: 16.5-18C.
- Dialogo Gastronomico: Abbinamenti calibrati su sapidita, grassezza e dolcezza.
  * Arancino e profili strutturati per bilanciare grassi.
  * Cannolo e note calde su referenze ad alta intensita.
  * Supporto eventi per conversione e storytelling.

### Momenti
Page: https://www.sicilianwhiskey.com/it/momenti
Hub esperienziale del brand: luoghi fisici, regole operative e onboarding editoriale per mantenere una relazione attiva con la community.
- Triade territoriale tra atelier, bosco e location speciali.
- Protocollo self-drive con rilascio coordinate post-booking.
- Esperienze gestite off-chain rispetto al ledger prodotto.
- Mappa dei Momenti: Esperienze pensate come estensione del protocollo.
  * Atelier per tasting e food pairing tecnico.
  * Bosco per percorsi rigenerativi e storytelling missione.
  * Location speciali per format ad alta memorabilita.
- Regole Logistiche: Partecipazione con standard operativi chiari.
  * Coordinate comunicate dopo conferma prenotazione.
  * Nessuna navetta integrata nel modello base.
  * Capacita limitata per garantire qualita dell'esperienza.
  * Transport: Self-drive
  * GPS: Post-booking
  * Tracking: Off-chain
- Policy di Accesso: Sicurezza e conformita prima della somministrazione.
  * Accesso tasting riservato ai maggiorenni.
  * Finestra stagionale per alcuni format outdoor.
  * Allineamento con flussi editoriali e newsletter nurturing.

### Backlog
Page: https://www.sicilianwhiskey.com/it/backlog
Nodo operativo della scarsita etica: espone la coda reale del backend ordini e il tempo necessario per preservare qualita artigianale e affidabilita di consegna.
- Queue reale su ordini paid/packed con pianificazione giornaliera.
- Backlog days calcolato sul calendario spedizioni effettivo.
- Formula dinamica 1.01^days con ancoraggio ai movimenti ledger.
- Scudo dell'Artigiano: La coda protegge il processo e impedisce degrado qualitativo.
  * Nessuna accelerazione artificiale della produzione.
  * Controllo del carico per evitare stress operativo.
  * Attesa come parte del valore certificato, non come inefficienza.
- Queue Engine Reale: La pianificazione usa ordini paid/packed ordinati per updatedAt e li distribuisce su slot giornalieri.
  * Ogni ordine occupa capacita in base al numero bottiglie (non per ordine secco).
  * La capacita giornaliera e configurabile da dashboard produzione (default 10 btg/giorno).
  * Ad ogni pagamento, spedizione, cancellazione o cambio stato rilevante, il calendario viene ricalcolato.
  * Input: paid + packed
  * Scheduler: daily slot allocator
  * Output: plannedShipDate per ordine
- Prezzo Dinamico e Coerenza Ledger: Il coefficiente di mercato nasce dal backlog reale e viene idratato sulle superfici pubbliche.
  * Coefficiente 1.01^giorni applicato alla base.
  * Prezzo bloccato all'atto del pagamento e backlogDaysAtPlanning storicizzato.
  * Pagamenti e spedizioni su OakChain mantengono allineati coda, stato ordine e traccia eventi.
- Trasparenza Operativa: La pagina Backlog espone dati reali e non simulati, mantenendo il perimetro privacy.
  * Gli identificativi sensibili cliente non vengono mostrati nel nodo pubblico.
  * Il calendario mostra bottiglie pianificate, capacita residua e profondita coda per giorno.
  * Filosofia prototipo preservata: lentezza consapevole, misura tecnica, tracciabilita verificabile.
  * Endpoint: /api/backlog/live
  * Sync: auto 9s
  * View: queue + calendar + ledger anchor

### Oakchain
Page: https://www.sicilianwhiskey.com/it/oakchain
Registro eventi pubblico del protocollo: collega frontend, dashboard Club, dashboard Produzione e layer biologico in una catena append-only verificabile.
- Movimenti reali sempre aggiornati da API /api/oakchain.
- Tracciabilita cross-dominio: pagamenti, spedizioni, PIN, Oaken, lotti, querce.
- Payload pubblico sanificato: trasparenza operativa senza leakage dati sensibili.
- Architettura Ledger: Ogni evento OakChain e scritto come record append-only con id, tipo, sorgente, timestamp e payload.
  * La catena eventi e unificata su backend e alimenta sito, dashboard e terminal di monitoraggio.
  * Il feed pubblico elimina email, pinId, paymentId, userId e riferimenti sensibili prima dell'esposizione.
  * Ogni blocco resta verificabile su data/ora, source e tipo evento senza compromettere la privacy utente.
  * Endpoint: /api/oakchain
  * Model: append-only stream
  * Visibility: public + sanitized
- Flussi Intercettati: OakChain intercetta i percorsi critici della piattaforma in tempo quasi reale.
  * Frontend Public: payment_received e shipment_executed per il ciclo order-to-fulfillment.
  * Dashboard Club: pin_activated, pin_consumed, oaken_purchased e oaken_spent per identita e reward.
  * Dashboard Produzione: production_batch_loaded e movimenti logistici collegati ai lotti.
  * Frontend: payment + shipment
  * Club: pin + oaken
  * Production: batch + shipment
- Layer Bio-Finanziario: Il ledger integra la parte commerciale con la componente biologica e di utilita Oaken.
  * Eventi mother_oak_registered e stabilized_oak_created ancorano il valore digitale al ciclo reale della missione.
  * Le operazioni Oaken restano tracciate con stato transazionale e delta utilita lato Club.
  * Il tracciato unico riduce mismatch tra stato operativo, stato economico e stato identita asset.
  * BioEvents: mother/stabilized oak
  * Utility: oaken purchase/spend
  * Integrity: single source of truth
- Audit e Trasparenza: La pagina OakChain espone dati reali aggiornati continuamente con terminal pubblico e metriche aggregate.
  * Ogni riga del terminal mostra blocco, timestamp, sorgente, tipo evento e delta operativo.
  * Le metriche aggregate rendono immediato il controllo di volumi pagamenti, spedizioni, PIN e Oaken.
  * La separazione tra endpoint pubblico e endpoint backoffice mantiene equilibrio tra apertura e controllo.
  * AutoSync: 8s
  * Terminal: public stream
  * Scope: site + dashboards + system

### Glossario
Page: https://www.sicilianwhiskey.com/it/glossary
Il dizionario tecnico del protocollo: definizioni fondamentali per comprendere l'ecosistema tra distillazione artigianale e infrastruttura digitale.
- Definizioni univoche per i pilastri del progetto.
- Chiarificazione del rapporto tra asset fisici e digitali.
- Ancoraggio semantico per la Topical Authority del brand.
- Pilastri Tecnologici: Infrastruttura di tracciabilità, scarsità e logica di sistema.
  * Oaken: Strumento di parità e utilità (Rapporto 1/45) per il riscatto fisico degli asset.
  * OakChain: Registro pubblico append-only che cristallizza ogni evento operativo e biologico.
  * Backlog Engine: Algoritmo di scarsità dinamica (1.01^giorni) che regola la velocità della produzione.
  * Sanitized Ledger: Protocollo di privacy che garantisce trasparenza totale senza esporre dati sensibili.
- Utilità & Valore: Meccanismi economici che governano l'ecosistema del Club.
  * Oaken Parity: Algoritmo che ancora l'utilità degli Oaken al prezzo di mercato, proteggendo il valore nel tempo.
  * Dynamic Scarcity: Modello dove la rarità è una funzione del tempo e della pressione operativa.
  * Asset Digital Twin: La rappresentazione immutabile su ledger di ogni bottiglia o barile fisico.
- Ingegneria Produttiva: Il vocabolario tecnico del laboratorio e del legno.
  * Radical Wood Management: Calibrazione del finissaggio tramite micro-botti da 10L a 50L.
  * Stave Matrix: Architettura di 23 doghe differenziate per modellare piani sensoriali complessi.
  * Proof of Oak: Certificazione immutabile della provenienza e del ciclo di vita del legno.
- Sicurezza & Phygital: Sistemi di ancoraggio tra mondo fisico e digitale.
  * Phygital Bridge: Sistema di connessione hardware-software tra bottiglia e certificato.
  * Phygital PIN: Sigillo non sequenziale che attiva il gemello digitale dell'asset.
  * PLA Shield: Scudo 3D biodegradabile per la protezione biologica delle querce.
- Visione & Filosofia: Concetti superiori che guidano l'evoluzione del brand.
  * Programmable Luxury: Lusso dove valore e scarsità sono governati da codice verificabile.
  * Bio-Ledger: Layer di tracciabilità dedicato all'impatto ambientale nel Bosco di Santo Pietro.
  * Gusto Layered: Architettura sensoriale costruita su piani temporali e organolettici distinti.

## 6. Club Identity, PIN, Caveau, Oaken
### 6.1 PIN and Asset Activation
- Every certified bottle carries a non-sequential PIN sealed inside a physical PLA hardware lock.
- The PIN activates the Club identity, links the physical asset to the owner account, and anchors the bottle lifecycle to the digital protocol.
- If a seal is lost before activation, the bottle can remain authentic but cannot complete the full Club reward and traceability loop.
- PIN activation emits ledger evidence and unlocks My Caveau, Oaken wallet logic, referral attribution, and future loyalty privileges.
- For eligible formats, declared bottle consumption closes the asset cycle and can emit additional Oaken reward logic.

### 6.2 My Caveau and Club Layer
- Club members can inspect claimed bottles, consumed bottles, logistics status and asset history.
- The dashboard links claimed physical assets to batch, format, ABV, status and reward logic.
- Club also exposes Whiskey Shop, experiences, Minibar, Cask Forge, B2B and Oaken services through one operational interface.

### 6.3 Oaken
- Oaken is an internal utility layer tied to the OakID identity and used as discount/privilege logic rather than a free-floating token.
- Oaken can be earned through activation, eligible consumption and referral confirmations.
- Oaken spend and purchase events are written into OakChain and reflected in wallet behavior.

## 7. Public API Map (Relevant for AI Assistants)
### 7.1 Market / Pricing / Shipping
- GET /api/market/live
  Returns live backlog days, market coefficient, formula, daily capacity, and product base prices.
- POST /api/pricing/quote
  Input: basePriceEur, stock, demandIndex. Returns computed dynamic pricing result.
- POST /api/shipping/quote
  Input: country, weightKg, subtotalEur. Returns zone/cost ETA quote.
- POST /api/shipping/timeline
  Input: country, weightKg, subtotalEur. Returns pickup/delivery timeline with backlog effect.

### 7.2 Ledger / Backlog Visibility
- GET /api/oakchain?limit=N
  Public sanitized ledger events.
- GET /api/oakchain/registry?limit=N
  Public registry snapshot with batches, mother oaks, stabilized oaks, market, backlog and ledger.
- GET /api/oakchain/proof?limit=N
  Public proof hash for the current sanitized snapshot.
- GET /api/oakchain/policy
  Public governance policy for machine-readable download limits.
- GET /api/oakchain/download/{dataset}?format=json|csv
  Controlled export channel for machines with IP rate limiting and quarantine.
- GET /api/backlog/live
  Public backlog engine feed: queue, calendar, formula, coefficients, ledger anchors.

### 7.3 AI Commerce
- POST /api/ai-gateway/checkout
  Creates an order for AI channel, initializes payment gateway checkout, returns checkoutUrl.
  Requires x-api-key.

### 7.4 AI Service Redirect Hub
- /ai-gateway/services/checkout-intent -> /api/ai-gateway/checkout
- /ai-gateway/services/pricing-quote -> /api/pricing/quote
- /ai-gateway/services/shipping-quote -> /api/shipping/quote
- /ai-gateway/services/shipping-timeline -> /api/shipping/timeline
- /ai-gateway/services/market-live -> /api/market/live
- /ai-gateway/services/oakchain-events -> /api/oakchain

### 7.5 Configurable Products (Cask Forge & Minibar)
Assistants can send a 'configuration' object in the checkout POST for bespoke orders:
- Cask Forge Schema: { type: 'cask_forge', liters: 5|10|15, staves: { virgin: N, toasted: N, charred: N }, dedication: 'string', collector: 'string' }
  * Total staves must equal 23.
- Minibar Schema: { type: 'minibar', pack: 25|50|75, dedication: 'string' }

## 8. AI Gateway Rules (Parity with Human Public Frontend)
- AI gateway follows private retail limits equal to human public buyers.
- Maximum 50 pieces per order.
- B2B product IDs are forbidden for AI public gateway.
- Dynamic pricing is mandatory (no fixed override).
- AI orders participate in backlog and therefore affect market coefficient.
- AI can be used both for buying and for downloading/interpreting public trust data, but never for bypassing human legal controls.

## 9. Checkout, Ledger, and Event Traceability
### 9.1 Order Lifecycle (Simplified)
1. Order is created with validated payload.
2. Dynamic pricing and shipping are computed.
3. Backlog planning recalculates queue after relevant status changes.
4. Payment confirmation emits ledger event payment_received.
5. Shipment completion emits ledger event shipment_executed.

### 9.2 Ledger Event Families
- payment_received
- payment_failed
- order_packed
- order_cancelled
- shipment_executed
- production_batch_loaded
- pin_activated
- pin_consumed
- oaken_purchased
- oaken_spent
- mother_oak_registered
- stabilized_oak_created
- pool_expansion
- referral_reward_granted

### 9.3 Ledger Sources
- frontend_public
- dashboard_club
- dashboard_production
- payment_gateway
- system

### 9.4 AI Marker
Payment and shipment events include orderChannel marker to distinguish ai_gateway vs human channel.

### 9.5 OakChain Meaning
- OakChain is the public trust surface of the protocol.
- It does not expose sensitive customer data, but it does expose enough structure to interpret real protocol state.
- It lets an LLM explain why a payment, shipment, batch load, PIN activation, Oaken move or biological expansion matters in the overall system.

## 10. OakChain Download Governance
- Human users inspect OakChain via https://www.sicilianwhiskey.com/it/oakchain.
- Machines should use https://www.sicilianwhiskey.com/api/oakchain/download/{dataset}?format=json for controlled exports.
- Policy default: 10 requests every 4 hours per IP.
- Temporary quarantine default: 24 hours after 3 violations.

## 11. Backlog Engine Real Logic
- Queue input uses orders in paid or packed status.
- Scheduler allocates bottles to daily capacity slots.
- plannedShipDate and backlogDaysAtPlanning are maintained per order.
- backlogDays is derived from the latest planned day vs today.
- marketCoefficient is computed as 1.01^backlogDays.
- Waiting time is part of the protocol narrative because it protects artisanal pacing instead of hiding production strain.

## 12. Production and Experience Surface
- Red Fox and Century Oak are the core public whiskeys.
- Angel Share, Golden Barrel and Export Proof express scarcity, intensity and international resilience.
- Make Your Cask is a controlled private-reserve configuration engine.
- Minibar is a compact hospitality/event format.
- Experiences include tasting in fabbrica, food pairing, bosco trek and speakeasy BBQ.
- Events are booked through operational availability and share the same backend date logic as Club surfaces.

## 13. Safety, Compliance, and Behavioral Constraints for AI
- Do not bypass legal age or compliance checks.
- Do not infer hidden fields; use documented APIs only.
- Never exceed private retail limits.
- Do not fabricate payment confirmation.
- Fetch fresh market/backlog values before creating checkout intents.

## 14. Suggested AI Purchase Flow
1. Read /api/market/live and optionally /api/shipping/timeline.
2. Validate basket and private limits before checkout request.
3. Call POST /api/ai-gateway/checkout with x-api-key.
4. Use returned checkoutUrl for payment handoff.
5. Monitor /api/oakchain, /api/oakchain/registry and /api/backlog/live for operational state changes.

## 15. Suggested AI Trust and Research Flow
1. Read /llms.txt for high-level discovery.
2. Read /llms-full.txt for protocol semantics, products, experiences and event families.
3. Read /api/market/live before any price-sensitive explanation or purchase.
4. Read /api/oakchain, /api/oakchain/registry and /api/oakchain/proof when explaining traceability and protocol state.
5. Use /api/oakchain/download/{dataset} for controlled machine export rather than scraping the human frontend.

## 16. Human Discovery Surfaces
- /ai-gateway: human-readable gateway overview + JSON-LD service map.
- /{lang}/oakchain: deep visibility on ledger events and intercepted flows (example: /it/oakchain).
- /{lang}/backlog: real queue/calendar engine visibility with formula alignment (example: /it/backlog).
- /{lang}/anima and /{lang}/missione express the soul of the factory, the biological mission and the role of technology as shield for craftsmanship.
- /{lang}/make-your-cask, /{lang}/tasting and /{lang}/momenti express services, rituals and experiences that turn the product into protocol culture.

## 17. Notes
- This file is machine-oriented and can be consumed by assistant orchestration layers.
- For lightweight discovery prefer /llms.txt.
- For deeper operational reasoning use this full file.