# smart86029/deopeia architecture

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

- Interactive diagram: https://gitdiagram.com/smart86029/deopeia
- Repository: https://github.com/smart86029/deopeia

## Overview

##### Project type and purpose
- Deopeia is a .NET practice project built on a microservices architecture.
- It consists of a user-facing Vue3 Single-Page Application (SPA), a backend-for-frontend service (BFF), two domain services (Identity and Product), shared libraries, and hosting infrastructure.

##### File-structure analysis
- Top-level solution (`Deopeia.slnx`) aggregates all projects under `src`.
- `src/AdminPortal/Web` holds the Vue3 SPA.
- `src/AdminPortal/Bff` contains the .NET Core Web API acting as a BFF.
- `src/Identity/Deopeia.Identity.Api` and `src/Product/Deopeia.Product.Api` are two independent ASP.NET Core microservices.
- `src/Common`, `src/Deopeia.ServiceDefaults`, and `src/Deopeia.AppHost` implement shared frameworks, defaults, and hosting abstractions used by all services.
- Each microservice follows a layered pattern:
- API (Controllers, Endpoints)
- Application (Commands, Queries, Handlers)
- Domain (Entities, Repositories, Domain Events)
- Infrastructure (EF Core/Dapper configurations, migrations, repository implementations)

##### README insights
- Confirms a .NET microservices practice.

##### Detail
- Don’t over-abstract: show every service and database as its own component.
- Inter-service boundaries, shared-kernel modules, and external dependencies (object storage).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        Browser("Client Browser (User)"):::frontend
        SPA["AdminPortal Web SPA\n(Vue3 + Vite)"]:::frontend
    end
    Browser -->|"interacts over HTTPS"| SPA
    click SPA "https://github.com/smart86029/deopeia/blob/main/src/AdminPortal/Deopeia.AdminPortal.Web"

    %% BFF Layer
    subgraph "Backend-for-Frontend"
        BFF["AdminPortal BFF\n(.NET Core Web API)"]:::bff
    end
    SPA -->|"HTTPS / REST"| BFF
    click BFF "https://github.com/smart86029/deopeia/blob/main/src/AdminPortal/Deopeia.AdminPortal.Bff"

    %% Microservices Layer
    subgraph "Microservices Layer"
        Identity["Identity Service API\n(ASP.NET Core)"]:::service
        Product["Product Service API\n(ASP.NET Core)"]:::service
    end
    BFF -->|"REST / HTTP"| Identity
    BFF -->|"REST / HTTP"| Product
    click Identity "https://github.com/smart86029/deopeia/blob/main/src/Identity/Deopeia.Identity.Api"
    click Product "https://github.com/smart86029/deopeia/blob/main/src/Product/Deopeia.Product.Api"

    %% Data Stores
    subgraph "Data Stores"
        IdentityDB["Identity DB\n(SQL Server)"]:::data
        ProductDB["Product DB\n(SQL Server)"]:::data
        ObjectStorage["Object Storage\n(MinIO/S3)"]:::data
    end
    Identity -->|"reads/writes"| IdentityDB
    Product -->|"reads/writes"| ProductDB
    Identity -->|"stores files"| ObjectStorage
    Product -->|"stores files"| ObjectStorage

    %% Shared Frameworks
    subgraph "Shared Frameworks" 
        CommonApi["Deopeia.Common.Api"]:::shared
        CommonApp["Deopeia.Common.Application"]:::shared
        CommonBff["Deopeia.Common.Bff"]:::shared
        CommonContracts["Deopeia.Common.Contracts"]:::shared
        CommonDomain["Deopeia.Common.Domain"]:::shared
        CommonInfra["Deopeia.Common.Infrastructure"]:::shared
        CommonWorker["Deopeia.Common.Worker"]:::shared
        CommonUtil["Deopeia.Common"]:::shared
        AppHost["Deopeia.AppHost"]:::shared
        ServiceDefaults["Deopeia.ServiceDefaults"]:::shared
    end
    %% Build-time references
    BFF -.-> CommonApi
    BFF -.-> CommonApp
    BFF -.-> CommonBff
    BFF -.-> CommonContracts
    BFF -.-> CommonDomain
    BFF -.-> CommonInfra
    BFF -.-> AppHost
    BFF -.-> ServiceDefaults

    Identity -.-> CommonApi
    Identity -.-> CommonApp
    Identity -.-> CommonDomain
    Identity -.-> CommonInfra
    Identity -.-> CommonContracts
    Identity -.-> CommonWorker
    Identity -.-> CommonUtil
    Identity -.-> AppHost
    Identity -.-> ServiceDefaults

    Product -.-> CommonApi
    Product -.-> CommonApp
    Product -.-> CommonDomain
    Product -.-> CommonInfra
    Product -.-> CommonContracts
    Product -.-> CommonWorker
    Product -.-> CommonUtil
    Product -.-> AppHost
    Product -.-> ServiceDefaults

    %% Click Events for Shared
    click CommonApi "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Api"
    click CommonApp "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Application"
    click CommonBff "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Bff"
    click CommonContracts "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Contracts"
    click CommonDomain "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Domain"
    click CommonInfra "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Infrastructure"
    click CommonWorker "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common.Worker"
    click CommonUtil "https://github.com/smart86029/deopeia/blob/main/src/Common/Deopeia.Common"
    click AppHost "https://github.com/smart86029/deopeia/blob/main/src/Deopeia.AppHost"
    click ServiceDefaults "https://github.com/smart86029/deopeia/blob/main/src/Deopeia.ServiceDefaults"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef bff fill:#DFFFE0,stroke:#228B22,color:#228B22;
    classDef service fill:#FFE8D0,stroke:#D2691E,color:#D2691E;
    classDef data fill:#F0F0F0,stroke:#666666,color:#333333;
    classDef shared fill:#F5E6FF,stroke:#800080,color:#800080;
```
