netgescon-day0/docs/90-UI-interfaccia-unica/GUIDA-CONDIVISIONE-WINDOWS.md

235 lines
7.3 KiB
Markdown

# 🌐 GUIDA CONDIVISIONE NETGESCON - WINDOWS
## Accesso alle cartelle di sviluppo da macchina Windows
### 📅 Creato: 28 Luglio 2025
### 🎯 Obiettivo: Condivisione cartelle di sviluppo Linux ↔ Windows
---
## 🔧 CONFIGURAZIONE COMPLETATA LINUX
### ✅ **SERVIZI ATTIVI**:
- **Samba Server**: Configurato e in esecuzione
- **IP Server Linux**: `192.168.0.200`
- **Nome NetBIOS**: `NETGESCON-DEV`
├─ Utente: michele
└─ Password: netgescon123### 📁 **CARTELLE CONDIVISE**:
1. **`netgescon-dev`**: `/home/michele/netgescon` (Cartella completa sviluppo)
2. **`netgescon-docs`**: `/home/michele/netgescon/docs` (Solo documentazione)
3. **`netgescon-production`**: `/var/www/netgescon` (Ambiente di produzione Laravel)
---
## 💻 CONNESSIONE DA WINDOWS
### 🎯 **METODO 1: Esplora File**
1. **Apri Esplora File** (Win + E)
2. **Nella barra indirizzi scrivi**:
```
\\192.168.0.200
```
OPPURE
```
\\NETGESCON-DEV
```
3. **Inserisci credenziali quando richiesto**:
- **Utente**: `michele`
- **Password**: `netgescon123`
- **☑️ Memorizza credenziali** (per accesso futuro)
### 🎯 **METODO 2: Mappa Unità di Rete**
1. **Esplora File****Questo PC**
2. **Clicca**: "Connetti unità di rete"
3. **Configurazione**:
- **Unità**: `Z:` (o altra lettera disponibile)
- **Cartella**: `\\192.168.0.200\netgescon-dev` (sviluppo) OPPURE `\\192.168.0.200\netgescon-production` (produzione)
- **☑️ Riconnetti all'accesso**
- **☑️ Connetti con credenziali diverse**
4. **Credenziali**:
- **Utente**: `michele`
- **Password**: `netgescon123`
### 🎯 **METODO 3: Prompt Comandi**
```cmd
# Connessione Sviluppo
net use Y: \\192.168.0.200\netgescon-dev /user:michele netgescon123
# Connessione Produzione
net use Z: \\192.168.0.200\netgescon-production /user:michele netgescon123
# Verifica connessioni
net use
# Disconnessione (se necessario)
net use Y: /delete
net use Z: /delete
```
---
## 📁 STRUTTURA CARTELLE ACCESSIBILI
### 🚀 **netgescon-dev** (Sviluppo - Y:\):
```
📂 netgescon-dev (Y:\)
├── 📁 docs/ ← Documentazione unificata
├── 📁 netgescon-laravel/ ← Progetto Laravel sviluppo
├── 📁 netgescon-scripts/ ← Script di gestione
├── 📁 scripts/ ← Script aggiuntivi
└── 📄 File vari...
```
### 🏭 **netgescon-production** (Produzione - Z:\):
```
📂 netgescon-production (Z:\)
├── 📁 app/ ← Codice applicazione Laravel
├── 📁 resources/ ← Views, CSS, JS, immagini
├── 📁 public/ ← File pubblici (CSS/JS compilati)
├── 📁 database/ ← Migrations, seeders
├── 📁 routes/ ← Route web, API, admin
├── 📁 config/ ← Configurazioni Laravel
├── 📄 .env ← Variabili ambiente PRODUZIONE
├── 📄 composer.json ← Dipendenze PHP
└── 📄 File Laravel...
```
### 📚 **netgescon-docs** (Solo documentazione):
```
📂 netgescon-docs
├── 📁 00-MASTER-DOCS-UNIFICATI/ ← Guide principali
├── 📁 90-UI-interfaccia-unica/ ← UI e automazione
├── 📁 05-backup-unificazione/ ← Credenziali e backup
└── 📄 Tutti i .md files...
```
---
## ⚡ WORKFLOW SVILUPPO INTEGRATO
### 🔄 **SINCRONIZZAZIONE AUTOMATICA**:
- **Modifica file Windows**: ✅ Visibili immediatamente su Linux
- **Modifica file Linux**: ✅ Visibili immediatamente su Windows
- **Compatibilità encoding**: UTF-8 su entrambi i sistemi
- **Permessi file**: Mantenuti correttamente
### 🚀 **WORKFLOW SVILUPPO → PRODUZIONE**:
```mermaid
Windows (Editor) → netgescon-dev (Y:\) → Test Linux → netgescon-production (Z:\) → Deploy Live
↓ ↓ ↓ ↓ ↓
Coding Development Local Test Production Live Site
```
### 📋 **PROCESSO DEPLOYMENT**:
1. **Sviluppo**: Modifica files su `Y:\netgescon-dev`
2. **Test Locale**: Esegui `php artisan serve` su Linux development
3. **Copy to Production**: Copia files modificati su `Z:\netgescon-production`
4. **Test Produzione**: Verifica su `http://192.168.0.200:8000`
5. **Git Commit**: Commit delle modifiche da Linux
6. **Deploy Live**: Push su repository produzione
### 💡 **MIGLIORI PRATICHE**:
1. **Editor Consigliati Windows**:
- Visual Studio Code (con estensioni Remote)
- Notepad++ (per editing veloce)
- PhpStorm (per sviluppo Laravel completo)
2. **Workflow Consigliato**:
- **Sviluppo**: Windows su `netgescon-dev` (Y:\)
- **Testing Locale**: Linux su `netgescon-dev`
- **Deploy**: Copy files to `netgescon-production` (Z:\)
- **Testing Produzione**: Linux su `/var/www/netgescon`
- **Git**: Linux (comandi terminal)
- **Documentazione**: Entrambi i sistemi
3. **File da Escludere da Sync**:
- `node_modules/` (pesanti, rigenera)
- `.git/` (usa solo da Linux)
- `vendor/` (composer install da Linux)
- `storage/logs/` (log di Laravel)
- `bootstrap/cache/` (cache Laravel)
---
## 🔧 TROUBLESHOOTING
### ❌ **PROBLEMA**: Non vedo le cartelle
**✅ SOLUZIONE**:
```cmd
# Test connettività
ping 192.168.0.200
# Verifica servizi
telnet 192.168.0.200 445
```
### ❌ **PROBLEMA**: Errore credenziali
**✅ SOLUZIONE**:
1. **Verifica utente/password**: `michele / netgescon123`
2. **Cancella credenziali memorizzate**:
- Pannello Controllo → Gestione Credenziali
- Windows → Rimuovi credenziali vecchie
3. **Riprova connessione**
### ❌ **PROBLEMA**: Cartella in sola lettura
**✅ SOLUZIONE**:
```bash
# Su Linux, verifica permessi
ls -la /home/michele/netgescon/
sudo chown -R michele:michele /home/michele/netgescon/
sudo chmod -R 755 /home/michele/netgescon/
```
### ❌ **PROBLEMA**: Performance lente
**✅ SOLUZIONE**:
1. **Escludi antivirus** dalla scansione delle cartelle di rete
2. **Disabilita indicizzazione** Windows sulle unità di rete
3. **Cache Samba**: Già ottimizzata nella configurazione
---
## 🎯 TEST RAPIDO FUNZIONAMENTO
### 1. **Test Connessione**:
- [ ] Ping verso `192.168.0.200` funziona
- [ ] Vedo cartelle `\\192.168.0.200`
- [ ] Login con `michele/netgescon` ok
### 2. **Test Lettura**:
- [ ] Apro file da cartella condivisa
- [ ] Vedo contenuto corretto
- [ ] Encoding UTF-8 mantenuto
### 3. **Test Scrittura**:
- [ ] Creo file di test da Windows
- [ ] File visibile su Linux immediatamente
- [ ] Modifiche sincronizzate in tempo reale
### 4. **Test Sviluppo**:
- [ ] Apro progetto Laravel in editor Windows
- [ ] Server Laravel parte su Linux
- [ ] Modifiche codice visibili istantaneamente
---
## 🚀 RISULTATO FINALE
### ✅ **VANTAGGI OTTENUTI**:
- **Development veloce**: Editor Windows nativi
- **Server potente**: Linux con tutte le ottimizzazioni
- **Sincronizzazione real-time**: Zero latenza
- **Backup automatico**: File sempre su entrambi i sistemi
- **Flessibilità totale**: Lavora da qualsiasi macchina
### 🎯 **WORKFLOW OTTIMALE**:
```mermaid
Windows (Editor) ←→ Linux (Server) ←→ Git Repository
↓ ↓ ↓
Sviluppo Testing Versioning
```
---
**🎉 SISTEMA PRONTO!**
**La tua cartella NetGescon è ora accessibile da Windows per uno sviluppo integrato perfetto!**