How pepememe1/the-first-project-student-journal- works
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: App.vue Shared web app · main.py Desktop app · routers API routes · app/main.py API server
Components 21
User clients
- Desktop app
main.py - Shared web app
web/src/App.vue - Web bootstrap
web/src/main.js - Web API client
web/src/api/server.js - Desktop shell
desktop/webview2_app.py
Offline and sync
- Local college records
data/local_db.py - Desktop sync
sync/sync_client.py
Server platform
- Sync API
server/app/routers/sync.py - API server
server/app/main.py - API routes
server/app/routers - College database
server/app/db.py - Data protection
server/app/security.py
Academic records
- Grades and journal
server/app/webdata.py - Grade calculations
grading.py - Schedule service
server/app/schedule_web.py - Course materials
server/app/routers/web/courses.py
Communication and assistance
- College messenger
server/app/routers/messenger - Vector assistant
server/app/routers/vector.py - Phone notifications
server/app/rustore_push.py
Other components
- Teacher
- Student
Connections 20
- Teacher → Desktop app: uses
README.md - Student → Shared web app: uses
README.md - Teacher → Shared web app: uses
README.md - Desktop app → Desktop shell: opens
main.py - Desktop app → Local college records: initializes
main.py - Web bootstrap → Shared web app: starts
web/src/main.js - Shared web app → Web API client: requests data
- Desktop app → Desktop sync: synchronizes
README.md - Desktop sync → Sync API: exchanges changes
README.md - API server → College database: uses
server/app/main.py - API server → API routes: registers
server/app/main.py - API routes → College database: auth queries
server/app/routers/auth.py - Shared web app → Grades and journal: views grades
README.md - Grades and journal → Grade calculations: calculates metrics
README.md - Shared web app → Schedule service: views schedule
README.md - Shared web app → Course materials: views courses
README.md - Shared web app → College messenger: uses
README.md - Shared web app → Vector assistant: asks questions
README.md - Schedule service → Phone notifications: notifies changes
README.md - API routes → Data protection: authenticates
server/app/routers/auth.py