AI - MENU - AMBIENTE SISTEMISTICO MENU

🧩 DOCUMENTO 1 — Knowledge Base Sistemistica di Passepartout Menu

1. Introduzione e Architettura del Sistema

Passepartout Menu è un sistema gestionale client-server per il settore Ho.Re.Ca., basato su SQL Server e composto da diversi moduli applicativi (cassa, palmari, backoffice, kitchen, ordini, ecc.).
L’infrastruttura tipica prevede:

Server Windows con servizio “Menu Server” installato come servizio di Windows.
Database SQL Server (Express o Standard) ospitante le tabelle gestionali.
Client Windows (punti cassa e backoffice).
Dispositivi mobili (palmari o tablet Android/iOS).
Stampanti fiscali, comande Ethernet o Wi-Fi.
POS di pagamento integrati tramite gateway.
Rete gestita con switch e access point (spesso Ubiquiti UniFi).

L’intero ecosistema si basa su un’architettura multi-layer:

Database layer: SQL Server.
Service layer: Menu Server, che espone servizi per client e palmari.
Application layer: client Menu e moduli gestionali.

2. Tipologie di Installazione

Esistono tre varianti principali:

Menu (standard) – installazione completa per clienti attivi con licenza ordinaria.
Menu Plus – consente di importare database con dati antecedenti al 31 dicembre dell’anno di licenza.
Menu Uso Interno / Demo – per test e simulazioni.
- Uso interno: illimitata, senza costi.
- Demo: limitata a 500 transazioni, senza progressivi di documenti.

3. Requisiti di Sistema

Hardware

Installazione minima: CPU i3, 4 GB RAM, SSD.
Installazione standard (server con palmari e più postazioni): CPU i5 o superiore, 8 GB RAM o più, SSD.
È SQL a determinare l’uso delle risorse, non l’applicativo Menu.

Software

Sistema operativo: Windows 10 o superiore (Windows 7 non supportato).
Database: SQL Server 2019 (versione Express consigliata).
- SQL Express utilizza al massimo 4 core e 1,5 GB RAM.
- Backup 2019 → 2017 non supportato (solo versioni successive compatibili).
Framework: .NET 4.8 o superiore.
Librerie: Visual C++ Redistributable, SQL Native Client, e driver ODBC aggiornati.

4. Servizi e Componenti Principali

Servizio Menu Server

Installato come servizio Windows.
Eseguito con l’utente PassAdmin, non con “Local System”.
La cultura (locale Windows) di questo utente è standardizzata per evitare errori decimali o di formattazione numerica in reti miste (IT/EN).
Ogni installazione mantiene una cultura identica per garantire la consistenza delle query.

Servizi Secondari

LDAP Check: ogni ora verifica la validità della licenza contattando i server Passepartout.
Backup Cloud / FTP Export: gestisce salvataggi automatici e upload dei log su SmartCloud o FTP aziendale.
Live Update / Cruscotto Partner: aggiorna automaticamente le installazioni o gestisce versioni “manuali”.

5. Firewall e Sicurezza

Il firewall deve consentire:

Comunicazione TCP tra client e server sulla porta 7608 (default).
Accesso in uscita verso ldap.passpartout.sm per il controllo licenze.
Accesso in uscita verso server FTP Passepartout (per upload log/backup).
Esclusioni antivirus per le cartelle di installazione e per SQL data/log.

Utente PassAdmin:

Assegna diritti di esecuzione e login come servizio.
Imposta la cultura “it-IT” e il formato numerico standard.
Evita conflitti tra culture Windows diverse nei dispositivi connessi.

6. Backup e Ripristino

I backup automatici vengono gestiti dal servizio “Smart Cloud Backup”.
È possibile scaricarli o verificarli manualmente.
In caso di problemi:
- Eseguire il comando Export → Log Controllo Integrità per inviare solo log.
- Export Log + DB per segnalazioni complete (upload FTP automatico con numero segnalazione).

7. Licenze e Controlli LDAP

Ogni installazione effettua chiamate orarie a un server LDAP remoto per validare:

Numero di postazioni attive.
Numero di terminali abilitati.
Codice installazione e versione.

Se il controllo fallisce (firewall o DNS errato), il software può bloccarsi temporaneamente.
Il pannello Verifica Connessione LDAP consente test manuali di connessione.

8. Configurazioni Server

Il pannello “Server Menu” consente:
- Arresto/riavvio del servizio.
- Controllo delle connessioni attive.
- Accesso ai log e diagnostica.
- Clonazione del server (per ambienti di test).
È possibile creare installazioni clonate per ambienti paralleli o test su DB cliente.

9. Strumenti Partner

U-PASS

Portale per la gestione licenze, moduli e creazione nuove installazioni.
Consente la gestione di Menu, Menu Plus e Menu Demo.

Cruscotto Live Update

Controlla versioni installate e aggiorna automaticamente o manualmente i client.
Gestisce versioni measure (major release) e secondarie (bugfix).

10. Best Practice Sistemistiche

Backup regolari del database SQL e dei log.
Controllo periodico delle licenze e test LDAP.
Verifica cultura e permessi dell’utente PassAdmin.
Aggiornamenti controllati via Cruscotto Partner, evitando update in orario di esercizio.
Documentare l’ID installazione e non variarlo dopo l’emissione dei conti.
Escludere SQL e cartelle Menu da antivirus.
Gestire VLAN dedicate per dispositivi Wi-Fi (palmari) e stampanti di cucina per ridurre collisioni.

11. Diagnostica e Troubleshooting

Verifica connessione server-client: ping sulla porta 7608, controllo DNS.
Test SQL: query dirette da Management Studio.
Verifica licenza: pannello “Informazioni → Licenza”.
Controllo Log Server: esportazione e lettura file log in caso di crash.
Errore cultura / formato numerico: controllare utente PassAdmin.
Problemi di stampa: separare rete Wi-Fi (stampanti) da rete palmari.
POS pagamento: verificare gateway e firewall.

12. Sintesi Tecnica

Area	Dettaglio
DB	SQL Server 2019 Express o Standard
Servizio Windows	Menu Server (eseguito con PassAdmin)
Porte principali	7608 TCP (interna), LDAP e FTP in uscita
Backup	Locale + Smart Cloud / FTP
Firewall	Regole in entrata/uscita per Menu e SQL
Ambiente supportato	Windows 10/11, Server 2016+
Cultura standard	it-IT per tutti i dispositivi
Rete	Ethernet + Wi-Fi con VLAN dedicate
Utente di servizio	PassAdmin con login as service

Link Veloci

CONTATTI