# srikrushnap/angular-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/srikrushnap/angular-ecommerce
- Repository: https://github.com/srikrushnap/angular-ecommerce

## Overview

##### Project type and purpose
- This is a single-page application (SPA) built in Angular that simulates an e-commerce portal.
- It supports three user roles: Admin (manages users), Seller (lists products/services), Buyer (browses and purchases).
- It uses a JSON-Server as a mock backend for all REST API calls.

##### File structure
- Top-level folders:
- src/app: contains all Angular feature modules (admin, customer, product, shared, core, user-profile, home, contact-us).
- e2e: end-to-end tests (Protractor).
- mock-api-data.json + json-server: mock REST endpoints.
- Key Angular artifacts:
- app-routing.module.ts: root router configuration.
- core module: global interceptors and API service.
- shared module: shared components (header, footer, error page), directives, and common services (auth-guard, login/signup).
- admin module: admin login, dashboard, user CRUD via AdminService.
- customer module: separate buyer and seller feature submodules and CustomerService.
- product module: product CRUD via ProductService.
- user-profile module: profile management.
- Configuration files: angular.json, tsconfig, karma.conf.js, tslint.json.

##### README for additional insights
- The project is started with `ng serve` (frontend) and `json-server --watch mock-api-data.json` (mock backend).
- Frontend listens on port 4200; mock API on port 3000.
- No real database or backend code—everything goes through JSON-Server.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser and Entry
    Browser["Browser"]:::external
    Main["Angular Client\n(src/main.ts)"]:::external
    Browser -->|loads SPA| Main
    click Main "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/main.ts"

    %% Routing
    AppRouting["App Routing Module\n(app-routing.module.ts)"]:::infra
    Main -->|bootstrap| AppRouting
    click AppRouting "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/app-routing.module.ts"

    %% Core Module
    subgraph "Core Module" 
        direction TB
        CoreMod["Core Module\n(core.module.ts)"]:::infra
        Interceptor["HTTP Interceptor\n(http.interceptors.ts)"]:::infra
        APIService["API Service\n(api.service.ts)"]:::infra
        HttpClient["HTTP Client"]:::infra
        CoreMod --> Interceptor
        CoreMod --> APIService
        APIService -->|uses| HttpClient
        Interceptor -->|intercepts| HttpClient
    end
    click CoreMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/core/core.module.ts"
    click Interceptor "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/core/interceptors/http.interceptors.ts"
    click APIService "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/core/services/api.service.ts"

    %% Shared Module
    subgraph "Shared Module"
        direction TB
        SharedMod["Shared Module\n(shared.module.ts)"]:::infra
        NumOnly["NumberOnly Directive\n(number-only.directive.ts)"]:::infra
        Header["Header Component\n(header.component.ts)"]:::infra
        Footer["Footer Component\n(footer.component.ts)"]:::infra
        ErrorPage["PageNotFound Component\n(page-not-found-error.component.ts)"]:::infra
        AuthGuard["Auth Guard Service\n(auth-gaurd.service.ts)"]:::infra
        LoginSignup["Login/Signup Service\n(login-signup.service.ts)"]:::infra
        UserSvc["User Service\n(user.service.ts)"]:::infra
        ProdSvc["Product Service\n(product.service.ts)"]:::infra

        SharedMod --> NumOnly
        SharedMod --> Header
        SharedMod --> Footer
        SharedMod --> ErrorPage
        SharedMod --> AuthGuard
        SharedMod --> LoginSignup
        SharedMod --> UserSvc
        SharedMod --> ProdSvc
    end
    click SharedMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/shared.module.ts"
    click NumOnly "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/directives/number-only.directive.ts"
    click Header "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/layouts/header/header.component.ts"
    click Footer "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/layouts/footer/footer.component.ts"
    click ErrorPage "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/layouts/page-not-found-error/page-not-found-error.component.ts"
    click AuthGuard "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/services/auth-gaurd.service.ts"
    click LoginSignup "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/services/login-signup.service.ts"
    click UserSvc "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/services/user.service.ts"
    click ProdSvc "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/shared/services/product.service.ts"

    %% Feature Modules

    subgraph "Admin Module"
        direction TB
        AdminMod["Admin Module\n(admin.module.ts)"]:::frontend
        AdminLogin["Admin Login Component\n(admin-login.component.ts)"]:::frontend
        AdminDash["Admin Dashboard Component\n(admin-dashboard.component.ts)"]:::frontend
        UserCRUD["User CRUD Component\n(user-crud.component.ts)"]:::frontend
        AdminSvc["Admin Service\n(admin.service.ts)"]:::infra

        AdminMod --> AdminLogin
        AdminMod --> AdminDash
        AdminMod --> UserCRUD
        AdminMod --> AdminSvc
    end
    click AdminMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/admin/admin.module.ts"
    click AdminLogin "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/admin/admin-login/admin-login.component.ts"
    click AdminDash "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/admin/admin-dashboard/admin-dashboard.component.ts"
    click UserCRUD "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/admin/user-crud/user-crud.component.ts"
    click AdminSvc "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/admin/services/admin.service.ts"

    subgraph "Customer Module"
        direction TB
        CustMod["Customer Module\n(customer.module.ts)"]:::frontend
        BuyerDash["Buyer Dashboard Component\n(buyer-dashboard.component.ts)"]:::frontend
        Checkout["Checkout Component\n(checkout.component.ts)"]:::frontend
        SellerDash["Seller Dashboard Component\n(seller-dashboard.component.ts)"]:::frontend
        CustSvc["Customer Service\n(customer.service.ts)"]:::infra
        CustAuth["Signin/Signup Component\n(signin-signup.component.ts)"]:::frontend

        CustMod --> BuyerDash
        CustMod --> Checkout
        CustMod --> SellerDash
        CustMod --> CustAuth
        CustMod --> CustSvc
    end
    click CustMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/customer.module.ts"
    click BuyerDash "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/buyer/buyer-dashboard/buyer-dashboard.component.ts"
    click Checkout "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/buyer/checkout/checkout.component.ts"
    click SellerDash "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/seller/seller-dashboard/seller-dashboard.component.ts"
    click CustSvc "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/services/customer.service.ts"
    click CustAuth "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/customer/signin-signup/signin-signup.component.ts"

    subgraph "Product Module"
        direction TB
        ProdMod["Product Module\n(product-crud.component.ts)"]:::frontend
        ProdCRUD["Product CRUD Component\n(product-crud.component.ts)"]:::frontend
        %% uses shared ProdSvc
    end
    click ProdMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/product/product-crud/product-crud.component.ts"
    click ProdCRUD "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/product/product-crud/product-crud.component.ts"

    subgraph "User-Profile Module"
        direction TB
        UPMod["User-Profile Module\n(user-profile.component.ts)"]:::frontend
    end
    click UPMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/user-profile/user-profile.component.ts"

    subgraph "Home Module"
        direction TB
        HomeMod["Home Component\n(home.component.ts)"]:::frontend
    end
    click HomeMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/home/home.component.ts"

    subgraph "Contact-Us Module"
        direction TB
        ContactMod["Contact-Us Component\n(contact-us.component.ts)"]:::frontend
    end
    click ContactMod "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/app/contact-us/contact-us.component.ts"

    %% Routing to Feature Modules
    AppRouting --> AdminMod
    AppRouting --> CustMod
    AppRouting --> ProdMod
    AppRouting --> UPMod
    AppRouting --> HomeMod
    AppRouting --> ContactMod

    %% Component-Service-HTTP Flow
    AdminDash -->|calls| AdminSvc
    UserCRUD -->|calls| AdminSvc
    AdminLogin -->|calls| AdminSvc

    BuyerDash -->|calls| CustSvc
    Checkout -->|calls| CustSvc
    SellerDash -->|calls| CustSvc
    CustAuth -->|calls| CustSvc

    ProdCRUD -->|calls| ProdSvc
    UPMod -->|calls| UserSvc
    HomeMod -->|calls| APIService
    ContactMod -->|calls| APIService

    AdminSvc -->|HTTP| Interceptor
    CustSvc -->|HTTP| Interceptor
    ProdSvc -->|HTTP| Interceptor
    UserSvc -->|HTTP| Interceptor
    LoginSignup -->|HTTP| Interceptor
    AuthGuard -->|HTTP| Interceptor

    %% Backend
    JSONServer["JSON-Server\n(mock-api-data.json)"]:::backend
    HttpClient -->|REST API| JSONServer
    click JSONServer "https://github.com/srikrushnap/angular-ecommerce/blob/master/mock-api-data.json"

    %% External Assets
    Assets["Localization Files\n(en.json, hn.json)"]:::external
    Assets --> Main
    click Assets "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/assets/i18n/en.json"
    click Assets "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/assets/i18n/hn.json"

    %% Environments
    EnvDev["Env Config Dev\n(environment.ts)"]:::external
    EnvProd["Env Config Prod\n(environment.prod.ts)"]:::external
    Main --> EnvDev
    Main --> EnvProd
    click EnvDev "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/environments/environment.ts"
    click EnvProd "https://github.com/srikrushnap/angular-ecommerce/blob/master/src/environments/environment.prod.ts"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef infra fill:#98FB98,stroke:#333,stroke-width:1px
    classDef backend fill:#FFA500,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
