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
- 2. Shelf Organizzazione — Contenuti da Creare
- 3. Shelf CRM — Contenuti da Creare
- 4. Shelf Pyuty — Contenuti da Creare
- 5. Shelf Amministrazione — Contenuti da Creare
- 6. Priorità e Tempistiche
- 7. Riferimenti Tecnici e API
1. Stato Attuale della KB
Stato Attuale della KB
Cosa è già stato creato
| Scaffale | Libro | Stato |
|---|---|---|
| Organizzazione | Visione e Struttura | 🏗 Struttura creata, contenuti da scrivere |
| Organizzazione | Strumenti e Accessi | 🏗 Struttura creata, contenuti da scrivere |
| CRM | Guida CRM | 🏗 Struttura creata, contenuti da scrivere |
| CRM | Flussi n8n | 🏗 Struttura creata, contenuti da scrivere |
| CRM | NocoDB — Database CRM | 🏗 Struttura creata, contenuti da scrivere |
| CRM | Coda — Documenti CRM | 🏗 Struttura creata, contenuti da scrivere |
| Pyuty | Guida Introduttiva Pyuty | 🏗 Struttura creata, contenuti da scrivere |
| Pyuty | Gestione Documenti Pyuty | 🏗 Struttura creata, contenuti da scrivere |
| Pyuty | Gestione Ruoli e Permessi Pyuty | 🏗 Struttura creata, contenuti da scrivere |
| Amministrazione | Repository Password | 🏗 Struttura creata, contenuti da scrivere |
| Amministrazione | Accessi Utenti | 🏗 Struttura creata, contenuti da scrivere |
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)
- Strumenti e Accessi — elenco piattaforme, URL, credenziali di riferimento
- Flussi n8n — documentare i workflow esistenti (sono già funzionanti)
- NocoDB — Database CRM — documentare le tabelle già create e popolate
- Coda — Documenti CRM — mappare i documenti Coda e le tabelle analizzate
Fase 2 — Breve termine
- Guida CRM — processi e best practice
- Repository Password — policy e procedura
- Accessi Utenti — registro e procedure
Fase 3 — Medio termine
- Visione e Struttura — organizzazione aziendale
- 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
| Endpoint | Metodo | Uso |
|---|---|---|
/api/shelves | GET | Lista scaffali |
/api/shelves | POST | Crea scaffale ({"name", "description_html"}) |
/api/shelves/{id} | PUT | Aggiorna scaffale e assegna libri con {"books": [id, ...]} |
/api/books | POST | Crea libro ({"name", "description_html"}) |
/api/books/{id} | DELETE | Elimina libro |
/api/pages | POST | Crea pagina ({"book_id", "name", "html"}) |
Autenticazione
Struttura KB attuale (ID e slug)
| Entità | ID | Slug |
|---|---|---|
| Shelf: Organizzazione | 1 | pasquetti-group-organizzazione |
| Shelf: CRM | 2 | crm-e-business-development |
| Shelf: Pyuty | 3 | pyuty-manuale-operativo |
| Shelf: Amministrazione | 4 | amministrazione-e-sicurezza |
| Shelf: Piano di Lavoro KB | 5 (o successivo) | (da determinare) |
| Book: Guida alla KB | 26 | guida-alla-knowledge-base-pasquetti |
| Book: Piano di Popolamento | (questo) | (da popolare) |
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 libroStrumenti 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-usunocodb.turbocrowd.net - Coda: token
eebe164c-6c4a-4032-834d-2923fc231f3asucoda.io/apis/v1 - Coolify: API token
3495|3R61yrioZMzrCDRLa01Mm3owmibONoLfBYoWGBl73e89bb2esucoolify.turbocrowd.net/api/v1