# mahmmuod/reactivities architecture

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

- Interactive diagram: https://gitdiagram.com/mahmmuod/reactivities
- Repository: https://github.com/mahmmuod/reactivities

## Overview

##### Main Components
- Client-App (React SPA)
– Components: App.tsx, Router, features/activities, activityStore (MobX), agent.ts (HTTP client).
- API Layer (ASP.NET Core Web API)
– Controllers: ActivitiesController, WeatherForecastController, BaseApiController.
– Startup & Program (DI setup, middleware, routing).
– Extensions: ApplicationServiceExtensions for wiring Application & Persistence.
- Application Layer
– Use-case handlers (Create, Delete, Details, Edit, List).
– Core mapping profiles (AutoMapper).
- Domain Layer
– Entities: Activity.
– Domain abstractions.
- Persistence Layer
– EF Core DataContext, migrations, seed data.
– SQLite database file (reactivities.db).
- External Services
– Browser, Network, File System (SQLite .db), Development settings.

##### Relationships & Data Flows
- Browser → React SPA → HTTP requests via agent.ts → API endpoints.
- API Controllers → Mediator → Application handlers → Domain models.
- Application handlers → Persistence (EF Core) → SQLite DB.
- Persistence returns data → AutoMapper maps to DTOs → Controllers return JSON → React updates store/UI.

##### Architectural Patterns
- Clean Architecture / Layered Architecture:
– Outer layers (UI, API, Persistence) depend inward on Application and Domain.
- CQRS-style use cases in Application.
- Dependency Injection configured in Startup.
- AutoMapper for object mapping.
- MobX for client-side state management.
- React Router for client navigation.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client-App (React SPA)" 
        direction TB
        App["App.tsx"]:::ui
        Router["React Router"]:::ui
        Agent["agent.ts (HTTP Client)"]:::ui
        Store["activityStore"]:::ui
        Features["Features: Activities UI"]:::ui
        Models["Models (DTO)"]:::ui
    end

    subgraph "API Layer (ASP.NET Core)" 
        direction TB
        BaseApi["BaseApiController"]:::api
        ActivitiesCtrl["ActivitiesController"]:::api
        WeatherCtrl["WeatherForecastController"]:::api
        Startup["Startup.cs"]:::api
        Program["Program.cs"]:::api
        Extensions["ApplicationServiceExtensions"]:::api
        Config["appsettings.Development.json"]:::api
    end

    subgraph "Application Layer" 
        direction TB
        Create["Create.cs"]:::app
        Delete["Delete.cs"]:::app
        Details["Details.cs"]:::app
        Edit["Edit.cs"]:::app
        List["List.cs"]:::app
        Mapping["MappingProfiles.cs"]:::app
    end

    subgraph "Domain Layer" 
        direction TB
        ActivityEntity["Activity.cs"]:::domain
    end

    subgraph "Persistence Layer" 
        direction TB
        DataContext["DataContext.cs"]:::persistence
        Migrations["Migrations"]:::persistence
        Seed["Seed.cs"]:::persistence
    end

    SQLiteDB["SQLite DB\nreactivities.db"]:::db

    %% Relationships
    App -->|uses Router| Router
    Router -->|HTTP calls via| Agent
    Agent -->|GET /api/activities| ActivitiesCtrl
    Agent -->|calls other endpoints| ActivitiesCtrl
    ActivitiesCtrl -->|inherits| BaseApi
    ActivitiesCtrl -->|calls Mediator| Create
    ActivitiesCtrl -->|calls Mediator| Delete
    ActivitiesCtrl -->|calls Mediator| Details
    ActivitiesCtrl -->|calls Mediator| Edit
    ActivitiesCtrl -->|calls Mediator| List
    WeatherCtrl -->|inherits| BaseApi
    WeatherCtrl -->|calls Mediator| Details

    Create -->|uses| Mapping
    Delete -->|uses| Mapping
    Details -->|uses| Mapping
    Edit -->|uses| Mapping
    List -->|uses| Mapping

    Create -->|reads/writes| DataContext
    Delete -->|reads/writes| DataContext
    Details -->|reads| DataContext
    Edit -->|reads/writes| DataContext
    List -->|reads| DataContext

    DataContext -->|queries| SQLiteDB
    DataContext -->|applies migrations| Migrations
    DataContext -->|seeds data| Seed

    Startup -->|configures DI| Extensions
    Startup -->|uses config| Config
    Program -->|builds host| Startup

    %% Click Events
    click App "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/app/layout/App.tsx"
    click Router "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/app/router/Router.tsx"
    click Agent "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/app/api/agent.ts"
    click Store "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/app/stores/activityStore.ts"
    click Features "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/features/activities/dashboard/ActivityDashboard.tsx"
    click Features "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/features/activities/dashboard/ActivityList.tsx"
    click Features "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/features/activities/details/ActivityDetails.tsx"
    click Features "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/features/activities/form/ActivityForm.tsx"
    click Models "https://github.com/mahmmuod/reactivities/blob/main/client-app/src/app/models/activity.ts"
    click ActivitiesCtrl "https://github.com/mahmmuod/reactivities/blob/main/API/Controllers/ActivitiesController.cs"
    click WeatherCtrl "https://github.com/mahmmuod/reactivities/blob/main/API/Controllers/WeatherForecastController.cs"
    click BaseApi "https://github.com/mahmmuod/reactivities/blob/main/API/Controllers/BaseApiController.cs"
    click Startup "https://github.com/mahmmuod/reactivities/blob/main/API/Startup.cs"
    click Program "https://github.com/mahmmuod/reactivities/blob/main/API/Program.cs"
    click Extensions "https://github.com/mahmmuod/reactivities/blob/main/API/Extensions/ApplicationServiceExtensions.cs"
    click Config "https://github.com/mahmmuod/reactivities/blob/main/API/appsettings.Development.json"
    click Create "https://github.com/mahmmuod/reactivities/blob/main/Application/Activities/Create.cs"
    click Delete "https://github.com/mahmmuod/reactivities/blob/main/Application/Activities/Delete.cs"
    click Details "https://github.com/mahmmuod/reactivities/blob/main/Application/Activities/Details.cs"
    click Edit "https://github.com/mahmmuod/reactivities/blob/main/Application/Activities/Edit.cs"
    click List "https://github.com/mahmmuod/reactivities/blob/main/Application/Activities/List.cs"
    click Mapping "https://github.com/mahmmuod/reactivities/blob/main/Application/Core/MappingProfiles.cs"
    click ActivityEntity "https://github.com/mahmmuod/reactivities/blob/main/Domain/Activity.cs"
    click DataContext "https://github.com/mahmmuod/reactivities/blob/main/Persistence/DataContext.cs"
    click Migrations "https://github.com/mahmmuod/reactivities/tree/main/Persistence/Migrations/"
    click Seed "https://github.com/mahmmuod/reactivities/blob/main/Persistence/Seed.cs"

    %% Styles
    classDef ui fill:#e0f7e9,stroke:#27a745,stroke-width:2px
    classDef api fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    classDef app fill:#f1f8e9,stroke:#558b2f,stroke-width:2px
    classDef domain fill:#f3e5f5,stroke:#6a1b9a,stroke-width:2px
    classDef persistence fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
    classDef db fill:#fff9c4,stroke:#f9a825,stroke-width:2px
```
