Ruoli e permessi
OnlyTons prevede due tipi di account e, per le organizzazioni, tre flag di capacità. Insieme determinano ciò che puoi vedere e fare. Ogni permesso è applicato lato server: l'interfaccia nasconde ciò che non puoi fare, ma le regole risiedono nell'API e quindi non possono essere aggirate.
I due tipi di account
Broker
Il broker (Alessio, più eventuali coordinatori futuri) dispone della modalità god-mode:
- Vede ogni organizzazione, offerta, richiesta e trattativa.
- Gestisce lo spazio di lavoro dell'abbinamento e crea le trattative.
- Guida ogni trattativa lungo il suo flusso (pipeline).
- Cura il catalogo dei prodotti.
- Verifica le organizzazioni e approva le certificazioni.
- Invita nuovi utenti (all'interno delle organizzazioni o altri broker).
- Vede la dashboard dei ricavi.
- Pubblica note interne sulle trattative che le organizzazioni non vedono mai.
Utente di organizzazione
Un utente di organizzazione appartiene a una sola organizzazione e agisce per suo conto. All'interno dell'organizzazione ha un ruolo:
- Titolare (Owner) — gestisce il profilo dell'organizzazione e le certificazioni.
- Membro (Member) — partecipa; un ruolo più leggero.
Ciò che un utente di organizzazione può pubblicare dipende dalle capacità dell'organizzazione (di seguito), non dal ruolo di titolare/membro.
Capacità dell'organizzazione
Ogni organizzazione ha cinque flag di capacità indipendenti, uno per ciascun tipo di operatore riconosciuto dalla piattaforma. Un'organizzazione può essere qualsiasi combinazione, ma deve averne almeno uno al momento in cui si invia per la revisione:
| Capacità | Può pubblicare | Organizzazione tipica |
|---|---|---|
| Produttore | Offerta | Un'azienda agricola con raccolti |
| Trasformatore | Offerta e richiesta | Un mulino/frantoio (compra grezzo, vende trasformato) |
| Acquirente | Richiesta | Un distributore o rivenditore |
| Trader | Offerta e richiesta | Una società di trading che rivende senza trasformare |
| Consulente | Nulla | Consulente, agronomo o tecnico — sola consultazione |
- Per pubblicare un'offerta, l'organizzazione deve essere un produttore, trasformatore o trader.
- Per pubblicare una richiesta, l'organizzazione deve essere un acquirente, trasformatore o trader.
- Un consulente non pubblica nulla. Gli account di consulenza esistono per osservare il mercato, non per operarvi, e il flag non viene mai mostrato a un altro operatore.
Il filtro di approvazione
Le capacità determinano cosa puoi pubblicare. Se tu possa pubblicare del tutto è una domanda distinta, a cui risponde lo stato di onboarding della tua organizzazione:
| Che cosa puoi fare | Visitatore | Bozza | In attesa di revisione | Approvata | Respinta | Sospesa |
|---|---|---|---|---|---|---|
Pagina iniziale e /explore | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Accedere, vedere la propria organizzazione | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Modificare profilo, prodotti, certificazioni | — | ✓ | ✓ | ✓ | ✓ | — |
| Consultare il catalogo | — | — | ✓ | ✓ | — | — |
| Pubblicare offerta / fabbisogno | — | — | — | ✓ | — | — |
| Inviare una richiesta su un annuncio | — | — | — | ✓ | — | — |
| Rispondere a una richiesta inoltrata dal portale | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Essere abbinati o entrare in una nuova trattativa | — | — | — | ✓ | — | — |
| Partecipare alle trattative già in corso | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Vedere la propria affidabilità e contestarla | — | ✓ | ✓ | ✓ | ✓ | ✓ |
La colonna Visitatore è il livello pubblico: chiunque, senza account. Mostra solo disponibilità aggregate — intervalli, mesi e aree ampie, mai un prezzo e mai un venditore. Vedi Consultazione pubblica per capire esattamente dove cade la linea. Un visitatore non è un utente registrato con meno permessi: è una vista diversa, e più grossolana, dello stesso mercato.
Due cose vanno dette chiaramente. Inviare la richiesta ti dà il catalogo: puoi consultarlo mentre il broker ti esamina, ed è questo il senso di completare il modulo. E una sospensione non lascia mai in sospeso un contratto in corso: un'organizzazione sospesa a metà trattativa mantiene pieno accesso a quella trattativa e può comunque ritirare i propri annunci.
Dettagli completi in Registrazione e approvazione.
È inoltre cosa distinta dallo stato di verifica, che è un segnale di fiducia graduato usato nell'abbinamento. «Non verificata» è uno stato del tutto ordinario per un operatore reale e attivo; «non approvata» no. Vedi Certificazioni e verifica.
Se provi a pubblicare qualcosa che la tua organizzazione non può, il server rifiuta con un messaggio chiaro ("La tua organizzazione non può pubblicare offerte…").
Visibilità delle trattative (chi vede una trattativa)
L'accesso a una trattativa non è un ruolo — dipende dall'essere parte di quella specifica trattativa. Per ogni trattativa, sei uno tra:
- Broker — vede tutto, comprese le note interne.
- Acquirente — l'organizzazione la cui richiesta ha dato origine alla trattativa. Vede la trattativa, la cronologia condivisa e la provenienza — ma non le note interne, e non i dettagli privati delle righe degli altri fornitori oltre a ciò che è condiviso.
- Fornitore — un'organizzazione che fornisce una riga. Vede la trattativa e le proprie righe. In una trattativa coperta da più produttori, un fornitore vede solo se stesso e l'acquirente — mai un altro fornitore. Vedi Riservatezza degli operatori.
Chiunque non sia parte di una trattativa semplicemente non può aprirla. Questo viene verificato a ogni lettura e scrittura di una trattativa.
I profili delle altre organizzazioni
Puoi aprire in qualsiasi momento, e per intero, il profilo della tua organizzazione. Non puoi aprire il profilo di un'altra organizzazione né sfogliare un elenco di operatori: quella vista è riservata al broker.
Un altro operatore ti raggiunge come codice operatore e area
(OP-7K3QMD · Puglia), mai come ragione sociale, e all'interno di una trattativa
come pseudonimo di trattativa ("Fornitore A"). I dati sottostanti — indirizzo,
coordinate, nome dell'organismo di controllo, numero di certificato, note degli
annunci, membri del team — non sono accessibili a nessuna controparte.
Riservatezza degli operatori spiega la regola completa.
Cosa vede ciascun ruolo — a colpo d'occhio
| Azione | Broker | Produttore | Trasformatore | Acquirente |
|---|---|---|---|---|
| Sfogliare catalogo e cronologie | ✅ | ✅ | ✅ | ✅ |
| Pubblicare offerte | ✅ | ✅ | ✅ | — |
| Pubblicare richieste | ✅ | — | ✅ | ✅ |
| Inviare una richiesta su un annuncio | ✅ | ✅ | ✅ | ✅ |
| Inoltrare una richiesta a una controparte | ✅ | — | — | — |
| Sapere a chi altro è stata inoltrata una richiesta | ✅ | — | — | — |
| Eseguire l'abbinamento | ✅ | — | — | — |
| Creare e guidare le trattative | ✅ | — | — | — |
| Vedere una trattativa di cui sei parte | ✅ | ✅ | ✅ | ✅ |
| Vedere le note interne delle trattative | ✅ | — | — | — |
| Vedere la ragione sociale di una controparte | ✅ | — | — | — |
| Vedere regione esatta o coordinate di una controparte | ✅ | — | — | — |
| Vedere organismo di controllo / numero di certificato | ✅ | — | — | — |
| Vedere indirizzi di ritiro e consegna in trattativa | ✅ | — | — | — |
| Aprire il profilo di un'altra organizzazione | ✅ | — | — | — |
| Sfogliare l'elenco degli operatori | ✅ | — | — | — |
| Vedere la propria fascia di affidabilità e come si è formata | ✅ | ✅ | ✅ | ✅ |
| Chiedere il riesame della propria fascia, o correggere un dato | — | ✅ | ✅ | ✅ |
| Vedere la fascia di affidabilità di un'altra organizzazione | ✅ | — | — | — |
| Confermare un blocco proposto, o forzare una fascia | ✅ | — | — | — |
| Verificare le organizzazioni | ✅ | — | — | — |
| Modificare il catalogo | ✅ | — | — | — |
| Dashboard dei ricavi | ✅ | — | — | — |
(Un produttore/trasformatore/acquirente vede solo le trattative di cui è parte la propria organizzazione.)
Prezzo su richiesta e mascheramento
Un'offerta può avere prezzo "su richiesta". Quel prezzo è visibile solo al broker e all'organizzazione proprietaria; ogni altra organizzazione vede "Su richiesta". Questo fa sì che la negoziazione del prezzo passi attraverso il broker anziché aggirarlo.
Nota tecnica: l'API applica tutto questo con una scala a livelli — pubblico → autenticato → qualsiasi utente in-app → utente di organizzazione → broker — più un controllo di parte per singola trattativa a ogni operazione sulla trattativa. I controlli sulle capacità e il mascheramento del prezzo avvengono nel livello dati, mai solo nell'interfaccia.