Appearance
Manuale BASE9
Guida all'integrazione — per referenti di progetto e partner. Bozza v0.1 · documento descrittivo, complementare all'API Reference.
Questo manuale spiega cos'è BASE9, come è organizzato e come si integra, con un linguaggio accessibile anche a chi non scrive codice. È pensato per integratori e partner: project manager, analisti e referenti che devono capire la piattaforma e pianificare un'integrazione, lasciando agli sviluppatori il dettaglio tecnico.
Due documenti, due livelli
| Documento | Risponde a | Per chi |
|---|---|---|
| Manuale BASE9 (questo) | Cosa fa e come si usa? — concetti, scenari, procedure | Referenti, partner, business |
| API Reference | Quali endpoint e quali campi? — dettaglio tecnico | Sviluppatori |
Ogni procedura di questo manuale rimanda al punto corrispondente dell'API Reference, che resta l'unica fonte tecnica autorevole.
Cos'è BASE9
BASE9 è una piattaforma API-first per il mercato dell'energia: gestisce clienti, punti di fornitura (luce e gas), contratti e offerte, rete di agenti e relativi processi. "API-first" significa che ogni funzione è disponibile come servizio: il partner può integrarla nei propri sistemi e costruirvi sopra le proprie interfacce.
Caratteristiche chiave per chi valuta un'integrazione:
- Multi-ambiente (multi-tenant): ogni partner opera in uno spazio dati isolato e dedicato.
- Coerente e prevedibile: convenzioni uniformi per risposte, errori, date e paginazione.
- Due canali d'accesso: per i sistemi (Chiave API) e per le persone (Area riservata). Vedi Accessi.
Come è organizzato questo manuale
- Concetti chiave — il vocabolario di BASE9 spiegato semplice.
- Primi passi — ambienti, indirizzi e come iniziare.
- Accessi — Chiave API e Area riservata (capitolo completo).
- Guide operative — come svolgere le attività ricorrenti.
- Casi d'uso — scenari completi dall'inizio alla fine.
- Glossario · FAQ — riferimento rapido.
Le sezioni 4–6 sono in preparazione: in questa bozza è completo il capitolo Accessi, che fa da modello per tutti gli altri.
BASE9 è costruito interamente su Amazon Web Services: infrastruttura serverless, cifratura a riposo, isolamento dei dati per cliente. Vedi l'architettura →