# sanketch04/special-day-reminder architecture

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

- Interactive diagram: https://gitdiagram.com/sanketch04/special-day-reminder
- Repository: https://github.com/sanketch04/special-day-reminder

## Overview

This is a Spring-based personal event and reminder application. Users register or sign in, manage dated events and day plans, and can generate messages with an AI service or schedule email reminders; separate features expose festival and holiday information and WhatsApp reminders. Admins manage users, events, and planner data. The graph emphasizes workflows supported by excerpts or the source index; several controller-to-service links are explicit, while integrations and storage wiring with unsampled implementations are omitted rather than inferred.

Main entry points: [`src/main/java/com/sdr/controller/AdminController.java`](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AdminController.java) (Admin console), [`src/main/java/com/sdr/service/ScheduledEmailService.java`](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/ScheduledEmailService.java) (Email scheduling), [`src/main/java/com/sdr/service/DayPlannerService.java`](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/DayPlannerService.java) (Planner service), [`src/main/java/com/sdr/controller/AuthController.java`](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AuthController.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Accounts and admin"]
  node_user["User account<br/>[User.java]"]
  node_auth["Authentication"]
  node_user_service["User service<br/>[UserService.java]"]
  node_admin_controller["Admin console"]
  node_admin_service["Admin service<br/>[AdminService.java]"]
  node_admin_dao["Admin data access<br/>[AdminDAO.java]"]
  node_admin["Admin account<br/>[Admin.java]"]
end

subgraph group_planning["Events and planning"]
  node_event_api["Event management"]
  node_event_service["Event service<br/>[EventService.java]"]
  node_event["User events<br/>[Event.java]"]
  node_admin_events_api["Admin events"]
  node_admin_event_service["Admin event service"]
  node_admin_event["Admin event records<br/>[AdminEvent.java]"]
  node_planner_api["Day planner"]
  node_planner_service["Planner service"]
  node_planner["Planner entries<br/>[DayPlanner.java]"]
end

subgraph group_messaging["Messages and reminders"]
  node_ai_api["Message generation API<br/>[AIController.java]"]
  node_ai_service["AI message service<br/>[OpenAIService.java]"]
  node_email_api["Scheduled email API"]
  node_email_service["Email scheduling"]
  node_email_dao["Scheduled email data"]
  node_scheduled_email["Scheduled emails"]
  node_email_util["Email delivery<br/>[EmailUtil.java]"]
  node_whatsapp_api["WhatsApp reminders"]
  node_whatsapp_dao["Reminder data access"]
end

subgraph group_calendar["Calendar content"]
  node_festival_api["Festival listings"]
  node_festival_service["Festival data"]
  node_holiday_api["Holiday listings"]
  node_holiday_service["Holiday data"]
end

node_groq{{"Groq API"}}
node_actor(("Application user"))

node_actor -->|"signs in"| node_auth
node_auth -->|"authenticates"| node_user_service
node_actor -.->|"manages events"| node_event_api
node_event_api -->|"delegates"| node_event_service
node_actor -.->|"plans day"| node_planner_api
node_planner_api -->|"delegates"| node_planner_service
node_planner_service -->|"uses DAO"| node_planner
node_actor -.->|"requests message"| node_ai_api
node_ai_api -->|"delegates"| node_ai_service
node_ai_service -->|"sends request"| node_groq
node_actor -.->|"schedules email"| node_email_api
node_email_api -->|"delegates"| node_email_service
node_email_service -->|"queries and updates"| node_email_dao
node_email_service -->|"sends email"| node_email_util
node_actor -.->|"manages reminders"| node_whatsapp_api
node_whatsapp_api -->|"uses DAO"| node_whatsapp_dao
node_actor -.->|"administers"| node_admin_controller
node_admin_controller -->|"delegates"| node_admin_service
node_admin_service -->|"queries and updates"| node_admin_dao
node_admin_controller -->|"lists plans"| node_planner_service
node_admin_controller -->|"lists users"| node_user_service
node_admin_events_api -->|"delegates"| node_admin_event_service
node_actor -.->|"views festivals"| node_festival_api
node_actor -.->|"views holidays"| node_holiday_api

click node_user "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/User.java"
click node_auth "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AuthController.java"
click node_user_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/UserService.java"
click node_admin_controller "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AdminController.java"
click node_admin_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/AdminService.java"
click node_admin_dao "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/AdminDAO.java"
click node_admin "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/Admin.java"
click node_event_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/EventController.java"
click node_event_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/EventService.java"
click node_event "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/Event.java"
click node_admin_events_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AdminEventController.java"
click node_admin_event_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/AdminEventService.java"
click node_admin_event "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/AdminEvent.java"
click node_planner_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/DayPlannerController.java"
click node_planner_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/DayPlannerService.java"
click node_planner "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/DayPlanner.java"
click node_ai_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AIController.java"
click node_ai_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/ai/OpenAIService.java"
click node_email_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/ScheduledEmailController.java"
click node_email_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/ScheduledEmailService.java"
click node_email_dao "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/ScheduledEmailDAO.java"
click node_scheduled_email "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/ScheduledEmail.java"
click node_email_util "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/allUtils/EmailUtil.java"
click node_whatsapp_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/WhatsAppReminderController.java"
click node_whatsapp_dao "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/WhatsAppReminderDao.java"
click node_festival_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/FestivalController.java"
click node_festival_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/FestivalService.java"
click node_holiday_api "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/HolidayController.java"
click node_holiday_service "https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/HolidayService.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_user,node_auth,node_user_service,node_admin_controller,node_admin_service,node_admin_dao,node_admin,node_actor toneBlue
class node_event_api,node_event_service,node_event,node_admin_events_api,node_admin_event_service,node_admin_event,node_planner_api,node_planner_service,node_planner toneAmber
class node_ai_api,node_ai_service,node_email_api,node_email_service,node_email_dao,node_scheduled_email,node_email_util,node_whatsapp_api,node_whatsapp_dao,node_groq toneMint
class node_festival_api,node_festival_service,node_holiday_api,node_holiday_service toneRose
```

## Components

### Accounts and admin

- [User account](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/User.java): `src/main/java/com/sdr/entity/User.java`
- [Authentication](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AuthController.java): `src/main/java/com/sdr/controller/AuthController.java`
- [User service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/UserService.java): `src/main/java/com/sdr/service/UserService.java`
- [Admin console](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AdminController.java): `src/main/java/com/sdr/controller/AdminController.java`
- [Admin service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/AdminService.java): `src/main/java/com/sdr/service/AdminService.java`
- [Admin data access](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/AdminDAO.java): `src/main/java/com/sdr/dao/AdminDAO.java`
- [Admin account](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/Admin.java): `src/main/java/com/sdr/entity/Admin.java`

### Events and planning

- [Event management](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/EventController.java): `src/main/java/com/sdr/controller/EventController.java`
- [Event service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/EventService.java): `src/main/java/com/sdr/service/EventService.java`
- [User events](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/Event.java): `src/main/java/com/sdr/entity/Event.java`
- [Admin events](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AdminEventController.java): `src/main/java/com/sdr/controller/AdminEventController.java`
- [Admin event service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/AdminEventService.java): `src/main/java/com/sdr/service/AdminEventService.java`
- [Admin event records](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/AdminEvent.java): `src/main/java/com/sdr/entity/AdminEvent.java`
- [Day planner](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/DayPlannerController.java): `src/main/java/com/sdr/controller/DayPlannerController.java`
- [Planner service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/DayPlannerService.java): `src/main/java/com/sdr/service/DayPlannerService.java`
- [Planner entries](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/DayPlanner.java): `src/main/java/com/sdr/entity/DayPlanner.java`

### Messages and reminders

- [Message generation API](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/AIController.java): `src/main/java/com/sdr/controller/AIController.java`
- [AI message service](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/ai/OpenAIService.java): `src/main/java/com/sdr/ai/OpenAIService.java`
- [Scheduled email API](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/ScheduledEmailController.java): `src/main/java/com/sdr/controller/ScheduledEmailController.java`
- [Email scheduling](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/ScheduledEmailService.java): `src/main/java/com/sdr/service/ScheduledEmailService.java`
- [Scheduled email data](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/ScheduledEmailDAO.java): `src/main/java/com/sdr/dao/ScheduledEmailDAO.java`
- [Scheduled emails](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/entity/ScheduledEmail.java): `src/main/java/com/sdr/entity/ScheduledEmail.java`
- [Email delivery](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/allUtils/EmailUtil.java): `src/main/java/com/sdr/allUtils/EmailUtil.java`
- [WhatsApp reminders](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/WhatsAppReminderController.java): `src/main/java/com/sdr/controller/WhatsAppReminderController.java`
- [Reminder data access](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/dao/WhatsAppReminderDao.java): `src/main/java/com/sdr/dao/WhatsAppReminderDao.java`

### Calendar content

- [Festival listings](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/FestivalController.java): `src/main/java/com/sdr/controller/FestivalController.java`
- [Festival data](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/FestivalService.java): `src/main/java/com/sdr/service/FestivalService.java`
- [Holiday listings](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/controller/HolidayController.java): `src/main/java/com/sdr/controller/HolidayController.java`
- [Holiday data](https://github.com/sanketch04/special-day-reminder/blob/master/src/main/java/com/sdr/service/HolidayService.java): `src/main/java/com/sdr/service/HolidayService.java`

### Other components

- **Groq API**
- **Application user**

## Connections

- Application user → Authentication: signs in (evidence: `src/main/java/com/sdr/controller/AuthController.java`)
- Authentication → User service: authenticates (evidence: `src/main/java/com/sdr/controller/AuthController.java`)
- Application user → Event management: manages events
- Event management → Event service: delegates (evidence: `src/main/java/com/sdr/controller/EventController.java`)
- Application user → Day planner: plans day
- Day planner → Planner service: delegates (evidence: `src/main/java/com/sdr/controller/DayPlannerController.java`)
- Planner service → Planner entries: uses DAO (evidence: `src/main/java/com/sdr/service/DayPlannerService.java`)
- Application user → Message generation API: requests message
- Message generation API → AI message service: delegates (evidence: `src/main/java/com/sdr/controller/AIController.java`)
- AI message service → Groq API: sends request (evidence: `src/main/java/com/sdr/ai/OpenAIService.java`)
- Application user → Scheduled email API: schedules email
- Scheduled email API → Email scheduling: delegates (evidence: `src/main/java/com/sdr/controller/ScheduledEmailController.java`)
- Email scheduling → Scheduled email data: queries and updates (evidence: `src/main/java/com/sdr/service/ScheduledEmailService.java`)
- Email scheduling → Email delivery: sends email (evidence: `src/main/java/com/sdr/service/ScheduledEmailService.java`)
- Application user → WhatsApp reminders: manages reminders
- WhatsApp reminders → Reminder data access: uses DAO (evidence: `src/main/java/com/sdr/controller/WhatsAppReminderController.java`)
- Application user → Admin console: administers
- Admin console → Admin service: delegates (evidence: `src/main/java/com/sdr/controller/AdminController.java`)
- Admin service → Admin data access: queries and updates (evidence: `src/main/java/com/sdr/service/AdminService.java`)
- Admin console → Planner service: lists plans (evidence: `src/main/java/com/sdr/controller/AdminController.java`)
- Admin console → User service: lists users (evidence: `src/main/java/com/sdr/controller/AdminController.java`)
- Admin events → Admin event service: delegates (evidence: `src/main/java/com/sdr/controller/AdminEventController.java`)
- Application user → Festival listings: views festivals
- Application user → Holiday listings: views holidays
