# minh-kma/lab4_cnwatt architecture

> Architecture diagram of the GitHub repository minh-kma/lab4_cnwatt, 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/minh-kma/lab4_cnwatt
- Repository: https://github.com/minh-kma/lab4_cnwatt

## Overview

This is a PHP web-practice application: users navigate a collection of exercises covering forms, calculations, sessions, cookies, file handling, and student records. The main exercise workflow enters through index.php, which selects a page and renders it inside the shared layout. Separate entry points handle registration, login, administration, and student-management exercises. The map preserves these documented-by-tree branches, but several are unsampled; their internal relationships are therefore omitted rather than inferred.

Main entry points: [`index.php`](https://github.com/minh-kma/lab4_cnwatt/blob/main/index.php) (Exercise Router), [`Menu.php`](https://github.com/minh-kma/lab4_cnwatt/blob/main/Menu.php) (Exercise Menu), [`admin/index.php`](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/index.php) (Admin Router), [`session.php`](https://github.com/minh-kma/lab4_cnwatt/blob/main/session.php) (Session Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_practice["Practice Hub"]
  node_main["Exercise Router<br/>[index.php]"]
  node_layout["Shared Layout<br/>[Head.php]"]
  node_navigation["Exercise Menu<br/>[Menu.php]"]
end

subgraph group_forms["Forms &amp; Calculations"]
  node_drawtable["Table Exercise<br/>[drawTable.php]"]
  node_calculate1["Calculation Exercise<br/>[calculate1.php]"]
  node_calculate2["Score Calculator<br/>[calculate2.php]"]
  node_array1["Matrix Arithmetic<br/>[array1.php]"]
  node_array2["Array Exercise<br/>[array2.php]"]
  node_getform["GET/POST Forms<br/>[getform.php]"]
  node_registration["Registration Form<br/>[register.php]"]
  node_registerresult["Registration Result<br/>[ResultRegister.php]"]
  node_functionexercise["Function Exercises<br/>[function.php]"]
  node_matrixfunctions["Matrix Functions<br/>[matrix.php]"]
end

subgraph group_security["Sessions &amp; Admin"]
  node_sessionentry["Session Portal<br/>[session.php]"]
  node_sessioninit["Session Setup<br/>[session_init.php]"]
  node_loginform["Login Form<br/>[login.php]"]
  node_admin["Admin Router<br/>[index.php]"]
  node_adminmenu["Admin Navigation<br/>[MenuAdmin.php]"]
  node_adminhome["Admin Home<br/>[home.php]"]
  node_favourites["Favourite Links<br/>[favourite.php]"]
  node_favouriteaction["Favourite Actions"]
  node_cookieexercise["Cookie Exercise<br/>[cookie.php]"]
end

subgraph group_records["Files &amp; Student Data"]
  node_adminupload["Admin Upload<br/>[upload.php]"]
  node_fileexercise["File Exercise<br/>[file.php]"]
  node_studentfiles["File Student Records<br/>[qldt.php]"]
  node_databaseexercise["Database Exercise<br/>[db.php]"]
  node_studentrecords["Student CRUD"]
  node_dbhelper["Database Helper<br/>[db_helper.php]"]
  node_qlsvhelper["Student Helper<br/>[qlsv_helper.php]"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_main
node_main -->|"includes"| node_layout
node_main -->|"includes"| node_navigation
node_main -->|"routes to"| node_drawtable
node_main -->|"routes to"| node_calculate1
node_main -->|"routes to"| node_calculate2
node_main -->|"routes to"| node_array1
node_main -->|"routes to"| node_array2
node_navigation -->|"links to"| node_getform
node_navigation -->|"links to"| node_sessionentry
node_navigation -->|"links to"| node_cookieexercise
node_navigation -->|"links to"| node_functionexercise
node_navigation -->|"links to"| node_fileexercise
node_navigation -->|"links to"| node_studentfiles
node_navigation -->|"links to"| node_databaseexercise
node_getform -->|"routes to"| node_registration
node_registration -->|"submits to"| node_registerresult
node_sessionentry -->|"initializes"| node_sessioninit
node_sessionentry -->|"routes to"| node_loginform
node_sessionentry -->|"redirects to"| node_admin
node_admin -->|"initializes"| node_sessioninit
node_admin -->|"includes"| node_adminmenu
node_admin -->|"routes to"| node_adminhome
node_admin -->|"routes to"| node_favourites
node_admin -->|"dispatches"| node_favouriteaction
node_admin -->|"routes to"| node_adminupload
node_functionexercise -.->|"may use"| node_matrixfunctions
node_studentfiles -.->|"may use"| node_fileexercise
node_databaseexercise -.->|"may use"| node_dbhelper
node_databaseexercise -.->|"may expose"| node_studentrecords
node_studentrecords -.->|"may use"| node_qlsvhelper

click node_main "https://github.com/minh-kma/lab4_cnwatt/blob/main/index.php"
click node_layout "https://github.com/minh-kma/lab4_cnwatt/blob/main/Head.php"
click node_navigation "https://github.com/minh-kma/lab4_cnwatt/blob/main/Menu.php"
click node_drawtable "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/drawTable.php"
click node_calculate1 "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/calculate1.php"
click node_calculate2 "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/calculate2.php"
click node_array1 "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/array1.php"
click node_array2 "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/array2.php"
click node_getform "https://github.com/minh-kma/lab4_cnwatt/blob/main/getform.php"
click node_registration "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/getform/register.php"
click node_registerresult "https://github.com/minh-kma/lab4_cnwatt/blob/main/ResultRegister.php"
click node_sessionentry "https://github.com/minh-kma/lab4_cnwatt/blob/main/session.php"
click node_sessioninit "https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/session_init.php"
click node_loginform "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/session/login.php"
click node_admin "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/index.php"
click node_adminmenu "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/MenuAdmin.php"
click node_adminhome "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/home.php"
click node_favourites "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/favourite.php"
click node_favouriteaction "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/favourite_action.php"
click node_adminupload "https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/upload.php"
click node_cookieexercise "https://github.com/minh-kma/lab4_cnwatt/blob/main/cookie.php"
click node_functionexercise "https://github.com/minh-kma/lab4_cnwatt/blob/main/function.php"
click node_matrixfunctions "https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/function/matrix.php"
click node_fileexercise "https://github.com/minh-kma/lab4_cnwatt/blob/main/file.php"
click node_studentfiles "https://github.com/minh-kma/lab4_cnwatt/blob/main/qldt.php"
click node_databaseexercise "https://github.com/minh-kma/lab4_cnwatt/blob/main/db.php"
click node_studentrecords "https://github.com/minh-kma/lab4_cnwatt/tree/main/pages/qlsv"
click node_dbhelper "https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/db_helper.php"
click node_qlsvhelper "https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/qlsv_helper.php"

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_main,node_layout,node_navigation toneBlue
class node_drawtable,node_calculate1,node_calculate2,node_array1,node_array2,node_getform,node_registration,node_registerresult,node_functionexercise,node_matrixfunctions toneAmber
class node_sessionentry,node_sessioninit,node_loginform,node_admin,node_adminmenu,node_adminhome,node_favourites,node_favouriteaction,node_cookieexercise toneMint
class node_adminupload,node_fileexercise,node_studentfiles,node_databaseexercise,node_studentrecords,node_dbhelper,node_qlsvhelper toneRose
class node_learner toneIndigo
```

## Components

### Practice Hub

- [Exercise Router](https://github.com/minh-kma/lab4_cnwatt/blob/main/index.php): `index.php`
- [Shared Layout](https://github.com/minh-kma/lab4_cnwatt/blob/main/Head.php): `Head.php`
- [Exercise Menu](https://github.com/minh-kma/lab4_cnwatt/blob/main/Menu.php): `Menu.php`

### Forms & Calculations

- [Table Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/drawTable.php): `pages/drawTable.php`
- [Calculation Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/calculate1.php): `pages/calculate1.php`
- [Score Calculator](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/calculate2.php): `pages/calculate2.php`
- [Matrix Arithmetic](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/array1.php): `pages/array1.php`
- [Array Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/array2.php): `pages/array2.php`
- [GET/POST Forms](https://github.com/minh-kma/lab4_cnwatt/blob/main/getform.php): `getform.php`
- [Registration Form](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/getform/register.php): `pages/getform/register.php`
- [Registration Result](https://github.com/minh-kma/lab4_cnwatt/blob/main/ResultRegister.php): `ResultRegister.php`
- [Function Exercises](https://github.com/minh-kma/lab4_cnwatt/blob/main/function.php): `function.php`
- [Matrix Functions](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/function/matrix.php): `pages/function/matrix.php`

### Sessions & Admin

- [Session Portal](https://github.com/minh-kma/lab4_cnwatt/blob/main/session.php): `session.php`
- [Session Setup](https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/session_init.php): `libs/session_init.php`
- [Login Form](https://github.com/minh-kma/lab4_cnwatt/blob/main/pages/session/login.php): `pages/session/login.php`
- [Admin Router](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/index.php): `admin/index.php`
- [Admin Navigation](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/MenuAdmin.php): `admin/MenuAdmin.php`
- [Admin Home](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/home.php): `admin/pages/home.php`
- [Favourite Links](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/favourite.php): `admin/pages/favourite.php`
- [Favourite Actions](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/favourite_action.php): `admin/pages/favourite_action.php`
- [Cookie Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/cookie.php): `cookie.php`

### Files & Student Data

- [Admin Upload](https://github.com/minh-kma/lab4_cnwatt/blob/main/admin/pages/upload.php): `admin/pages/upload.php`
- [File Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/file.php): `file.php`
- [File Student Records](https://github.com/minh-kma/lab4_cnwatt/blob/main/qldt.php): `qldt.php`
- [Database Exercise](https://github.com/minh-kma/lab4_cnwatt/blob/main/db.php): `db.php`
- [Student CRUD](https://github.com/minh-kma/lab4_cnwatt/tree/main/pages/qlsv): `pages/qlsv`
- [Database Helper](https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/db_helper.php): `libs/db_helper.php`
- [Student Helper](https://github.com/minh-kma/lab4_cnwatt/blob/main/libs/qlsv_helper.php): `libs/qlsv_helper.php`

### Other components

- **Learner**

## Connections

- Learner → Exercise Router: opens
- Exercise Router → Shared Layout: includes (evidence: `index.php`)
- Exercise Router → Exercise Menu: includes (evidence: `index.php`)
- Exercise Router → Table Exercise: routes to (evidence: `index.php`)
- Exercise Router → Calculation Exercise: routes to (evidence: `index.php`)
- Exercise Router → Score Calculator: routes to (evidence: `index.php`)
- Exercise Router → Matrix Arithmetic: routes to (evidence: `index.php`)
- Exercise Router → Array Exercise: routes to (evidence: `index.php`)
- Exercise Menu → GET/POST Forms: links to (evidence: `Menu.php`)
- Exercise Menu → Session Portal: links to (evidence: `Menu.php`)
- Exercise Menu → Cookie Exercise: links to (evidence: `Menu.php`)
- Exercise Menu → Function Exercises: links to (evidence: `Menu.php`)
- Exercise Menu → File Exercise: links to (evidence: `Menu.php`)
- Exercise Menu → File Student Records: links to (evidence: `Menu.php`)
- Exercise Menu → Database Exercise: links to (evidence: `Menu.php`)
- GET/POST Forms → Registration Form: routes to (evidence: `pages/getform/register.php`)
- Registration Form → Registration Result: submits to (evidence: `pages/getform/register.php`)
- Session Portal → Session Setup: initializes (evidence: `session.php`)
- Session Portal → Login Form: routes to (evidence: `session.php`)
- Session Portal → Admin Router: redirects to (evidence: `session.php`)
- Admin Router → Session Setup: initializes (evidence: `admin/index.php`)
- Admin Router → Admin Navigation: includes (evidence: `admin/index.php`)
- Admin Router → Admin Home: routes to (evidence: `admin/index.php`)
- Admin Router → Favourite Links: routes to (evidence: `admin/index.php`)
- Admin Router → Favourite Actions: dispatches (evidence: `admin/index.php`)
- Admin Router → Admin Upload: routes to (evidence: `admin/index.php`)
- Function Exercises → Matrix Functions: may use
- File Student Records → File Exercise: may use
- Database Exercise → Database Helper: may use
- Database Exercise → Student CRUD: may expose
- Student CRUD → Student Helper: may use
