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)

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: 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.

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

Usato per campagne WhatsApp (es. auguri Pasqua, comunicazioni commerciali) e per solleciti RDO. La lista contatti disponibile conta 1867 cellulari unici.

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 (7 file)

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

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

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