# inforkgodara/javafx-login-registration-admin-panel architecture

> Architecture diagram of the GitHub repository inforkgodara/javafx-login-registration-admin-panel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/inforkgodara/javafx-login-registration-admin-panel
- Repository: https://github.com/inforkgodara/javafx-login-registration-admin-panel

## Overview

##### Project type and purpose
- This is a JavaFX-based desktop application that provides user login, registration, notifications and an admin panel.
- It follows a lightweight MVC-style pattern: FXML views (presentation), Controllers (UI logic), a database access layer, and helper utilities.

##### File structure
- src/view: FXML files and CSS styles (HomeView.fxml, LoginView.fxml, RegisterView.fxml, MainPanelView.fxml, Page01View.fxml … Page10View.fxml + style.css, mainpanel.css).
- src/controller: one Controller class per FXML (LoginController.java, RegisterController.java, Page01Controller.java … Page10Controller.java, MainPanelController.java).
- src/database: DbConnection.java (handles JDBC connection to Oracle).
- src/helper: AlertHelper.java (utility for notifications).
- src/main: MainPanel.java (application entry point, loads initial scene).
- database/table_script.sql: schema for USERS table and any supporting tables.
- build.xml, nbproject/*: Ant scripts and NetBeans project files for build, Java WebStart packaging (JNLP), deployment.
- dist/lib: external JAR dependencies (JavaFX controls like JFoenix, ControlsFX; JDBC drivers; logging; reporting; utility libraries).

##### Extract architectural insights from the README
- Uses Java 8 + JavaFX Scene Builder; Oracle DB (connection parameters in DbConnection).
- Layers: Presentation (JavaFX + FXML + CSS), Controller (UI event handlers & navigation), Persistence (JDBC via DbConnection), Helper utilities (AlertHelper).
- Deployment via NetBeans Ant scripts, can be packaged as standalone JAR or WebStart (JNLP).

##### Final recommendations
- Essential elements: FXML views, CSS, Controllers, DbConnection, SQL scripts, external libraries, build/deploy artifacts.
- Maintain readability: group related components into larger modules when appropriate, but annotate individual pieces for precise understanding.
- The goal is a clear, accurate blueprint that maps the JavaFX desktop app’s flow from user interaction down to data persistence.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        App["MainPanel.java"]:::view
    end

    %% View Module
    subgraph "View Module"
        direction TB
        HomeView["HomeView.fxml"]:::view
        LoginView["LoginView.fxml"]:::view
        RegisterView["RegisterView.fxml"]:::view
        MainPanelView["MainPanelView.fxml"]:::view
        subgraph "Page Views"
            direction TB
            Page01View["Page01View.fxml"]:::view
            Page02View["Page02View.fxml"]:::view
            Page03View["Page03View.fxml"]:::view
            Page04View["Page04View.fxml"]:::view
            Page05View["Page05View.fxml"]:::view
            Page06View["Page06View.fxml"]:::view
            Page07View["Page07View.fxml"]:::view
            Page08View["Page08View.fxml"]:::view
            Page09View["Page09View.fxml"]:::view
            Page10View["Page10View.fxml"]:::view
        end
        styleCSS["style.css"]:::view
        mainpanelCSS["mainpanel.css"]:::view
    end

    %% Controller Module
    subgraph "Controller Module"
        direction TB
        LoginCtrl["LoginController.java"]:::controller
        RegisterCtrl["RegisterController.java"]:::controller
        MainPanelCtrl["MainPanelController.java"]:::controller
        subgraph "Page Controllers"
            direction TB
            Page01Ctrl["Page01Controller.java"]:::controller
            Page02Ctrl["Page02Controller.java"]:::controller
            Page03Ctrl["Page03Controller.java"]:::controller
            Page04Ctrl["Page04Controller.java"]:::controller
            Page05Ctrl["Page05Controller.java"]:::controller
            Page06Ctrl["Page06Controller.java"]:::controller
            Page07Ctrl["Page07Controller.java"]:::controller
            Page08Ctrl["Page08Controller.java"]:::controller
            Page09Ctrl["Page09Controller.java"]:::controller
            Page10Ctrl["Page10Controller.java"]:::controller
        end
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        DbConn["DbConnection.java"]:::data
        Schema["table_script.sql"]:::data
        OracleDB["Oracle Database"]:::db
    end

    %% Helper Module
    subgraph "Helper Module"
        Alert["AlertHelper.java"]:::helper
    end

    %% External & Packaging
    subgraph "Build & Deployment"
        direction TB
        Ant["build.xml"]:::external
        Jar["javafx-login-registration-adminpanel.jar"]:::external
        JNLP["javafx-login-registration-adminpanel.jnlp"]:::external
        Libs["dist/lib/"]:::external
    end

    %% Connections
    App -->|loads| HomeView
    App -->|loads| LoginView
    App -->|loads| RegisterView
    App -->|loads| MainPanelView
    App -->|loads| Page01View
    App -->|loads| Page02View
    App -->|loads| Page03View
    App -->|loads| Page04View
    App -->|loads| Page05View
    App -->|loads| Page06View
    App -->|loads| Page07View
    App -->|loads| Page08View
    App -->|loads| Page09View
    App -->|loads| Page10View

    HomeView -->|handled by| LoginCtrl
    LoginView -->|handled by| LoginCtrl
    RegisterView -->|handled by| RegisterCtrl
    MainPanelView -->|handled by| MainPanelCtrl
    Page01View -->|handled by| Page01Ctrl
    Page02View -->|handled by| Page02Ctrl
    Page03View -->|handled by| Page03Ctrl
    Page04View -->|handled by| Page04Ctrl
    Page05View -->|handled by| Page05Ctrl
    Page06View -->|handled by| Page06Ctrl
    Page07View -->|handled by| Page07Ctrl
    Page08View -->|handled by| Page08Ctrl
    Page09View -->|handled by| Page09Ctrl
    Page10View -->|handled by| Page10Ctrl

    LoginCtrl -->|calls| DbConn
    RegisterCtrl -->|calls| DbConn
    MainPanelCtrl -->|calls| DbConn
    Page01Ctrl -->|calls| DbConn
    Page02Ctrl -->|calls| DbConn
    Page03Ctrl -->|calls| DbConn
    Page04Ctrl -->|calls| DbConn
    Page05Ctrl -->|calls| DbConn
    Page06Ctrl -->|calls| DbConn
    Page07Ctrl -->|calls| DbConn
    Page08Ctrl -->|calls| DbConn
    Page09Ctrl -->|calls| DbConn
    Page10Ctrl -->|calls| DbConn

    LoginCtrl -->|uses| Alert
    RegisterCtrl -->|uses| Alert
    MainPanelCtrl -->|uses| Alert
    Page01Ctrl -->|uses| Alert
    Page02Ctrl -->|uses| Alert
    Page03Ctrl -->|uses| Alert
    Page04Ctrl -->|uses| Alert
    Page05Ctrl -->|uses| Alert
    Page06Ctrl -->|uses| Alert
    Page07Ctrl -->|uses| Alert
    Page08Ctrl -->|uses| Alert
    Page09Ctrl -->|uses| Alert
    Page10Ctrl -->|uses| Alert

    DbConn -->|executes script| Schema
    DbConn -->|connects to| OracleDB

    Ant -->|builds| Jar
    Ant -->|generates| JNLP
    Jar -->|includes| Libs

    %% Click Events
    click App "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/main/MainPanel.java"
    click HomeView "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/HomeView.fxml"
    click LoginView "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/LoginView.fxml"
    click RegisterView "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/RegisterView.fxml"
    click MainPanelView "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/MainPanelView.fxml"
    click Page01View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page01View.fxml"
    click Page02View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page02View.fxml"
    click Page03View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page03View.fxml"
    click Page04View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page04View.fxml"
    click Page05View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page05View.fxml"
    click Page06View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page06View.fxml"
    click Page07View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page07View.fxml"
    click Page08View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page08View.fxml"
    click Page09View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page09View.fxml"
    click Page10View "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/Page10View.fxml"
    click styleCSS "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/style.css"
    click mainpanelCSS "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/view/mainpanel.css"
    click LoginCtrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/LoginController.java"
    click RegisterCtrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/RegisterController.java"
    click MainPanelCtrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/MainPanelController.java"
    click Page01Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page01Controller.java"
    click Page02Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page02Controller.java"
    click Page03Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page03Controller.java"
    click Page04Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page04Controller.java"
    click Page05Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page05Controller.java"
    click Page06Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page06Controller.java"
    click Page07Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page07Controller.java"
    click Page08Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page08Controller.java"
    click Page09Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page09Controller.java"
    click Page10Ctrl "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/controller/Page10Controller.java"
    click DbConn "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/database/DbConnection.java"
    click Schema "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/database/table_script.sql"
    click Alert "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/src/helper/AlertHelper.java"
    click Ant "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/build.xml"
    click Jar "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/dist/javafx-login-registration-adminpanel.jar"
    click JNLP "https://github.com/inforkgodara/javafx-login-registration-admin-panel/blob/main/dist/javafx-login-registration-adminpanel.jnlp"
    click Libs "https://github.com/inforkgodara/javafx-login-registration-admin-panel/tree/main/dist/lib/"

    %% Styles
    classDef view fill:#AED6F1,stroke:#3498DB,color:#154360
    classDef controller fill:#ABEBC6,stroke:#28B463,color:#1D8348
    classDef data fill:#F9E79F,stroke:#D68910,color:#7D6608
    classDef helper fill:#FAD7A0,stroke:#D35400,color:#873600
    classDef db fill:#F5CBA7,stroke:#A04000,color:#78281F
    classDef external fill:#D7DBDD,stroke:#566573,color:#2C3E50
```
