# 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

1. **Bookstack = documentazione stabile.** Solo contenuto riusabile, leggibile da umani.
2. **Coda/NocoDB = dati operativi.** Dati tabellari vivi, stato corrente, automazioni.
3. **Tool live = task, deploy, automazioni.** Non copiare in KB.
4. **Zero segreti in KB.** Password, token, chiavi API mai in Bookstack.
5. **Una fonte di verità.** Non duplicare dati che vivono altrove.
6. **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](/books/49)
- [Shelf Knowledge Base — Governance](/shelves/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

<table id="bkmrk-tipo-contenutoshelfn"><tr><th>Tipo contenuto</th><th>Shelf</th><th>Note</th></tr><tr><td>Visione, struttura, ownership</td><td>Organizzazione</td><td>Contenuto stabile fondativo</td></tr><tr><td>Procedura operativa</td><td>Shelf funzionale (CRM, Pyuty, Amministrazione)</td><td>Classificare come Runbook</td></tr><tr><td>Integrazione tra sistemi</td><td>Shelf funzionale del dominio</td><td>Classificare come Integration</td></tr><tr><td>Accessi, policy, ruoli</td><td>Amministrazione e Sicurezza</td><td>Mai dati sensibili</td></tr><tr><td>Standard, convenzioni, decisioni</td><td>Knowledge Base — Governance</td><td>Interno, per editori della KB</td></tr></table>

## 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

1. Eliminare immediatamente il contenuto dalla pagina
2. Se il segreto è statico (es. password fissa), ruotarlo
3. Segnalare la violazione