# harlestnguyen/traffic-congestion-alert-application architecture

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

- Interactive diagram: https://gitdiagram.com/harlestnguyen/traffic-congestion-alert-application
- Repository: https://github.com/harlestnguyen/traffic-congestion-alert-application

## Overview

##### Project Type and Purpose
- This is a full-stack mobile application for traffic jam alerts, composed of:
- An Android client (“DoAnNganh/app”)
- A RESTful API server in ASP.NET Core (“ApiDoAn/ApiDoAn”)
- A SQL Server database (backup files in root)
- Users register/login, send warnings with geocoordinates, admins moderate.

##### File Structure Analysis
- Server (“ApiDoAn/ApiDoAn”):
- Controllers (AddressController, WarningController, UserController, AdminController) → MVC pattern
- Models (LoginModel, RegisterModel, WarningModel, AddressModel, etc.)
- Program.cs + launchSettings.json + appsettings.json → hosting & config (JWT Issuer, SQL connection string)
- Client (“DoAnNganh/app”):
- Activities (LoginActivity, MainActivity, WarningNearbyActivity, Admin and User flows) → UI layer
- Object (API.java, Warning.java, User.java, Address.java, StaticClass) → data models & constants
- Repository (WarningRepository, UserRepository, AddressRepository, MapRepository) → data layer, network calls
- Gradle config + Android resources (layouts, drawables, menus)

##### README Insights
- API uses JWT authentication and exposes endpoints via Swagger.
- Database is SQL Server; backup and .sql scripts provided.
- Android app points to IPv4:port; calls API endpoints from API.java.

##### Main Components & Interactions
- Android Client
- UI layer (Activities)
- Repository layer issues HTTP requests to API
- Local models map JSON ↔ Java objects
- RESTful API Server
- Controllers handle requests, validate JWT, call service/repository logic
- Entity Framework (implied) interacts with SQL Server
- SQL Server Database
- Tables for Users, Roles, Addresses, Warnings
- External/Infrastructure
- JWT Issuer/Authority (self-hosted ASP.NET Core)
- Network over HTTP (Swagger UI for testing)

##### Architectural Patterns & Design Principles
- Server: MVC, layered (Controllers → Services/Repositories → Data)
- Client: MVVM-style separation (Activities ← Repositories ← Network/API)
- Use of Repository pattern to abstract data access
- Stateless REST, JWT for authentication/authorization
- Clear separation of concerns: UI, business logic, data

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Android Client"
        subgraph "UI Layer"
            UIActivities["Activities"]:::client
            click UIActivities "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Activity"
            AdminActivities["Admin Activities"]:::client
            click AdminActivities "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Activity/Admin"
            UserActivities["User Activities"]:::client
            click UserActivities "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Activity/User"
            WarningNearby["WarningNearbyActivity"]:::client
            click WarningNearby "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Activity/WarningNearbyActivity.java"
        end
        DataModels["Data Models"]:::client
        click DataModels "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Object"
        Repos["Repository Layer"]:::client
        click Repos "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Repository"
        APIInterface["API Interface (API.java)"]:::client
        click APIInterface "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/DoAnNganh/app/src/main/java/com/doannganh/warningmap/Object/API.java"
        Gradle["Gradle Config"]:::client
        click Gradle "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/DoAnNganh/app/build.gradle"
    end

    subgraph "RESTful API Server"
        Controllers["Controllers"]:::server
        click Controllers "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/ApiDoAn/ApiDoAn/Controllers"
        UserCtrl["UserController"]:::server
        click UserCtrl "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Controllers/UserController.cs"
        WarningCtrl["WarningController"]:::server
        click WarningCtrl "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Controllers/WarningController.cs"
        AddressCtrl["AddressController"]:::server
        click AddressCtrl "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Controllers/AddressController.cs"
        AdminCtrl["AdminController"]:::server
        click AdminCtrl "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Controllers/AdminController.cs"
        ModelsServer["Models (DTOs & Entities)"]:::server
        click ModelsServer "https://github.com/harlestnguyen/traffic-congestion-alert-application/tree/main/ApiDoAn/ApiDoAn/Model"
        ConfigGroup["Configuration"]:::server
        Ps["Program.cs"]:::server
        click Ps "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Program.cs"
        AppSettings["appsettings.json"]:::server
        click AppSettings "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/appsettings.json"
        Launch["launchSettings.json"]:::server
        click Launch "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/Properties/launchSettings.json"
        Solution["Solution & Project"]:::server
        click Solution "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/ApiDoAn.sln"
        click Solution "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/ApiDoAn/ApiDoAn/ApiDoAn.csproj"
    end

    DB["SQL Server Database"]:::db
    click DB "https://github.com/harlestnguyen/traffic-congestion-alert-application/blob/main/db_a9ebb9_mapwarning_10_23_2023.bak"

    UIActivities -->|interacts via| APIInterface
    AdminActivities --> APIInterface
    UserActivities --> APIInterface
    WarningNearby --> APIInterface
    APIInterface -->|HTTP/JSON + JWT| Controllers
    Controllers --> ModelsServer
    ModelsServer --> DB
    DB --> Controllers
    Controllers -->|HTTP/JSON| APIInterface
    APIInterface --> DataModels
    DataModels --> Repos
    Repos --> APIInterface

    classDef client fill:#D0E6FF,stroke:#0366d6,color:#0366d6
    classDef server fill:#DFFFE0,stroke:#28a745,color:#28a745
    classDef db fill:#FFEFD5,stroke:#d2691e,color:#d2691e
```
