Standard Editoriali
Classificazione, template, naming, collocazione e regole per la gestione della Knowledge Base Pasquetti.

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 Standard Editoriali Shelf Knowledge Base — Governance

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