# gocaspt/pweb-habitaqui architecture

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

- Interactive diagram: https://gitdiagram.com/gocaspt/pweb-habitaqui
- Repository: https://github.com/gocaspt/pweb-habitaqui

## Overview

##### Project Type & Purpose
- Monolithic full-stack web application built with ASP.NET Core MVC.
- Uses Entity Framework Core for data access and migrations.
- Uses ASP.NET Core Identity (Razor Pages area) for authentication/authorization.
- Serves server-rendered Razor views and static assets (CSS/JS) via wwwroot.

##### File Structure to Extract Components
- Areas/Identity – Razor Pages for login, registration, profile management.
- Controllers/… – MVC controllers for each domain entity (Habitacoes, Alugueres, CheckIn, CheckOut, Locadores, Pontuacoes, Categorias, UserManager).
- Views/… – Razor view templates corresponding to each controller and shared layout/partials.
- Data/
- ApplicationDbContext – EF Core DbContext configuring all domain DbSet<T>.
- Migrations – EF migration snapshots and scripts.
- Inicializacao – likely database seeding logic.
- Models/ – POCO domain classes (Habitacao, Locador, CheckIn, Itens, Fotografia, Pontuacao, Categoria, Tipologia, ApplicationUser, etc.).
- ViewModels/ – DTOs for specialized view scenarios (user roles, search).
- wwwroot/ – static assets and client libs (Bootstrap, jQuery, custom CSS/JS).
- Program.cs / appsettings.json – ASP.NET Core host setup, middleware pipeline, connection strings.

##### README Insights
- Minimal: identifies it as a PWEB coursework project.
- No explicit high-level architecture doc, so infer layering and key frameworks.

##### Main Components & Their Interactions
a. Client Layer
- Web Browser: HTTP requests, receives HTML/CSS/JS.
- Static Content (wwwroot): CSS, JS, images served by Static File Middleware.
b. Presentation Layer
- ASP.NET Core MVC Middleware Pipeline:
· StaticFileMiddleware → Routing → Authentication → Authorization → Endpoint (Controller or Razor Page).
- Controllers & Razor Views: handle GET/POST, return ViewResults or Redirects.
c. Authentication/Authorization
- ASP.NET Core Identity (Area “Identity”): UserStore via EF Core, cookie auth.
d. Business/Data Layer
- Services/Initialization (Data/Inicializacao) if any business logic lives here.
- EF Core DbContext: CRUD operations on domain models, runs Migrations, interacts with SQL Server database (.mdf file).
e. Database
- Local SQL Server database file (HabitAquiDatabase.mdf).
f. External Libraries & Frameworks
- Bootstrap, jQuery for UI.
- Entity Framework Core, ASP.NET Core Identity, Razor.

##### Architectural Patterns & Principles
- MVC Pattern: Controllers, Models, Views separated.
- Layered Architecture: Presentation → Business/Service → Data Access → Database.
- Use of ViewModels for shaping data for views.
- Convention-over-configuration in ASP.NET Core (folder structure drives routing and views).
- EF Core Code-First with migrations for schema evolution.

##### Detail Without Overthinking
- Break the monolith into as many logical components as needed:
- Static file server
- Routing & Middleware
- Identity subsystem
- MVC controllers layer
- ViewModels layer
- EF Core data access layer
- Database storage

## Diagram (Mermaid)

```mermaid
flowchart TB
    Browser["Web Browser"]:::external
    subgraph Static_Layer
        StaticAssets["Static Assets (CSS, JS, Images)"]:::static
        Libs["Bootstrap & jQuery"]:::lib
    end
    subgraph "ASP.NET Core Middleware Pipeline"
        StaticFileMW["Static File Middleware"]
        RoutingMW["Routing Middleware"]
        AuthnMW["Authentication Middleware"]
        AuthzMW["Authorization Middleware"]
        EndpointExec["Endpoint Execution"]
    end
    subgraph Presentation_Layer
        IdentityPages["Identity Razor Pages"]:::presentation
        MVCControllers["MVC Controllers"]:::presentation
        RazorViews["Razor Views"]:::presentation
        SharedPartials["Shared Layouts & Partials"]:::presentation
        ViewModels["ViewModels (DTOs)"]:::presentation
    end
    subgraph Data_Layer
        ApplicationDbContext["ApplicationDbContext (EF Core DbContext)"]:::data
        Inicializacao["Database Seeding (Inicializacao)"]:::data
        Migrations["EF Core Migrations"]:::data
        DomainModels["Domain Models"]:::data
    end
    subgraph Storage_Layer
        Database["SQL Server Database"]:::storage
    end
    subgraph Config_Files
        ProgramConfig["Program.cs & Startup"]:::config
        AppSettings["appsettings.json & appsettings.Development.json"]:::config
    end

    Browser -->|HTTP GET/POST| StaticFileMW
    StaticFileMW -->|serves CSS/JS/Images| Browser
    StaticLayerEnd((". . .")):::none
    Browser -->|HTTP GET/POST| RoutingMW
    RoutingMW -->|route resolution| AuthnMW
    AuthnMW -->|authenticate user| AuthzMW
    AuthzMW -->|authorize request| EndpointExec
    EndpointExec -->|invokes Razor Pages| IdentityPages
    EndpointExec -->|invokes Controllers| MVCControllers

    MVCControllers -->|uses ViewModels| ViewModels
    MVCControllers -->|returns Views| RazorViews
    MVCControllers -->|queries/updates| ApplicationDbContext
    IdentityPages -->|uses EF Core| ApplicationDbContext
    RazorViews -->|renders HTML| Browser

    ApplicationDbContext -->|runs migrations| Migrations
    ApplicationDbContext -->|seeding logic| Inicializacao
    ApplicationDbContext -->|CRUD operations| DomainModels
    ApplicationDbContext -->|SQL queries| Database

    ProgramConfig -->|configures| StaticFileMW
    ProgramConfig -->|configures| RoutingMW
    ProgramConfig -->|configures| AuthnMW
    ProgramConfig -->|configures| AuthzMW
    ProgramConfig -->|adds DbContext| ApplicationDbContext
    AppSettings -->|provides connection strings| ProgramConfig

    StaticAssets -->|served by| StaticFileMW
    Libs -->|stored in| StaticAssets
    Libs -->|served by| StaticFileMW

    classDef external fill:#E0E0E0,stroke:#333
    classDef presentation fill:#ADD8E6,stroke:#333
    classDef data fill:#90EE90,stroke:#333
    classDef storage fill:#D3D3D3,stroke:#333
    classDef static fill:#FFA500,stroke:#333
    classDef lib fill:#EE82EE,stroke:#333
    classDef config fill:#FFFFE0,stroke:#333

    click IdentityPages "https://github.com/gocaspt/pweb-habitaqui/tree/main/Areas/Identity/Pages"
    click MVCControllers "https://github.com/gocaspt/pweb-habitaqui/tree/main/Controllers"
    click RazorViews "https://github.com/gocaspt/pweb-habitaqui/tree/main/Views"
    click SharedPartials "https://github.com/gocaspt/pweb-habitaqui/tree/main/Views/Shared"
    click ViewModels "https://github.com/gocaspt/pweb-habitaqui/tree/main/ViewModels"
    click ApplicationDbContext "https://github.com/gocaspt/pweb-habitaqui/blob/main/Data/ApplicationDbContext.cs"
    click Inicializacao "https://github.com/gocaspt/pweb-habitaqui/blob/main/Data/Inicializacao.cs"
    click Migrations "https://github.com/gocaspt/pweb-habitaqui/tree/main/Data/Migrations"
    click DomainModels "https://github.com/gocaspt/pweb-habitaqui/tree/main/Models"
    click StaticAssets "https://github.com/gocaspt/pweb-habitaqui/tree/main/wwwroot"
    click Libs "https://github.com/gocaspt/pweb-habitaqui/tree/main/wwwroot/lib"
    click ProgramConfig "https://github.com/gocaspt/pweb-habitaqui/blob/main/Program.cs"
    click AppSettings "https://github.com/gocaspt/pweb-habitaqui/blob/main/appsettings.json"
    click Database "https://github.com/gocaspt/pweb-habitaqui/blob/main/AppData/aspnet-HabitAquiDatabase.mdf"
```
