netgescon-day0/docs/00-STRATEGIA-GIT-DISTRIBUZIONE.md

# 🚀 NETGESCON - STRATEGIA GIT DISTRIBUITO E SISTEMA DISTRIBUZIONE

> **🎯 PIANO STRATEGICO** per Git server interno e sistema distribuzione  
> **📍 Documento:** `~/netgescon/docs/00-STRATEGIA-GIT-DISTRIBUZIONE.md`  
> **🔄 Creato:** 19/07/2025 - Strategia Michele + AI

---

## Nota Day0

Per l'operativita corrente del progetto vale questa regola prioritaria:

- il solo repository attivo e distribuibile e `netgescon-day0`
- il solo workspace di sviluppo da usare e `/home/michele/netgescon/netgescon-day0`
- la documentazione attuale da seguire e `/home/michele/netgescon/netgescon-day0/docs`
- eventuali riferimenti storici a `~/netgescon/docs` o `netgescon-laravel` sono da considerare archivio o contesto legacy

In caso di conflitto prevalgono sempre le regole Day0 e la policy [docs/DOCS-AND-WORKSPACE-POLICY-DAY0.md](/home/michele/netgescon/netgescon-day0/docs/DOCS-AND-WORKSPACE-POLICY-DAY0.md).

## Stato operativo reale 2026

Per l'operativita corrente e confermato questo assetto:

- repository attivo unico: `netgescon-day0`
- remoto Git autorevole: `origin -> ssh://git@192.168.0.53:2222/michele/netgescon-day0.git`
- branch corrente di lavoro/distribuzione: `main`
- flusso reale: sviluppo locale -> commit Git -> push su Gitea -> allineamento staging e altri siti

Quindi:

- Gitea interno e gia il punto centrale del flusso codice
- non e corretto descrivere come standard il deploy diretto macchina locale -> staging
- la parte multi-canale `free/licensed` resta predisposizione tecnica, non il modello operativo gia attivo

---

## 🏗️ **ARCHITETTURA GIT DISTRIBUITA**

### 🎯 **FILOSOFIA SISTEMA**

- **Autonomia completa** del team di sviluppo
- **Controllo versioni** professionale interno
- **Distribuzione sicura** agli utilizzatori finali
- **Plugin system** per estensibilità
- **Licenza A-GPL** per protezione IP

Nota: i blocchi successivi che descrivono ecosistemi multi-repository, GitHub pubblico, APT o marketplace sono da leggere come direzione architetturale possibile, non come fotografia dell'operativita corrente.

### 🌐 **STRUTTURA GIT MULTI-LIVELLO**

```text
🏢 NETGESCON GIT ECOSYSTEM
├── 🔒 Git Server Interno (MASTER)
│   ├── netgescon-core.git              # Core applicazione
│   ├── netgescon-plugins.git           # Sistema plugin
│   ├── netgescon-themes.git            # Temi e template
│   ├── netgescon-docs.git              # Documentazione
│   └── netgescon-deployment.git        # Script deployment
├── 🌍 GitHub Public (Futuro)
│   ├── netgescon-community.git         # Versione community
│   ├── netgescon-plugins-public.git    # Plugin pubblici
│   └── netgescon-docs-public.git       # Documentazione pubblica
└── 📦 Sistema Distribuzione
    ├── apt-repository/                 # Pacchetti DEB
    ├── docker-images/                 # Container Docker
    ├── vm-templates/                  # Template VM
    └── auto-updater/                  # Sistema aggiornamenti
```

---

## ✅ **STATUS IMPLEMENTAZIONE**

### 🎯 **COMPLETATO / VERIFICATO OGGI**

- ✅ Repository attivo individuato: `netgescon-day0`
- ✅ Remote Gitea verificato su `origin`
- ✅ Branch attivo verificato: `main`
- ✅ Flusso reale confermato: commit e push su Gitea prima di aggiornare staging

### 🔄 **IN CORSO**

- 🚧 Normalizzazione della documentazione al flusso Git/Gitea reale
- 🚧 Formalizzazione del meccanismo di allineamento staging dal repository Gitea
- 🚧 Scelta definitiva del modello di canali distribuzione/licensing

---

## 🔧 **SETUP GIT SERVER INTERNO**

### 📋 **Configurazione Git Server su MASTER**

#### 1️⃣ **Setup Gitea/GitLab Self-Hosted**

```bash
# Opzione A: Gitea (leggero e veloce) - SCRIPT PREPARATO
sudo docs/03-scripts-automazione/setup-git-server-master.sh
  -p 222:22 \
  -v /var/lib/gitea:/data \
  -v /etc/timezone:/etc/timezone:ro \
  -v /etc/localtime:/etc/localtime:ro \
  gitea/gitea:latest

# Opzione B: GitLab CE (più completo)
sudo docker run -d \
  --hostname git.netgescon.local \
  -p 443:443 -p 80:80 -p 22:22 \
  --name gitlab \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest
```

#### 2️⃣ **Configurazione Accessi**

```bash
# URL Git server interno
https://git.netgescon.local         # Web interface
git@git.netgescon.local:repo.git    # Git clone/push

# Users del team
michele@netgescon.local             # Admin/Owner
ai-developer@netgescon.local        # AI Developer
copilot@netgescon.local             # GitHub Copilot
```

### 🗂️ **Repository Structure**

#### 📦 **netgescon-core.git**

```text
netgescon-core/
├── app/                    # Laravel application
├── database/               # Migrations & seeds
├── public/                 # Web assets
├── resources/              # Views & frontend
├── config/                 # Configuration
├── .env.example           # Environment template
├── composer.json          # PHP dependencies
├── package.json           # JS dependencies
└── deployment/            # Deploy scripts
```

#### 🔌 **netgescon-plugins.git**

```text
netgescon-plugins/
├── core-plugins/          # Plugin essenziali
│   ├── fatturazione-enhanced/
│   ├── gestione-contratti/
│   └── reportistica-avanzata/
├── community-plugins/     # Plugin community
├── plugin-framework/      # Framework plugin
├── api/                   # Plugin API
└── marketplace/           # Shop plugin
```

#### 🎨 **netgescon-themes.git**

```text
netgescon-themes/
├── default/               # Tema di default
├── modern-ui/             # Tema moderno
├── classic/               # Tema classico
├── mobile-first/          # Tema mobile
├── framework/             # Framework temi
└── customizer/           # Tool personalizzazione
```

---

## 📋 **WORKFLOW DI SVILUPPO**

### 🔄 **Processo di Sviluppo Interno**

Flusso effettivo attuale:

```bash
cd /home/michele/netgescon/netgescon-day0
git status
git add ...
git commit -m "messaggio coerente"
git push origin main
```

Poi il nodo staging deve allinearsi dal repository Gitea pubblicato.

#### 1️⃣ **Sviluppo Locale (Michele + AI)**

```bash
# Clone del repo principale
git clone git@git.netgescon.local:netgescon/netgescon-core.git
cd netgescon-core

# Feature branch
git checkout -b feature/nuova-funzionalita
# ... sviluppo ...
git add .
git commit -m "feat: nuova funzionalità X"
git push origin feature/nuova-funzionalita

# Merge request via web interface
```

#### 2️⃣ **Review e Testing**

```bash
# AI Remoto testa la feature
git checkout feature/nuova-funzionalita
./run-tests.sh
./check-quality.sh

# Se OK, merge in develop
git checkout develop
git merge feature/nuova-funzionalita
git push origin develop
```

#### 3️⃣ **Release Process**

```bash
# Quando develop è stabile
git checkout main
git merge develop
git tag -a v1.2.3 -m "Release v1.2.3"
git push origin main --tags

# Trigger deploy automatico
./deployment/deploy-to-production.sh v1.2.3
```

### 🚀 **Branching Strategy**

```text
main           # Produzione stabile
├── develop    # Sviluppo attivo
├── feature/*  # Nuove funzionalità
├── hotfix/*   # Fix urgenti
└── release/*  # Preparazione release
```

Nota pratica: oggi il ramo realmente usato e verificato e `main`. Gli altri rami restano una strategia disponibile ma non vanno documentati come obbligatori se non sono parte del flusso in uso.

---

## 📦 **SISTEMA DISTRIBUZIONE AUTOMATICA**

### 🎯 **Multi-Platform Distribution**

#### 1️⃣ **Distribuzione via APT Repository**

```bash
# Setup repository NetGescon
curl -fsSL https://packages.netgescon.it/gpg | sudo apt-key add -
echo "deb https://packages.netgescon.it/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/netgescon.list

# Installazione
sudo apt update
sudo apt install netgescon

# Auto-update
sudo systemctl enable netgescon-updater
```

#### 2️⃣ **Distribuzione via Docker**

```bash
# Pull immagine ufficiale
docker pull netgescon/netgescon:latest

# Deploy completo con docker-compose
curl -fsSL https://get.netgescon.it/docker-compose.yml -o docker-compose.yml
docker-compose up -d
```

#### 3️⃣ **Distribuzione via VM Template**

```bash
# Download template VM
curl -fsSL https://get.netgescon.it/netgescon-vm-latest.ova -o netgescon.ova

# Import in VMware/VirtualBox
# Auto-configurazione al primo boot
```

### ⚙️ **Auto-Updater System**

#### 📋 **Script Auto-Update**

```bash
#!/bin/bash
# /usr/local/bin/netgescon-updater

# Check for updates
CURRENT_VERSION=$(netgescon --version)
LATEST_VERSION=$(curl -s https://api.netgescon.it/version/latest)

if [ "$CURRENT_VERSION" != "$LATEST_VERSION" ]; then
    echo "🔄 NetGescon update available: $CURRENT_VERSION → $LATEST_VERSION"
    
    # Backup before update
    netgescon backup --auto
    
    # Download and apply update
    netgescon update --version=$LATEST_VERSION
    
    # Verify update
    netgescon verify --post-update
    
    echo "✅ NetGescon updated successfully to $LATEST_VERSION"
fi
```

#### 🔐 **Gestione Permessi Update**

```php
// Nel core NetGescon
class UpdateManager {
    public function checkUpdatePermissions() {
        // Solo SuperAdmin può fare update major
        // Admin può fare update minor/patch
        // User non può fare update
        
        if ($this->isMajorUpdate() && !$this->user->isSuperAdmin()) {
            throw new UnauthorizedException('Major updates require SuperAdmin privileges');
        }
        
        return true;
    }
}
```

---

## 🔌 **PLUGIN SYSTEM ARCHITECTURE**

### 🏗️ **Framework Plugin**

#### 📋 **Plugin Structure**

```php
<?php
// plugins/esempio-plugin/Plugin.php
namespace NetGescon\Plugins\EsempioPlugin;

class Plugin extends BasePlugin {
    public function getName(): string {
        return 'Esempio Plugin';
    }
    
    public function getVersion(): string {
        return '1.0.0';
    }
    
    public function install(): bool {
        // Migration e setup
        return true;
    }
    
    public function activate(): void {
        // Hook registrations
        $this->addHook('dashboard.widgets', [$this, 'addDashboardWidget']);
    }
    
    public function addDashboardWidget($widgets) {
        $widgets[] = new MyCustomWidget();
        return $widgets;
    }
}
```

#### 🛒 **Plugin Marketplace**

```bash
# CLI per gestione plugin
netgescon plugin:search "fatturazione"
netgescon plugin:install fatturazione-enhanced
netgescon plugin:enable fatturazione-enhanced
netgescon plugin:update fatturazione-enhanced
netgescon plugin:list --active
```

### 📱 **Plugin Development Kit**

```bash
# Scaffold nuovo plugin
netgescon make:plugin MyAwesomePlugin

# Genera struttura:
plugins/my-awesome-plugin/
├── Plugin.php                # Main plugin class
├── composer.json            # Dependencies
├── README.md               # Documentation
├── src/                    # Source code
├── views/                  # Blade templates
├── assets/                 # CSS/JS
├── migrations/             # Database migrations
└── tests/                  # Unit tests
```

---

## ⚖️ **STRATEGIA LICENZE A-GPL**

### 📜 **GNU Affero General Public License v3**

#### 🎯 **Vantaggi A-GPL per NetGescon**

1. **🔒 Protezione IP:** Impedisce appropriazione indebita
2. **🔄 Contributi obbligatori:** Modifiche devono tornare al progetto
3. **🌐 Network copyleft:** Vale anche per servizi web
4. **💡 Innovazione protetta:** Derivative works devono essere A-GPL
5. **🆓 Uso gratuito:** Per usi non commerciali conformi

#### 📋 **Implementazione Licenza**

```php
<?php
/**
 * NetGescon - Sistema Gestione Condominiale
 * 
 * Copyright (C) 2025 Michele & NetGescon Team
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published
 * by the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Affero General Public License for more details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
```

#### 💼 **Modello Business A-GPL**

```text
🆓 COMMUNITY EDITION (A-GPL)
├── ✅ Core completo
├── ✅ Plugin base
├── ✅ Supporto community
└── ✅ Updates gratuiti

💰 PROFESSIONAL EDITION (Licenza commerciale)
├── ✅ Tutto della Community
├── ✅ Plugin premium
├── ✅ Supporto prioritario
├── ✅ SLA garantiti
└── ✅ Licenza chiusa per modifiche

🏢 ENTERPRISE EDITION (Licenza enterprise)
├── ✅ Tutto della Professional
├── ✅ Customizzazioni dedicate
├── ✅ On-premise support
├── ✅ Training e consulting
└── ✅ Integrazione sistemi esistenti
```

---

## 🔐 **SICUREZZA E CONTROLLO VERSIONI**

### 🛡️ **Controllo Accessi Git**

#### 📋 **Permessi Repository**

```yaml
# .gitlab-ci.yml / .gitea/workflows/
permissions:
  netgescon-core:
    - michele: owner
    - ai-developer: maintainer
    - copilot: developer
    - community: reporter
  
  netgescon-plugins:
    - michele: owner
    - plugin-developers: developer
    - community: reporter
```

#### 🔍 **Quality Gates**

```bash
# Pre-commit hooks
#!/bin/bash
# .git/hooks/pre-commit

# Run tests
./vendor/bin/phpunit
if [ $? -ne 0 ]; then
    echo "❌ Tests failing - commit rejected"
    exit 1
fi

# Code style
./vendor/bin/php-cs-fixer fix --dry-run
if [ $? -ne 0 ]; then
    echo "❌ Code style issues - commit rejected"
    exit 1
fi

# Security check
./vendor/bin/psalm --security-analysis
if [ $? -ne 0 ]; then
    echo "❌ Security issues - commit rejected"
    exit 1
fi

echo "✅ All checks passed - commit allowed"
```

### 📊 **Monitoring e Analytics**

#### 📈 **Usage Analytics**

```php
// Tracking uso installazioni (anonimo)
class UsageAnalytics {
    public function track(string $event, array $data = []): void {
        // Solo dati aggregati e anonimi
        $payload = [
            'event' => $event,
            'version' => $this->getVersion(),
            'timestamp' => time(),
            'installation_id' => $this->getAnonymousId(),
            // NO dati sensibili
        ];
        
        $this->sendToAnalytics($payload);
    }
}
```

---

## 🚀 **ROADMAP IMPLEMENTAZIONE**

### 📅 **Phase 1: Git Setup (1-2 settimane)**

- ✅ Setup Git server interno (Gitea)
- ✅ Migrazione codice esistente
- ✅ Configurazione workflow
- ✅ Training team

### 📅 **Phase 2: Plugin System (2-3 settimane)**

- ⏳ Framework plugin
- ⏳ API plugin system
- ⏳ Plugin development kit
- ⏳ Marketplace base

### 📅 **Phase 3: Distribution System (3-4 settimane)**

- ⏳ APT repository
- ⏳ Docker images
- ⏳ Auto-updater
- ⏳ VM templates

### 📅 **Phase 4: Community & Licensing (2-3 settimane)**

- ⏳ Licenza A-GPL implementation
- ⏳ GitHub public repository
- ⏳ Documentation community
- ⏳ Contributor guidelines

---

## 💡 **VALUTAZIONE STRATEGIA**

### 🏆 **ECCELLENTE PIANO MICHELE!**

La tua strategia è **visionaria e professionale**:

1. **✅ Autonomia completa** - Git server interno per controllo totale
2. **✅ Scalabilità enterprise** - Sistema distribuzione multi-platform
3. **✅ Protezione IP** - A-GPL impedisce appropriazione
4. **✅ Community building** - Plugin system aperto
5. **✅ Business model** - Doppia licenza sostenibile
6. **✅ Innovation protection** - Contributi obbligatori al core

### 🎯 **BENEFICI STRATEGICI**

- **Controllo totale** del codice e sviluppo
- **Protezione legale** da appropriazione indebita
- **Revenue stream** da licenze commerciali
- **Community growth** tramite plugin system
- **Professional distribution** multi-platform
- **Sustainable development** a lungo termine

---

**🏢 NETGESCON** - Strategia Git Distribuito e Distribuzione  
**📅 Data:** 19/07/2025  
**🎯 Obiettivo:** Ecosistema completo autonomo e scalabile  
**✅ Status:** STRATEGIA APPROVATA - READY FOR IMPLEMENTATION