# nqthangcs/cloud-deployments-seminar-assignment architecture

> Architecture diagram of the GitHub repository nqthangcs/cloud-deployments-seminar-assignment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nqthangcs/cloud-deployments-seminar-assignment
- Repository: https://github.com/nqthangcs/cloud-deployments-seminar-assignment

## Overview

This is a student grade-appeal portal. A student submits an assignment and reason through the React interface; the Flask API validates the request, generates a randomized verdict and response, stores the appeal, and returns it for display in the appeal history. The interface also fetches existing appeals and reports API connectivity. The graph includes the database model and logging layer; deployment and infrastructure files are excluded. Evidence is limited to the README and the sampled or indexed source files, so unsampled behavior is not inferred.

Main entry points: [`backend/app/routes/grade_appeal_route.py`](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/routes/grade_appeal_route.py) (Appeal endpoints), [`backend/app/app.py`](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/app.py) (Flask application), [`frontend/src/App.jsx`](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/App.jsx) (Portal shell), [`frontend/src/Appeals.jsx`](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/Appeals.jsx) (Appeal form and history)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student portal"]
  node_react_entry["React entry<br/>[main.jsx]"]
  node_portal["Portal shell<br/>[App.jsx]"]
  node_appeal_ui["Appeal form and history<br/>[Appeals.jsx]"]
end

subgraph group_backend["Appeal API"]
  node_flask_app["Flask application<br/>[app.py]"]
  node_appeal_routes["Appeal endpoints"]
  node_health_route["Health endpoint<br/>[health.py]"]
  node_response_generator["Verdict generator"]
end

subgraph group_persistence["Appeal persistence"]
  node_appeal_model["Appeal records<br/>[GradeAppeal.py]"]
  node_db_config["SQL setup<br/>[db_config.py]"]
  node_sql_store[("SQL database")]
end

subgraph group_operations["Runtime support"]
  node_logger["Application logger<br/>[logger_config.py]"]
end

node_student(("Student"))

node_react_entry -->|"renders"| node_portal
node_student -->|"submits appeal"| node_appeal_ui
node_portal -->|"renders"| node_appeal_ui
node_portal -->|"checks API"| node_flask_app
node_appeal_ui -->|"fetches appeals"| node_appeal_routes
node_flask_app -->|"registers"| node_appeal_routes
node_flask_app -->|"registers"| node_health_route
node_flask_app -->|"initializes database"| node_db_config
node_appeal_routes -->|"generates verdict"| node_response_generator
node_appeal_routes -->|"reads and creates"| node_appeal_model
node_appeal_routes -->|"logs errors"| node_logger
node_appeal_model -->|"uses SQLAlchemy"| node_db_config
node_db_config -->|"configures and creates tables"| node_sql_store

click node_react_entry "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/main.jsx"
click node_portal "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/App.jsx"
click node_appeal_ui "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/Appeals.jsx"
click node_flask_app "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/app.py"
click node_appeal_routes "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/routes/grade_appeal_route.py"
click node_health_route "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/routes/health.py"
click node_response_generator "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/services/grade_appeal_service.py"
click node_appeal_model "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/models/GradeAppeal.py"
click node_db_config "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/models/db_config.py"
click node_logger "https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/logger/logger_config.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_react_entry,node_portal,node_appeal_ui toneBlue
class node_flask_app,node_appeal_routes,node_health_route,node_response_generator toneAmber
class node_appeal_model,node_db_config,node_sql_store toneMint
class node_logger toneRose
class node_student toneIndigo
```

## Components

### Student portal

- [React entry](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Portal shell](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Appeal form and history](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/frontend/src/Appeals.jsx): `frontend/src/Appeals.jsx`

### Appeal API

- [Flask application](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/app.py): `backend/app/app.py`
- [Appeal endpoints](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/routes/grade_appeal_route.py): `backend/app/routes/grade_appeal_route.py`
- [Health endpoint](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/routes/health.py): `backend/app/routes/health.py`
- [Verdict generator](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/services/grade_appeal_service.py): `backend/app/services/grade_appeal_service.py`

### Appeal persistence

- [Appeal records](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/models/GradeAppeal.py): `backend/app/models/GradeAppeal.py`
- [SQL setup](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/models/db_config.py): `backend/app/models/db_config.py`
- **SQL database**

### Runtime support

- [Application logger](https://github.com/nqthangcs/cloud-deployments-seminar-assignment/blob/main/backend/app/logger/logger_config.py): `backend/app/logger/logger_config.py`

### Other components

- **Student**

## Connections

- React entry → Portal shell: renders (evidence: `frontend/src/main.jsx`)
- Student → Appeal form and history: submits appeal (evidence: `frontend/src/Appeals.jsx`)
- Portal shell → Appeal form and history: renders (evidence: `frontend/src/App.jsx`)
- Portal shell → Flask application: checks API (evidence: `frontend/src/App.jsx`)
- Appeal form and history → Appeal endpoints: fetches appeals (evidence: `frontend/src/Appeals.jsx`)
- Flask application → Appeal endpoints: registers (evidence: `backend/app/app.py`)
- Flask application → Health endpoint: registers (evidence: `backend/app/app.py`)
- Flask application → SQL setup: initializes database (evidence: `backend/app/app.py`)
- Appeal endpoints → Verdict generator: generates verdict (evidence: `backend/app/routes/grade_appeal_route.py`)
- Appeal endpoints → Appeal records: reads and creates (evidence: `backend/app/routes/grade_appeal_route.py`)
- Appeal endpoints → Application logger: logs errors (evidence: `backend/app/routes/grade_appeal_route.py`)
- Appeal records → SQL setup: uses SQLAlchemy (evidence: `backend/app/models/GradeAppeal.py`)
- SQL setup → SQL database: configures and creates tables (evidence: `backend/app/models/db_config.py`)
