Manuale VPS Gemini9

Servizi systemd

Porte Nginx Reverse Proxy

Docker Containers

File di Configurazione

• Nginx vhost: /www/server/panel/vhost/nginx/crm.gemini9.it.conf
• Paperclip Nginx: /www/server/panel/vhost/nginx/paperclip.conf
• Nginx reload: sudo /www/server/nginx/sbin/nginx -s reload

Frontend

Stile UI: Apple/macOS Ventura con font Inter, sidebar gradiente blu notte, icone Lucide SVG, glassmorphism leggero, animazioni fadeSlideIn. Colore accent #007AFF.

Backend

Database PostgreSQL

Credenziali e .env

• File: /www/wwwroot/crm.gemini9.it/.env (chmod 600, owner www)
• Caricamento: env_helper.py → load_env(), env(), db_conn_string(), get_db(), put_db()
• Nessuna credenziale hardcoded nei file Python

Dati CRM Attuali

575 clienti, 767 contatti (dopo import Google contacts del 03-04/04/2026).

CRM Vecchio (Sync)

Progetti Commerciali (aggiunto 27/05/2026)

Modulo per tracciare progetti commerciali multi-step (es. apertura centro assistenza, sviluppo rete installatori).

Task Commerciali (aggiunto 27/05/2026)

Task operativi collegati a clienti, zone o progetti. Visibili nel CRM come lista filtrabile per progetto.

L'infrastruttura MCP (Model Context Protocol) espone i dati del CRM e dei servizi come tool utilizzabili da Claude e dagli agenti Paperclip.

MCP CRM Direttore (porta 9094)

Tool disponibili (aggiornato 27/05/2026):

• Analisi: analisi_fatturato, analisi_ordine, briefing_cliente, cerca_ordini, clienti_dormienti, confronto_condizioni, previsione_ordini, promo_efficaci, riepilogo_visite, strategia_commerciale, tattiche_chiusura, top_prodotti, artiglieria, quick_check
• Task: crea_task, task_per_zona, chiudi_task
• Progetti: crea_progetto, stato_progetto, aggiorna_progetto, lista_progetti

MCP Salute (porta 9096)

16 tool: get/post uscite, body, workout, alimentazione, integratori, acqua, info, riepilogo, sync.

MCP Memory (porta 9095)

Tool: memory_read, memory_write, memory_append, memory_list, memory_search. Gestisce file memory persistenti (PROFILE, ARCHITECTURE, PROJECTS, ecc.).

MCP Operations (porta 9091)

22 tool suddivisi per area: Finance (5), Marketing (5), IT (7), Email (5). Usato dagli agenti Paperclip.

Accesso

Company

Gemini9 - Danilo Bertone
ID: aee1074a-ab88-4588-81b4-bc847d696aa8

6 Agenti

Configurazione Agenti

• API Key Anthropic configurata nel systemd service come Environment
• Heartbeat: tutti disabilitati (da attivare quando pronto)
• Skill files: ogni agente ha AGENTS.md in ~/.paperclip/instances/default/companies/{company_id}/agents/{agent_id}/instructions/
• Gli agenti usano claude_local per le operazioni (il vecchio webhook bridge su porta 9089 è stato sostituito)

Backup Paperclip

• Pre-installazione: /opt/backups/pre-paperclip/ (DB, file CRM, nginx, systemd, Docker)
• Giornaliero: file paperclip-data (~116 MB) su Google Drive

Informazioni Bot

Comandi Disponibili

Gestione Foto

• Foto senza testo: chiede [Rifornimento] o [Allegato RDO]
• Foto con didascalia “rdo ...”: avvia RDO con allegato

Integrazione Gmail

• Account: d.bertone@agenziarcm.com
• Token: /www/wwwroot/crm.gemini9.it/.gmail_token.json
• Refresh automatico con GOOGLE_CLIENT_ID/SECRET hardcodati nel bot

Configurazione

Token Refresh

Il refresh_token è permanente. L'access_token scade ogni ora e si rinnova automaticamente.

Utilizzo per Agente

Panoramica

Le RDO sono richieste d'offerta inviate all'ufficio tecnico di Stefano per ottenere preventivi dai mandanti. Possono essere create da Telegram (Lamù) o intercettate dalle email dei clienti.

Email RDO

Mandanti Disponibili (bottoni Telegram)

Vaillant, Euroacque, Resideo, Sunerg, Uponor, GF, Ici Caldaie

Flusso da Telegram (richiesta manuale)

Flusso da Email (richiesta cliente)

Tracking Stato RDO

richiesta → inviata_a_stefano → in_lavorazione → completata → inviata_al_cliente

• Sollecito WhatsApp/Telegram dopo 2 giorni lavorativi se non completata
• Verifica che l'offerta sia spedita al cliente
• Registra esito nel CRM

Database

Sezione CRM

Il frontend CRM ha una sezione dedicata RDO con: nav item nella sidebar, funzioni loadRdo() e showRdoDetail(), modale dettaglio con link “Apri in Gmail” (usa gmail_message_id salvato nel DB).

Allegati

• Da email cliente: Executive Assistant cattura e allega alla RDO
• Da Telegram: Lamù supporta foto, PDF, documenti
• Tipici: capitolati, disegni, specifiche tecniche

Configurazione

Limiti Operativi

Uso

Il bridge ha due funzioni:

1. Invio — campagne WhatsApp (es. auguri Pasqua, comunicazioni commerciali) e solleciti RDO. Lista contatti: 1867 cellulari unici.
2. Archivio conversazioni — ogni messaggio scambiato viene salvato e agganciato al CRM (vedi sotto).

Archivio conversazioni — tabella whatsapp_messaggi

Ogni messaggio viene registrato nella tabella whatsapp_messaggi (schema ppc8j1wrkypcy4m su NocoDB Postgres). Ad oggi ~19.800 messaggi archiviati dal 27/05/2026.

Aggancio automatico al CRM

Alla ricezione, il bridge cerca il numero (ultime 9 cifre) tra Cellulare/Telefono dei contatti 03_Contatti e, se lo trova, collega il messaggio a contatto e cliente. I numeri non riconosciuti restano senza aggancio finché il contatto non viene creato/aggiornato nel CRM.

Classificazione automatica (keyword, lato server)

Ogni messaggio in entrata con testo viene classificato istantaneamente per parole chiave:

Analisi chat e incrocio numeri (via Claude)

• Analisi per cliente — es. «analizza chat Climatica»: sintesi conversazione, richieste aperte, promesse fatte e non mantenute, segnali commerciali.
• Incrocio numeri ↔ CRM — confronto tra i numeri delle chat e i contatti CRM per identificare interlocutori non censiti; una volta creato/aggiornato il contatto, i messaggi storici si retro-agganciano (UPDATE su whatsapp_messaggi).
• Messaggi non pertinenti (privati/personali) vengono marcati rilevante = false con nota, per escluderli dalle analisi.

Traccar Server

Bridge Traccar-CRM (porta 9093)

Endpoints: /position, /route, /km, /nearby, /visits-today, /map-data, /health

Auto-Visite

• Script: /opt/gps_auto_visits.py
• Cron: ogni giorno alle 23:00
• Logica: soste >10 minuti entro 2500 m da un cliente = visita registrata automaticamente

Frontend GPS

File: /www/wwwroot/crm.gemini9.it/gps.html — Mappa con posizioni, percorsi e visite.

Configurazione

Bot Telegram Vecchio

OpenClaw usa un token Telegram separato (bot Lamù vecchio). Non toccare questo token.

Note Importanti

Il path /opt/lamu-fuel-bot è montato rw con permessi 777 dentro il container.

Configurazione

Peer

Home Assistant Cercepiccola

Porte Aperte sulla VPN

22, 80, 443, 8888, 15685

Google Drive

Backup ore 01:00 — /opt/backup-crm.sh (8 file)

Backup ore 03:00 — /opt/backup-openclaw.sh (1 file)

Copertura nuovi componenti (aggiornato 27/05/2026)

Backup Vault Second Brain — Architettura

Il vault vive direttamente sul VPS in /home/danilo/SecondBrain/. Il backup è identico a quello di qualsiasi altra cartella: il VPS la tara e la carica su Google Drive ogni notte. Nessuna dipendenza dal Mac, nessuna configurazione aggiuntiva.

VPS (/home/danilo/SecondBrain/)   ← vault autoritativo — già sul VPS
    │
    │  backup-crm.sh alle 01:00 (step 6b)
    ▼
/opt/backups/crm/secondbrain-YYYYMMDD.tar.gz
    │
    │  upload step 7 + 7b
    ▼
Google Drive → CRM_Backups/secondbrain-YYYYMMDD.tar.gz
               Cartella personale dbertone76@gmail.com/secondbrain-YYYYMMDD.tar.gz

Configurazione — ✅ Già attiva (27/05/2026)

Aggiunto a /opt/backup-crm.sh:

# 6b. Vault Second Brain (direttamente sul VPS — /home/danilo/SecondBrain/)
tar czf "$BACKUP_DIR/secondbrain-${TIMESTAMP}.tar.gz" /home/danilo/SecondBrain/ 2>/dev/null

# Upload in step 7 (CRM_Backups) e step 7b (cartella personale):
python3 .../drive_upload.py "$BACKUP_DIR/secondbrain-${TIMESTAMP}.tar.gz" CRM_Backups
python3 .../drive_upload.py "$BACKUP_DIR/secondbrain-${TIMESTAMP}.tar.gz" "$PERSONAL_FOLDER"
# Pulizia: coperta dal wildcard *.tar.gz in step 8 (14 giorni)

Riepilogo

Prerequisiti

Scaricare tutti i file di backup dalla cartella Google Drive VPS-Gemini → CRM_Backups (account d.bertone@agenziarcm.com).

Procedura di Ripristino Completa

# Installa Docker, Docker Compose, Node.js 20, pnpm, Python 3, pip
apt update && apt upgrade -y
apt install docker.io docker-compose nodejs npm python3 python3-pip -y
npm install -g pnpm

tar xzf configs-*.tar.gz
cp etc/wireguard/wg0.conf /etc/wireguard/
systemctl enable wg-quick@wg0 && systemctl start wg-quick@wg0

# NocoDB (PostgreSQL)
docker-compose up -d nocodb
# Traccar GPS
cd /opt/traccar && docker-compose up -d
# Wallabag
docker-compose up -d wallabag wallabag-db wallabag-redis

gunzip nocodb-sqldump-*.sql.gz
# Restore nel container Docker PostgreSQL
docker exec -i dk_nocodb-nocodb-db-1 psql -U nocodb < nocodb-sqldump-*.sql

tar xzf crm-code-*.tar.gz -C /www/wwwroot/crm.gemini9.it/
chmod 600 /www/wwwroot/crm.gemini9.it/.env
chmod 600 /www/wwwroot/crm.gemini9.it/.gmail_token.json

tar xzf opt-scripts-*.tar.gz -C /opt/

tar xzf nginx-*.tar.gz -C /www/server/panel/vhost/nginx/
sudo /www/server/nginx/sbin/nginx -s reload

tar xzf configs-*.tar.gz
# Copia i .service files in /etc/systemd/system/
systemctl daemon-reload

cd /opt && git clone [repo-paperclip] paperclip
cd paperclip && pnpm install
tar xzf paperclip-data-*.tar.gz -C ~/.paperclip/

tar xzf openclaw-*.tar.gz -C /www/dk_project/dk_app/dk_openclaw/
docker restart dk_openclaw-openclaw-gateway-1
# Ricollegare a rete NocoDB + reinstallare psycopg2

systemctl start crm-link-proxy salute-api mcp-salute mcp-crm mcp-memory \
  mcp-operations traccar-crm whatsapp-bridge paperclip lamu-bot
systemctl enable crm-link-proxy salute-api mcp-salute mcp-crm mcp-memory \
  mcp-operations traccar-crm whatsapp-bridge paperclip lamu-bot

# Scarica da Drive: VPS-Gemini → CRM_Backups → secondbrain-YYYYMMDD.tar.gz
# Ripristina sul nuovo VPS:
tar xzf secondbrain-YYYYMMDD.tar.gz -C /
# La cartella /home/danilo/SecondBrain/ è ripristinata esattamente com'era

# Verifica progetti e task (aggiunti 27/05/2026)
docker exec dk_nocodb-nocodb-db-1 psql -U nocodb -d nocodb -c \
  "SELECT count(*) FROM ppc8j1wrkypcy4m.progetti_commerciali;"
docker exec dk_nocodb-nocodb-db-1 psql -U nocodb -d nocodb -c \
  "SELECT count(*) FROM ppc8j1wrkypcy4m.task_commerciali;"

Comandi Diagnostici Utili

# Stato di tutti i servizi
systemctl status crm-link-proxy salute-api mcp-salute mcp-crm mcp-memory \
  mcp-operations traccar-crm whatsapp-bridge paperclip lamu-bot

# Log di un servizio
journalctl -u crm-link-proxy -f --no-pager -n 50

# Verifica porte in ascolto
ss -tlnp | grep -E '909[0-9]|3100|3101'

# Stato Docker
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

# Test connessione DB
docker exec dk_nocodb-nocodb-db-1 psql -U nocodb -c "SELECT count(*) FROM ppc8j1wrkypcy4m.nc_acjx___Clienti;"

# Stato WireGuard
wg show

Note Operative Generali

• Il server è in UTC — il timezone Roma viene calcolato nel codice
• Backend CRM: servizio systemd — NON killare, usare sempre systemctl restart
• Nessuna credenziale hardcoded nei file Python (tutto in .env)
• Per eseguire comandi su Gemini9 da remoto: cron job via aaPanel, aspettare 75s, leggere output, eliminare cron

Panoramica

Il Second Brain è il sistema di memoria e intelligenza operativa di Danilo, costruito su tre strati integrati che si completano senza sovrapporsi.

Struttura Vault (~/SecondBrain/)

Integrazione Vault ↔ CRM

Il vault e il CRM si sincronizzano attraverso Claude + MCP, non attraverso copia diretta di dati.

Comandi di Sessione

Regole Aggiornamento Schede Cliente

Comportamento Automatico di Claude

Durante qualsiasi conversazione, senza essere esplicitamente chiesto:

• Se viene menzionato un cliente → controlla se esiste la scheda vault, propone la creazione se mancante
• Se viene presa una decisione → append in Libreria/decisioni.md con data, contesto e rationale
• Se emerge un progetto commerciale multi-step → crea pagina Wiki/Progetti/ + record CRM + task
• Se emerge un aggiornamento su progetto esistente → aggiorna pagina vault + chiama aggiorna_progetto()
• Se emerge un prossimo step con scadenza → lo evidenzia e propone di aggiungerlo al calendario
• Se una nuova informazione contraddice una pagina wiki → segnala la contraddizione, non aggiorna silenziosamente

Riferimenti Tecnici