# pepememe1/the-first-project-student-journal- architecture

> Architecture diagram of the GitHub repository pepememe1/the-first-project-student-journal-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pepememe1/the-first-project-student-journal-
- Repository: https://github.com/pepememe1/the-first-project-student-journal-

## Overview

GradeBookAI is an offline-first college gradebook spanning desktop, web, and mobile clients. Teachers and students use a shared interface to enter or view academic records; the desktop can work against local data and synchronize with the college server when connected. The server provides the shared API and persistence behind journal, schedule, course, messaging, and assistant capabilities. Edges reflect README statements and the supplied source index or excerpts; several feature implementations were not sampled, so their internal call paths are not asserted.

Main entry points: [`web/src/App.vue`](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/App.vue) (Shared web app), [`main.py`](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/main.py) (Desktop app), [`server/app/routers`](https://github.com/pepememe1/the-first-project-student-journal-/tree/Release-4.1.6/server/app/routers) (API routes), [`server/app/main.py`](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/main.py) (API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_desktop_app["Desktop app<br/>[main.py]"]
  node_web_app["Shared web app<br/>[App.vue]"]
  node_web_bootstrap["Web bootstrap<br/>[main.js]"]
  node_web_api["Web API client<br/>[server.js]"]
  node_desktop_shell["Desktop shell<br/>[webview2_app.py]"]
end

subgraph group_offline["Offline and sync"]
  node_local_records[("Local college records<br/>[local_db.py]")]
  node_sync_client["Desktop sync<br/>[sync_client.py]"]
end

subgraph group_server["Server platform"]
  node_sync_api["Sync API<br/>[sync.py]"]
  node_api_server["API server<br/>[main.py]"]
  node_server_routes["API routes"]
  node_server_db[("College database<br/>[db.py]")]
  node_security["Data protection<br/>[security.py]"]
end

subgraph group_academics["Academic records"]
  node_journal["Grades and journal<br/>[webdata.py]"]
  node_grading["Grade calculations<br/>[grading.py]"]
  node_schedule["Schedule service<br/>[schedule_web.py]"]
  node_courses["Course materials<br/>[courses.py]"]
end

subgraph group_services["Communication and assistance"]
  node_messenger["College messenger"]
  node_vector["Vector assistant<br/>[vector.py]"]
  node_push["Phone notifications<br/>[rustore_push.py]"]
end

node_teacher(("Teacher"))
node_student(("Student"))

node_teacher -->|"uses"| node_desktop_app
node_student -->|"uses"| node_web_app
node_teacher -->|"uses"| node_web_app
node_desktop_app -->|"opens"| node_desktop_shell
node_desktop_app -->|"initializes"| node_local_records
node_web_bootstrap -->|"starts"| node_web_app
node_web_app -.->|"requests data"| node_web_api
node_desktop_app -->|"synchronizes"| node_sync_client
node_sync_client -->|"exchanges changes"| node_sync_api
node_api_server -->|"uses"| node_server_db
node_api_server -->|"registers"| node_server_routes
node_server_routes -->|"auth queries"| node_server_db
node_web_app -->|"views grades"| node_journal
node_journal -->|"calculates metrics"| node_grading
node_web_app -->|"views schedule"| node_schedule
node_web_app -->|"views courses"| node_courses
node_web_app -->|"uses"| node_messenger
node_web_app -->|"asks questions"| node_vector
node_schedule -->|"notifies changes"| node_push
node_server_routes -->|"authenticates"| node_security

click node_desktop_app "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/main.py"
click node_web_app "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/App.vue"
click node_web_bootstrap "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/main.js"
click node_web_api "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/api/server.js"
click node_desktop_shell "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/desktop/webview2_app.py"
click node_local_records "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/data/local_db.py"
click node_sync_client "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/sync/sync_client.py"
click node_sync_api "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/sync.py"
click node_api_server "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/main.py"
click node_server_routes "https://github.com/pepememe1/the-first-project-student-journal-/tree/Release-4.1.6/server/app/routers"
click node_server_db "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/db.py"
click node_journal "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/webdata.py"
click node_grading "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/grading.py"
click node_schedule "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/schedule_web.py"
click node_courses "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/web/courses.py"
click node_messenger "https://github.com/pepememe1/the-first-project-student-journal-/tree/Release-4.1.6/server/app/routers/messenger"
click node_vector "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/vector.py"
click node_push "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/rustore_push.py"
click node_security "https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/security.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_desktop_app,node_web_app,node_web_bootstrap,node_web_api,node_desktop_shell toneBlue
class node_local_records,node_sync_client toneAmber
class node_sync_api,node_api_server,node_server_routes,node_server_db,node_security toneMint
class node_journal,node_grading,node_schedule,node_courses toneRose
class node_messenger,node_vector,node_push,node_teacher,node_student toneIndigo
```

## Components

### User clients

- [Desktop app](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/main.py): `main.py`
- [Shared web app](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/App.vue): `web/src/App.vue`
- [Web bootstrap](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/main.js): `web/src/main.js`
- [Web API client](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/web/src/api/server.js): `web/src/api/server.js`
- [Desktop shell](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/desktop/webview2_app.py): `desktop/webview2_app.py`

### Offline and sync

- [Local college records](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/data/local_db.py): `data/local_db.py`
- [Desktop sync](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/sync/sync_client.py): `sync/sync_client.py`

### Server platform

- [Sync API](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/sync.py): `server/app/routers/sync.py`
- [API server](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/main.py): `server/app/main.py`
- [API routes](https://github.com/pepememe1/the-first-project-student-journal-/tree/Release-4.1.6/server/app/routers): `server/app/routers`
- [College database](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/db.py): `server/app/db.py`
- [Data protection](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/security.py): `server/app/security.py`

### Academic records

- [Grades and journal](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/webdata.py): `server/app/webdata.py`
- [Grade calculations](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/grading.py): `grading.py`
- [Schedule service](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/schedule_web.py): `server/app/schedule_web.py`
- [Course materials](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/web/courses.py): `server/app/routers/web/courses.py`

### Communication and assistance

- [College messenger](https://github.com/pepememe1/the-first-project-student-journal-/tree/Release-4.1.6/server/app/routers/messenger): `server/app/routers/messenger`
- [Vector assistant](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/routers/vector.py): `server/app/routers/vector.py`
- [Phone notifications](https://github.com/pepememe1/the-first-project-student-journal-/blob/Release-4.1.6/server/app/rustore_push.py): `server/app/rustore_push.py`

### Other components

- **Teacher**
- **Student**

## Connections

- Teacher → Desktop app: uses (evidence: `README.md`)
- Student → Shared web app: uses (evidence: `README.md`)
- Teacher → Shared web app: uses (evidence: `README.md`)
- Desktop app → Desktop shell: opens (evidence: `main.py`)
- Desktop app → Local college records: initializes (evidence: `main.py`)
- Web bootstrap → Shared web app: starts (evidence: `web/src/main.js`)
- Shared web app → Web API client: requests data
- Desktop app → Desktop sync: synchronizes (evidence: `README.md`)
- Desktop sync → Sync API: exchanges changes (evidence: `README.md`)
- API server → College database: uses (evidence: `server/app/main.py`)
- API server → API routes: registers (evidence: `server/app/main.py`)
- API routes → College database: auth queries (evidence: `server/app/routers/auth.py`)
- Shared web app → Grades and journal: views grades (evidence: `README.md`)
- Grades and journal → Grade calculations: calculates metrics (evidence: `README.md`)
- Shared web app → Schedule service: views schedule (evidence: `README.md`)
- Shared web app → Course materials: views courses (evidence: `README.md`)
- Shared web app → College messenger: uses (evidence: `README.md`)
- Shared web app → Vector assistant: asks questions (evidence: `README.md`)
- Schedule service → Phone notifications: notifies changes (evidence: `README.md`)
- API routes → Data protection: authenticates (evidence: `server/app/routers/auth.py`)
