Standard Editoriali
Classificazione, template, naming, collocazione e regole per la gestione della Knowledge Base Pasquetti.
- 1. Panoramica — Classificazione e Principi
- 2. Regole di Naming — policy
- 3. Template Pagina — reference
- 4. Regole di Collocazione — policy
- 5. Regola Dati Sensibili — policy
1. Panoramica — Classificazione e Principi
Panoramica — Classificazione e Principi
Categoria: Overview
Ultima revisione: 2026-05-26
Scopo
Definire i principi fondamentali e la classificazione dei contenuti della Knowledge Base Pasquetti.
Principi
- Bookstack = documentazione stabile. Solo contenuto riusabile, leggibile da umani.
- Coda/NocoDB = dati operativi. Dati tabellari vivi, stato corrente, automazioni.
- Tool live = task, deploy, automazioni. Non copiare in KB.
- Zero segreti in KB. Password, token, chiavi API mai in Bookstack.
- Una fonte di verità. Non duplicare dati che vivono altrove.
- Template obbligatorio. Ogni pagina segue il template standard.
Categorie contenuto
- Overview — panoramica, scopo, visione
- Runbook — procedura operativa passo-passo
- Reference — riferimento tecnico: API, comandi, endpoint
- Policy — regola, standard, convenzione
- Integration — connessione tra due sistemi
- Glossary — definizione termini di dominio
- Decision Log — decisione architetturale motivata
Link correlati
2. Regole di Naming — policy
Regole di Naming — policy
Categoria: Policy
Ultima revisione: 2026-05-26
Shelf
- Nome per area funzionale (es. Organizzazione, CRM e Business Development)
- Non creare shelf se il contenuto si risolve con un book in uno shelf esistente
- Uno shelf contiene libri omogenei per area di conoscenza
Book
- Nome autoesplicativo del corpus di pagine
- Pattern: Nome area oppure Ruolo (es. Guida CRM, Standard Editoriali)
- Evitare titoli generici come Documenti Vari o Varie
Page
- Titolo descrittivo del contenuto specifico
- Suffisso opzionale di categoria per chiarezza (es. — policy, — procedura)
- La pagina deve stare dentro il libro più specifico possibile
3. Template Pagina — reference
Template Pagina — reference
Categoria: Reference
Ultima revisione: 2026-05-26
Struttura obbligatoria
Titolo Pagina Categoria: [Overview | Runbook | Reference | Policy | Integration | Glossary | Decision Log] Shelf: [Nome shelf] Libro: [Nome libro] Ultima revisione: [YYYY-MM-DD] Owner: [Ruolo o persona] ## Scopo 1-3 frasi su cosa copre la pagina. ## Quando si usa - Caso d'uso 1 ## Fonte di verità Dichiarare dove vive il dato originale. ## Contenuto principale (Overview, procedura, riferimento, regola, ecc. in base alla categoria) ## Link correlati
Nota: Il template completo è disponibile in OpenCode: context/templates/bookstack-page.md
4. Regole di Collocazione — policy
Regole di Collocazione — policy
Categoria: Policy
Ultima revisione: 2026-05-26
Mappa contenuto → shelf
| Tipo contenuto | Shelf | Note |
|---|---|---|
| Visione, struttura, ownership | Organizzazione | Contenuto stabile fondativo |
| Procedura operativa | Shelf funzionale (CRM, Pyuty, Amministrazione) | Classificare come Runbook |
| Integrazione tra sistemi | Shelf funzionale del dominio | Classificare come Integration |
| Accessi, policy, ruoli | Amministrazione e Sicurezza | Mai dati sensibili |
| Standard, convenzioni, decisioni | Knowledge Base — Governance | Interno, per editori della KB |
Regole
- Il contenuto va nel shelf più specifico possibile
- Se un contenuto riguarda più shelf, metterlo nel principale e linkare dagli altri
- Non duplicare la stessa pagina in più shelf
5. Regola Dati Sensibili — policy
Regola Dati Sensibili — policy
Categoria: Policy
Ultima revisione: 2026-05-26
Regola assoluta
Nessun segreto in chiaro in Bookstack. Password, token API, chiavi private, certificati e URL amministrativi non protetti non vanno mai inseriti in nessuna pagina, libro o shelf.
Cosa non inserire mai
- Password di qualsiasi sistema
- Token API (Coda, NocoDB, n8n, Bookstack stesso, ecc.)
- Chiavi SSH o certificati
- URL di pannelli amministrativi non protetti
- Dati personali di clienti o utenti
- Strategie commerciali riservate
Alternative
- Usare variabili d'ambiente o vault (es. env, Coolify env vars)
- In OpenCode: reference-only (es. BOOKSTACK_API_TOKEN)
- In Bookstack: scrivere "token disponibile nel vault" oppure "vedi reference OpenCode"
Cosa fare se si trova un segreto in Bookstack
- Eliminare immediatamente il contenuto dalla pagina
- Se il segreto è statico (es. password fissa), ruotarlo
- Segnalare la violazione