# leduyen-05/internshipmanagement architecture

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

- Interactive diagram: https://gitdiagram.com/leduyen-05/internshipmanagement
- Repository: https://github.com/leduyen-05/internshipmanagement

## Overview

This is a thesis-internship management system with a React client, an ASP.NET API/BLL/DAL backend, and an offline company-recommendation script. The demonstrated user workflow is browsing and maintaining student records; the README describes broader internship stages including company registration, applications, interviews, placement, supervision, progress, and evaluation. Those domain stages are represented by the documented data model, not asserted as implemented end-to-end. Edges reflect shown code references or README statements; the frontend-to-API HTTP wiring is not shown and is marked unverified.

Main entry points: [`backend/src/InternshipManagement.DAL/AppDbContext.cs`](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/AppDbContext.cs) (Data model context), [`frontend/src/services/sinhVienService.js`](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/services/sinhVienService.js) (Student API client), [`backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs`](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs) (Student business logic), [`ml-service/generate_recommendations.py`](https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/generate_recommendations.py) (Recommendation generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_routes["Client routes<br/>[AppRoutes.jsx]"]
  node_student_page["Student records page"]
  node_student_client["Student API client<br/>[sinhVienService.js]"]
  node_http_client["HTTP client<br/>[api.js]"]
  node_api_routes["API route constants<br/>[apiRoutes.js]"]
end

subgraph group_backend["Application backend"]
  node_student_api["Student API controller"]
  node_student_logic["Student business logic<br/>[SinhVienService.cs]"]
  node_student_validation["Student input validation"]
  node_student_repo["Student repository"]
  node_data_context["Data model context<br/>[AppDbContext.cs]"]
end

subgraph group_internship["Internship domain"]
  node_student_profile["Student profile<br/>[SinhVien.cs]"]
  node_company["Company records<br/>[CongTy.cs]"]
  node_internship_application["Internship applications<br/>[DangKyThucTap.cs]"]
  node_placement["Internship placement<br/>[PhanBoThucTap.cs]"]
  node_interview["Company interviews<br/>[PhongVan.cs]"]
  node_company_proposal["Company proposals<br/>[DeXuatCongTy.cs]"]
  node_student_skills["Student capability profile<br/>[HoSoNangLuc.cs]"]
end

subgraph group_recommendations["Recommendations"]
  node_recommendation_generator["Recommendation generator"]
  node_similarity["Similarity scoring"]
  node_ml_database["ML database connection<br/>[connection.py]"]
end

node_student(("Student user"))
node_sql_server[("SQL Server")]

node_student -->|"opens"| node_routes
node_routes -->|"routes to"| node_student_page
node_student_page -->|"uses"| node_student_client
node_student_client -->|"calls"| node_http_client
node_student_client -->|"uses"| node_api_routes
node_student_client -.->|"requests"| node_student_api
node_student_api -->|"delegates to"| node_student_logic
node_student_logic -->|"validates with"| node_student_validation
node_student_logic -->|"reads and writes"| node_student_repo
node_student_repo -->|"uses"| node_data_context
node_data_context -->|"configures SQL Server"| node_sql_server
node_data_context -->|"maps"| node_student_profile
node_data_context -->|"maps"| node_company
node_data_context -->|"maps"| node_internship_application
node_data_context -->|"maps"| node_placement
node_data_context -->|"maps"| node_interview
node_data_context -->|"maps"| node_company_proposal
node_data_context -->|"maps"| node_student_skills
node_recommendation_generator -->|"uses"| node_similarity
node_recommendation_generator -->|"uses"| node_ml_database

click node_routes "https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_student_page "https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/pages/SinhVien/SinhVienListPage.jsx"
click node_student_client "https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/services/sinhVienService.js"
click node_http_client "https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/services/api.js"
click node_api_routes "https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/constants/apiRoutes.js"
click node_student_api "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.API/Controllers/SinhVienController.cs"
click node_student_logic "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs"
click node_student_validation "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.BLL/Validators/SinhVien/CreateSinhVienValidator.cs"
click node_student_repo "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Repositories/SinhVienRepository.cs"
click node_data_context "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/AppDbContext.cs"
click node_student_profile "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/SinhVien.cs"
click node_company "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/CongTy.cs"
click node_internship_application "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/DangKyThucTap.cs"
click node_placement "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/PhanBoThucTap.cs"
click node_interview "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/PhongVan.cs"
click node_company_proposal "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/DeXuatCongTy.cs"
click node_student_skills "https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/HoSoNangLuc.cs"
click node_recommendation_generator "https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/generate_recommendations.py"
click node_similarity "https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/services/similarity_service.py"
click node_ml_database "https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/db/connection.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_routes,node_student_page,node_student_client,node_http_client,node_api_routes,node_student toneBlue
class node_student_api,node_student_logic,node_student_validation,node_student_repo,node_data_context,node_sql_server toneAmber
class node_student_profile,node_company,node_internship_application,node_placement,node_interview,node_company_proposal,node_student_skills toneMint
class node_recommendation_generator,node_similarity,node_ml_database toneRose
```

## Components

### Web client

- [Client routes](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Student records page](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/pages/SinhVien/SinhVienListPage.jsx): `frontend/src/pages/SinhVien/SinhVienListPage.jsx`
- [Student API client](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/services/sinhVienService.js): `frontend/src/services/sinhVienService.js`
- [HTTP client](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [API route constants](https://github.com/leduyen-05/internshipmanagement/blob/main/frontend/src/constants/apiRoutes.js): `frontend/src/constants/apiRoutes.js`

### Application backend

- [Student API controller](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.API/Controllers/SinhVienController.cs): `backend/src/InternshipManagement.API/Controllers/SinhVienController.cs`
- [Student business logic](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs): `backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs`
- [Student input validation](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.BLL/Validators/SinhVien/CreateSinhVienValidator.cs): `backend/src/InternshipManagement.BLL/Validators/SinhVien/CreateSinhVienValidator.cs`
- [Student repository](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Repositories/SinhVienRepository.cs): `backend/src/InternshipManagement.DAL/Repositories/SinhVienRepository.cs`
- [Data model context](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/AppDbContext.cs): `backend/src/InternshipManagement.DAL/AppDbContext.cs`

### Internship domain

- [Student profile](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/SinhVien.cs): `backend/src/InternshipManagement.DAL/Entities/SinhVien.cs`
- [Company records](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/CongTy.cs): `backend/src/InternshipManagement.DAL/Entities/CongTy.cs`
- [Internship applications](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/DangKyThucTap.cs): `backend/src/InternshipManagement.DAL/Entities/DangKyThucTap.cs`
- [Internship placement](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/PhanBoThucTap.cs): `backend/src/InternshipManagement.DAL/Entities/PhanBoThucTap.cs`
- [Company interviews](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/PhongVan.cs): `backend/src/InternshipManagement.DAL/Entities/PhongVan.cs`
- [Company proposals](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/DeXuatCongTy.cs): `backend/src/InternshipManagement.DAL/Entities/DeXuatCongTy.cs`
- [Student capability profile](https://github.com/leduyen-05/internshipmanagement/blob/main/backend/src/InternshipManagement.DAL/Entities/HoSoNangLuc.cs): `backend/src/InternshipManagement.DAL/Entities/HoSoNangLuc.cs`

### Recommendations

- [Recommendation generator](https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/generate_recommendations.py): `ml-service/generate_recommendations.py`
- [Similarity scoring](https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/services/similarity_service.py): `ml-service/services/similarity_service.py`
- [ML database connection](https://github.com/leduyen-05/internshipmanagement/blob/main/ml-service/db/connection.py): `ml-service/db/connection.py`

### Other components

- **Student user**
- **SQL Server**

## Connections

- Student user → Client routes: opens
- Client routes → Student records page: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Student records page → Student API client: uses (evidence: `frontend/src/pages/SinhVien/SinhVienListPage.jsx`)
- Student API client → HTTP client: calls (evidence: `frontend/src/services/sinhVienService.js`)
- Student API client → API route constants: uses (evidence: `frontend/src/services/sinhVienService.js`)
- Student API client → Student API controller: requests
- Student API controller → Student business logic: delegates to (evidence: `backend/src/InternshipManagement.API/Controllers/SinhVienController.cs`)
- Student business logic → Student input validation: validates with (evidence: `backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs`)
- Student business logic → Student repository: reads and writes (evidence: `backend/src/InternshipManagement.BLL/Services/SinhVien/SinhVienService.cs`)
- Student repository → Data model context: uses (evidence: `backend/src/InternshipManagement.DAL/Repositories/SinhVienRepository.cs`)
- Data model context → SQL Server: configures SQL Server
- Data model context → Student profile: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Company records: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Internship applications: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Internship placement: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Company interviews: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Company proposals: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Data model context → Student capability profile: maps (evidence: `backend/src/InternshipManagement.DAL/AppDbContext.cs`)
- Recommendation generator → Similarity scoring: uses (evidence: `ml-service/generate_recommendations.py`)
- Recommendation generator → ML database connection: uses (evidence: `ml-service/generate_recommendations.py`)
