Concetti fondamentali

Il modello mentale alla base di OnlyTons. Comprenderlo rende ovvia ogni schermata.

Prodotto

Un prodotto è un articolo canonico nel catalogo curato dal broker — «Grano duro biologico», «Ceci», «Olio extravergine di oliva». I prodotti sono il punto di riferimento: offerte e richieste riguardano sempre un prodotto. Ogni prodotto ha una categoria (grezzo / semilavorato / lavorato) e uno schema di attributi — campi aggiuntivi (varietà, % di proteine, calibro…) che le offerte e le richieste relative a quel prodotto possono compilare. Solo il broker modifica il catalogo. Vedi Prodotti.

Offerta — una proposta di disponibilità

Un'offerta è un produttore o un trasformatore che dichiara «avrò questa quantità di questo prodotto disponibile durante questa finestra, a questo prezzo». La parola chiave è finestra: l'offerta non è merce a magazzino, ma disponibilità distribuita su un arco di date. Vedi Offerte.

Finestra di disponibilità e offerta a termine

Ogni offerta ha una finestra di disponibilità — una data di inizio e una di fine. È la primitiva a termine che distingue OnlyTons da un marketplace spot:

• Una finestra nel futuro (che inizia dopo oggi) è offerta a termine — un raccolto promesso. Viene mostrata in modo distinto ovunque (un badge «A termine», una barra a strisce sulla cronologia).
• Una finestra che comprende la data odierna è corrente.
• Una finestra interamente nel passato è scaduta.

L'attributo «a termine» è derivato dalle date, non è un flag separato — quindi non può mai diventare obsoleto. La cronologia di disponibilità di ciascun prodotto traccia ogni finestra su un asse temporale con una linea «oggi».

Richiesta — una pianificazione di ciò che ti serve

Una richiesta è un acquirente o un trasformatore che dichiara «mi serve questa quantità di questo prodotto entro questa data, con questo requisito». Può includere un inizio finestra (non propormi offerte disponibili prima di questa data), un flag richiede biologico e un elenco di schemi di certificazione richiesti. Una richiesta può anche essere ricorrente (ad es. trimestrale). Vedi Richieste.

Intermediazione (il broker al centro)

OnlyTons è intermediata dal broker per progettazione. Il broker è parte di ogni trattativa; le organizzazioni non transano direttamente tra loro. Due regole rendono tutto ciò concreto e non un semplice slogan:

• Il prezzo su richiesta è mascherato. Un prezzo di un'offerta pubblicato «su richiesta» appare come «Su richiesta» a chiunque, tranne al broker e all'organizzazione proprietaria — così un acquirente non può aggirare il broker sul prezzo.
• Le note interne restano interne. Le note private del broker su una trattativa vengono filtrate prima che l'acquirente o il fornitore vedano la cronologia.

Abbinamento

L'abbinamento è il modo in cui il broker trasforma una richiesta in una rosa di offerte candidate. È deterministico — «il motore è SQL più il broker», senza alcun machine learning. I candidati vengono individuati con regole rigide (stesso prodotto, attiva, finestra sovrapposta, filtri biologico/certificazioni) e poi classificati in base a cinque fattori trasparenti e ponderati, ciascuno con un «perché» in linguaggio semplice. Decide il broker. Vedi Abbinamento.

Aggregazione e riconciliazione

Una richiesta può essere soddisfatta da più offerte — questa è l'aggregazione. Quando il broker seleziona più produttori, OnlyTons riconcilia il totale: le quantità selezionate sono inferiori, uguali o superiori alla richiesta? Il sistema avvisa, non blocca mai — le evasioni parziali sono normali e decide il broker. Le quantità in unità diverse (kg contro tonnellate) vengono convertite; le unità incompatibili generano un avviso. Vedi Abbinamento.

Trattativa

Una trattativa è la transazione coordinata che il broker costruisce a partire da una richiesta e dalle offerte a essa abbinate. Ha un riferimento (DEAL-YYYY-NNNN), una o più righe (ogni riga = un'allocazione da una singola offerta), un flusso (pipeline) di stati, una cronologia di eventi e — una volta concordata — un valore e un compenso. Vedi Trattative.

Qualificazione biologica (il gate biologico)

Un'offerta è qualificata biologica solo se una certificazione collegata appartiene a uno schema biologico (EU Organic, Bio o Demeter), è attualmente attiva e la sua validità copre l'intera finestra di disponibilità. Questo valore viene ricalcolato dal server ogni volta che un'offerta viene salvata — la piattaforma non si fida mai semplicemente di una casella spuntata. Vedi Certificazioni e verifica.

Tracciabilità e provenienza

Una catena di tracciabilità registra in sequenza i passi che un prodotto attraversa — origine, coltivatore, raccolto, trasformazione, confezionamento, trasporto. In una trattativa consegnata, queste catene si compongono in una vista di provenienza per ciascuna riga. Vedi Tracciabilità.

Verifica e affidabilità

Le organizzazioni hanno uno stato di verifica (non verificata / in revisione / verificata), assegnato dal broker, oltre alle loro certificazioni. Le organizzazioni non verificate non vengono mai escluse in silenzio dall'abbinamento — vengono mostrate con un avviso, e decide il broker. Vedi Certificazioni e verifica.

Denaro e quantità

Prezzi e quantità sono gestiti come decimali esatti, mai come float arrotondati, così i prezzi unitari inferiori al centesimo (ad es. 0,8525 €/kg) restano precisi. Ogni importo porta con sé una valuta esplicita (EUR per impostazione predefinita). Questo è importante per chiunque debba riconciliare i valori delle trattative e i compensi.

---

Avanti: Guida introduttiva · Torna all'indice