# arad108/vaikhari architecture

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

- Interactive diagram: https://gitdiagram.com/arad108/vaikhari
- Repository: https://github.com/arad108/vaikhari

## Overview

This appears to be a Spring Boot backend for Vedic scripture content and mantra practice, with authentication, user onboarding, practice tracking, and gamified progress. The likely user workflow is to authenticate, browse scripture and mantra details, record practice, and view progress. The tree shows distinct controllers, services, and repositories for these capabilities, but no README or application-source excerpts establish their runtime relationships. Dashed links therefore indicate likely, unverified interactions rather than inspected calls.

Main entry points: [`src/main/java/com/vaikhari/demo/controller`](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/controller) (REST controllers), [`src/main/java/com/vaikhari/demo/service/PracticeLogService.java`](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/PracticeLogService.java) (Practice tracking), [`src/main/java/com/vaikhari/demo/service/MantraService.java`](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/MantraService.java) (Scripture services), [`src/main/java/com/vaikhari/demo/repository`](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/repository) (Data repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and access"]
  node_app["Spring application"]
  node_api["REST controllers"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_security["Security and JWT"]
end

subgraph group_scripture["Scripture catalog"]
  node_scripture_api["Scripture endpoints"]
  node_scripture_services["Scripture services<br/>[MantraService.java]"]
  node_vedic_metadata["Vedic metadata"]
  node_interpretation["Interpretations"]
end

subgraph group_practice["Practice and progress"]
  node_practice_api["Practice endpoints"]
  node_practice_logs["Practice tracking"]
  node_summaries["Practice summaries"]
  node_streaks["Streak tracking<br/>[StreakService.java]"]
  node_xp["XP tracking<br/>[XplogService.java]"]
  node_badges["Badge awards<br/>[BadgeService.java]"]
  node_onboarding["User onboarding"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Data repositories"]
  node_entities["Domain entities"]
end

node_user(("User"))
node_mysql[("MySQL database")]

node_user -.->|"sends requests"| node_api
node_api -.->|"uses authentication"| node_auth
node_api -.->|"passes through"| node_security
node_api -.->|"routes scripture"| node_scripture_api
node_scripture_api -.->|"delegates to"| node_scripture_services
node_scripture_services -.->|"uses metadata"| node_vedic_metadata
node_scripture_services -.->|"uses interpretations"| node_interpretation
node_api -.->|"routes practice"| node_practice_api
node_practice_api -.->|"delegates to"| node_practice_logs
node_practice_logs -.->|"feeds summaries"| node_summaries
node_practice_logs -.->|"updates streaks"| node_streaks
node_practice_logs -.->|"records experience"| node_xp
node_practice_logs -.->|"supports awards"| node_badges
node_api -.->|"supports onboarding"| node_onboarding
node_scripture_services -.->|"accesses data"| node_repositories
node_practice_logs -.->|"accesses data"| node_repositories
node_repositories -.->|"persists entities"| node_entities
node_repositories -.->|"stores data"| node_mysql

click node_app "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/DemoApplication.java"
click node_api "https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/controller"
click node_auth "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/AuthService.java"
click node_security "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/config/SecurityConfig.java"
click node_scripture_api "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/controller/MantraController.java"
click node_scripture_services "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/MantraService.java"
click node_vedic_metadata "https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/service"
click node_interpretation "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/InterpretationService.java"
click node_practice_api "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/controller/PracticeLogController.java"
click node_practice_logs "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/PracticeLogService.java"
click node_summaries "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/PracticeSummaryService.java"
click node_streaks "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/StreakService.java"
click node_xp "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/XplogService.java"
click node_badges "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/BadgeService.java"
click node_onboarding "https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/UserOnboardingService.java"
click node_repositories "https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/repository"
click node_entities "https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/entity"

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_api,node_auth,node_security,node_user toneBlue
class node_scripture_api,node_scripture_services,node_vedic_metadata,node_interpretation,node_mysql toneAmber
class node_practice_api,node_practice_logs,node_summaries,node_streaks,node_xp,node_badges,node_onboarding toneMint
class node_repositories,node_entities toneRose
```

## Components

### Application and access

- [Spring application](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/DemoApplication.java): `src/main/java/com/vaikhari/demo/DemoApplication.java`
- [REST controllers](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/controller): `src/main/java/com/vaikhari/demo/controller`
- [Authentication](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/AuthService.java): `src/main/java/com/vaikhari/demo/service/AuthService.java`
- [Security and JWT](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/config/SecurityConfig.java): `src/main/java/com/vaikhari/demo/config/SecurityConfig.java`

### Scripture catalog

- [Scripture endpoints](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/controller/MantraController.java): `src/main/java/com/vaikhari/demo/controller/MantraController.java`
- [Scripture services](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/MantraService.java): `src/main/java/com/vaikhari/demo/service/MantraService.java`
- [Vedic metadata](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/service): `src/main/java/com/vaikhari/demo/service`
- [Interpretations](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/InterpretationService.java): `src/main/java/com/vaikhari/demo/service/InterpretationService.java`

### Practice and progress

- [Practice endpoints](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/controller/PracticeLogController.java): `src/main/java/com/vaikhari/demo/controller/PracticeLogController.java`
- [Practice tracking](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/PracticeLogService.java): `src/main/java/com/vaikhari/demo/service/PracticeLogService.java`
- [Practice summaries](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/PracticeSummaryService.java): `src/main/java/com/vaikhari/demo/service/PracticeSummaryService.java`
- [Streak tracking](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/StreakService.java): `src/main/java/com/vaikhari/demo/service/StreakService.java`
- [XP tracking](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/XplogService.java): `src/main/java/com/vaikhari/demo/service/XplogService.java`
- [Badge awards](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/BadgeService.java): `src/main/java/com/vaikhari/demo/service/BadgeService.java`
- [User onboarding](https://github.com/arad108/vaikhari/blob/master/src/main/java/com/vaikhari/demo/service/UserOnboardingService.java): `src/main/java/com/vaikhari/demo/service/UserOnboardingService.java`

### Persistence

- [Data repositories](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/repository): `src/main/java/com/vaikhari/demo/repository`
- [Domain entities](https://github.com/arad108/vaikhari/tree/master/src/main/java/com/vaikhari/demo/entity): `src/main/java/com/vaikhari/demo/entity`

### Other components

- **User**
- **MySQL database**

## Connections

- User → REST controllers: sends requests
- REST controllers → Authentication: uses authentication
- REST controllers → Security and JWT: passes through
- REST controllers → Scripture endpoints: routes scripture
- Scripture endpoints → Scripture services: delegates to
- Scripture services → Vedic metadata: uses metadata
- Scripture services → Interpretations: uses interpretations
- REST controllers → Practice endpoints: routes practice
- Practice endpoints → Practice tracking: delegates to
- Practice tracking → Practice summaries: feeds summaries
- Practice tracking → Streak tracking: updates streaks
- Practice tracking → XP tracking: records experience
- Practice tracking → Badge awards: supports awards
- REST controllers → User onboarding: supports onboarding
- Scripture services → Data repositories: accesses data
- Practice tracking → Data repositories: accesses data
- Data repositories → Domain entities: persists entities
- Data repositories → MySQL database: stores data
