# parthkprogrammer/lifecompass_java_project architecture

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

- Interactive diagram: https://gitdiagram.com/parthkprogrammer/lifecompass_java_project
- Repository: https://github.com/parthkprogrammer/lifecompass_java_project

## Overview

LifeCompass is a JavaFX mental-wellness platform serving users, psychologists, and administrators. The main user journey is account access followed by wellness tracking and support features; psychologists and administrators have separate care-management and oversight workflows. The graph preserves documented content, community, scheduling, crisis, and analytics capabilities. Source excerpts and the index support some controller-to-view and service-to-store links; other feature relationships are shown only where the README documents them.

Main entry points: [`src/main/java/com/lifecompass/dao/PsychologistDao.java`](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/dao/PsychologistDao.java) (Psychologist data access), [`src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java`](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java) (Psychologist dashboard), [`src/main/java/com/lifecompass/model/FirebaseService.java`](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/model/FirebaseService.java) (Platform data service), [`src/main/java/com/lifecompass/controller/AuthController.java`](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/AuthController.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and access"]
  node_app["JavaFX application<br/>[Main.java]"]
  node_auth["Authentication"]
  node_firebase_config["Firebase configuration"]
end

subgraph group_wellness["User wellness"]
  node_wellness_ui["Wellness screens"]
  node_mood_analytics["Mood analytics"]
  node_journal["Journal service"]
  node_content_apis["Wellness content APIs"]
  node_community_api["Community API"]
  node_music_api["Music API"]
  node_challenge_api["Daily challenges API"]
end

subgraph group_care["Psychologist care"]
  node_psych_dashboard["Psychologist dashboard"]
  node_appointments["Appointments"]
  node_crisis_monitor["Crisis monitoring"]
  node_psych_profile["Psychologist profile"]
end

subgraph group_oversight["Administration and data"]
  node_admin_dashboard["Admin dashboard"]
  node_verification["Credential verification"]
  node_crisis_response["Crisis response"]
  node_user_management["User management"]
  node_psych_dao["Psychologist data access"]
  node_firebase_service["Platform data service"]
  node_mood_dao["Mood data access"]
end

node_user(("User"))
node_psychologist(("Psychologist"))
node_admin(("Administrator"))
node_firestore[("Firestore")]
node_external_content["External content services"]

node_user -->|"signs in"| node_auth
node_psychologist -->|"signs in"| node_auth
node_auth -->|"initializes auth"| node_firebase_config
node_app -->|"initializes"| node_firebase_config
node_user -->|"uses wellness features"| node_wellness_ui
node_wellness_ui -->|"supports mood analysis"| node_mood_analytics
node_mood_analytics -->|"reads mood data"| node_mood_dao
node_mood_dao -.->|"reads and writes"| node_firestore
node_user -->|"keeps journal"| node_journal
node_journal -->|"stores entries"| node_firestore
node_user -->|"accesses articles and activities"| node_content_apis
node_user -->|"joins discussions"| node_community_api
node_user -->|"gets music recommendations"| node_music_api
node_user -.->|"gets daily challenges"| node_challenge_api
node_content_apis -.->|"requests content"| node_external_content
node_community_api -.->|"connects externally"| node_external_content
node_music_api -.->|"requests music"| node_external_content
node_psychologist -->|"manages care"| node_psych_dashboard
node_psych_dashboard -->|"routes appointment view"| node_appointments
node_psych_dashboard -->|"routes profile view"| node_psych_profile
node_psychologist -->|"manages sessions"| node_appointments
node_psychologist -->|"monitors crises"| node_crisis_monitor
node_psychologist -->|"manages profile"| node_psych_profile
node_psych_dashboard -->|"loads care data"| node_psych_dao
node_appointments -->|"accesses appointments"| node_psych_dao
node_crisis_monitor -->|"accesses alerts"| node_psych_dao
node_psych_profile -->|"loads and saves profile"| node_psych_dao
node_psych_dao -->|"queries records"| node_firestore
node_admin -->|"oversees platform"| node_admin_dashboard
node_admin -->|"verifies credentials"| node_verification
node_admin -->|"coordinates response"| node_crisis_response
node_admin -->|"manages accounts"| node_user_management
node_admin_dashboard -.->|"reads platform data"| node_firestore
node_verification -->|"updates verification status"| node_firebase_service
node_crisis_response -->|"handles crisis records"| node_firebase_service
node_user_management -->|"manages user records"| node_firebase_service
node_firebase_service -->|"accesses records"| node_firestore

click node_app "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/Main.java"
click node_auth "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/AuthController.java"
click node_firebase_config "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/config/FirebaseConfig.java"
click node_wellness_ui "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/view/MoodTrackerApp.java"
click node_mood_analytics "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/services/MoodAnalyticsService.java"
click node_journal "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/services/FirebaseJournalService.java"
click node_content_apis "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/ArticleApiClient.java"
click node_community_api "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/CommunityApiClient.java"
click node_music_api "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/MusicApiClient.java"
click node_challenge_api "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/DailyChallengeApiClient.java"
click node_psych_dashboard "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java"
click node_appointments "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/AppointmentsController.java"
click node_crisis_monitor "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/CrisisMonitorController.java"
click node_psych_profile "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/PsychologistProfileController.java"
click node_admin_dashboard "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/AdminDashboardController.java"
click node_verification "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/VerificationController.java"
click node_crisis_response "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/CrisisResponseController.java"
click node_user_management "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/UserManagementController.java"
click node_psych_dao "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/dao/PsychologistDao.java"
click node_firebase_service "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/model/FirebaseService.java"
click node_mood_dao "https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/dao/impl/MoodDaoFirestoreImpl.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_app,node_auth,node_firebase_config,node_user toneBlue
class node_wellness_ui,node_mood_analytics,node_journal,node_content_apis,node_community_api,node_music_api,node_challenge_api,node_firestore toneAmber
class node_psych_dashboard,node_appointments,node_crisis_monitor,node_psych_profile toneMint
class node_admin_dashboard,node_verification,node_crisis_response,node_user_management,node_psych_dao,node_firebase_service,node_mood_dao toneRose
class node_psychologist,node_admin,node_external_content toneIndigo
```

## Components

### Application and access

- [JavaFX application](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/Main.java): `src/main/java/com/lifecompass/Main.java`
- [Authentication](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/AuthController.java): `src/main/java/com/lifecompass/controller/AuthController.java`
- [Firebase configuration](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/config/FirebaseConfig.java): `src/main/java/com/lifecompass/config/FirebaseConfig.java`

### User wellness

- [Wellness screens](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/view/MoodTrackerApp.java): `src/main/java/com/lifecompass/view/MoodTrackerApp.java`
- [Mood analytics](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/services/MoodAnalyticsService.java): `src/main/java/com/lifecompass/services/MoodAnalyticsService.java`
- [Journal service](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/services/FirebaseJournalService.java): `src/main/java/com/lifecompass/services/FirebaseJournalService.java`
- [Wellness content APIs](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/ArticleApiClient.java): `src/main/java/com/lifecompass/api/ArticleApiClient.java`
- [Community API](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/CommunityApiClient.java): `src/main/java/com/lifecompass/api/CommunityApiClient.java`
- [Music API](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/MusicApiClient.java): `src/main/java/com/lifecompass/api/MusicApiClient.java`
- [Daily challenges API](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/api/DailyChallengeApiClient.java): `src/main/java/com/lifecompass/api/DailyChallengeApiClient.java`

### Psychologist care

- [Psychologist dashboard](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java): `src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java`
- [Appointments](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/AppointmentsController.java): `src/main/java/com/lifecompass/controller/psychologist/AppointmentsController.java`
- [Crisis monitoring](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/CrisisMonitorController.java): `src/main/java/com/lifecompass/controller/psychologist/CrisisMonitorController.java`
- [Psychologist profile](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/psychologist/PsychologistProfileController.java): `src/main/java/com/lifecompass/controller/psychologist/PsychologistProfileController.java`

### Administration and data

- [Admin dashboard](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/AdminDashboardController.java): `src/main/java/com/lifecompass/controller/AdminDashboardController.java`
- [Credential verification](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/VerificationController.java): `src/main/java/com/lifecompass/controller/VerificationController.java`
- [Crisis response](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/CrisisResponseController.java): `src/main/java/com/lifecompass/controller/CrisisResponseController.java`
- [User management](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/controller/UserManagementController.java): `src/main/java/com/lifecompass/controller/UserManagementController.java`
- [Psychologist data access](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/dao/PsychologistDao.java): `src/main/java/com/lifecompass/dao/PsychologistDao.java`
- [Platform data service](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/model/FirebaseService.java): `src/main/java/com/lifecompass/model/FirebaseService.java`
- [Mood data access](https://github.com/parthkprogrammer/lifecompass_java_project/blob/main/src/main/java/com/lifecompass/dao/impl/MoodDaoFirestoreImpl.java): `src/main/java/com/lifecompass/dao/impl/MoodDaoFirestoreImpl.java`

### Other components

- **User**
- **Psychologist**
- **Administrator**
- **Firestore**
- **External content services**

## Connections

- User → Authentication: signs in
- Psychologist → Authentication: signs in
- Authentication → Firebase configuration: initializes auth (evidence: `src/main/java/com/lifecompass/controller/AuthController.java`)
- JavaFX application → Firebase configuration: initializes (evidence: `src/main/java/com/lifecompass/Main.java`)
- User → Wellness screens: uses wellness features
- Wellness screens → Mood analytics: supports mood analysis (evidence: `src/main/java/com/lifecompass/services/MoodAnalyticsService.java`)
- Mood analytics → Mood data access: reads mood data (evidence: `src/main/java/com/lifecompass/services/MoodAnalyticsService.java`)
- Mood data access → Firestore: reads and writes
- User → Journal service: keeps journal
- Journal service → Firestore: stores entries (evidence: `src/main/java/com/lifecompass/services/FirebaseJournalService.java`)
- User → Wellness content APIs: accesses articles and activities
- User → Community API: joins discussions
- User → Music API: gets music recommendations
- User → Daily challenges API: gets daily challenges
- Wellness content APIs → External content services: requests content
- Community API → External content services: connects externally
- Music API → External content services: requests music
- Psychologist → Psychologist dashboard: manages care
- Psychologist dashboard → Appointments: routes appointment view (evidence: `src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java`)
- Psychologist dashboard → Psychologist profile: routes profile view (evidence: `src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java`)
- Psychologist → Appointments: manages sessions
- Psychologist → Crisis monitoring: monitors crises
- Psychologist → Psychologist profile: manages profile
- Psychologist dashboard → Psychologist data access: loads care data (evidence: `src/main/java/com/lifecompass/controller/psychologist/PsychologistDashboardController.java`)
- Appointments → Psychologist data access: accesses appointments (evidence: `src/main/java/com/lifecompass/controller/psychologist/AppointmentsController.java`)
- Crisis monitoring → Psychologist data access: accesses alerts (evidence: `src/main/java/com/lifecompass/controller/psychologist/CrisisMonitorController.java`)
- Psychologist profile → Psychologist data access: loads and saves profile (evidence: `src/main/java/com/lifecompass/controller/psychologist/PsychologistProfileController.java`)
- Psychologist data access → Firestore: queries records (evidence: `src/main/java/com/lifecompass/dao/PsychologistDao.java`)
- Administrator → Admin dashboard: oversees platform
- Administrator → Credential verification: verifies credentials
- Administrator → Crisis response: coordinates response
- Administrator → User management: manages accounts
- Admin dashboard → Firestore: reads platform data
- Credential verification → Platform data service: updates verification status (evidence: `src/main/java/com/lifecompass/controller/VerificationController.java`)
- Crisis response → Platform data service: handles crisis records (evidence: `src/main/java/com/lifecompass/controller/CrisisResponseController.java`)
- User management → Platform data service: manages user records (evidence: `src/main/java/com/lifecompass/controller/UserManagementController.java`)
- Platform data service → Firestore: accesses records (evidence: `src/main/java/com/lifecompass/model/FirebaseService.java`)
