# mehmettilhann/e-ticaret-form-uygulamasi architecture

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

- Interactive diagram: https://gitdiagram.com/mehmettilhann/e-ticaret-form-uygulamasi
- Repository: https://github.com/mehmettilhann/e-ticaret-form-uygulamasi

## Overview

##### Project Type and Purpose
- This is a standalone desktop Java e-commerce form application built with Swing (JFrame) as the UI toolkit, and MySQL as the persistent store.
- It has two primary user roles:
- Administrator: can add, delete, and update products
- Customer: can register, log in, browse products, add to cart, and complete shopping
- All data (users, products, cart items) is stored in a MySQL database.

##### File Structure
- Top-level:
- ETicaret/src – contains all Java packages
- README.md – high-level description
- ticaret_1 (1).sql – database schema script
- Inside src:
- Administrator – admin UI classes (adminmenu.java, adminpanel.java)
- client – customer UI classes (DashBoard, UrunListeleme, SepetClient, CuzdanClient, etc.), domain models (Urun, Kullanici), custom exception (HataliSifreException)
- Service – business logic layer (GirisyapServices, SepetService, UyeolService)
- dbconnet – persistence utility (DatabaseManager for JDBC connections)
- dto – data transfer objects (UrunDto, UyeolRequest)
- MainClient.java – application entry point

##### README for Additional Insights
- Confirms Swing UI + MySQL, two user flows.

##### Detail
- DTO objects as part of the interaction between Service and DatabaseManager
- Exception handling flow (e.g., HataliSifreException thrown by Service to UI)
- SQL script import at startup if applicable

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Entry Point
    MainClient["MainClient"]:::presentation

    %% Presentation Layer
    subgraph "Presentation Layer"
        AdminMenu["Admin Menu"]:::presentation
        AdminPanel["Admin Panel"]:::presentation
        DashBoard["DashBoard"]:::presentation
        UrunListeleme["UrunListeleme"]:::presentation
        SepetClient["SepetClient"]:::presentation
        CuzdanClient["CuzdanClient"]:::presentation
        BackButton["BackButton"]:::presentation
        LogOutButton["LogOutButton"]:::presentation
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        GirisyapServices["GirisyapServices"]:::business
        UyeolService["UyeolService"]:::business
        SepetService["SepetService"]:::business
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        DatabaseManager["DatabaseManager"]:::dataaccess
        UrunDto["UrunDto"]:::dataaccess
        UyeolRequest["UyeolRequest"]:::dataaccess
        SQLScript["ticaret_1 (1).sql"]:::dataaccess
    end

    %% External System
    MySQL["MySQL Database"]:::external

    %% Relationships
    MainClient -->|initializes UI| AdminMenu
    MainClient -->|initializes UI| DashBoard

    AdminMenu -->|"login() / logout()"| GirisyapServices
    AdminPanel -->|"addProduct()/updateProduct()/deleteProduct()"| DatabaseManager

    DashBoard -->|"login() / register()"| GirisyapServices
    DashBoard -->|"browseProducts()"| DatabaseManager
    DashBoard -->|"addToCart()"| SepetService
    DashBoard -->|"viewWallet()"| DatabaseManager

    SepetClient -->|"addItem()/removeItem()"| SepetService
    CuzdanClient -->|"deposit()/withdraw()"| DatabaseManager
    BackButton -->|"navigate back"| DashBoard
    LogOutButton -->|"logout()"| GirisyapServices

    GirisyapServices -->|"validate credentials / throws HataliSifreException"| DatabaseManager
    UyeolService -->|"registerUser() / UyeolRequest DTO"| DatabaseManager
    SepetService -->|"cart operations / uses UrunDto"| DatabaseManager

    DatabaseManager -->|"executeQuery()/executeUpdate()"| MySQL
    SQLScript -->|"initial schema load"| DatabaseManager

    %% Click Events
    click AdminMenu "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/Administrator/adminmenu.java"
    click AdminPanel "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/Administrator/adminpanel.java"
    click DashBoard "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/DashBoard.java"
    click UrunListeleme "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/UrunListeleme.java"
    click SepetClient "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/SepetClient.java"
    click CuzdanClient "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/CuzdanClient.java"
    click BackButton "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/BackButton.java"
    click LogOutButton "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/client/LogOutButton.java"
    click GirisyapServices "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/Service/GirisyapServices.java"
    click UyeolService "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/Service/UyeolService.java"
    click SepetService "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/Service/SepetService.java"
    click DatabaseManager "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/dbconnet/DatabaseManager.java"
    click UrunDto "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/dto/UrunDto.java"
    click UyeolRequest "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/dto/UyeolRequest.java"
    click MainClient "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ETicaret/src/MainClient.java"
    click SQLScript "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/ticaret_1 (1).sql"
    click README "https://github.com/mehmettilhann/e-ticaret-form-uygulamasi/blob/main/README.md"

    %% Styles
    classDef presentation fill:#B3D9FF,stroke:#3399FF,color:#000;
    classDef business fill:#C2F0C2,stroke:#33CC33,color:#000;
    classDef dataaccess fill:#FFD699,stroke:#FF9933,color:#000;
    classDef external fill:#E0E0E0,stroke:#999999,color:#000;
    class MainClient,AdminMenu,AdminPanel,DashBoard,UrunListeleme,SepetClient,CuzdanClient,BackButton,LogOutButton presentation
    class GirisyapServices,UyeolService,SepetService business
    class DatabaseManager,UrunDto,UyeolRequest,SQLScript dataaccess
    class MySQL external
```
