How nitish-11k/sheandsoulversion1 works
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: AppService.java Account and profile logic · PCOSReportService.java Report generation · AuthController.java Authentication API · PcosService.java PCOS assessment logic
Components 21
Access and profiles
- Authentication API
src/main/java/com/sheandsoul/v1update/controller/AuthController.java - Profile API
src/main/java/com/sheandsoul/v1update/controller/AppController.java - Account and profile logic
src/main/java/com/sheandsoul/v1update/services/AppService.java - User records
src/main/java/com/sheandsoul/v1update/repository/UserRepository.java - Profile records
src/main/java/com/sheandsoul/v1update/repository/ProfileRepository.java - OTP records
src/main/java/com/sheandsoul/v1update/repository/OtpRepository.java - JWT utilities
src/main/java/com/sheandsoul/v1update/util/JwtUtil.java
Health tracking
- PCOS API
src/main/java/com/sheandsoul/v1update/controller/PcosController.java - PCOS assessment logic
src/main/java/com/sheandsoul/v1update/services/PcosService.java - PCOS assessment records
src/main/java/com/sheandsoul/v1update/repository/PCOSAssessmentRepository.java
Assistants and reports
- Chat API
src/main/java/com/sheandsoul/v1update/controller/ChatController.java - Health assistant routing
src/main/java/com/sheandsoul/v1update/services/AssistantServiceFactory.java - Gemini integration
src/main/java/com/sheandsoul/v1update/services/GeminiService.java - Report API
src/main/java/com/sheandsoul/v1update/controller/ReportController.java - Report generation
src/main/java/com/sheandsoul/v1update/services/PCOSReportService.java
Wellness features
- Article API
src/main/java/com/sheandsoul/v1update/controller/ArticleController.java - Music API
src/main/java/com/sheandsoul/v1update/controller/MusicController.java - Notifications API
src/main/java/com/sheandsoul/v1update/controller/NotificationController.java - Dashboard API
src/main/java/com/sheandsoul/v1update/controller/DashboardController.java
Other components
- User
- Gemini AI
Connections 24
- 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