# lien2004-lien/hl-course architecture

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

- Interactive diagram: https://gitdiagram.com/lien2004-lien/hl-course
- Repository: https://github.com/lien2004-lien/hl-course

## Overview

This Django application supports course discovery, student registration and login, course enrollment and demo payment, automatic class assignment, and student/teacher dashboards. The main flow runs from course enrollment through payment confirmation to class placement; home and course browsing are separate entry points. The README is empty, so capabilities and relationships are inferred from the source index and shown excerpts; unsampled view behavior is represented only where the index or URL configuration supports it.

Main entry points: [`apps/enrollments/models.py`](https://github.com/lien2004-lien/hl-course/blob/main/apps/enrollments/models.py) (Enrollment records), [`apps/accounts/urls.py`](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/urls.py) (Account routes), [`apps/courses/models.py`](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/models.py) (Course and class records), [`apps/payments/models.py`](https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/models.py) (Payment records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and accounts"]
  node_site_urls["Site routes<br/>[urls.py]"]
  node_home["Home page<br/>[trang_chu.py]"]
  node_account_routes["Account routes<br/>[urls.py]"]
  node_signup["Registration<br/>[dang_ky.py]"]
  node_login["Login<br/>[dang_nhap.py]"]
  node_logout["Logout<br/>[dang_xuat.py]"]
  node_account_forms["Account forms<br/>[forms.py]"]
  node_student_dash["Student dashboard<br/>[hoc_vien.py]"]
  node_teacher_dash["Teacher dashboard<br/>[giang_vien.py]"]
end

subgraph group_learning["Courses and classes"]
  node_course_routes["Course routes<br/>[urls.py]"]
  node_course_list["Course listing"]
  node_course_detail["Course detail"]
  node_course_enroll["Course enrollment"]
  node_class_assign["Class assignment<br/>[phan_lop.py]"]
end

subgraph group_transactions["Enrollment and payment"]
  node_payment_routes["Payment routes<br/>[urls.py]"]
  node_payment_flow["Demo payment<br/>[thanh_toan.py]"]
end

subgraph group_records["Domain records"]
  node_enrollment_records[("Enrollment records<br/>[models.py]")]
  node_payment_records[("Payment records<br/>[models.py]")]
  node_course_records[("Course and class records<br/>[models.py]")]
  node_user_records[("User records<br/>[models.py]")]
end

node_visitor(("Site user"))

node_visitor -->|"opens site"| node_site_urls
node_site_urls -->|"routes home"| node_home
node_visitor -->|"uses accounts"| node_account_routes
node_account_routes -->|"routes registration"| node_signup
node_account_routes -->|"routes login"| node_login
node_account_routes -->|"routes logout"| node_logout
node_account_routes -->|"routes dashboard"| node_student_dash
node_account_routes -->|"routes dashboard"| node_teacher_dash
node_signup -->|"uses forms"| node_account_forms
node_account_forms -->|"uses user model"| node_user_records
node_home -->|"queries courses"| node_course_records
node_home -->|"queries users"| node_user_records
node_home -->|"counts enrollments"| node_enrollment_records
node_visitor -->|"browses courses"| node_course_routes
node_course_routes -->|"routes listing"| node_course_list
node_course_routes -->|"routes detail"| node_course_detail
node_course_routes -->|"routes enrollment"| node_course_enroll
node_course_enroll -->|"loads course"| node_course_records
node_course_enroll -->|"creates enrollment"| node_enrollment_records
node_course_enroll -->|"creates payment"| node_payment_records
node_visitor -->|"opens payment"| node_payment_routes
node_payment_routes -->|"routes payment"| node_payment_flow
node_payment_flow -->|"updates payment"| node_payment_records
node_payment_flow -->|"assigns class"| node_class_assign
node_class_assign -->|"creates class"| node_course_records
node_class_assign -->|"sets class group"| node_enrollment_records
node_student_dash -->|"queries courses"| node_course_records
node_student_dash -->|"lists enrollments"| node_enrollment_records
node_student_dash -->|"filters paid"| node_payment_records
node_teacher_dash -->|"loads classes"| node_course_records
node_enrollment_records -->|"references student"| node_user_records
node_enrollment_records -->|"references course"| node_course_records
node_payment_records -->|"references enrollment"| node_enrollment_records
node_payment_records -->|"references student"| node_user_records
node_payment_records -->|"references course"| node_course_records

click node_site_urls "https://github.com/lien2004-lien/hl-course/blob/main/hl_course/urls.py"
click node_home "https://github.com/lien2004-lien/hl-course/blob/main/hl_course/trang_chu.py"
click node_account_routes "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/urls.py"
click node_signup "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_ky.py"
click node_login "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_nhap.py"
click node_logout "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_xuat.py"
click node_account_forms "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/forms.py"
click node_student_dash "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/hoc_vien.py"
click node_teacher_dash "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/giang_vien.py"
click node_course_routes "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/urls.py"
click node_course_list "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/danh_sach_khoa_hoc.py"
click node_course_detail "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/chi_tiet_khoa_hoc.py"
click node_course_enroll "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/dang_ky_khoa_hoc.py"
click node_class_assign "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/phan_lop.py"
click node_payment_routes "https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/urls.py"
click node_payment_flow "https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/thanh_toan.py"
click node_enrollment_records "https://github.com/lien2004-lien/hl-course/blob/main/apps/enrollments/models.py"
click node_payment_records "https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/models.py"
click node_course_records "https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/models.py"
click node_user_records "https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/models.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_site_urls,node_home,node_account_routes,node_signup,node_login,node_logout,node_account_forms,node_student_dash,node_teacher_dash,node_visitor toneBlue
class node_course_routes,node_course_list,node_course_detail,node_course_enroll,node_class_assign toneAmber
class node_payment_routes,node_payment_flow toneMint
class node_enrollment_records,node_payment_records,node_course_records,node_user_records toneRose
```

## Components

### Entry and accounts

- [Site routes](https://github.com/lien2004-lien/hl-course/blob/main/hl_course/urls.py): `hl_course/urls.py`
- [Home page](https://github.com/lien2004-lien/hl-course/blob/main/hl_course/trang_chu.py): `hl_course/trang_chu.py`
- [Account routes](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/urls.py): `apps/accounts/urls.py`
- [Registration](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_ky.py): `apps/accounts/dang_ky.py`
- [Login](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_nhap.py): `apps/accounts/dang_nhap.py`
- [Logout](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/dang_xuat.py): `apps/accounts/dang_xuat.py`
- [Account forms](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/forms.py): `apps/accounts/forms.py`
- [Student dashboard](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/hoc_vien.py): `apps/accounts/hoc_vien.py`
- [Teacher dashboard](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/giang_vien.py): `apps/accounts/giang_vien.py`

### Courses and classes

- [Course routes](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/urls.py): `apps/courses/urls.py`
- [Course listing](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/danh_sach_khoa_hoc.py): `apps/courses/danh_sach_khoa_hoc.py`
- [Course detail](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/chi_tiet_khoa_hoc.py): `apps/courses/chi_tiet_khoa_hoc.py`
- [Course enrollment](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/dang_ky_khoa_hoc.py): `apps/courses/dang_ky_khoa_hoc.py`
- [Class assignment](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/phan_lop.py): `apps/courses/phan_lop.py`

### Enrollment and payment

- [Payment routes](https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/urls.py): `apps/payments/urls.py`
- [Demo payment](https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/thanh_toan.py): `apps/payments/thanh_toan.py`

### Domain records

- [Enrollment records](https://github.com/lien2004-lien/hl-course/blob/main/apps/enrollments/models.py): `apps/enrollments/models.py`
- [Payment records](https://github.com/lien2004-lien/hl-course/blob/main/apps/payments/models.py): `apps/payments/models.py`
- [Course and class records](https://github.com/lien2004-lien/hl-course/blob/main/apps/courses/models.py): `apps/courses/models.py`
- [User records](https://github.com/lien2004-lien/hl-course/blob/main/apps/accounts/models.py): `apps/accounts/models.py`

### Other components

- **Site user**

## Connections

- Site user → Site routes: opens site
- Site routes → Home page: routes home (evidence: `hl_course/urls.py`)
- Site user → Account routes: uses accounts
- Account routes → Registration: routes registration (evidence: `apps/accounts/urls.py`)
- Account routes → Login: routes login (evidence: `apps/accounts/urls.py`)
- Account routes → Logout: routes logout (evidence: `apps/accounts/urls.py`)
- Account routes → Student dashboard: routes dashboard (evidence: `apps/accounts/urls.py`)
- Account routes → Teacher dashboard: routes dashboard (evidence: `apps/accounts/urls.py`)
- Registration → Account forms: uses forms (evidence: `apps/accounts/dang_ky.py`)
- Account forms → User records: uses user model (evidence: `apps/accounts/forms.py`)
- Home page → Course and class records: queries courses (evidence: `hl_course/trang_chu.py`)
- Home page → User records: queries users (evidence: `hl_course/trang_chu.py`)
- Home page → Enrollment records: counts enrollments (evidence: `hl_course/trang_chu.py`)
- Site user → Course routes: browses courses
- Course routes → Course listing: routes listing (evidence: `apps/courses/urls.py`)
- Course routes → Course detail: routes detail (evidence: `apps/courses/urls.py`)
- Course routes → Course enrollment: routes enrollment (evidence: `apps/courses/urls.py`)
- Course enrollment → Course and class records: loads course (evidence: `apps/courses/dang_ky_khoa_hoc.py`)
- Course enrollment → Enrollment records: creates enrollment (evidence: `apps/courses/dang_ky_khoa_hoc.py`)
- Course enrollment → Payment records: creates payment (evidence: `apps/courses/dang_ky_khoa_hoc.py`)
- Site user → Payment routes: opens payment
- Payment routes → Demo payment: routes payment (evidence: `apps/payments/urls.py`)
- Demo payment → Payment records: updates payment (evidence: `apps/payments/thanh_toan.py`)
- Demo payment → Class assignment: assigns class (evidence: `apps/payments/thanh_toan.py`)
- Class assignment → Course and class records: creates class (evidence: `apps/courses/phan_lop.py`)
- Class assignment → Enrollment records: sets class group (evidence: `apps/courses/phan_lop.py`)
- Student dashboard → Course and class records: queries courses (evidence: `apps/accounts/hoc_vien.py`)
- Student dashboard → Enrollment records: lists enrollments (evidence: `apps/accounts/hoc_vien.py`)
- Student dashboard → Payment records: filters paid (evidence: `apps/accounts/hoc_vien.py`)
- Teacher dashboard → Course and class records: loads classes (evidence: `apps/accounts/giang_vien.py`)
- Enrollment records → User records: references student (evidence: `apps/enrollments/models.py`)
- Enrollment records → Course and class records: references course (evidence: `apps/enrollments/models.py`)
- Payment records → Enrollment records: references enrollment (evidence: `apps/payments/models.py`)
- Payment records → User records: references student (evidence: `apps/payments/models.py`)
- Payment records → Course and class records: references course (evidence: `apps/payments/models.py`)
