🚀 Installazione Rapida - Gestione Soci ANCR

Metodo 1: Installazione Automatica (Consigliato)

Per una nuova installazione fresh, usa lo script automatico:

bash ./install.sh

Lo script farà automaticamente: - ✅ Creazione ambiente virtuale - ✅ Installazione dipendenze - ✅ Configurazione file .env - ✅ Inizializzazione database - ✅ Creazione utente admin - ✅ Setup sistema migrazioni

Tempo stimato: 2-3 minuti

Metodo 2: Installazione Manuale

Se preferisci il controllo manuale:

1. Ambiente Virtuale

```bash python3 -m venv venv source venv/bin/activate # macOS/Linux

oppure venv\Scripts\activate # Windows

```

2. Dipendenze Essenziali

bash pip install flask flask-sqlalchemy flask-migrate flask-login flask-mail flask-wtf wtforms werkzeug python-dotenv reportlab markdown

3. Dipendenze Opzionali (per Excel)

bash pip install pandas openpyxl

4. Configurazione

```bash cp .env.sample .env

Modifica .env con le tue impostazioni

```

5. Database

bash python -c "from app import app, db; app.app_context().push(); db.create_all()"

6. Utente Admin

bash python -c " from app import app, db from models.utente import Utente from werkzeug.security import generate_password_hash app.app_context().push() admin = Utente(username='admin', email='admin@example.com', password_hash=generate_password_hash('admin'), ruolo='admin') db.session.add(admin) db.session.commit() print('Admin creato') "

7. Avvio

bash flask run

🔐 Credenziali di Default

• Username: admin
• Password: admin
• URL: http://127.0.0.1:5000

⚠️ Note Importanti

Problemi Comuni Risolti

• Werkzeug 2.0+: Compatibilità automatica con url_parse
• Pandas: Installazione opzionale, l'app funziona senza
• Dipendenze: Solo quelle essenziali per il funzionamento base

Configurazioni Minime

Il file .env viene creato automaticamente con: - SECRET_KEY di sviluppo - Database SQLite locale - Configurazioni associazione di default

Sicurezza

• ⚠️ Cambia la password admin dopo il primo accesso
• ⚠️ In produzione, aggiorna SECRET_KEY nel file .env
• ⚠️ Configura le impostazioni email per le notifiche

🆘 Risoluzione Problemi

Errore Pandas

Se pandas non si installa: ```bash

L'app funziona comunque, solo l'export Excel sarà limitato

pip install openpyxl # Per supporto Excel base ```

Errore Werkzeug

Se hai problemi con url_parse: bash pip install werkzeug==2.3.7 # Versione compatibile

Database Locked

Se il database è bloccato: ```bash rm gest_2025.db # Rimuovi database esistente

Poi riesegui l'inizializzazione

```

📊 Funzionalità Disponibili

Dopo l'installazione avrai accesso a: - ✅ Gestione soci completa - ✅ Sistema tessere - ✅ Gestione utenti multi-ruolo - ✅ Dashboard con statistiche - ✅ Export CSV (sempre disponibile) - ✅ Export Excel (se pandas installato) - ✅ Sistema email (se configurato) - ✅ Modulo iscrizione pubblico - ✅ Calcolo codice fiscale

🔄 Aggiornamenti Futuri

Per aggiornare l'applicazione: bash git pull # Se usi git source venv/bin/activate pip install -r requirements.txt # Nuove dipendenze flask db upgrade # Aggiorna database

---

Tempo totale installazione: 2-5 minuti
Difficoltà: Principiante
Supporto: Tutte le dipendenze gestite automaticamente