Gestione Soci ANCR

Applicazione web per la gestione dei soci dell'Associazione Nazionale Combattenti e Reduci (ANCR).

Funzionalità

• Gestione completa dei soci (aggiunta, modifica, eliminazione)
• Possibilità di eliminare soci anche se hanno tessere associate
• Gestione delle tessere associative
• Gestione degli utenti con diversi livelli di accesso (amministratore, segretario, operatore)
• Esportazione dei dati in formato CSV ed Excel (solo soci con tessere valide)
• Dashboard con statistiche
• Modulo di iscrizione pubblico accessibile senza login
• Accessibile dalla pagina di login tramite link dedicato
• Calcolo automatico del codice fiscale
• Protezione anti-spam con CAPTCHA
• Generazione automatica di immagini CAPTCHA per prevenire iscrizioni automatizzate
• Notifiche email all'amministratore per nuove richieste di iscrizione
• Configurabili tramite le impostazioni email nel file .env

Requisiti

• Python 3.8 o superiore
• Pip (gestore pacchetti Python)
• SQLite (database predefinito) o altro database supportato da SQLAlchemy

Installazione

1. Clona il repository o scarica i file

2. Crea un ambiente virtuale (consigliato)

bash python -m venv venv

1. Attiva l'ambiente virtuale

2. Su Windows:

bash venv\Scripts\activate

• Su macOS/Linux:

bash source venv/bin/activate

1. Installa le dipendenze

bash pip install -r requirements.txt

Configurazione

1. Crea un file .env nella directory principale del progetto

Puoi utilizzare il file .env.sample come template:

bash cp .env.sample .env

Quindi modifica il file .env con i tuoi valori specifici:

```env

Configurazione applicazione

SECRET_KEY=la-tua-chiave-segreta-molto-lunga-e-sicura DATABASE_URL=sqlite:///gest_2025.db

Configurazione server Flask

FLASK_RUN_HOST=0.0.0.0 FLASK_RUN_PORT=8080

Configurazione email

MAIL_SERVER=smtp.example.com MAIL_PORT=587 MAIL_USE_TLS=True MAIL_USE_SSL=False MAIL_USERNAME=tuo-indirizzo@example.com MAIL_PASSWORD=tua-password MAIL_DEFAULT_SENDER=tuo-indirizzo@example.com ADMINS=admin@example.com

Configurazioni Associazione

ASSOCIATION_FEDERATION=FEDERAZIONE POTENZA MATERA ASSOCIATION_NAME=ANCR - Sezione di Avigliano ASSOCIATION_URL=https://gestionale.ancravigliano.it/ ASSOCIATION_TITLE=Bartolo Gianturco ASSOCIATION_ADDRESS=Via Roma, 1 - 85021 Avigliano (PZ) ASSOCIATION_PHONE=+39 0971 123456 ASSOCIATION_EMAIL=info@ancravigliano.it ```

Note importanti sulla configurazione:

• Il file .env è obbligatorio per il corretto funzionamento dell'applicazione
• Utilizza il file .env.sample come punto di partenza per la configurazione
• Tutte le configurazioni dell'associazione sono ora gestite tramite variabili d'ambiente
• Per la sicurezza, il file .env non deve essere incluso nel controllo versione
• Personalizza tutti i valori secondo le tue esigenze specifiche

• I valori nel file .env.sample sono sicuri per lo sviluppo ma devono essere sostituiti in produzione

• Inizializza il database

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

1. Crea l'utente amministratore

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

Avvio dell'applicazione

bash python -m flask run

L'applicazione sarà disponibile all'indirizzo http://127.0.0.1:5000/

Accesso

Credenziali predefinite per l'amministratore:

• Username: admin
• Password: admin123

Importante: Cambiare la password dopo il primo accesso!

Struttura del progetto

• app.py: File principale dell'applicazione
• config.py: Configurazioni dell'applicazione (legge dal file .env)
• .env: File di configurazione con variabili d'ambiente
• .env.sample: Template di esempio per la configurazione
• models/: Modelli del database
• database.py: Configurazione del database
• socio.py: Modello per i soci
• tessera.py: Modello per le tessere
• utente.py: Modello per gli utenti
• codice_fiscale.py: Utility per il calcolo del codice fiscale
• templates/: Template HTML
• static/: File statici (CSS, JavaScript, immagini)
• data/: Dati dell'applicazione
• uploads/: Cartella per i file caricati

Backup del database

Per effettuare un backup del database SQLite:

bash sqlite3 app.db .dump > backup.sql

Per ripristinare il database da un backup:

bash sqlite3 app.db < backup.sql

Licenza

Questo progetto è rilasciato sotto licenza MIT.