# santimacnet/fabrikamfiber-mvc architecture

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

- Interactive diagram: https://gitdiagram.com/santimacnet/fabrikamfiber-mvc
- Repository: https://github.com/santimacnet/fabrikamfiber-mvc

## Overview

##### Project type and purpose
- This is a full-stack ASP.NET MVC 5 web application (“FabrikamFiber.CallCenter”) designed for call-center training and demonstration.
- It consists of two main projects:
a. FabrikamFiber.DAL – a Data Access Layer implementing EF Code First repositories for Customers, Employees, Tickets, etc.
b. FabrikamFiber.Web – an MVC web front-end with controllers, views, client scripts (jQuery, Knockout, FullCalendar), CSS, and dependency injection via Ninject.

##### File structure
- Top-level solution (.sln) references two projects: DAL and Web.
- FabrikamFiber.DAL
- App.config – EF connection string to LocalDB
- Data folder – EF DbContext interface & implementation + individual repositories
- Models folder – POCO entity definitions (Customer, ServiceTicket, ScheduleItem, Alert, etc.)
- FabrikamFiber.Web
- App_Start/NinjectMVC3.cs – configures DI for controllers and repositories
- Controllers – MVC controllers for Customers, Employees, ServiceTickets, Reports, Home
- ViewModels – server-side models shaping data for views (DashboardViewModel, AssignViewModel, etc.)
- Views – Razor .cshtml templates organized by feature
- Scripts – jQuery, Knockout, FullCalendar, validation, unobtrusive AJAX
- Content – CSS, images, FullCalendar assets, fonts
- App_Data – LocalDB MDF/LDF files
- Deploy – simple batch script for deployment
- Web.config + transform files for debug/release

##### Main architectural components
- Web Browser (Client)
- UI layer built with Razor views, Knockout bindings, FullCalendar plugin, custom JS/CSS
- FabrikamFiber.Web (Web Application)
- MVC Controllers orchestrate user requests
- ViewModels adapt domain data for views
- Dependency Injection (Ninject) supplies IRepository<T> implementations
- FabrikamFiber.DAL (Data Access Layer)
- EF DbContext and Repositories encapsulate CRUD operations
- Domain Models represent database tables
- Database (SQL Server LocalDB)
- External Libraries/Frameworks
- ASP.NET MVC 5, Entity Framework 6, Ninject, jQuery, Knockout.js, FullCalendar

##### Relationships and data flow
- Client → HTTP Request → MVC Controller
- Controller → calls service/repository via injected IRepository
- Repository → EF DbContext → SQL Server LocalDB
- DbContext returns entities → Controller maps to ViewModel → Razor view renders HTML+JSON
- Client-side Knockout binds JSON data, FullCalendar displays schedules, AJAX calls Controllers for updates

##### Architectural patterns and design principles
- MVC (Model-View-Controller) separates concerns between UI, business logic, and data.
- Repository Pattern abstracts EF data access behind interfaces.
- Dependency Injection (Ninject) decouples controllers from concrete repositories.
- Code-First EF with configuration via App.config and database initializer.
- Client-side MVVM via Knockout.js for dynamic UI components.

##### Detail without over-fragmentation
- Logical component (Controllers, ViewModels, Repositories, DbContext).
- Critical dependencies (Controller → Repo → DbContext → Database).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Side
    subgraph "Client Side" 
        direction TB
        Browser["Web Browser"]:::client
        Scripts["Client-side Scripts"]:::client
        ExternalLibs["jQuery / Knockout / FullCalendar"]:::client
    end

    %% Web Server
    subgraph "Web Server (FabrikamFiber.Web)"
        direction TB
        Controllers["MVC Controllers"]:::server
        ViewModels["ViewModels"]:::server
        Views["Razor Views"]:::server
        DI["Ninject Kernel (NinjectMVC3.cs)"]:::server
        Init["Database Initializer (FabrikamFiberDatabaseInitializer.cs)"]:::server
        Config["Web.config + Transforms"]:::server
        Deploy["Deploy Scripts (deploy.bat)"]:::server
    end

    %% Data Access Layer
    subgraph "Data Access Layer (FabrikamFiber.DAL)" 
        direction TB
        DbContextInterface["IFabrikamFiberWebContext"]:::dal
        DbContextImpl["FabrikamFiberWebContext"]:::dal
        subgraph Repositories
            direction TB
            AlertRepo["AlertRepository"] 
            CustomerRepo["CustomerRepository"]
            EmployeeRepo["EmployeeRepository"]
            MessageRepo["MessageRepository"]
            ScheduleItemRepo["ScheduleItemRepository"]
            ServiceLogEntryRepo["ServiceLogEntryRepository"]
            ServiceTicketRepo["ServiceTicketRepository"]
        end
        subgraph Models
            direction TB
            Entities["Domain Model Entities"]:::dal
        end
    end

    %% Database
    subgraph "Database (SQL Server LocalDB)"
        direction TB
        Db[".mdf / .ldf files"]:::db
    end

    %% Relationships
    Browser -->|HTTP Request| Controllers
    Scripts -->|loads| Browser
    ExternalLibs -->|plugins| Browser

    Controllers -->|injects| DI
    DI -->|supplies| Controllers
    Controllers -->|uses| ViewModels
    Controllers -->|renders| Views
    Controllers -->|calls| AlertRepo
    Controllers -->|calls| CustomerRepo
    Controllers -->|calls| EmployeeRepo
    Controllers -->|calls| MessageRepo
    Controllers -->|calls| ScheduleItemRepo
    Controllers -->|calls| ServiceLogEntryRepo
    Controllers -->|calls| ServiceTicketRepo

    AlertRepo -->|CRUD via| DbContextImpl
    CustomerRepo -->|CRUD via| DbContextImpl
    EmployeeRepo -->|CRUD via| DbContextImpl
    MessageRepo -->|CRUD via| DbContextImpl
    ScheduleItemRepo -->|CRUD via| DbContextImpl
    ServiceLogEntryRepo -->|CRUD via| DbContextImpl
    ServiceTicketRepo -->|CRUD via| DbContextImpl

    DbContextImpl -->|implements| DbContextInterface
    DbContextImpl -->|manages| Entities
    DbContextImpl -->|queries| Db

    Init -->|seeds| Db
    Config -->|configures| Controllers
    Deploy -->|deploys| Controllers

    %% Click Events
    click DbContextInterface "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/IFabrikamFiberWebContext.cs"
    click DbContextImpl "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/FabrikamFiberWebContext.cs"
    click AlertRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/AlertRepository.cs"
    click CustomerRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/CustomerRepository.cs"
    click EmployeeRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/EmployeeRepository.cs"
    click MessageRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/MessageRepository.cs"
    click ScheduleItemRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/ScheduleItemRepository.cs"
    click ServiceLogEntryRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/ServiceLogEntryRepository.cs"
    click ServiceTicketRepo "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.DAL/Data/ServiceTicketRepository.cs"
    click Entities "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.DAL/Models"
    click Controllers "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.Web/Controllers"
    click ViewModels "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.Web/ViewModels"
    click Views "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.Web/Views"
    click DI "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.Web/App_Start/NinjectMVC3.cs"
    click Init "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.Web/FabrikamFiberDatabaseInitializer.cs"
    click Scripts "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.Web/Scripts"
    click Deploy "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.Web/Deploy/deploy.bat"
    click Config "https://github.com/santimacnet/fabrikamfiber-mvc/blob/master/FabrikamFiber.Web/Web.config"
    click Db "https://github.com/santimacnet/fabrikamfiber-mvc/tree/master/FabrikamFiber.Web/App_Data"

    %% Styles
    classDef client fill:#D0E6FF,stroke:#036,stroke-width:1px
    classDef server fill:#DAF7DC,stroke:#2E7D32,stroke-width:1px
    classDef dal fill:#FFF9C4,stroke:#FBC02D,stroke-width:1px
    classDef db fill:#FFE0B2,stroke:#E65100,stroke-width:1px
```
