# Piano di Popolamento KB

Piano dettagliato per il popolamento della Knowledge Base Pasquetti. Contiene lo stato attuale, i contenuti da realizzare per ogni scaffale, le priorità e i riferimenti tecnici per l'implementazione.

# 1. Stato Attuale della KB

# Stato Attuale della KB

## Cosa è già stato creato

<table id="bkmrk-scaffalelibrostatoor"><tr><th>Scaffale</th><th>Libro</th><th>Stato</th></tr><tr><td>Organizzazione</td><td>Visione e Struttura</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Organizzazione</td><td>Strumenti e Accessi</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>CRM</td><td>Guida CRM</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>CRM</td><td>Flussi n8n</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>CRM</td><td>NocoDB — Database CRM</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>CRM</td><td>Coda — Documenti CRM</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Pyuty</td><td>Guida Introduttiva Pyuty</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Pyuty</td><td>Gestione Documenti Pyuty</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Pyuty</td><td>Gestione Ruoli e Permessi Pyuty</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Amministrazione</td><td>Repository Password</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr><tr><td>Amministrazione</td><td>Accessi Utenti</td><td>🏗 Struttura creata, contenuti da scrivere</td></tr></table>

## Strumenti coinvolti

- **Coda** — Dati CRM (aziende, persone, trattative). Workspace Pasquetti Hub.
- **n8n Cloud** — Automazioni. URL: pasquettigroup.app.n8n.cloud
- **NocoDB** — Database strutturato. URL: nocodb.turbocrowd.net
- **Bookstack** — KB documentale. Sei qui.
- **Coolify** — Infrastruttura. URL: coolify.turbocrowd.net

# 2. Shelf Organizzazione — Contenuti da Creare

# Scaffale: Pasquetti Group — Organizzazione

## Visione e Struttura

Contenuti da inserire:

- Mission e visione del gruppo Pasquetti
- Organigramma: ruoli e responsabilità
- Elenco soci e stakeholder
- Struttura legale e amministrativa
- Aree di business attive

**Fonte:** da redigere con il team.

## Strumenti e Accessi

Contenuti da inserire:

- Elenco completo di tutte le piattaforme usate dal team
- URL, credenziali di riferimento e modalità di accesso
- Procedura di onboarding per nuovi membri del team
- Mappa delle integrazioni tra strumenti
- Licenze e costi

**Fonte:** da raccogliere dalle configurazioni attuali e dai tool.

**Priorità:** ALTA — necessario per l'operatività del team.

# 3. Shelf CRM — Contenuti da Creare

# Scaffale: CRM e Business Development

## Guida CRM

Contenuti da inserire:

- Panoramica del processo CRM: lead → contatto → trattativa → cliente
- Ruoli coinvolti (BD, commerciali, owner)
- Gestione aziende: creazione, aggiornamento, esito
- Gestione persone: contatti, ruoli, interazioni
- Gestione trattative e stati avanzamento
- KPI e metriche di vendita

**Fonte:** Coda (CRM Pasquetti), flussi n8n, best practice del team.

## Flussi n8n

Contenuti da inserire:

- Architettura dei workflow: Coda → NocoDB
- Workflow main: Pasquetti CRM - Coda to NocoDB v5
- Workflow test: TEST CRM Aziende - API v3
- Pattern di trasformazione dati (Code node, mapping campi)
- API NocoDB v3: formato body, endpoint, autenticazione
- Troubleshooting: errori comuni e soluzioni
- Limitazioni note (Bookstack shelf assignment, body format)

**Fonte:** workflow n8n attuali, report di debug.

## NocoDB — Database CRM

Contenuti da inserire:

- Struttura tabelle: aziende\_old, aziende\_crm, persone\_old, persone\_crm
- Schema colonne per ogni tabella
- API endpoint per CRUD
- Autenticazione con xc-token
- Query utili per analisi dati
- Relazioni tra tabelle

**Fonte:** NocoDB live, report di trasferimento dati.

## Coda — Documenti CRM

Contenuti da inserire:

- Workspace Pasquetti Hub: struttura e documenti
- Documento \[OLD\] BD e CRM (RvCgPkIMMq): scopo, tabelle, campi
- Documento CRM Pasquetti (BsnmZwATV7): scopo, tabelle, campi
- Mappatura campi Coda → NocoDB
- API Coda: token, endpoint, useColumnNames

**Fonte:** Coda live, report di analisi colonne.

**Priorità:** ALTA — il CRM è il cuore operativo.

# 4. Shelf Pyuty — Contenuti da Creare

# Scaffale: Pyuty — Manuale Operativo

## Guida Introduttiva Pyuty

Contenuti da inserire:

- Cos'è Pyuty e a cosa serve
- Accesso e primo login
- Panoramica dell'interfaccia
- Concetti base: documenti, ruoli, utenti
- Onboarding per nuovi utenti

**Fonte:** documenti Coda Pyuty, esperienza operativa.

## Gestione Documenti Pyuty

Contenuti da inserire:

- Caricamento documenti: formati supportati, dimensioni
- Visualizzazione e ricerca documenti
- Archivio e conservazione
- Categorie e tagging
- Condivisione e permessi sui documenti

**Fonte:** documenti Coda Pyuty (Gestione Documenti, Visualizza Documenti).

## Gestione Ruoli e Permessi Pyuty

Contenuti da inserire:

- Tipologie di ruoli disponibili
- Assegnazione ruoli agli utenti
- Permessi di lettura, scrittura, admin
- Flusso di approvazione
- Audit e log delle attività

**Fonte:** documenti Coda Pyuty (Gestione Ruoli, Documentazione Pyuty x Comifar).

**Priorità:** MEDIA — Pyuty è operativo ma serve documentazione utente.

# 5. Shelf Amministrazione — Contenuti da Creare

# Scaffale: Amministrazione e Sicurezza

## Repository Password

Contenuti da inserire:

- Policy di gestione password
- Elenco dei servizi con credenziali condivise
- Procedura di reset password
- Rotazione periodica delle credenziali
- Strumento utilizzato per la gestione (PW repository)

**Fonte:** documenti Coda PW Repository (ADMIN, Accesso Utenti).

## Accessi Utenti

Contenuti da inserire:

- Registro delle persone con accesso ai sistemi
- Onboarding: procedura per dare accesso a un nuovo membro
- Offboarding: procedura per rimuovere accessi
- Audit periodico degli accessi
- Strumenti di autenticazione (SSO, 2FA, password)

**Fonte:** documenti Coda PW Repository, Segnalazioni Personale ADMIN.

**Priorità:** ALTA — sicurezza e compliance.

# 6. Priorità e Tempistiche

# Priorità e Tempistiche

## Fase 1 — Immediata (da completare prima)

1. **Strumenti e Accessi** — elenco piattaforme, URL, credenziali di riferimento
2. **Flussi n8n** — documentare i workflow esistenti (sono già funzionanti)
3. **NocoDB — Database CRM** — documentare le tabelle già create e popolate
4. **Coda — Documenti CRM** — mappare i documenti Coda e le tabelle analizzate

## Fase 2 — Breve termine

1. **Guida CRM** — processi e best practice
2. **Repository Password** — policy e procedura
3. **Accessi Utenti** — registro e procedure

## Fase 3 — Medio termine

1. **Visione e Struttura** — organizzazione aziendale
2. **Pyuty — tutti i libri** — documentazione operativa completa

## Criteri di completamento

- Ogni libro deve avere almeno 1 pagina con contenuto significativo
- I riferimenti a strumenti devono includere URL e accesso
- Le procedure devono essere scritte in modo chiaro e testabili
- Le credenziali vanno sempre referenziate, mai scritte in chiaro

# 7. Riferimenti Tecnici e API

# Riferimenti Tecnici e API

Documentazione di riferimento per la scrittura della KB tramite API.

## Bookstack API

<table id="bkmrk-endpointmetodouso%2Fap"><tr><th>Endpoint</th><th>Metodo</th><th>Uso</th></tr><tr><td>`/api/shelves`</td><td>GET</td><td>Lista scaffali</td></tr><tr><td>`/api/shelves`</td><td>POST</td><td>Crea scaffale (`{"name", "description_html"}`)</td></tr><tr><td>`/api/shelves/{id}`</td><td>PUT</td><td>Aggiorna scaffale e assegna libri con `{"books": [id, ...]}`</td></tr><tr><td>`/api/books`</td><td>POST</td><td>Crea libro (`{"name", "description_html"}`)</td></tr><tr><td>`/api/books/{id}`</td><td>DELETE</td><td>Elimina libro</td></tr><tr><td>`/api/pages`</td><td>POST</td><td>Crea pagina (`{"book_id", "name", "html"}`)</td></tr></table>

## Autenticazione

`Authorization: Token <token_id>:<token_secret>`

## Struttura KB attuale (ID e slug)

<table id="bkmrk-entit%C3%A0idslugshelf%3A-o"><tr><th>Entità</th><th>ID</th><th>Slug</th></tr><tr><td>Shelf: Organizzazione</td><td>1</td><td>`pasquetti-group-organizzazione`</td></tr><tr><td>Shelf: CRM</td><td>2</td><td>`crm-e-business-development`</td></tr><tr><td>Shelf: Pyuty</td><td>3</td><td>`pyuty-manuale-operativo`</td></tr><tr><td>Shelf: Amministrazione</td><td>4</td><td>`amministrazione-e-sicurezza`</td></tr><tr><td>Shelf: Piano di Lavoro KB</td><td>5 (o successivo)</td><td>(da determinare)</td></tr><tr><td>Book: Guida alla KB</td><td>26</td><td>`guida-alla-knowledge-base-pasquetti`</td></tr><tr><td>Book: Piano di Popolamento</td><td>(questo)</td><td>(da popolare)</td></tr></table>

## Flusso di creazione contenuti

```
1. POST /api/books  -> crea libro (orifano, senza shelf)2. PUT /api/shelves/{id}  -> assegna libro allo scaffale3. POST /api/pages -> crea pagine dentro il libro
```

## Strumenti esterni da referenziare

- **n8n**: API key per Pasquetti — `pasquettigroup.app.n8n.cloud` (auth via X-N8N-API-KEY header)
- **NocoDB**: xc-token `nc_pat_nO8YYdD9jp2xQpyOjbKzC_2tOd2UNdTHUTTV2T-u` su `nocodb.turbocrowd.net`
- **Coda**: token `eebe164c-6c4a-4032-834d-2923fc231f3a` su `coda.io/apis/v1`
- **Coolify**: API token `3495|3R61yrioZMzrCDRLa01Mm3owmibONoLfBYoWGBl73e89bb2e` su `coolify.turbocrowd.net/api/v1`