# nitish-11k/sheandsoulversion1 architecture

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

- Interactive diagram: https://gitdiagram.com/nitish-11k/sheandsoulversion1
- Repository: https://github.com/nitish-11k/sheandsoulversion1

## Overview

This is a women’s health API covering account access and profiles, menstrual tracking, PCOS assessment, breast-health logging and reports, health assistants, and supporting content and wellness features. The main flow is a user request through a controller to domain logic and, where evidenced, persisted data or an external AI service; reports return generated PDFs. The README is empty, and source excerpts are partial, so several capabilities are represented from the tree without speculative service wiring.

Main entry points: [`src/main/java/com/sheandsoul/v1update/services/AppService.java`](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/AppService.java) (Account and profile logic), [`src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java`](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java) (Report generation), [`src/main/java/com/sheandsoul/v1update/controller/AuthController.java`](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/AuthController.java) (Authentication API), [`src/main/java/com/sheandsoul/v1update/services/PcosService.java`](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PcosService.java) (PCOS assessment logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and profiles"]
  node_auth["Authentication API"]
  node_appapi["Profile API<br/>[AppController.java]"]
  node_appsvc["Account and profile logic<br/>[AppService.java]"]
  node_users[("User records")]
  node_profiles[("Profile records")]
  node_otp[("OTP records<br/>[OtpRepository.java]")]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
end

subgraph group_health["Health tracking"]
  node_pcosapi["PCOS API"]
  node_pcossvc["PCOS assessment logic<br/>[PcosService.java]"]
  node_pcosdata[("PCOS assessment records")]
end

subgraph group_assist["Assistants and reports"]
  node_assistantapi["Chat API"]
  node_assistant["Health assistant routing"]
  node_gemini["Gemini integration<br/>[GeminiService.java]"]
  node_reportapi["Report API"]
  node_reports["Report generation"]
end

subgraph group_wellness["Wellness features"]
  node_articles["Article API"]
  node_music["Music API"]
  node_notifications["Notifications API"]
  node_dashboard["Dashboard API"]
end

node_user(("User"))
node_ai{{"Gemini AI"}}

node_user -->|"submits credentials"| node_auth
node_user -->|"manages profile"| node_appapi
node_user -->|"submits assessment"| node_pcosapi
node_user -->|"asks health question"| node_assistantapi
node_user -->|"requests report"| node_reportapi
node_user -->|"requests content"| node_articles
node_user -->|"requests music"| node_music
node_user -->|"manages notifications"| node_notifications
node_user -->|"views dashboard"| node_dashboard
node_auth -->|"registers users"| node_appsvc
node_auth -->|"creates token"| node_jwt
node_appapi -->|"updates profile"| node_appsvc
node_appsvc -->|"reads and writes"| node_users
node_appsvc -->|"reads and writes"| node_profiles
node_appsvc -->|"validates OTP"| node_otp
node_pcosapi -->|"submits and queries"| node_pcossvc
node_pcossvc -->|"loads profile"| node_appsvc
node_pcossvc -->|"reads and saves"| node_pcosdata
node_reportapi -->|"requests PDF"| node_reports
node_reports -->|"looks up user"| node_users
node_reports -->|"loads profile"| node_profiles
node_reports -->|"loads assessment"| node_pcosdata
node_reports -->|"requests analysis"| node_gemini
node_gemini -->|"sends prompt"| node_ai

click node_auth "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/AuthController.java"
click node_appapi "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/AppController.java"
click node_appsvc "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/AppService.java"
click node_users "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/UserRepository.java"
click node_profiles "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/ProfileRepository.java"
click node_otp "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/OtpRepository.java"
click node_jwt "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/util/JwtUtil.java"
click node_pcosapi "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/PcosController.java"
click node_pcossvc "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PcosService.java"
click node_pcosdata "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/PCOSAssessmentRepository.java"
click node_assistantapi "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ChatController.java"
click node_assistant "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/AssistantServiceFactory.java"
click node_gemini "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/GeminiService.java"
click node_reportapi "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ReportController.java"
click node_reports "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java"
click node_articles "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ArticleController.java"
click node_music "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/MusicController.java"
click node_notifications "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/NotificationController.java"
click node_dashboard "https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/DashboardController.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_auth,node_appapi,node_appsvc,node_users,node_profiles,node_otp,node_jwt,node_user toneBlue
class node_pcosapi,node_pcossvc,node_pcosdata toneAmber
class node_assistantapi,node_assistant,node_gemini,node_reportapi,node_reports toneMint
class node_articles,node_music,node_notifications,node_dashboard toneRose
class node_ai toneIndigo
```

## Components

### Access and profiles

- [Authentication API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/AuthController.java): `src/main/java/com/sheandsoul/v1update/controller/AuthController.java`
- [Profile API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/AppController.java): `src/main/java/com/sheandsoul/v1update/controller/AppController.java`
- [Account and profile logic](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/AppService.java): `src/main/java/com/sheandsoul/v1update/services/AppService.java`
- [User records](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/UserRepository.java): `src/main/java/com/sheandsoul/v1update/repository/UserRepository.java`
- [Profile records](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/ProfileRepository.java): `src/main/java/com/sheandsoul/v1update/repository/ProfileRepository.java`
- [OTP records](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/OtpRepository.java): `src/main/java/com/sheandsoul/v1update/repository/OtpRepository.java`
- [JWT utilities](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/util/JwtUtil.java): `src/main/java/com/sheandsoul/v1update/util/JwtUtil.java`

### Health tracking

- [PCOS API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/PcosController.java): `src/main/java/com/sheandsoul/v1update/controller/PcosController.java`
- [PCOS assessment logic](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PcosService.java): `src/main/java/com/sheandsoul/v1update/services/PcosService.java`
- [PCOS assessment records](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/repository/PCOSAssessmentRepository.java): `src/main/java/com/sheandsoul/v1update/repository/PCOSAssessmentRepository.java`

### Assistants and reports

- [Chat API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ChatController.java): `src/main/java/com/sheandsoul/v1update/controller/ChatController.java`
- [Health assistant routing](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/AssistantServiceFactory.java): `src/main/java/com/sheandsoul/v1update/services/AssistantServiceFactory.java`
- [Gemini integration](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/GeminiService.java): `src/main/java/com/sheandsoul/v1update/services/GeminiService.java`
- [Report API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ReportController.java): `src/main/java/com/sheandsoul/v1update/controller/ReportController.java`
- [Report generation](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java): `src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java`

### Wellness features

- [Article API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/ArticleController.java): `src/main/java/com/sheandsoul/v1update/controller/ArticleController.java`
- [Music API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/MusicController.java): `src/main/java/com/sheandsoul/v1update/controller/MusicController.java`
- [Notifications API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/NotificationController.java): `src/main/java/com/sheandsoul/v1update/controller/NotificationController.java`
- [Dashboard API](https://github.com/nitish-11k/sheandsoulversion1/blob/main/src/main/java/com/sheandsoul/v1update/controller/DashboardController.java): `src/main/java/com/sheandsoul/v1update/controller/DashboardController.java`

### Other components

- **User**
- **Gemini AI**

## Connections

- User → Authentication API: submits credentials
- User → Profile API: manages profile
- User → PCOS API: submits assessment
- User → Chat API: asks health question
- User → Report API: requests report
- User → Article API: requests content
- User → Music API: requests music
- User → Notifications API: manages notifications
- User → Dashboard API: views dashboard
- Authentication API → Account and profile logic: registers users
- Authentication API → JWT utilities: creates token
- Profile API → Account and profile logic: updates profile
- Account and profile logic → User records: reads and writes
- Account and profile logic → Profile records: reads and writes
- Account and profile logic → OTP records: validates OTP
- PCOS API → PCOS assessment logic: submits and queries
- PCOS assessment logic → Account and profile logic: loads profile
- PCOS assessment logic → PCOS assessment records: reads and saves
- Report API → Report generation: requests PDF
- Report generation → User records: looks up user
- Report generation → Profile records: loads profile
- Report generation → PCOS assessment records: loads assessment
- Report generation → Gemini integration: requests analysis
- Gemini integration → Gemini AI: sends prompt