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 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 Authorization: Token : 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 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