# martineza79/ecommercesite architecture

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

- Interactive diagram: https://gitdiagram.com/martineza79/ecommercesite
- Repository: https://github.com/martineza79/ecommercesite

## Overview

##### Project type and purpose
- This is a full-stack ASP.NET MVC 5 e-commerce demo application.
- It implements a layered architecture:
- WebUI layer (controllers/views/models)
- Domain layer (business interfaces and implementations)
- Persistence (Entity Framework + SQL Server)
- External services (SMTP/email)

##### File structure
- Top-level solution (ECommerceSite.sln) with two projects:
- ECommerceSite.Domain – contains Abstract (interfaces), Concrete (EF context, repos, order processing, auth), Entities, Migrations
- ECommerceSite.WebUI – ASP.NET MVC 5 application with App_Start (Ninject, routing), Controllers, Views, Models, Binders
- EF Migrations and App.config in Domain define DB schema and settings.
- Web.config, ApplicationInsights.config, Web.*.config in WebUI define environment settings.

##### README
- Confirms tech stack: C#, ASP.NET MVC 5, Razor, Bootstrap, EF (SQL Server), Ninject DI.
- Notes configurable EmailSettings for order notifications.

##### Main components
a. Client (Browser)
- UI rendered via Razor/Bootstrap
b. WebUI (ASP.NET MVC)
- Controllers (Account, Admin, Cart, Nav, Product)
- ViewModels/Models
- ModelBinders (CartModelBinder)
- DI Container (Ninject)
c. Domain Layer
- Interfaces: IProductRepository, IOrderProcess, IAuthentication
- Implementations: EFProductRepository (uses EFDbContext), EmailOrderProcess (uses EmailSettings), FormsAuthenticationProvider
d. Persistence
- EFDbContext → SQL Server database via ADO.NET
- Migrations for schema evolution
e. External/Infrastructure Services
- SMTP server for order emails
- (Optional) Application Insights telemetry

##### Relationships and data flows
1. Browser → HTTP → ASP.NET MVC middleware
2. MVC routing → Controller action
3. Controller calls injected Domain interface(s)
– IProductRepository → EFDbContext → SQL Server
– IOrderProcess → SMTP/email server
– IAuthentication → FormsAuth provider
4. Controller populates ViewModel → Razor View → HTML/CSS/JS → Browser
5. ModelBinders convert HTTP form data → strongly-typed Models (e.g., Cart)

##### Architectural patterns & design principles
- Layered architecture (UI → Domain → Data)
- MVC pattern in WebUI
- Repository pattern (IProductRepository + EF implementation)
- Dependency Injection/Inversion of Control (Ninject)
- Configuration-driven settings (EmailSettings, AppSettings, web.config transformations)

##### Detail
- EF Migrations as part of the build/deploy pipeline if relevant
- Call out configuration files that influence behavior (web.config, App.config, EmailSettings.cs)

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Browser\n(Razor/Bootstrap Views)"]:::ui
    click Client "https://github.com/martineza79/ecommercesite/tree/master/ECommerceSite.WebUI/Views"

    subgraph "WebUI Layer"
        subgraph "Controllers"
            AC["AccountController"]:::ui
            ADC["AdminController"]:::ui
            CC["CartController"]:::ui
            NC["NavController"]:::ui
            PC["ProductController"]:::ui
        end
        subgraph "Views"
            Shared["Shared Layouts"]:::ui
            AccountV["Account/Login"]:::ui
            AdminV["Admin Views"]:::ui
            CartV["Cart Views"]:::ui
            NavV["Nav/Menu"]:::ui
            ProdV["Product/List"]:::ui
        end
        CMB["CartModelBinder"]:::ui
        NInject["NinjectWebCommon"]:::ui
        Routes["RouteConfig"]:::ui
        Configs["Web.config & Transforms\nAppInsights.config"]:::ui
    end

    subgraph "Domain Layer"
        Interfaces["Interfaces\nIProductRepository\nIOrderProcess\nIAuthentication"]:::domain
        Impls["Implementations\nEFDbContext\nEFProductRepository\nEmailOrderProcess\nFormsAuthenticationProvider\nEmailSettings"]:::domain
        Entities["Entities\nProduct, Cart, CartLine,\nShippingDetails, User"]:::domain
        AppConf["App.config"]:::domain
    end

    subgraph "Persistence"
        Migrations["EF Migrations"]:::persistence
        SQL["SQL Server"]:::persistence
    end

    subgraph "External Services"
        SMTP["SMTP Email Server"]:::external
        AI["App Insights"]:::external
    end

    Client -->|"HTTP/GET"| Routes
    Routes -->|route to| AC
    Routes -->|route to| ADC
    Routes -->|route to| CC
    Routes -->|route to| NC
    Routes -->|route to| PC

    CC -->|"bind Cart"| CMB
    CMB --> CC

    AC -->|inject| Interfaces
    ADC -->|inject| Interfaces
    CC -->|inject| Interfaces
    NC -->|inject| Interfaces
    PC -->|inject| Interfaces
    NInject -.-> Interfaces

    PC -->|"IProductRepository.GetProducts()"| Interfaces
    Interfaces -->|"implemented by EFProductRepository"| Impls
    Impls -->|"uses EFDbContext"| Impls
    Impls -->|"DbContext.SaveChanges()"| SQL

    CC -->|"IOrderProcess.ProcessOrder()"| Interfaces
    Interfaces -->|"implemented by EmailOrderProcess"| Impls
    Impls -->|"SMTP.Send()"| SMTP

    AC -->|"IAuthentication.Authenticate()"| Interfaces
    Interfaces -->|"implemented by FormsAuthenticationProvider"| Impls

    AC --> AccountV
    ADC --> AdminV
    CC --> CartV
    NC --> NavV
    PC --> ProdV
    Shared --> AccountV
    Shared --> AdminV
    Shared --> CartV
    Shared --> ProdV
    Shared --> NavV

    Configs -.-> AC
    Configs -.-> ADC
    Configs -.-> CC

    AppConf --> Impls
    Migrations --> SQL
    AI --> AC

    classDef ui fill:#e0ffe0,stroke:#333,stroke-width:1px
    classDef domain fill:#ffe4b3,stroke:#333,stroke-width:1px
    classDef persistence fill:#b3d9ff,stroke:#333,stroke-width:1px
    classDef external fill:#cccccc,stroke:#333,stroke-width:1px

    click AC "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Controllers/AccountController.cs"
    click ADC "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Controllers/AdminController.cs"
    click CC "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Controllers/CartController.cs"
    click NC "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Controllers/NavController.cs"
    click PC "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Controllers/ProductController.cs"
    click Shared "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Shared/_Layout.cshtml"
    click AccountV "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Account/Login.cshtml"
    click AdminV "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Admin/Index.cshtml"
    click CartV "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Cart/Index.cshtml"
    click NavV "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Nav/Menu.cshtml"
    click ProdV "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Views/Product/List.cshtml"
    click CMB "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Binders/CartModelBinder.cs"
    click NInject "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/App_Start/NinjectWebCommon.cs"
    click Routes "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/App_Start/RouteConfig.cs"
    click Configs "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.WebUI/Web.config"
    click Interfaces "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.Domain/Abstract/IProductRepository.cs"
    click Impls "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.Domain/Concrete/EFDbContext.cs"
    click Migrations "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.Domain/Migrations/201701240504433_initial.cs"
    click AppConf "https://github.com/martineza79/ecommercesite/blob/master/ECommerceSite.Domain/App.config"
```
