# dplearncs/e-commerce-application architecture

> Architecture diagram of the GitHub repository dplearncs/e-commerce-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dplearncs/e-commerce-application
- Repository: https://github.com/dplearncs/e-commerce-application

## Overview

##### Project type and purpose
- This is a console-based, monolithic E-commerce application written in Java.
- It simulates basic user and product management with file-based persistence and input validation, following OOP principles.

##### File structure
- Top-level “src” folder contains 5 packages:
- inputValidator (InputValidator.java, ReturnValues.java)
- main (Main.java)
- models (User, Admin, Customer, Product)
- services (ECommerceApp.java, UserService.java, ProductService.java)
- storage (FileService.java)
- No external web or database services—persistence is via Java I/O to flat files.
- The entry point is Main.java, which drives console I/O.

##### README
- Confirms core features: user auth, product CRUD, order placement, order history.
- Emphasizes file-based storage and input validation.

a. Main components
- Presentation Layer – Main.java (console UI)
- Input Validation – InputValidator, ReturnValues
- Service Layer – ECommerceApp orchestrator, UserService, ProductService
- Data Model – domain objects in models package
- Persistence Layer – FileService (file I/O)
b. Relationships & interactions
1. Main → ECommerceApp.run() to start the app loop
2. Main reads user commands, delegates to InputValidator
3. Validated input → ECommerceApp routes to UserService or ProductService
4. Services ←→ models (create, update domain objects)
5. Services → FileService for save/load operations
6. FileService reads/writes domain data to disk
c. Architectural patterns & principles
- Layered architecture (Presentation → Validation → Services → Persistence)
- Single Responsibility per package/class
- Dependency direction: higher layers depend on lower ones, not vice versa
d. Key technologies
- Java core libraries
- java.io for FileService
- OOP classes for models and services

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        Main["Console UI (Main)"]:::presentation
    end

    %% Validation Layer
    subgraph "Validation Layer"
        InputValidator["InputValidator"]:::validation
        ReturnValues["ReturnValues"]:::validation
    end

    %% Service Layer
    subgraph "Service Layer"
        ECommerceApp["ECommerceApp"]:::services
        UserService["UserService"]:::services
        ProductService["ProductService"]:::services
    end

    %% Data Model
    subgraph "Data Model"
        User["User"]:::models
        Admin["Admin"]:::models
        Customer["Customer"]:::models
        Product["Product"]:::models
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        FileService[("FileService\n(.txt/.csv)")]:::persistence
    end

    %% Connections
    Main -->|"readInput()"| InputValidator
    InputValidator -->|"validate()"| ReturnValues
    ReturnValues -->|"validInput()"| ECommerceApp
    ECommerceApp -->|"userOperation()"| UserService
    ECommerceApp -->|"productOperation()"| ProductService
    UserService -->|"uses"| User
    UserService -->|"uses"| Admin
    UserService -->|"uses"| Customer
    ProductService -->|"uses"| Product
    UserService -->|"save/load()"| FileService
    ProductService -->|"save/load()"| FileService
    FileService -->|"reads/writes files"| FileService

    %% Click Events
    click Main "https://github.com/dplearncs/e-commerce-application/blob/main/src/main/Main.java"
    click InputValidator "https://github.com/dplearncs/e-commerce-application/blob/main/src/inputValidator/InputValidator.java"
    click ReturnValues "https://github.com/dplearncs/e-commerce-application/blob/main/src/inputValidator/ReturnValues.java"
    click ECommerceApp "https://github.com/dplearncs/e-commerce-application/blob/main/src/services/ECommerceApp.java"
    click UserService "https://github.com/dplearncs/e-commerce-application/blob/main/src/services/UserService.java"
    click ProductService "https://github.com/dplearncs/e-commerce-application/blob/main/src/services/ProductService.java"
    click User "https://github.com/dplearncs/e-commerce-application/blob/main/src/models/User.java"
    click Admin "https://github.com/dplearncs/e-commerce-application/blob/main/src/models/Admin.java"
    click Customer "https://github.com/dplearncs/e-commerce-application/blob/main/src/models/Customer.java"
    click Product "https://github.com/dplearncs/e-commerce-application/blob/main/src/models/Product.java"
    click FileService "https://github.com/dplearncs/e-commerce-application/blob/main/src/storage/FileService.java"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef validation fill:#87CEFA,stroke:#000,stroke-width:1px
    classDef services fill:#90EE90,stroke:#000,stroke-width:1px
    classDef models fill:#FFFFE0,stroke:#000,stroke-width:1px
    classDef persistence fill:#FFD580,stroke:#000,stroke-width:1px
```
