# ashrithbalaji456/task_reminder_backend architecture

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

- Interactive diagram: https://gitdiagram.com/ashrithbalaji456/task_reminder_backend
- Repository: https://github.com/ashrithbalaji456/task_reminder_backend

## Overview

Task Reminder is a Spring Boot task-and-reminder backend. The main workflow is authenticated task management: users create and update dated task occurrences, recurring definitions can materialize into occurrences, and scheduled jobs send reminders and periodic reports. Separate API branches provide history, dashboard analytics, and overdue-task alerts. The README also describes a separate offline-capable PWA client; its implementation is outside this repository’s Java source tree. Edges use the README or source-index references; unsampled internal links are omitted where evidence is unavailable.

Main entry points: [`src/main/java/com/application/taskmanager`](https://github.com/ashrithbalaji456/task_reminder_backend/tree/main/src/main/java/com/application/taskmanager) (REST API), [`src/main/java/com/application/taskmanager/task/service/TaskService.java`](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/service/TaskService.java) (Task occurrences), [`src/main/java/com/application/taskmanager/notification/scheduler/TaskReminderScheduler.java`](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/scheduler/TaskReminderScheduler.java) (Reminder scheduler), [`src/main/java/com/application/taskmanager/auth/service/AuthService.java`](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/auth/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and access"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT security"]
  node_users[("User accounts<br/>[User.java]")]
end

subgraph group_tasks["Task workflows"]
  node_tasks["Task occurrences<br/>[TaskService.java]"]
  node_taskstore[("Occurrence store")]
  node_recurring["Recurring tasks"]
  node_definitions[("Task definitions")]
end

subgraph group_insights["History and insights"]
  node_history["Task history"]
  node_dashboard["Dashboard"]
  node_analytics["Analytics"]
  node_charts["Chart generation"]
  node_alerts["Task alerts<br/>[AlertService.java]"]
end

subgraph group_notifications["Notifications"]
  node_scheduler["Reminder scheduler"]
  node_reports["Report schedulers"]
  node_email["Email delivery"]
  node_push["Web Push"]
end

subgraph group_platform["Shared platform"]
  node_api["REST API"]
end

node_user(("User"))
node_brevo["Brevo email"]
node_pushservice["Push services"]
node_chartstore[("Application data store")]

node_user -->|"uses"| node_api
node_api -->|"routes auth"| node_auth
node_auth -->|"reads and writes"| node_users
node_auth -->|"creates tokens"| node_jwt
node_api -->|"routes tasks"| node_tasks
node_tasks -->|"reads and writes"| node_taskstore
node_tasks -->|"loads owners"| node_users
node_tasks -->|"manages definitions"| node_definitions
node_api -->|"routes recurring"| node_recurring
node_recurring -->|"reads and writes"| node_definitions
node_recurring -->|"loads owners"| node_users
node_api -->|"routes history"| node_history
node_history -->|"queries occurrences"| node_taskstore
node_api -->|"routes dashboard"| node_dashboard
node_dashboard -->|"queries occurrences"| node_taskstore
node_api -->|"routes analytics"| node_analytics
node_analytics -->|"generates charts"| node_charts
node_api -->|"routes alerts"| node_alerts
node_scheduler -->|"checks reminders"| node_tasks
node_reports -->|"builds reports"| node_analytics
node_scheduler -.->|"sends notifications"| node_email
node_reports -.->|"sends reports"| node_email
node_email -->|"sends email"| node_brevo
node_scheduler -.->|"sends push"| node_push
node_push -->|"delivers payload"| node_pushservice
node_tasks -->|"persists task data"| node_chartstore

click node_api "https://github.com/ashrithbalaji456/task_reminder_backend/tree/main/src/main/java/com/application/taskmanager"
click node_auth "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/auth/service/AuthService.java"
click node_jwt "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/security/JwtTokenProvider.java"
click node_users "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/user/entity/User.java"
click node_tasks "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/service/TaskService.java"
click node_taskstore "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/repository/TaskOccurrenceRepository.java"
click node_recurring "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/recurring/service/RecurringTaskService.java"
click node_definitions "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/repository/TaskDefinitionRepository.java"
click node_history "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/history/service/HistoryService.java"
click node_dashboard "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/dashboard/service/DashboardService.java"
click node_analytics "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/analytics/service/AnalyticsService.java"
click node_charts "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/analytics/chart/ChartGenerationService.java"
click node_alerts "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/alert/service/AlertService.java"
click node_scheduler "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/scheduler/TaskReminderScheduler.java"
click node_reports "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/scheduler/WeeklyReportScheduler.java"
click node_email "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/service/EmailSenderService.java"
click node_push "https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/service/WebPushService.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_jwt,node_users,node_user toneBlue
class node_tasks,node_taskstore,node_recurring,node_definitions,node_chartstore toneAmber
class node_history,node_dashboard,node_analytics,node_charts,node_alerts toneMint
class node_scheduler,node_reports,node_email,node_push toneRose
class node_api,node_brevo,node_pushservice toneIndigo
```

## Components

### Identity and access

- [Authentication](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/auth/service/AuthService.java): `src/main/java/com/application/taskmanager/auth/service/AuthService.java`
- [JWT security](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/security/JwtTokenProvider.java): `src/main/java/com/application/taskmanager/security/JwtTokenProvider.java`
- [User accounts](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/user/entity/User.java): `src/main/java/com/application/taskmanager/user/entity/User.java`

### Task workflows

- [Task occurrences](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/service/TaskService.java): `src/main/java/com/application/taskmanager/task/service/TaskService.java`
- [Occurrence store](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/repository/TaskOccurrenceRepository.java): `src/main/java/com/application/taskmanager/task/repository/TaskOccurrenceRepository.java`
- [Recurring tasks](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/recurring/service/RecurringTaskService.java): `src/main/java/com/application/taskmanager/recurring/service/RecurringTaskService.java`
- [Task definitions](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/task/repository/TaskDefinitionRepository.java): `src/main/java/com/application/taskmanager/task/repository/TaskDefinitionRepository.java`

### History and insights

- [Task history](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/history/service/HistoryService.java): `src/main/java/com/application/taskmanager/history/service/HistoryService.java`
- [Dashboard](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/dashboard/service/DashboardService.java): `src/main/java/com/application/taskmanager/dashboard/service/DashboardService.java`
- [Analytics](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/analytics/service/AnalyticsService.java): `src/main/java/com/application/taskmanager/analytics/service/AnalyticsService.java`
- [Chart generation](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/analytics/chart/ChartGenerationService.java): `src/main/java/com/application/taskmanager/analytics/chart/ChartGenerationService.java`
- [Task alerts](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/alert/service/AlertService.java): `src/main/java/com/application/taskmanager/alert/service/AlertService.java`

### Notifications

- [Reminder scheduler](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/scheduler/TaskReminderScheduler.java): `src/main/java/com/application/taskmanager/notification/scheduler/TaskReminderScheduler.java`
- [Report schedulers](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/scheduler/WeeklyReportScheduler.java): `src/main/java/com/application/taskmanager/notification/scheduler/WeeklyReportScheduler.java`
- [Email delivery](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/service/EmailSenderService.java): `src/main/java/com/application/taskmanager/notification/service/EmailSenderService.java`
- [Web Push](https://github.com/ashrithbalaji456/task_reminder_backend/blob/main/src/main/java/com/application/taskmanager/notification/service/WebPushService.java): `src/main/java/com/application/taskmanager/notification/service/WebPushService.java`

### Shared platform

- [REST API](https://github.com/ashrithbalaji456/task_reminder_backend/tree/main/src/main/java/com/application/taskmanager): `src/main/java/com/application/taskmanager`

### Other components

- **User**
- **Brevo email**
- **Push services**
- **Application data store**

## Connections

- User → REST API: uses
- REST API → Authentication: routes auth (evidence: `src/main/java/com/application/taskmanager/auth/controller/AuthController.java`)
- Authentication → User accounts: reads and writes (evidence: `src/main/java/com/application/taskmanager/auth/service/AuthService.java`)
- Authentication → JWT security: creates tokens (evidence: `src/main/java/com/application/taskmanager/auth/service/AuthService.java`)
- REST API → Task occurrences: routes tasks (evidence: `src/main/java/com/application/taskmanager/dashboard/service/DashboardService.java`)
- Task occurrences → Occurrence store: reads and writes (evidence: `src/main/java/com/application/taskmanager/task/service/TaskService.java`)
- Task occurrences → User accounts: loads owners (evidence: `src/main/java/com/application/taskmanager/task/service/TaskService.java`)
- Task occurrences → Task definitions: manages definitions (evidence: `src/main/java/com/application/taskmanager/task/service/TaskService.java`)
- REST API → Recurring tasks: routes recurring (evidence: `src/main/java/com/application/taskmanager/recurring/controller/RecurringTaskController.java`)
- Recurring tasks → Task definitions: reads and writes (evidence: `src/main/java/com/application/taskmanager/recurring/service/RecurringTaskService.java`)
- Recurring tasks → User accounts: loads owners (evidence: `src/main/java/com/application/taskmanager/recurring/service/RecurringTaskService.java`)
- REST API → Task history: routes history (evidence: `src/main/java/com/application/taskmanager/history/controller/HistoryController.java`)
- Task history → Occurrence store: queries occurrences (evidence: `src/main/java/com/application/taskmanager/history/service/HistoryService.java`)
- REST API → Dashboard: routes dashboard (evidence: `src/main/java/com/application/taskmanager/dashboard/controller/DashboardController.java`)
- Dashboard → Occurrence store: queries occurrences (evidence: `src/main/java/com/application/taskmanager/dashboard/service/DashboardService.java`)
- REST API → Analytics: routes analytics
- Analytics → Chart generation: generates charts
- REST API → Task alerts: routes alerts (evidence: `src/main/java/com/application/taskmanager/alert/controller/AlertController.java`)
- Reminder scheduler → Task occurrences: checks reminders
- Report schedulers → Analytics: builds reports
- Reminder scheduler → Email delivery: sends notifications
- Report schedulers → Email delivery: sends reports
- Email delivery → Brevo email: sends email
- Reminder scheduler → Web Push: sends push
- Web Push → Push services: delivers payload
- Task occurrences → Application data store: persists task data
