# natsirt-01/wawata architecture

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

- Interactive diagram: https://gitdiagram.com/natsirt-01/wawata
- Repository: https://github.com/natsirt-01/wawata

## Overview

ScholarNet/CompHub is a desktop lab-management system with student endpoints and teacher/admin consoles. The main workflow is account login and lab-session registration, followed by live endpoint monitoring and teacher actions such as messaging, screen viewing/control, and device commands. Persistent accounts, sessions, alerts, and inventory are handled by the server-side database. The tree and excerpts support the main login, dashboard, networking, and storage relationships; several listed capabilities are represented by their source modules, but their internal call paths were not sampled.

Main entry points: [`thesis-main/teacher_dashboard/teacher_dash.py`](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/teacher_dash.py) (Teacher Dashboard), [`Student/network_config.py`](https://github.com/natsirt-01/wawata/blob/main/Student/network_config.py) (Endpoint Network Config), [`thesis-main/admin_dashboard/admin_dash.py`](https://github.com/natsirt-01/wawata/blob/main/thesis-main/admin_dashboard/admin_dash.py) (Admin Dashboard), [`Student/login_student.py`](https://github.com/natsirt-01/wawata/blob/main/Student/login_student.py) (Student Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student Endpoint"]
  node_student_login["Student Login<br/>[login_student.py]"]
  node_student_commands["Endpoint Commands<br/>[client_side.py]"]
  node_student_listener["Endpoint Listener<br/>[client_listener.py]"]
  node_student_stream["Screen Sender<br/>[screen_sender.py]"]
  node_student_webcam["Webcam Window"]
end

subgraph group_server["Login And Sessions"]
  node_server_login["Login Service<br/>[login.py]"]
end

subgraph group_teacher["Teacher Monitoring"]
  node_teacher_dashboard["Teacher Dashboard<br/>[teacher_dash.py]"]
  node_listeners["Connection And Stream Listeners"]
  node_student_cards["Live Student Cards<br/>[student_cards.py]"]
  node_screen_viewer["Screen Viewer And Control<br/>[screen_receiver.py]"]
  node_network_commands["Device Commands<br/>[network_utils.py]"]
  node_teacher_inbox["Alerts And Inbox<br/>[inbox_window.py]"]
  node_teacher_history["Session History<br/>[history_window.py]"]
  node_teacher_webcam["Student Webcam<br/>[student_webcam.py]"]
  node_teacher_broadcast["Broadcast"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin Dashboard<br/>[admin_dash.py]"]
  node_account_approvals["Account Approvals"]
end

subgraph group_data["Persistence And Config"]
  node_database[("Application Database<br/>[db.py]")]
  node_server_config["Server Configuration<br/>[config.py]"]
  node_student_network_config["Endpoint Network Config<br/>[network_config.py]"]
end

node_student_user(("Student"))

node_student_user -->|"signs in"| node_student_login
node_student_login -.->|"submits login"| node_server_login
node_student_login -->|"uses settings"| node_student_network_config
node_student_login -.->|"starts streaming"| node_student_stream
node_student_login -->|"opens webcam"| node_student_webcam
node_student_commands -->|"uses sender"| node_student_stream
node_student_commands -->|"uses settings"| node_student_network_config
node_student_listener -->|"uses settings"| node_student_network_config
node_student_stream -->|"uses settings"| node_student_network_config
node_student_webcam -.->|"uses settings"| node_student_network_config
node_server_login -->|"reads and writes"| node_database
node_server_login -->|"opens dashboard"| node_teacher_dashboard
node_server_login -->|"starts listeners"| node_listeners
node_server_login -->|"uses settings"| node_server_config
node_teacher_dashboard -->|"starts monitoring"| node_listeners
node_teacher_dashboard -->|"builds cards"| node_student_cards
node_teacher_dashboard -->|"opens viewer"| node_screen_viewer
node_teacher_dashboard -->|"sends commands"| node_network_commands
node_teacher_dashboard -->|"opens history"| node_teacher_history
node_teacher_dashboard -->|"opens inbox"| node_teacher_inbox
node_teacher_dashboard -.->|"opens webcam"| node_teacher_webcam
node_teacher_dashboard -.->|"uses broadcast"| node_teacher_broadcast
node_listeners -->|"updates cards"| node_student_cards
node_listeners -->|"looks up users"| node_database
node_screen_viewer -->|"uses control port"| node_student_network_config
node_network_commands -->|"uses ports"| node_student_network_config
node_admin_dashboard -->|"manages records"| node_database
node_admin_dashboard -->|"hydrates monitoring"| node_listeners
node_admin_dashboard -->|"opens inbox"| node_teacher_inbox
node_admin_dashboard -->|"uses cards"| node_student_cards
node_admin_dashboard -.->|"manages approvals"| node_account_approvals
node_teacher_dashboard -->|"reads session data"| node_database
node_teacher_dashboard -->|"uses settings"| node_server_config

click node_student_login "https://github.com/natsirt-01/wawata/blob/main/Student/login_student.py"
click node_student_commands "https://github.com/natsirt-01/wawata/blob/main/Student/client_side.py"
click node_student_listener "https://github.com/natsirt-01/wawata/blob/main/Student/client_listener.py"
click node_student_stream "https://github.com/natsirt-01/wawata/blob/main/Student/screen_sender.py"
click node_student_webcam "https://github.com/natsirt-01/wawata/blob/main/Student/student_webcam_window.py"
click node_server_login "https://github.com/natsirt-01/wawata/blob/main/thesis-main/login.py"
click node_teacher_dashboard "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/teacher_dash.py"
click node_listeners "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/network_listeners.py"
click node_student_cards "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/student_cards.py"
click node_screen_viewer "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/screen_receiver.py"
click node_network_commands "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/network_utils.py"
click node_teacher_inbox "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/inbox_window.py"
click node_teacher_history "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/history_window.py"
click node_teacher_webcam "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/student_webcam.py"
click node_teacher_broadcast "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/teacher_broadcast.py"
click node_admin_dashboard "https://github.com/natsirt-01/wawata/blob/main/thesis-main/admin_dashboard/admin_dash.py"
click node_account_approvals "https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/account_approvals.py"
click node_database "https://github.com/natsirt-01/wawata/blob/main/thesis-main/database/db.py"
click node_server_config "https://github.com/natsirt-01/wawata/blob/main/thesis-main/config.py"
click node_student_network_config "https://github.com/natsirt-01/wawata/blob/main/Student/network_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_student_login,node_student_commands,node_student_listener,node_student_stream,node_student_webcam toneBlue
class node_server_login toneAmber
class node_teacher_dashboard,node_listeners,node_student_cards,node_screen_viewer,node_network_commands,node_teacher_inbox,node_teacher_history,node_teacher_webcam,node_teacher_broadcast toneMint
class node_admin_dashboard,node_account_approvals toneRose
class node_database,node_server_config,node_student_network_config,node_student_user toneIndigo
```

## Components

### Student Endpoint

- [Student Login](https://github.com/natsirt-01/wawata/blob/main/Student/login_student.py): `Student/login_student.py`
- [Endpoint Commands](https://github.com/natsirt-01/wawata/blob/main/Student/client_side.py): `Student/client_side.py`
- [Endpoint Listener](https://github.com/natsirt-01/wawata/blob/main/Student/client_listener.py): `Student/client_listener.py`
- [Screen Sender](https://github.com/natsirt-01/wawata/blob/main/Student/screen_sender.py): `Student/screen_sender.py`
- [Webcam Window](https://github.com/natsirt-01/wawata/blob/main/Student/student_webcam_window.py): `Student/student_webcam_window.py`

### Login And Sessions

- [Login Service](https://github.com/natsirt-01/wawata/blob/main/thesis-main/login.py): `thesis-main/login.py`

### Teacher Monitoring

- [Teacher Dashboard](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/teacher_dash.py): `thesis-main/teacher_dashboard/teacher_dash.py`
- [Connection And Stream Listeners](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/network_listeners.py): `thesis-main/teacher_dashboard/network_listeners.py`
- [Live Student Cards](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/student_cards.py): `thesis-main/teacher_dashboard/student_cards.py`
- [Screen Viewer And Control](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/screen_receiver.py): `thesis-main/teacher_dashboard/screen_receiver.py`
- [Device Commands](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/network_utils.py): `thesis-main/teacher_dashboard/network_utils.py`
- [Alerts And Inbox](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/inbox_window.py): `thesis-main/teacher_dashboard/inbox_window.py`
- [Session History](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/history_window.py): `thesis-main/teacher_dashboard/history_window.py`
- [Student Webcam](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/student_webcam.py): `thesis-main/teacher_dashboard/student_webcam.py`
- [Broadcast](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/teacher_broadcast.py): `thesis-main/teacher_dashboard/teacher_broadcast.py`

### Administration

- [Admin Dashboard](https://github.com/natsirt-01/wawata/blob/main/thesis-main/admin_dashboard/admin_dash.py): `thesis-main/admin_dashboard/admin_dash.py`
- [Account Approvals](https://github.com/natsirt-01/wawata/blob/main/thesis-main/teacher_dashboard/account_approvals.py): `thesis-main/teacher_dashboard/account_approvals.py`

### Persistence And Config

- [Application Database](https://github.com/natsirt-01/wawata/blob/main/thesis-main/database/db.py): `thesis-main/database/db.py`
- [Server Configuration](https://github.com/natsirt-01/wawata/blob/main/thesis-main/config.py): `thesis-main/config.py`
- [Endpoint Network Config](https://github.com/natsirt-01/wawata/blob/main/Student/network_config.py): `Student/network_config.py`

### Other components

- **Student**

## Connections

- Student → Student Login: signs in (evidence: `Student/login_student.py`)
- Student Login → Login Service: submits login
- Student Login → Endpoint Network Config: uses settings (evidence: `Student/login_student.py`)
- Student Login → Screen Sender: starts streaming (evidence: `Student/login_student.py`)
- Student Login → Webcam Window: opens webcam (evidence: `Student/login_student.py`)
- Endpoint Commands → Screen Sender: uses sender (evidence: `Student/client_side.py`)
- Endpoint Commands → Endpoint Network Config: uses settings (evidence: `Student/client_side.py`)
- Endpoint Listener → Endpoint Network Config: uses settings (evidence: `Student/client_listener.py`)
- Screen Sender → Endpoint Network Config: uses settings (evidence: `Student/screen_sender.py`)
- Webcam Window → Endpoint Network Config: uses settings
- Login Service → Application Database: reads and writes (evidence: `thesis-main/login.py`)
- Login Service → Teacher Dashboard: opens dashboard (evidence: `thesis-main/login.py`)
- Login Service → Connection And Stream Listeners: starts listeners (evidence: `thesis-main/login.py`)
- Login Service → Server Configuration: uses settings (evidence: `thesis-main/login.py`)
- Teacher Dashboard → Connection And Stream Listeners: starts monitoring (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Live Student Cards: builds cards (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Screen Viewer And Control: opens viewer (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Device Commands: sends commands (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Session History: opens history (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Alerts And Inbox: opens inbox (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Student Webcam: opens webcam
- Teacher Dashboard → Broadcast: uses broadcast
- Connection And Stream Listeners → Live Student Cards: updates cards (evidence: `thesis-main/teacher_dashboard/network_listeners.py`)
- Connection And Stream Listeners → Application Database: looks up users (evidence: `thesis-main/teacher_dashboard/network_listeners.py`)
- Screen Viewer And Control → Endpoint Network Config: uses control port (evidence: `thesis-main/teacher_dashboard/screen_receiver.py`)
- Device Commands → Endpoint Network Config: uses ports (evidence: `thesis-main/teacher_dashboard/network_utils.py`)
- Admin Dashboard → Application Database: manages records (evidence: `thesis-main/admin_dashboard/admin_dash.py`)
- Admin Dashboard → Connection And Stream Listeners: hydrates monitoring (evidence: `thesis-main/admin_dashboard/admin_dash.py`)
- Admin Dashboard → Alerts And Inbox: opens inbox (evidence: `thesis-main/admin_dashboard/admin_dash.py`)
- Admin Dashboard → Live Student Cards: uses cards (evidence: `thesis-main/admin_dashboard/admin_dash.py`)
- Admin Dashboard → Account Approvals: manages approvals
- Teacher Dashboard → Application Database: reads session data (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
- Teacher Dashboard → Server Configuration: uses settings (evidence: `thesis-main/teacher_dashboard/teacher_dash.py`)
