# miguelcosta/limiaurbanus architecture

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

- Interactive diagram: https://gitdiagram.com/miguelcosta/limiaurbanus
- Repository: https://github.com/miguelcosta/limiaurbanus

## Overview

##### Project Type Analysis
This is a .NET MVC-based web application for real estate management (Limia Urbanus), built using ASP.NET MVC with Entity Framework for data persistence.

##### Main Architectural Components

A. Presentation Layer (Frontend)
- MVC Views (in /Views directory)
- Static Content (CSS, JavaScript, Images)
- Client-side Libraries (Bootstrap, jQuery, Kendo UI)

B. Application Layer
- Controllers (handling business logic)
- ViewModels (data transfer objects)
- Identity/Authentication Services

C. Data Layer
- Entity Framework Models
- Database Context
- Migrations

**[Client Browser] → [Web Server (IIS)]**
- ↑               ↓
- [ASP.NET MVC Application]
- ↓
- [Database]

##### Client-Side Layer (Top)
- Sub-components:
- HTML/CSS/JavaScript
- Kendo UI Components
- Bootstrap UI
- Google Maps Integration

##### Web Application Layer (Middle)
- Sub-sections:
- Controllers (ImoveisController, AccountController, etc.)
- Views (Razor Views)
- Models (Domain Models)
- Identity Framework (Authentication)
- File Management System

##### Data Layer (Bottom)
- Entity Framework connection
- Migration capabilities

##### Cross-Cutting Concerns (Side)
- Authentication & Authorization
- File Storage
- Configuration Management

- Blue: Client-side components
- Green: Server-side components
- Yellow: Data storage
- Gray: External services/integrations

Special Considerations:
##### Real estate specific features
- Property Management (Imoveis)
- Location Services (Freguesias, Concelhos, Distritos)
- Energy Classifications (ClassesEnergeticas)
- Property Types (Tipos, Tipologias)

##### Integration points
- Google Maps API integration
- File upload/storage system
- Authentication system

##### Important architectural patterns
- MVC pattern implementation
- Repository pattern for data access
- Identity pattern for authentication

- Component types
- Architectural patterns
- External service integrations

Level of Detail:
- Keep high-level components visible at first glance
- Use expandable/collapsible sections for detailed views
- Maintain clarity while showing relationships

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client["Client Layer"]
        Browser["Web Browser"]
        UI["UI Components"]:::frontend
        Maps["Google Maps Integration"]:::external
        Static["Static Content"]:::frontend
    end

    subgraph Application["Application Layer"]
        direction TB
        Controllers["Controllers"]:::controller
        Views["MVC Views"]:::view
        ViewModels["View Models"]:::model
        Identity["Identity Framework"]:::service
        FileSystem["File Management System"]:::service

        subgraph PropertyFeatures["Property Management"]
            direction TB
            ImoveisCtrl["Property Controller"]:::controller
            LocationCtrl["Location Services"]:::controller
            EnergyCtrl["Energy Classifications"]:::controller
        end
    end

    subgraph Data["Data Layer"]
        direction TB
        EF["Entity Framework"]:::data
        DbContext["Database Context"]:::data
        Database[(SQL Database)]:::database
        Migrations["Database Migrations"]:::data
    end

    %% Relationships
    Browser --> UI
    UI --> Maps
    UI --> Static
    Browser --> Controllers
    Controllers --> Views
    Controllers --> ViewModels
    Controllers --> Identity
    Controllers --> FileSystem
    Controllers --> PropertyFeatures
    PropertyFeatures --> EF
    EF --> DbContext
    DbContext --> Database
    DbContext --> Migrations

    %% Click Events
    click Views "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/Views"
    click Controllers "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/Controllers"
    click ViewModels "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/ViewModels"
    click Static "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/Content"
    click Maps "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/Scripts/jmelosegui.googlemap.js"
    click DbContext "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/Models/LimiaUrbanusDbContext.cs"
    click Identity "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/App_Start/IdentityConfig.cs"
    click Migrations "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/Migrations"
    click FileSystem "https://github.com/MiguelCosta/limiaurbanus/tree/master/LimiaUrbanus.WebSite/Files"
    click ImoveisCtrl "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/Controllers/ImoveisController.cs"
    click LocationCtrl "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/Controllers/FreguesiasController.cs"
    click EnergyCtrl "https://github.com/MiguelCosta/limiaurbanus/blob/master/LimiaUrbanus.WebSite/Controllers/ClassesEnergeticasController.cs"

    %% Styling
    classDef frontend fill:#2196F3,stroke:#1565C0,color:white
    classDef controller fill:#4CAF50,stroke:#2E7D32,color:white
    classDef model fill:#FFC107,stroke:#FFA000,color:black
    classDef view fill:#9C27B0,stroke:#7B1FA2,color:white
    classDef service fill:#FF5722,stroke:#E64A19,color:white
    classDef data fill:#607D8B,stroke:#455A64,color:white
    classDef database fill:#795548,stroke:#5D4037,color:white
    classDef external fill:#9E9E9E,stroke:#616161,color:white
```
