# armybit/bankapp architecture

> Architecture diagram of the GitHub repository armybit/bankapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/armybit/bankapp
- Repository: https://github.com/armybit/bankapp

## Overview

##### Project Type and Purpose
- This is a full-stack Java web application (“Bank App”) that provides user authentication, account balance look-up, and operation history.
- It uses Jakarta EE servlets as the controller layer, JSP pages as the view layer, a DAO pattern for persistence, and a relational database (bank.sql) as the data store.

##### File Structure Analysis
- Top-level: pom.xml (Maven build), bank.sql (DDL/DML), src/main (code & web assets).
- src/main/java/com/bankapp/bank:
- dao & daoImp: interfaces + implementations for CRUD on users, accounts, operations.
- db: DatabaseConnectionManager (manages JDBC connections).
- model: POJOs for User, Account, Operation entities.
- servlet/authentification: servlets handling login, signup, dashboard, internal/external ops, commissions.
- src/main/webapp:
- JSP views under /login and /dashboard.
- web.xml for servlet mappings.

##### Key Architectural Patterns
- MVC:
- Model = model package + bank.sql schema
- View = JSP pages
- Controller = servlets
- DAO Pattern for persistence isolation.
- Single-node monolith deployed on Tomcat 10.

##### Main Components
A. Web Client (Browser)
- Interacts via HTTP/HTTPS with the Tomcat server.
B. Web Server (Tomcat 10)
- Hosts:
- Servlets (/authentification/*)
- JSPs (/login, /dashboard)
C. Controller Layer (Servlets)
- Entry points: auth.java, Signup.java, dashboard.java, Commission.java, OpsInterne.java, opsExterne.java
- Handles HTTP requests, session management, routes to views.
D. Service/Business Logic (could be thin or embedded in servlets)
- For balance retrieval, operation listing, commission calculation.
E. DAO Layer
- dao interfaces + daoImp implementations
- CRUD operations on User, Account, Operation entities.
F. Database
- MySQL/PostgreSQL (represented by bank.sql)
- Tables: users, accounts, operations, commissions

##### Relationships and Data Flows
- Browser → HTTP → Tomcat/Servlet Container
- Servlet receives request → invokes DAO via DatabaseConnectionManager → executes SQL on DB → returns model objects → forwards to JSP → HTTP response to browser.
- Bi-directional on DAO ↔ Database (queries, results).

##### Technologies and Frameworks
- Java 20, Jakarta EE Servlets, JSP, JDBC
- Tomcat 10
- Maven for build & dependency management

- Rectangles for components (Servlets, DAO, DB)
- Blue = Presentation (JSP, Servlets)
- Green = Business/DAO
- Orange = Database

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Layer 1: Client
    subgraph "Layer 1: Client"
        Browser("Web Browser"):::external
    end

    %% Layer 2: Web Server
    subgraph "Layer 2: Web Server (Tomcat 10)"
        Tomcat("Tomcat 10 Container"):::external
    end

    %% Layer 3: Presentation (Controller & View)
    subgraph "Layer 3: Presentation (Controller & View)"
        auth("auth.java (Login Servlet)"):::presentation
        signup("Signup.java (Signup Servlet)"):::presentation
        dashboard("dashboard.java (Dashboard Servlet)"):::presentation
        interne("OpsInterne.java"):::presentation
        externe("opsExterne.java"):::presentation
        commission("Commission.java"):::presentation

        loginjsp("login.jsp"):::presentation
        signupjsp("signup.jsp"):::presentation
        dashjsp("dashboard.jsp"):::presentation
        newops("New_ops.jsp"):::presentation
        opslist("ops.jsp"):::presentation
        commjsp("Commission.jsp"):::presentation
    end

    %% Layer 4: Persistence (DAO)
    subgraph "Layer 4: Persistence (DAO)"
        dbManager("DatabaseConnectionManager"):::persistence
        daoClientI("dao_Client.java"):::persistence
        daoUserI("daouser.java"):::persistence
        daoAccountI("doa_account.java"):::persistence
        daoOpI("doa_op.java"):::persistence
        daoClientImp("doa_ClientBank.java"):::persistence
        daoUserImp("Doa_user_imp.java"):::persistence
        daoAccountImp("doa_account_imp.java"):::persistence
        daoOpImp("doa_opImp.java"):::persistence
    end

    %% Layer 5: Database
    subgraph "Layer 5: Database"
        DB["bank.sql (Relational DB)"]:::database
    end

    %% Connections
    Browser -->|"HTTP Request"| Tomcat
    Tomcat -->|"Dispatch to Servlet"| auth
    Tomcat -->|"Dispatch to Servlet"| signup
    Tomcat -->|"Dispatch to Servlet"| dashboard
    Tomcat -->|"Dispatch to Servlet"| interne
    Tomcat -->|"Dispatch to Servlet"| externe
    Tomcat -->|"Dispatch to Servlet"| commission

    auth -->|"forward"| loginjsp
    signup -->|"forward"| signupjsp
    dashboard -->|"render"| dashjsp
    interne -->|"render"| newops
    externe -->|"render"| opslist
    commission -->|"render"| commjsp

    auth -->|"uses"| dbManager
    signup -->|"uses"| dbManager
    dashboard -->|"uses"| dbManager
    interne -->|"uses"| dbManager
    externe -->|"uses"| dbManager
    commission -->|"uses"| dbManager

    dbManager --> daoClientImp
    dbManager --> daoUserImp
    dbManager --> daoAccountImp
    dbManager --> daoOpImp

    daoClientImp --> daoClientI
    daoUserImp --> daoUserI
    daoAccountImp --> daoAccountI
    daoOpImp --> daoOpI

    daoClientImp <-->|"SQL Queries / Results"| DB
    daoUserImp <-->|"SQL Queries / Results"| DB
    daoAccountImp <-->|"SQL Queries / Results"| DB
    daoOpImp <-->|"SQL Queries / Results"| DB

    %% Click Events
    click bank.sql "https://github.com/armybit/bankapp/blob/master/bank.sql"
    click pom.xml "https://github.com/armybit/bankapp/blob/master/pom.xml"
    click auth "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/auth.java"
    click signup "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/Signup.java"
    click dashboard "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/dashboard.java"
    click interne "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/OpsInterne.java"
    click externe "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/opsExterne.java"
    click commission "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/servlet/authentification/Commission.java"
    click loginjsp "https://github.com/armybit/bankapp/blob/master/src/main/webapp/login/login.jsp"
    click signupjsp "https://github.com/armybit/bankapp/blob/master/src/main/webapp/login/signup.jsp"
    click dashjsp "https://github.com/armybit/bankapp/blob/master/src/main/webapp/dashboard/dashboard.jsp"
    click newops "https://github.com/armybit/bankapp/blob/master/src/main/webapp/dashboard/New_ops.jsp"
    click opslist "https://github.com/armybit/bankapp/blob/master/src/main/webapp/dashboard/ops.jsp"
    click commjsp "https://github.com/armybit/bankapp/blob/master/src/main/webapp/dashboard/Commission.jsp"
    click webxml "https://github.com/armybit/bankapp/blob/master/src/main/webapp/WEB-INF/web.xml"
    click daoClientI "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/dao/dao_Client.java"
    click daoUserI "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/dao/daouser.java"
    click daoAccountI "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/dao/doa_account.java"
    click daoOpI "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/dao/doa_op.java"
    click daoClientImp "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/daoImp/doa_ClientBank.java"
    click daoUserImp "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/daoImp/Doa_user_imp.java"
    click daoAccountImp "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/daoImp/doa_account_imp.java"
    click daoOpImp "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/daoImp/doa_opImp.java"
    click dbManager "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/db/DatabaseConnectionManager.java"
    click clientModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/ClientBank.java"
    click userModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/user.java"
    click accountModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/account.java"
    click operationModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/operation.java"
    click opsModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/ops.java"
    click commissionModel "https://github.com/armybit/bankapp/blob/master/src/main/java/com/bankapp/bank/model/CommissionModel.java"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef persistence fill:#90EE90,stroke:#333,stroke-width:1px
    classDef database fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
