# yashaswikathota/study-app architecture

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

- Interactive diagram: https://gitdiagram.com/yashaswikathota/study-app
- Repository: https://github.com/yashaswikathota/study-app

## Overview

Study Companion is an Electron desktop app for timed study sessions, focus/distraction tracking, character feedback, and session analytics, backed by a Java service. Users choose a subject and operate a timer; the Electron main process manages session lifecycle and desktop activity, while separate views present the character, reports, and analytics. The sampled main-process code shows HTTP calls to Java for session start/stop. Backend internals and several IPC handlers were not sampled, so those relationships are omitted or marked unverified.

Main entry points: [`renderer.js`](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/renderer.js) (Subject selection), [`timer.js`](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/timer.js) (Study timer), [`analytics.js`](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/analytics.js) (Analytics view), [`Java-backend/src/main/java/com/studycompanion/demo/controller/StudySessionController.java`](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/StudySessionController.java) (Study session API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Electron desktop"]
  node_main["Desktop orchestrator"]
  node_bridge["Preload API<br/>[preload.js]"]
end

subgraph group_study["Study experience"]
  node_subject["Subject selection<br/>[renderer.js]"]
  node_timer["Study timer<br/>[timer.js]"]
  node_activity["Activity monitoring<br/>[main.js]"]
  node_video_check["Video relevance check"]
  node_character["Character feedback<br/>[character.js]"]
end

subgraph group_insights["Study insights"]
  node_report["Session report<br/>[report.js]"]
  node_analytics["Analytics view<br/>[analytics.js]"]
end

subgraph group_backend["Java backend"]
  node_java_api["Study session API"]
  node_session_service["Session management"]
  node_session_store[("Session repository")]
  node_analytics_api["Analytics API"]
  node_analytics_service["Analytics aggregation"]
  node_video_api["Video check API"]
end

node_user(("Student"))

node_user -->|"chooses subject"| node_subject
node_user -->|"controls timer"| node_timer
node_main -->|"starts/stops sessions"| node_java_api
node_subject -.->|"selects via API"| node_bridge
node_timer -.->|"sends session events"| node_main
node_main -->|"tracks activity"| node_activity
node_main -.->|"sends character state"| node_character
node_main -.->|"requests relevance check"| node_video_check
node_user -->|"opens analytics"| node_analytics
node_analytics -.->|"requests analytics data"| node_main
node_main -.->|"provides session report"| node_report
node_java_api -.->|"delegates session work"| node_session_service
node_session_service -.->|"persists sessions"| node_session_store
node_analytics_api -.->|"requests aggregates"| node_analytics_service
node_analytics_service -.->|"reads sessions"| node_session_store
node_video_api -.->|"checks relevance"| node_video_check

click node_bridge "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/preload.js"
click node_subject "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/renderer.js"
click node_timer "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/timer.js"
click node_activity "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/main.js"
click node_video_check "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/VideoRelevanceService.java"
click node_character "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/character.js"
click node_report "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/report.js"
click node_analytics "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/analytics.js"
click node_java_api "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/StudySessionController.java"
click node_session_service "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/StudySessionService.java"
click node_session_store "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/repository/StudySessionRepository.java"
click node_analytics_api "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/AnalyticsController.java"
click node_analytics_service "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/AnalyticsService.java"
click node_video_api "https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/VideoCheckController.java"

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_bridge toneBlue
class node_subject,node_timer,node_activity,node_video_check,node_character toneAmber
class node_report,node_analytics toneMint
class node_java_api,node_session_service,node_session_store,node_analytics_api,node_analytics_service,node_video_api toneRose
class node_user toneIndigo
```

## Components

### Electron desktop

- **Desktop orchestrator**
- [Preload API](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/preload.js): `preload.js`

### Study experience

- [Subject selection](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/renderer.js): `renderer.js`
- [Study timer](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/timer.js): `timer.js`
- [Activity monitoring](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/main.js): `main.js`
- [Video relevance check](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/VideoRelevanceService.java): `Java-backend/src/main/java/com/studycompanion/demo/service/VideoRelevanceService.java`
- [Character feedback](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/character.js): `character.js`

### Study insights

- [Session report](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/report.js): `report.js`
- [Analytics view](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/analytics.js): `analytics.js`

### Java backend

- [Study session API](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/StudySessionController.java): `Java-backend/src/main/java/com/studycompanion/demo/controller/StudySessionController.java`
- [Session management](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/StudySessionService.java): `Java-backend/src/main/java/com/studycompanion/demo/service/StudySessionService.java`
- [Session repository](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/repository/StudySessionRepository.java): `Java-backend/src/main/java/com/studycompanion/demo/repository/StudySessionRepository.java`
- [Analytics API](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/AnalyticsController.java): `Java-backend/src/main/java/com/studycompanion/demo/controller/AnalyticsController.java`
- [Analytics aggregation](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/service/AnalyticsService.java): `Java-backend/src/main/java/com/studycompanion/demo/service/AnalyticsService.java`
- [Video check API](https://github.com/yashaswikathota/study-app/blob/java-backend-migration/Java-backend/src/main/java/com/studycompanion/demo/controller/VideoCheckController.java): `Java-backend/src/main/java/com/studycompanion/demo/controller/VideoCheckController.java`

### Other components

- **Student**

## Connections

- Student → Subject selection: chooses subject (evidence: `renderer.js`)
- Student → Study timer: controls timer (evidence: `timer.js`)
- Desktop orchestrator → Study session API: starts/stops sessions
- Subject selection → Preload API: selects via API
- Study timer → Desktop orchestrator: sends session events
- Desktop orchestrator → Activity monitoring: tracks activity (evidence: `main.js`)
- Desktop orchestrator → Character feedback: sends character state
- Desktop orchestrator → Video relevance check: requests relevance check
- Student → Analytics view: opens analytics
- Analytics view → Desktop orchestrator: requests analytics data
- Desktop orchestrator → Session report: provides session report
- Study session API → Session management: delegates session work
- Session management → Session repository: persists sessions
- Analytics API → Analytics aggregation: requests aggregates
- Analytics aggregation → Session repository: reads sessions
- Video check API → Video relevance check: checks relevance
