# ahmedkashima/webf_iu5_bmstu architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedkashima/webf_iu5_bmstu
- Repository: https://github.com/ahmedkashima/webf_iu5_bmstu

## Overview

##### Project type and purpose
- This repository is a collection of frontend laboratory works for the BMSTU IU5 course.
- Each lab (SPA, Redux, User-Interface, Real-Time) lives on its own branch and focuses on a different aspect of modern web front-end development.
- There is a separate “backend” repository handling server-side logic (Django), so this repo represents the client-side slice of a full-stack educational project.

##### File structure
- Top-level files:
- README.md – overview of labs and links to each branch
- Resources/ – images used in the README
- No application code at the main branch; code for each lab exists in its respective branch (e.g., “frontend/SPA”, “frontend/Redux”, etc.).
- External dependency: backend API served from a separate repository.

##### README for additional insights
- Lists links to four frontend labs:
- 05-lab-05: Single-Page App
- 05-lab-06: Redux state management
- 05-lab-07: User-Interface component design
- 05-lab-08: Real-time updates
- Final link points to the backend Django repository.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Project repository files
    subgraph "Project Repository"
        README["README.md"]:::doc
        Resources["Resources/"]:::doc
    end

    %% Frontend client with lab branches
    subgraph "Frontend Labs (Branches)" 
        direction TB
        lab05["05-lab-05: SPA"]:::frontend
        lab06["05-lab-06: Redux"]:::frontend
        lab07["05-lab-07: UI Components"]:::frontend
        lab08["05-lab-08: Real-Time"]:::frontend
    end

    %% Unified browser client
    Browser["Browser SPA"]:::frontend

    %% State management
    ReduxStore["Redux Store"]:::frontend

    %% Backend services
    subgraph "Backend Service"
        direction TB
        API["Django REST API"]:::backend
        WS["WebSocket Server"]:::backend
        DB["Database"]:::data
    end

    %% Interactions
    lab05 -->|“deploys code”| Browser
    lab06 -->|“deploys code”| Browser
    lab07 -->|“deploys code”| Browser
    lab08 -->|“deploys code”| Browser

    Browser -->|"HTTP GET/POST"| API
    Browser -->|"dispatch(action)"| ReduxStore
    Browser -->|"WebSocket connection"| WS
    API -->|"SQL queries"| DB

    %% Click events
    click README "https://github.com/ahmedkashima/webf_iu5_bmstu/blob/main/README.md"
    click Resources "https://github.com/ahmedkashima/webf_iu5_bmstu/tree/main/Resources/"

    %% Styling
    classDef frontend fill:#d0e7ff,stroke:#0366d6,stroke-width:2px
    classDef backend fill:#d4f4dd,stroke:#22863a,stroke-width:2px
    classDef data fill:#ffe4b5,stroke:#d2691e,stroke-width:2px
    classDef doc fill:#f0f0f0,stroke:#999999,stroke-width:1px,stroke-dasharray: 2 2
```
