JavaBank - Java Project

📋 Descrizione Progetto

JavaBank è un sistema completo di gestione bancaria che include registrazione clienti, gestione conti correnti, operazioni di deposito e prelievo, validazione codici fiscali e generazione documenti HTML. Il sistema implementa una architettura OOP avanzata con separazione tra entity models, service layers e view rendering.

✨ Funzionalità Principali

👤 Gestione Clienti

Registrazione nuovo cliente
Generazione ID conto univoco
Raccolta dati anagrafici completi
Validazione data di nascita
Verifica codice fiscale

💰 Operazioni Bancarie

Deposito con euro e centesimi
Prelievo con controllo saldo
Visualizzazione saldo corrente
Storico operazioni
Gestione multi-cliente

🔒 Validazione Avanzata

Validazione codice fiscale italiano
Controllo formato SSN
Validazione date con LocalDate
Controllo input utente
Gestione errori robusta

📄 Generazione Documenti

Template HTML personalizzati
Rendering vista testuale
Esportazione PDF-ready
Salvataggio automatico in print/
Sistema template modulare

🏗️ Architettura del Progetto

Entity Models

BankAccount.java - Modello conto bancario con operazioni deposit/withdrawal
Client.java - Entity cliente con dati anagrafici (name, surname, dob, ssn)
Config.java - Configurazioni sistema (paese, valuta, formati)
Country.java - Enum per gestione paesi e formati locali

Service Layer

AccountService.java - Gestione collezione conti, operazioni CRUD
SsnService.java - Validazione e formattazione codici fiscali
UserInputService.java - Raccolta e validazione input utente

View Layer

BankView.java - Rendering template e menu interattivi
Template system - Template TXT e HTML per documenti

💻 Menu Interattivo

Menu Principale

1. Inserisci nuovo cliente
2. Visualizza clienti
3. Effettua deposito
4. Effettua prelievo
5. Esci dal sistema

Menu Interno (dopo selezione cliente)

1. Effettua deposito
2. Effettua prelievo
3. Visualizza saldo
4. Torna al menu principale

🔧 Algoritmi Chiave

Gestione Saldo


                deposit(euros, cents) → balance += (euros + cents/100)

                withdrawal(euros, cents) → if balance >= amount then balance -= amount

Validazione SSN

Controllo lunghezza (16 caratteri per codice fiscale IT)
Validazione formato alfanumerico
Controllo carattere di controllo
Supporto formati multipli (IT, US, etc.)

Multi-Account Management

ArrayList per collezione conti
Selezione cliente corrente
Iterazione e rendering multipli conti
Contatori e statistiche

💡 Tecnologie e Pattern

OOP Architecture: Separazione entity-service-view
LocalDate API: Gestione date moderna e sicura
Template Pattern: Sistema rendering modulare
Service Layer Pattern: Business logic centralizzata
Input Validation: Validazione robusta con retry logic
File I/O: Lettura template e scrittura documenti
Collections: ArrayList per gestione multi-account

📤 Output Generati

Account Statement TXT: Visualizzazione console con tutti i dati cliente
Account Statement HTML: Documento HTML salvato in print/[ID]_conto.html
Template System: File template/ con placeholder sostituibili
Multi-Client Export: Generazione batch documenti per tutti i clienti

📁 Package Structure


                com.generation.ba.main

                └── Main

                com.generation.ba.model.entities

                ├── BankAccount

                ├── Client

                ├── Config

                └── Country

                com.generation.ba.service

                ├── AccountService

                ├── SsnService

                └── UserInputService

                com.generation.ba.view

                └── BankView

                com.generation.library

                ├── Console

                ├── FileWriter

                ├── FileReader

                └── Template

🎓 Concetti Appresi

Advanced OOP: Multi-layer architecture con separation of concerns
Service Pattern: Gestione business logic in service layer dedicato
Data Validation: Validazione SSN/codice fiscale con algoritmi specifici
Collections Management: Gestione dinamica collezioni di oggetti
Template Engine: Sistema rendering con placeholder e sostituzione
Money Handling: Gestione corretta euro e centesimi
User Experience: Menu interattivi con flow navigazionale