# karinabril19/prograbarberia architecture

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

- Interactive diagram: https://gitdiagram.com/karinabril19/prograbarberia
- Repository: https://github.com/karinabril19/prograbarberia

## Overview

##### Project type and purpose
- This is a monolithic full-stack web application built on ASP.NET Core MVC.
- Purpose (inferred from name “prograbarberia” and domain models): a barber shop appointment management system enabling clients to book “Cita” (appointments), with entities for “Cliente”, “Empleado” (barber), “Servicio”, and “Usuario” (authentication/authorization).

##### File structure
- Top-level directories:
- Controllers/ – MVC controllers handling HTTP requests.
- Services/ – business-logic layer services (e.g., CitaService, ClienteService).
- Data/ – EF Core DbContext (BarberiaDbContext) for data access.
- Models/ – domain/entities and view models (Cita, Cliente, Empleado, Servicio, Usuario).
- Views/ – Razor view templates (presentation layer).
- wwwroot/ – static assets (CSS, JS, client libs via libman).
- Configuration:
- Program.cs – application startup.
- appsettings.json & appsettings.Development.json – environment/config.
- launchSettings.json – IIS/launch profiles.
- Solution/Scripts:
- prograbarberia.sln & .csproj – solution/project definitions.

##### README
- Only contains the project title; no additional architectural notes.
- Rely on code structure to infer layers and interactions.

a. Main components
1. Client (Web Browser / HTTP client)
2. Presentation Layer (ASP.NET Core MVC)
– Controllers
– Razor Views (Views/…)
– Static Assets (wwwroot: CSS/JS)
3. Business Logic Layer (Services)
– CitaService, ClienteService, EmpleadoService, ServicioService, UsuarioService
4. Data Access Layer
– EF Core DbContext (BarberiaDbContext)
5. Persistence
– Relational Database (SQL Server / other)
6. External Dependencies (if any)
– NuGet packages (Bootstrap, jQuery, EF Core)
– Potential external authentication or logging providers
b. Relationships & interactions
- Browser → HTTP GET/POST → Controllers
- Controller → calls Service methods → returns domain model or DTO
- Service → reads/writes via DbContext → Database
- Controller → returns View + ViewModel → HTML → Browser
- Static asset requests handled by ASP.NET Core static file middleware directly from wwwroot
c. Architectural patterns & principles
- Layered architecture (Presentation → Business → Data)
- MVC pattern in the presentation layer
- Dependency injection of Services and DbContext (built-in ASP.NET Core DI container)
- Separation of concerns: Controllers orchestrate, Services encapsulate business rules, DbContext handles persistence
d. Key technologies/frameworks
- ASP.NET Core MVC
- Razor view engine
- Entity Framework Core (Code-First)
- Bootstrap & jQuery for frontend styling and interactions
- .NET Core DI, appsettings config

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    Browser["Web Browser"]:::external

    %% Presentation Layer
    subgraph "Presentation Layer"
        Controller["HomeController"]:::presentation
        subgraph "Razor Views"
            Index["Index.cshtml"]:::presentation
            Privacy["Privacy.cshtml"]:::presentation
            Layout["_Layout.cshtml"]:::presentation
            ErrorView["Error.cshtml"]:::presentation
            Validation["_ValidationScriptsPartial.cshtml"]:::presentation
            ViewImports["_ViewImports.cshtml"]:::presentation
            ViewStart["_ViewStart.cshtml"]:::presentation
        end
        StaticFiles["Static Assets (wwwroot)"]:::presentation
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        CitaService["CitaService"]:::business
        ClienteService["ClienteService"]:::business
        EmpleadoService["EmpleadoService"]:::business
        ServicioService["ServicioService"]:::business
        UsuarioService["UsuarioService"]:::business
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        DbContext["BarberiaDbContext"]:::data
    end

    %% Persistence
    Database["SQL Database"]:::external

    %% External Dependencies
    NuGet["NuGet Packages"]:::external

    %% Connections
    Browser -->|HTTP GET/POST| Controller
    Controller -->|returns ViewModel| Index
    Controller -->|returns ViewModel| Privacy
    Controller -->|uses Layout| Layout
    Controller -->|uses ErrorViewModel| ErrorView
    Controller -->|includes Validation Scripts| Validation
    Controller -->|imports View_Configs| ViewImports
    Controller -->|imports View_Start| ViewStart
    Browser -->|requests static assets| StaticFiles
    Controller -->|calls| CitaService
    Controller -->|calls| ClienteService
    Controller -->|calls| EmpleadoService
    Controller -->|calls| ServicioService
    Controller -->|calls| UsuarioService
    CitaService -->|uses DbContext| DbContext
    ClienteService -->|uses DbContext| DbContext
    EmpleadoService -->|uses DbContext| DbContext
    ServicioService -->|uses DbContext| DbContext
    UsuarioService -->|uses DbContext| DbContext
    DbContext -->|SQL Queries| Database
    Controller -->|uses DI & Config| NuGet

    %% Click Events
    click Controller "https://github.com/karinabril19/prograbarberia/blob/master/Controllers/HomeController.cs"
    click Index "https://github.com/karinabril19/prograbarberia/blob/master/Views/Home/Index.cshtml"
    click Privacy "https://github.com/karinabril19/prograbarberia/blob/master/Views/Home/Privacy.cshtml"
    click Layout "https://github.com/karinabril19/prograbarberia/blob/master/Views/Shared/_Layout.cshtml"
    click ErrorView "https://github.com/karinabril19/prograbarberia/blob/master/Views/Shared/Error.cshtml"
    click Validation "https://github.com/karinabril19/prograbarberia/blob/master/Views/Shared/_ValidationScriptsPartial.cshtml"
    click ViewImports "https://github.com/karinabril19/prograbarberia/blob/master/Views/_ViewImports.cshtml"
    click ViewStart "https://github.com/karinabril19/prograbarberia/blob/master/Views/_ViewStart.cshtml"
    click StaticFiles "https://github.com/karinabril19/prograbarberia/tree/master/wwwroot/"
    click CitaService "https://github.com/karinabril19/prograbarberia/blob/master/Services/CitaService.cs"
    click ClienteService "https://github.com/karinabril19/prograbarberia/blob/master/Services/ClienteService.cs"
    click EmpleadoService "https://github.com/karinabril19/prograbarberia/blob/master/Services/EmpleadoService.cs"
    click ServicioService "https://github.com/karinabril19/prograbarberia/blob/master/Services/ServicioService.cs"
    click UsuarioService "https://github.com/karinabril19/prograbarberia/blob/master/Services/UsuarioService.cs"
    click DbContext "https://github.com/karinabril19/prograbarberia/blob/master/Data/BarberiaDbContext.cs"

    %% Styles
    classDef presentation fill:#D6EAF8,stroke:#1F618D,stroke-width:1px
    classDef business fill:#D5F5E3,stroke:#196F3D,stroke-width:1px
    classDef data fill:#FCF3CF,stroke:#B9770E,stroke-width:1px
    classDef external fill:#E5E7E9,stroke:#424949,stroke-width:1px
```
