480e7eafbd
📋 Commit iniziale con: - ✅ Documentazione unificata in docs/ - ✅ Codice Laravel in netgescon-laravel/ - ✅ Script automazione in scripts/ - ✅ Configurazione sync rsync - ✅ Struttura organizzata e pulita 🔄 Versione: 2025.07.19-1644 🎯 Sistema pronto per Git distribuito
162 lines
4.9 KiB
Markdown
162 lines
4.9 KiB
Markdown
# SPECIFICHE GENERALI - NetGesCon Unified Platform
|
|
|
|
## 🎯 OBIETTIVO GENERALE
|
|
Unificare NetGesCon in un'unica piattaforma con interfaccia universale, gestione centralizzata di autenticazione, ruoli, permessi e menù, con struttura dati organizzata per utente/ruolo.
|
|
|
|
## 📋 REQUISITI FUNZIONALI PRINCIPALI
|
|
|
|
### 1. PIATTAFORMA UNIFICATA
|
|
- [x] **Layout universale unico** che si adatta dinamicamente al ruolo
|
|
- [x] **Sistema di template Bootstrap** al posto di Tailwind
|
|
- [ ] **Navigazione fluida** tra diverse sezioni senza cambio interfaccia
|
|
- [ ] **Branding consistente** su tutte le schermate
|
|
|
|
### 2. INTERFACCIA DINAMICA
|
|
- [x] **Sidebar adattiva** in base al ruolo e permessi
|
|
- [x] **Launcher bar** con accesso rapido funzioni
|
|
- [ ] **Dashboard personalizzata** per ogni tipo di utente
|
|
- [ ] **Responsive design** per desktop, tablet, mobile
|
|
|
|
### 3. GESTIONE CENTRALIZZATA
|
|
- [ ] **Database unico** per tutti i dati
|
|
- [ ] **Configurazione menù** tramite file/database
|
|
- [ ] **Gestione permessi** granulare per ogni funzione
|
|
- [ ] **Audit log** di tutte le operazioni
|
|
|
|
## 🏗️ ARCHITETTURA GENERALE
|
|
|
|
### STRUTTURA APPLICAZIONE
|
|
```
|
|
NetGesCon-Unified/
|
|
├── app/
|
|
│ ├── Models/ # Modelli dati unificati
|
|
│ ├── Controllers/ # Controller per ogni modulo
|
|
│ ├── Middleware/ # Autenticazione, ruoli, permessi
|
|
│ └── Services/ # Logica business centralizzata
|
|
├── resources/
|
|
│ ├── views/
|
|
│ │ ├── layouts/ # Layout universale
|
|
│ │ ├── components/ # Componenti riusabili
|
|
│ │ └── modules/ # Viste per ogni modulo
|
|
│ └── assets/ # Asset comuni (CSS, JS, immagini)
|
|
├── database/
|
|
│ ├── migrations/ # Schema database unificato
|
|
│ └── seeders/ # Dati iniziali e demo
|
|
├── config/
|
|
│ ├── menu.php # Configurazione menù
|
|
│ ├── permissions.php # Configurazione permessi
|
|
│ └── roles.php # Configurazione ruoli
|
|
└── docs/ # Documentazione completa
|
|
```
|
|
|
|
### MODULI PRINCIPALI
|
|
1. **Autenticazione e Sessioni**
|
|
2. **Gestione Ruoli e Permessi**
|
|
3. **Amministrazione Condominiale**
|
|
4. **Gestione Fornitori**
|
|
5. **Contabilità e Fatturazione**
|
|
6. **Comunicazioni e Documenti**
|
|
7. **Reportistica e Analisi**
|
|
8. **Configurazione Sistema**
|
|
|
|
## 📊 TIPI DI UTENTE / RUOLI
|
|
|
|
### SUPER-ADMIN
|
|
- Accesso completo a tutto il sistema
|
|
- Gestione altri admin e configurazioni globali
|
|
- Funzione impersonificazione per test
|
|
- Accesso a log sistema e audit
|
|
|
|
### AMMINISTRATORE
|
|
- Gestione completa del proprio condominio/i
|
|
- Accesso a tutte le funzioni amministrative
|
|
- Gestione condomini e fornitori
|
|
- Generazione report e documenti
|
|
|
|
### CONDOMINO
|
|
- Visualizzazione dati personali
|
|
- Consultazione spese e documenti
|
|
- Comunicazioni con amministratore
|
|
- Pagamenti online (futuro)
|
|
|
|
### FORNITORE
|
|
- Gestione preventivi e fatture
|
|
- Comunicazioni con amministratori
|
|
- Stato ordini e pagamenti
|
|
- Caricamento documenti
|
|
|
|
### COLLABORATORE
|
|
- Accesso limitato alle sezioni assegnate
|
|
- Funzioni operative specifiche
|
|
- No accesso a configurazioni
|
|
- Audit delle proprie azioni
|
|
|
|
## 🔧 TECNOLOGIE E STACK
|
|
|
|
### BACKEND
|
|
- **Framework:** Laravel 11
|
|
- **Database:** MySQL/PostgreSQL
|
|
- **Autenticazione:** Laravel Sanctum
|
|
- **API:** RESTful + GraphQL (futuro)
|
|
|
|
### FRONTEND
|
|
- **CSS Framework:** Bootstrap 5
|
|
- **Icons:** FontAwesome 6
|
|
- **JavaScript:** Vanilla JS + Alpine.js
|
|
- **Chart/Graph:** Chart.js
|
|
|
|
### DEPLOYMENT
|
|
- **Server:** Apache/Nginx
|
|
- **PHP:** 8.2+
|
|
- **Database:** MySQL 8.0+
|
|
- **Cache:** Redis (opzionale)
|
|
|
|
## 📈 ROADMAP IMPLEMENTAZIONE
|
|
|
|
### FASE 1 - BASE (ATTUALE)
|
|
- [x] Conversione layout da Tailwind a Bootstrap
|
|
- [x] Layout universale base
|
|
- [ ] Sistema autenticazione codice unico
|
|
- [ ] Gestione ruoli base
|
|
|
|
### FASE 2 - CORE
|
|
- [ ] Menù dinamici configurabili
|
|
- [ ] Interfaccia gestione permessi
|
|
- [ ] Dashboard personalizzate
|
|
- [ ] Migrazione dati completa
|
|
|
|
### FASE 3 - ADVANCED
|
|
- [ ] API per moduli esterni
|
|
- [ ] Sistema notifiche real-time
|
|
- [ ] Mobile app companion
|
|
- [ ] Integrazione servizi esterni
|
|
|
|
### FASE 4 - ENTERPRISE
|
|
- [ ] Multi-tenant architecture
|
|
- [ ] Distribuzione multi-macchina
|
|
- [ ] Backup e disaster recovery
|
|
- [ ] Performance optimization
|
|
|
|
## 🎯 KPI E METRICHE DI SUCCESSO
|
|
|
|
### PRESTAZIONI
|
|
- Tempo caricamento pagine < 2 secondi
|
|
- Disponibilità sistema > 99.5%
|
|
- Zero downtime durante aggiornamenti
|
|
|
|
### USABILITÀ
|
|
- Riduzione click per task comuni (>30%)
|
|
- Feedback utenti positivo (>4.5/5)
|
|
- Tempo formazione nuovi utenti <2 ore
|
|
|
|
### BUSINESS
|
|
- Unificazione 100% funzionalità esistenti
|
|
- Riduzione costi manutenzione (>40%)
|
|
- Facilità aggiunta nuovi moduli
|
|
|
|
---
|
|
|
|
**Ultima modifica:** $(Get-Date -Format "dd/MM/yyyy HH:mm")
|
|
**Versione:** 1.0
|
|
**Stato:** In Sviluppo
|