Benvenuto nella Documentazione My¶

Documentazione completa per utenti e sviluppatori di My - la piattaforma di gestione centralizzata.

Cos'è My?¶

My è una piattaforma di gestione completa che fornisce:

• Autenticazione Centralizzata usando Logto come Identity Provider
• Gestione Organizzativa Gerarchica (Owner, Distributore, Rivenditore, Cliente)
• Controllo Accessi Basato su Ruoli (RBAC) con sistema a doppio ruolo
• Monitoraggio Sistemi con inventario in tempo reale e tracking heartbeat
• Gestione Utenti con email di benvenuto automatiche e funzionalità self-service

Struttura Documentazione¶

📚 Guida Utente¶

Guide complete per utenti finali e amministratori:

💻 Documentazione Sviluppatori¶

Documentazione tecnica per sviluppatori e integratori:

• API Backend - Server API REST Go con autenticazione JWT
• Servizio Collect - Servizio raccolta inventario e heartbeat
• Tool Sync - Tool CLI per sincronizzazione RBAC
• Panoramica Progetto - Documentazione completa del progetto e architettura

Guida Rapida¶

🧑 Per Utenti Finali¶

1. Accedi con le tue credenziali
2. Crea organizzazioni in base alla tua gerarchia aziendale
3. Aggiungi utenti e assegna i ruoli appropriati
4. Crea sistemi per i tuoi clienti
5. Registra sistemi per abilitare il monitoraggio

🧑‍💻 Per Sviluppatori¶

1. Clona il repository
2. Leggi la Documentazione del progetto
3. Configura il tuo ambiente di sviluppo
4. Segui la guida configurazione RBAC

Funzionalità Principali¶

🔐 Sicurezza Prima di Tutto¶

• Argon2id hashing dei secret (memory-hard, resistente GPU)
• Token Split Pattern per credenziali di sistema
• Autenticazione basata su JWT con blacklist token
• RBAC con permessi gerarchici

🏢 Gerarchia Aziendale¶

Owner (Nethesis)
    ↓
Distributori
    ↓
Rivenditori
    ↓
Clienti

Ogni livello gestisce solo le organizzazioni sottostanti.

👥 Sistema a Doppio Ruolo¶

Ruoli Organizzazione (gerarchia aziendale): - Owner, Distributore, Rivenditore, Cliente

Ruoli Utente (capacità tecniche): - Admin, Support, e altri

Permessi effettivi = Ruolo Organizzazione + Ruolo Utente

📊 Monitoraggio in Tempo Reale¶

• Tracking heartbeat ogni 5 minuti
• Raccolta inventario ogni 6 ore
• Rilevamento automatico modifiche con analisi diff
• Indicatori stato: Attivo 🟢 / Inattivo 🟡 / Sconosciuto ⚪ / Eliminato 🔴

🔄 Ciclo di Vita Sistema¶

graph LR
    A[Crea Sistema] --> B[Ricevi secret]
    B --> C[Registra Sistema]
    C --> D[Ottieni system_key]
    D --> E[Invia Inventario]
    D --> F[Invia Heartbeat]
    E --> G[Monitorato]
    F --> G

Ottenere Aiuto¶

Per Utenti¶

• Esplora le sezioni della Guida Utente
• Controlla le sezioni troubleshooting in ogni guida
• Contatta il tuo amministratore di sistema

Per Sviluppatori¶

• Leggi i README specifici dei componenti
• Consulta la documentazione API
• Rivedi la documentazione architettura in DESIGN.md
• Apri un issue su GitHub

Stack Tecnologico¶

• Backend: Go 1.24+ con framework Gin
• Database: PostgreSQL con migrazioni
• Cache: Redis per caching ad alte prestazioni
• Identity: Logto per autenticazione e RBAC
• Frontend: Vue.js 3 (vedi repository separato)

Informazioni Versione¶

Versione corrente: 0.3.0 (Pre-produzione)

Questa documentazione viene aggiornata continuamente. Ultimo aggiornamento: 2025-11-07