# arunvijay28/mentoring-system architecture

> Architecture diagram of the GitHub repository arunvijay28/mentoring-system, 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/arunvijay28/mentoring-system
- Repository: https://github.com/arunvijay28/mentoring-system

## Overview

This is a Tkinter-based mentoring system for mentees, mentors, and a manager. The main workflow is role login, access to mentee and academic records, mentor-mentee meeting coordination, and manager mark reports. Runtime data is loaded from text files into in-memory structures; the README also documents email invitations and reporting visualizations. The excerpts show data loading and selected UI-to-module calls, but not all of app.py, so undocumented links are omitted.

Main entry points: [`app.py`](https://github.com/arunvijay28/mentoring-system/blob/main/app.py) (Desktop App), [`main.py`](https://github.com/arunvijay28/mentoring-system/blob/main/main.py) (Record Loader), [`acad.py`](https://github.com/arunvijay28/mentoring-system/blob/main/acad.py) (Subject Mark Views), [`logincred.py`](https://github.com/arunvijay28/mentoring-system/blob/main/logincred.py) (Credential Lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Role Access"]
  node_application["Desktop App<br/>[app.py]"]
  node_credentials["Credential Lookup<br/>[logincred.py]"]
  node_credential_data["Login Credentials<br/>[newcredentials.txt]"]
end

subgraph group_records["Mentee Records"]
  node_record_loader["Record Loader<br/>[main.py]"]
  node_mentee_trees["Mentee AVL Trees<br/>[avl.py]"]
  node_mentor_list["Mentor Assignments<br/>[linkedlist.py]"]
  node_mentee_data["Mentee Record Files<br/>[first20.txt]"]
end

subgraph group_academics["Academic Records"]
  node_academic_data["Academic Results<br/>[CAT-1results.txt]"]
  node_mark_array["Resizable Mark Array<br/>[ARRAY.py]"]
  node_academic_views["Subject Mark Views<br/>[acad.py]"]
  node_mentee_lookup["Mentee BST Lookup<br/>[samplecode.py]"]
  node_report_visualization["Mark Reports<br/>[app.py]"]
end

subgraph group_meetings["Meetings"]
  node_meeting_scheduling["Meeting Scheduling<br/>[app.py]"]
  node_email_service["Email Service"]
end

node_mentee(("Mentee"))
node_mentor(("Mentor"))
node_manager(("Manager"))

node_mentee -->|"uses"| node_application
node_mentor -->|"uses"| node_application
node_manager -->|"uses"| node_application
node_application -->|"checks login"| node_credentials
node_credentials -->|"loads"| node_credential_data
node_application -->|"uses records"| node_record_loader
node_record_loader -->|"loads"| node_mentee_data
node_record_loader -->|"builds trees"| node_mentee_trees
node_record_loader -->|"builds assignments"| node_mentor_list
node_record_loader -->|"loads results"| node_academic_data
node_record_loader -->|"stores marks"| node_mark_array
node_application -->|"reads marks"| node_mark_array
node_application -->|"requests subject marks"| node_academic_views
node_academic_views -->|"reads results"| node_record_loader
node_application -->|"imports lookup"| node_mentee_lookup
node_mentee -->|"requests meeting"| node_application
node_mentor -->|"schedules meeting"| node_application
node_application -->|"sends invitation"| node_email_service
node_manager -->|"requests reports"| node_application
node_application -->|"gets report marks"| node_academic_views
node_application -.->|"renders reports"| node_report_visualization

click node_application "https://github.com/arunvijay28/mentoring-system/blob/main/app.py"
click node_credentials "https://github.com/arunvijay28/mentoring-system/blob/main/logincred.py"
click node_credential_data "https://github.com/arunvijay28/mentoring-system/blob/main/newcredentials.txt"
click node_record_loader "https://github.com/arunvijay28/mentoring-system/blob/main/main.py"
click node_mentee_trees "https://github.com/arunvijay28/mentoring-system/blob/main/avl.py"
click node_mentor_list "https://github.com/arunvijay28/mentoring-system/blob/main/linkedlist.py"
click node_mentee_data "https://github.com/arunvijay28/mentoring-system/blob/main/first20.txt"
click node_academic_data "https://github.com/arunvijay28/mentoring-system/blob/main/CAT-1results.txt"
click node_mark_array "https://github.com/arunvijay28/mentoring-system/blob/main/ARRAY.py"
click node_academic_views "https://github.com/arunvijay28/mentoring-system/blob/main/acad.py"
click node_mentee_lookup "https://github.com/arunvijay28/mentoring-system/blob/main/samplecode.py"
click node_meeting_scheduling "https://github.com/arunvijay28/mentoring-system/blob/main/app.py"
click node_report_visualization "https://github.com/arunvijay28/mentoring-system/blob/main/app.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_application,node_credentials,node_credential_data toneBlue
class node_record_loader,node_mentee_trees,node_mentor_list,node_mentee_data toneAmber
class node_academic_data,node_mark_array,node_academic_views,node_mentee_lookup,node_report_visualization toneMint
class node_meeting_scheduling,node_email_service toneRose
class node_mentee,node_mentor,node_manager toneIndigo
```

## Components

### Role Access

- [Desktop App](https://github.com/arunvijay28/mentoring-system/blob/main/app.py): `app.py`
- [Credential Lookup](https://github.com/arunvijay28/mentoring-system/blob/main/logincred.py): `logincred.py`
- [Login Credentials](https://github.com/arunvijay28/mentoring-system/blob/main/newcredentials.txt): `newcredentials.txt`

### Mentee Records

- [Record Loader](https://github.com/arunvijay28/mentoring-system/blob/main/main.py): `main.py`
- [Mentee AVL Trees](https://github.com/arunvijay28/mentoring-system/blob/main/avl.py): `avl.py`
- [Mentor Assignments](https://github.com/arunvijay28/mentoring-system/blob/main/linkedlist.py): `linkedlist.py`
- [Mentee Record Files](https://github.com/arunvijay28/mentoring-system/blob/main/first20.txt): `first20.txt`

### Academic Records

- [Academic Results](https://github.com/arunvijay28/mentoring-system/blob/main/CAT-1results.txt): `CAT-1results.txt`
- [Resizable Mark Array](https://github.com/arunvijay28/mentoring-system/blob/main/ARRAY.py): `ARRAY.py`
- [Subject Mark Views](https://github.com/arunvijay28/mentoring-system/blob/main/acad.py): `acad.py`
- [Mentee BST Lookup](https://github.com/arunvijay28/mentoring-system/blob/main/samplecode.py): `samplecode.py`
- [Mark Reports](https://github.com/arunvijay28/mentoring-system/blob/main/app.py): `app.py`

### Meetings

- [Meeting Scheduling](https://github.com/arunvijay28/mentoring-system/blob/main/app.py): `app.py`
- **Email Service**

### Other components

- **Mentee**
- **Mentor**
- **Manager**

## Connections

- Mentee → Desktop App: uses (evidence: `README.md`)
- Mentor → Desktop App: uses (evidence: `README.md`)
- Manager → Desktop App: uses (evidence: `README.md`)
- Desktop App → Credential Lookup: checks login (evidence: `app.py`)
- Credential Lookup → Login Credentials: loads (evidence: `logincred.py`)
- Desktop App → Record Loader: uses records (evidence: `app.py`)
- Record Loader → Mentee Record Files: loads (evidence: `main.py`)
- Record Loader → Mentee AVL Trees: builds trees (evidence: `main.py`)
- Record Loader → Mentor Assignments: builds assignments (evidence: `main.py`)
- Record Loader → Academic Results: loads results (evidence: `main.py`)
- Record Loader → Resizable Mark Array: stores marks (evidence: `main.py`)
- Desktop App → Resizable Mark Array: reads marks (evidence: `app.py`)
- Desktop App → Subject Mark Views: requests subject marks (evidence: `app.py`)
- Subject Mark Views → Record Loader: reads results (evidence: `acad.py`)
- Desktop App → Mentee BST Lookup: imports lookup (evidence: `app.py`)
- Mentee → Desktop App: requests meeting (evidence: `README.md`)
- Mentor → Desktop App: schedules meeting (evidence: `README.md`)
- Desktop App → Email Service: sends invitation (evidence: `README.md`)
- Manager → Desktop App: requests reports (evidence: `README.md`)
- Desktop App → Subject Mark Views: gets report marks (evidence: `app.py`)
- Desktop App → Mark Reports: renders reports (evidence: `app.py`)
