Sistema completo per la gestione di annunci di compravendita sviluppato in Java con interfacce CLI e GUI
🚀 Quick Start • 📱 App macOS (DMG) • 📖 Documentazione • 💻 Screenshots • 🤝 Contribuire
Il Sistema di Gestione Bacheca Annunci è un'applicazione Java completa che implementa un marketplace digitale per annunci di acquisto e vendita. Utilizza il pattern architetturale MVC e offre sia interfaccia grafica (GUI) che da riga di comando (CLI).
| Funzionalità | Descrizione | Status |
|---|---|---|
| 🏪 Gestione Annunci | Creazione, modifica e ricerca annunci | ✅ Completato |
| 👥 Gestione Utenti | Registrazione e autenticazione utenti | ✅ Completato |
| 🖥️ Interfaccia GUI | Interfaccia grafica moderna con Swing | ✅ Completato |
| ⌨️ Interfaccia CLI | Interfaccia testuale per terminale | ✅ Completato |
| 💾 Persistenza CSV | Salvataggio e caricamento dati | ✅ Completato |
| 🔍 Ricerca Avanzata | Ricerca per parole chiave con correlazione | ✅ Completato |
| 🛡️ Validazione Dati | Sistema robusto con eccezioni personalizzate | ✅ Completato |
| 📱 App macOS (DMG) | Installazione nativa con icona personalizzata | ✅ Completato |
Basato sul documento ufficiale docs/Progetto 24-25.pdf, verifica completa dell'implementazione:
| Requisito Specifico | Richiesto | Implementato | Implementazione | Note |
|---|---|---|---|---|
| Classi Test | ✓ | ✅ | src/test/TestAnnuncioVendita.javasrc/test/TestUtente.java |
Test per classi del dominio |
| Documentazione Javadoc | ✓ | ✅ | Annotazioni complete nel codice | Documentazione API completa |
| Relazione Progetto | ✓ | ✅ | README.md dettagliato |
Scelte architetturali documentate |
| Interfaccia CLI | ✓ | ✅ | view/cli/MainCLI.java |
Menu completo con gestione eccezioni |
| Interfaccia GUI | ✓ | ✅ | view/frontend/MainGUI.java |
Swing con layout responsivo |
| Separazione UI/Logic | ✓ | ✅ | Pattern MVC implementato | View separate da Controller/Model |
| Funzionalità | Richiesto | Implementato | Classe/Metodo | Verifica |
|---|---|---|---|---|
| Gestione Utenti | ✓ | ✅ | bacheca/Utente.javacontroller/GestoreUtenti.java |
Email + Nome identificativi |
| Annunci Acquisto/Vendita | ✓ | ✅ | bacheca/AnnuncioAcquisto.javabacheca/AnnuncioVendita.java |
Ereditarietà da classe astratta |
| Parole Chiave | ✓ | ✅ | Campo List<String> paroleChiave |
Separatore virgola supportato |
| Data Scadenza Vendita | ✓ | ✅ | AnnuncioVendita.dataScadenza |
Tipo LocalDate |
| ID Annunci | ✓ | ✅ | Annuncio.id (contatore statico) |
Assegnazione automatica |
| Operazione | Richiesto | Implementato | Metodo | Interfacce |
|---|---|---|---|---|
| Inserire Parola Chiave | ✓ | ✅ | aggiungiParoleChiave(id, nuoveParole) |
CLI + GUI |
| Inserire Annuncio | ✓ | ✅ | aggiungiAnnuncio(annuncio) |
CLI + GUI |
| Lista Correlazioni Acquisto | ✓ | ✅ | cercaAnnunciVenditaCorrelati() |
Automatico in GUI |
| Rimuovere Annuncio | ✓ | ✅ | rimuoviAnnuncio(id, emailUtente) |
Solo proprietario |
| Cercare per Parole Chiave | ✓ | ✅ | cercaPerParoleChiave(paroleChiave) |
Intersezione parole |
| Ripulire Bacheca | ✓ | ✅ | pulisciBacheca() |
Rimuove annunci scaduti |
| Requisito Tecnico | Richiesto | Implementato | Implementazione | Dettagli |
|---|---|---|---|---|
| Memorizzazione File | ✓ | ✅ | salvaSuFile() / leggiDaFile() |
Formato CSV |
| Iteratore Bacheca | ✓ | ✅ | implements Iterable<Annuncio> |
For-each supportato |
| Gestione Eccezioni | ✓ | ✅ | 5 eccezioni personalizzate | No stampe per errori |
| Classi Astratte/Interfacce | ✓ | ✅ | Annuncio astratta, interfacce Gestore |
Principi OOP applicati |
| Campi Privati | ✓ | ✅ | Encapsulation completo | Getter/Setter pubblici |
| Metodi Compatti | ✓ | ✅ | Single Responsibility | Codice ben strutturato |
| Feature Extra | Descrizione | Valore Aggiunto | Implementazione |
|---|---|---|---|
| Layout Responsivo GUI | Adattamento automatico finestra | ⭐ UX moderna | CardLayout dinamico |
| Dual Mode GUI | Toggle Annunci/Utenti | ⭐ Gestione completa | Bottone switch |
| Auto-Save GUI | Salvataggio automatico | ⭐ Protezione dati | File chooser integrato |
| Correlazioni Visuali | Popup annunci correlati | ⭐ Discovery intelligente | Tabelle filtrate |
| Validazione Robusta | Regex parole chiave | ⭐ Input sicuro | Pattern validation |
📁 Project Root/
├── 📂 src/ # Codice sorgente Java
├── 📂 data/ # File CSV dati
├── 📂 docs/ # Documentazione progetto
├── 📂 lib/ # Librerie esterne (JUnit)
├── 📂 jbook/ # Utility input
└── 📄 README.md # Documentazione principale
# Verifica versione Java
java --version # Richiede Java 17+-
Clona il repository
git clone https://github.com/phantumblade/bacheca-annunci-java.git cd bacheca-annunci-java -
Compila il progetto
# Compila tutti i file nella cartella bin javac -cp ".:lib/*:jbook" -d bin src/**/*.java
-
Esegui l'applicazione
🖥️ Interfaccia Grafica (GUI)
java -cp ".:lib/*:jbook:bin" view.frontend.MainGUI⌨️ Interfaccia Testuale (CLI)
java -cp ".:lib/*:jbook:bin" view.cli.StartApp
Per utenti macOS, puoi installare l'applicazione come app nativa:
-
Scarica il DMG
# Il file DMG è disponibile in App/BachecaAnnunci-v1.0.dmg -
Installa l'app
- Apri il file
BachecaAnnunci-v1.0.dmg - Trascina
BachecaAnnunci.appnella cartellaApplications - Esegui l'app dal Launchpad o dalla cartella Applications
- Apri il file
-
Crea il DMG da linea di comando
# Vai nella cartella App cd App/ # Esegui lo script di build ./build-dmg.sh
- Compila il progetto con le ultime modifiche
- Crea un JAR eseguibile con tutte le dipendenze
- Converte l'icona PNG in formato ICNS per macOS
- Genera un App Bundle (.app) con struttura corretta
- Crea un DMG con icona personalizzata e installer
- Include un README con istruzioni di installazione
- macOS (per gli strumenti
iconutil,hdiutil,sips) - Java 17+ installato
- Xcode Command Line Tools per i tool di sviluppo
- File:
BachecaAnnunci-v1.0.dmg(~520KB) - Contenuto: App nativa macOS con icona personalizzata
- Installazione: Drag & drop nelle Applications
- Esecuzione: Doppio click sull'app installata
Il progetto segue il pattern MVC (Model-View-Controller) per una separazione chiara delle responsabilità:
📁 src/
├── 📂 bacheca/ # 🎯 MODEL - Modello dati
│ ├── 📄 Annuncio.java # Classe base astratta
│ ├── 📄 AnnuncioAcquisto.java # Annunci di acquisto
│ ├── 📄 AnnuncioVendita.java # Annunci di vendita
│ ├── 📄 Bacheca.java # Collezione annunci
│ └── 📄 Utente.java # Entità utente
├── 📂 controller/ # 🎮 CONTROLLER - Logica business
│ ├── 📄 GestoreBacheca.java # Interfaccia gestore
│ ├── 📄 GestoreBachecaImpl.java # Implementazione gestore
│ ├── 📄 GestoreUtenti.java # Interfaccia utenti
│ └── 📄 GestoreUtentiImpl.java # Implementazione utenti
├── 📂 view/ # 🖼️ VIEW - Interfacce utente
│ ├── 📂 cli/ # Interfaccia testuale
│ │ ├── 📄 MainCLI.java
│ │ └── 📄 StartApp.java
│ └── 📂 frontend/ # Interfaccia grafica
│ └── 📄 MainGUI.java
└── 📂 eccezioni/ # ⚠️ Eccezioni personalizzate
├── 📄 BachecaException.java
├── 📄 DatiNonValidiException.java
└── 📄 ...
| Tipo Annuncio | Caratteristiche | Funzionalità |
|---|---|---|
| 🛒 Acquisto | • Richiesta di acquisto • Parole chiave • Prezzo massimo |
• Correlazione automatica • Suggerimenti vendita |
| 🏪 Vendita | • Offerta di vendita • Data scadenza • Stato venduto |
• Rimozione automatica scaduti • Gestione stato |
- Registrazione: Validazione email e dati utente
- Autenticazione: Sistema di controllo accessi
- Autorizzazioni: Solo proprietari possono modificare annunci
- Formato: CSV per compatibilità e semplicità
- Caricamento: Automatico all'avvio dell'applicazione
- Salvataggio: Manuale e automatico con validazione
La GUI presenta un layout responsivo che si adatta alle dimensioni della finestra:
- Vista Compatta: Menu centralizzato con popup per visualizzazione dati
- Vista Estesa: Tabelle laterali con controlli a sinistra
- Gestione Dual-Mode: Toggle tra gestione annunci e utenti
Menu interattivo completo con:
- Navigazione numerica
- Validazione input
- Messaggi di errore informativi
- Caricamento automatico dati
- ☕ Java 17+: Linguaggio principale
- 🎨 Swing: Framework GUI nativo
- 📊 CSV: Formato dati per persistenza
- 🏗️ MVC Pattern: Separazione responsabilità
- 🔧 Factory Pattern: Creazione oggetti
⚠️ Exception Handling: Gestione errori robusta- ✅ Data Validation: Validazione dati completa
- 📚 JUnit: Framework per unit testing
- 📋 Input Utilities: Gestione input utente
- 🎯 Custom Exceptions: Eccezioni personalizzate
-
Gestione Annunci
✅ Crea nuovo annuncio (acquisto/vendita) 🔍 Cerca annunci per parole chiave ✏️ Modifica parole chiave esistenti 🗑️ Rimuovi annunci propri 🧹 Pulisci annunci scaduti -
Gestione Utenti
👤 Registra nuovo utente 🔍 Cerca utente per email 🗑️ Rimuovi utente 📊 Visualizza statistiche utenti -
Persistenza
💾 Salva bacheca su file 📂 Carica bacheca da file 🔄 Sincronizzazione automatica
-
Primo Utilizzo
- Registra utente
- Crea primi annunci
- Testa ricerca
-
Utilizzo Quotidiano
- Controlla annunci scaduti
- Aggiungi nuovi annunci
- Ricerca correlazioni
-
Manutenzione
- Backup dati
- Pulizia annunci vecchi
- Aggiornamento parole chiave
- Controlla Issues esistenti
- Crea nuovo issue con:
- Descrizione dettagliata
- Passi per riprodurre
- Screenshot se necessario
- Nuove funzionalità: Apri discussion per proposte
- Miglioramenti: Fork → Branch → Pull Request
- Documentazione: Correzioni sempre benvenute
# Setup ambiente sviluppo
git clone https://github.com/phantumblade/bacheca-annunci-java.git
cd bacheca-annunci-java
# Crea branch feature
git checkout -b feature/nome-feature
# Develop, test, commit
git commit -m "feat: aggiunta nuova funzionalità"
# Push e crea PR
git push origin feature/nome-featureQuesto progetto è distribuito sotto licenza MIT. Vedi il file LICENSE per dettagli.
Sviluppato per il corso di Paradigmi di Programmazione 2024-2025
- 📧 Email: Contatta l'autore
- 🐙 GitHub: @phantumblade
- 📚 Università: Paradigmi di Programmazione A.A. 2024-2025
⭐ Se questo progetto ti è stato utile, considera di dargli una stella! ⭐