# bachhungcb/scic_be architecture

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

- Interactive diagram: https://gitdiagram.com/bachhungcb/scic_be
- Repository: https://github.com/bachhungcb/scic_be

## Overview

##### Project type and purpose
- This is an ASP .NET Core Web API back-end service (“SCIC_BE”) for managing attendance, users, devices, permissions, lecturers, and students.
- It exposes REST endpoints (Controllers), implements business logic (Services), persists data (Repositories + Entity Framework Core), and runs in Docker (Dockerfile + docker-compose).

##### File structure
- Top-level “SCIC_BE” directory holds:
- Controllers – HTTP endpoints grouped by feature
- Datas – EF DbContext
- Models – EF entities + API error models
- Interfaces – service/repository contracts
- Repositories – data-access implementations
- Services – business logic + JWT, password, RCP handling
- Middlewares – exception handling
- Migrations – EF schema versions
- Configuration – appsettings, launchSettings
- A Dockerfile and docker-compose.yml orchestrate the API and its backing database.

##### README
- Minimal; no further architectural guidance. Use the code structure to infer layers and interactions.

## Diagram (Mermaid)

```mermaid
flowchart TB
    Clients((Clients)):::external
    subgraph "Infrastructure"
        Middleware["ExceptionHandlingMiddleware"]:::infra
    end
    Clients -->|HTTP Request| Middleware

    subgraph "Presentation Layer"
        AuthController["AuthController"]:::controllers
        AttendanceController["AttendanceController"]:::controllers
        DeviceController["DeviceController"]:::controllers
        LecturerController["LecturerController"]:::controllers
        PermissionController["PermissionController"]:::controllers
        StudentController["StudentController"]:::controllers
        UserController["UserController"]:::controllers
        AdminController["AdminController"]:::controllers
        WeatherForecastController["WeatherForecastController"]:::controllers
    end
    Middleware --> AuthController
    Middleware --> AttendanceController
    Middleware --> DeviceController
    Middleware --> LecturerController
    Middleware --> PermissionController
    Middleware --> StudentController
    Middleware --> UserController
    Middleware --> AdminController
    Middleware --> WeatherForecastController

    subgraph "Business Layer"
        AttendanceService["AttendanceService"]:::services
        DeviceService["DeviceService"]:::services
        JwtService["JwtService"]:::services
        LecturerService["LecturerService"]:::services
        PermissionService["PermissionService"]:::services
        PasswordService["PasswordService"]:::services
        RcpService["RcpService"]:::services
        StudentService["StudentService"]:::services
        UserInfoService["UserInfoService"]:::services
    end
    AuthController --> JwtService
    AuthController --> UserInfoService
    AttendanceController --> AttendanceService
    DeviceController --> DeviceService
    LecturerController --> LecturerService
    PermissionController --> PermissionService
    StudentController --> StudentService
    UserController --> UserInfoService
    AdminController --> PermissionService
    WeatherForecastController --> JwtService

    subgraph "Data Access Layer"
        AttendanceRepository["AttendanceRepository"]:::repositories
        LecturerRepository["LecturerRepository"]:::repositories
        PermissionRepository["PermissionRepository"]:::repositories
        RoleRepository["RoleRepository"]:::repositories
        StudentInfoRepository["StudentInfoRepository"]:::repositories
        UserRepository["UserRepository"]:::repositories
    end
    AttendanceService --> AttendanceRepository
    DeviceService --> UserRepository
    LecturerService --> LecturerRepository
    PermissionService --> PermissionRepository
    PermissionService --> RoleRepository
    StudentService --> StudentInfoRepository
    UserInfoService --> UserRepository

    subgraph "Persistence Layer"
        ScicDbContext["ScicDbContext"]:::persistence
        SQLDatabase[(SQL Database)]:::persistence
    end
    AttendanceRepository --> ScicDbContext
    LecturerRepository --> ScicDbContext
    PermissionRepository --> ScicDbContext
    RoleRepository --> ScicDbContext
    StudentInfoRepository --> ScicDbContext
    UserRepository --> ScicDbContext
    ScicDbContext --> SQLDatabase

    subgraph "Infrastructure - Deployment"
        DockerCompose["docker-compose.yml"]:::infra
        ServiceContainer["SCIC_BE Container"]:::infra
        DBContainer["Database Container"]:::infra
    end
    DockerCompose --> ServiceContainer
    DockerCompose --> DBContainer

    classDef external fill:#f2f2f2,stroke:#333,stroke-width:1px
    classDef infra fill:#d9d9d9,stroke:#666,stroke-width:1px
    classDef controllers fill:#cce5ff,stroke:#004085,stroke-width:2px
    classDef services fill:#d4edda,stroke:#155724,stroke-width:2px
    classDef repositories fill:#ffe5b4,stroke:#996600,stroke-width:2px
    classDef persistence fill:#f8d7da,stroke:#721c24,stroke-width:2px

    click Middleware "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Middlewares/Exceptions/ExceptionHandlingMiddleware.cs"
    click ScicDbContext "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Datas/ScicDbContext.cs"
    click AuthController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/AuthControllers/AuthController.cs"
    click AttendanceController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/AttendanceControllers/AttendanceController.cs"
    click DeviceController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/DeviceControllers/DeviceController.cs"
    click LecturerController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/LecturerControllers/LecturerController.cs"
    click PermissionController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/PermissionControllers/PermissionController.cs"
    click StudentController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/StudentControllers/StudentController.cs"
    click UserController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/UserControllers/UserController.cs"
    click AdminController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/AdminControllers/AdminController.cs"
    click WeatherForecastController "https://github.com/bachhungcb/scic_be/blob/main/SCIC_BE/Controllers/WeatherForecastController.cs"
    click DockerCompose "https://github.com/bachhungcb/scic_be/blob/main/docker-compose.yml"
    click ServiceContainer "https://github.com/bachhungcb/scic_be/tree/main/SCIC_BE/Dockerfile"
```
