How salahashraf253/banksystem works
Project Type and Purpose
• This is a full-stack desktop banking application built with JavaFX (frontend), Java (backend), and MySQL (database).
• It supports two user roles (Client and Admin), provides account operations (open/close accounts, deposit/withdraw, transfer, loan management), and integrates external services (email notifications and currency conversion).
High-Level Component Identification
a. Presentation Layer (JavaFX GUI)
• Package: com.example.GUI
• Controllers (e.g., LoginFormController, HomeController, MoneyTransferController, etc.)
• FXML views and CSS under src/main/resources/com/example/banksystem
b. Business Logic Layer
• Core domain: com.example.banksystem (Account, Transaction, Login, MainClass)
• Loan module: com.example.LoanPackage (LoanFactory, specific loan types, Iterator for requests)
• UserFactory: com.example.UserFactory (FactoryUser, Client, Staff)
• Generator: com.example.Generator (IdGenerator, PasswordGenerator)
c. Data Access Layer
• Package: com.example.dataBase
• DataBase (Singleton), DataBaseMapping, and CRUD helpers (DataBaseReader, DataBaseWriter, DataBaseUpdater)
d. External Integrations
• Email API: com.example.Api.EmailApi (AuthenticationEmail, Email, NotifierEmail)
• Currency Converter API: com.example.Api.currencyConverter (CurrencyApi, URLBuilder)
e. Notification Observer
• Package: com.example.NotificationsObserver
• Observer pattern classes (Subject, NotificationBuilder, EmailNotification, DesktopNotification, etc.)
Relationships and Data Flows
• User → GUI Controller → Business Logic
• Business Logic → Data Access Layer → MySQL (DB)
• Business Logic → External APIs (Email sending, Currency conversion)
• Business Logic publishes events to Subject → Observer classes send notifications
• Sequence: e.g., “Transfer money” use case → MoneyTransferController calls Transaction in business logic → DataBaseUpdater commits → Subject notifies observers → NotifierEmail or DesktopNotification sends update
Architectural Patterns & Design Principles
• Factory: UserFactory creates Client or Staff; LoanFactory produces different Loan types
• Singleton: DataBase class ensures single DB connection
• Observer: NotificationsObserver implements pub-sub for events
• MVC-like separation: FXML (View), Controllers (Controller), Domain classes (Model)
Technologies & Frameworks
• JavaFX for UI (FXML + Controllers)
• Java 11+ modules (module-info.java)
• JDBC/MySQL via custom DataBaseMapping
• External REST calls for currency (CurrencyApi)
• JavaMail (or custom) for email notifications
Final Checklist
• Layered view: Presentation, Business Logic, Data Access, External Services
• Annotations for applied design patterns (Factory, Singleton, Observer)