# fryday-crispycrew/fryday-server architecture

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

- Interactive diagram: https://gitdiagram.com/fryday-crispycrew/fryday-server
- Repository: https://github.com/fryday-crispycrew/fryday-server

## Overview

FryDay is a Spring backend for a personal todo-list app with recurring tasks, social groups, reports, notifications, and administration. The main user workflow is to authenticate, organize tasks into categories, manage and complete tasks (including recurring instances), then review daily or monthly results. Group sharing, push notifications, and admin analytics are additional capabilities visible in the tree and event vocabulary. Several subsystem paths are known only from the tree, so their entry-point links are marked unverified; edges otherwise rely on the supplied excerpts or source index.

Main entry points: [`src/main/java/basakan/fryday/service/todo/TodoService.java`](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/TodoService.java) (Todo Management), [`src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java`](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java) (Recurring Tasks), [`src/main/java/basakan/fryday/service/group/GroupService.java`](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/group/GroupService.java) (Group Management), [`src/main/java/basakan/fryday/repository/todo/TodoRepository.java`](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/todo/TodoRepository.java) (Todo Store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_user["User Accounts"]
  node_authproviders["Social Login Providers"]
end

subgraph group_planning["Tasks And Reports"]
  node_category["Categories"]
  node_categoryrepo[("Category Store")]
  node_todo["Todo Management<br/>[TodoService.java]"]
  node_recurrence["Recurring Tasks"]
  node_todorepo[("Todo Store")]
  node_recurrencerepo[("Recurrence Store")]
  node_alarms["Todo Alarms"]
  node_daily["Daily Results"]
  node_monthly["Monthly Reports"]
end

subgraph group_groups["Social Groups"]
  node_groupsvc["Group Management<br/>[GroupService.java]"]
  node_grouprepo[("Group Stores")]
  node_groupstream["Group Live Updates"]
end

subgraph group_signals["Events And Notifications"]
  node_eventlog["User Event Log"]
  node_push["Push Delivery"]
  node_devices[("Device Records")]
end

subgraph group_operations["Admin And Content"]
  node_notices["Notices<br/>[NoticeService.java]"]
  node_admin["Admin Analytics"]
end

node_client(("Mobile App User"))
node_social{{"Social Providers"}}
node_fcm{{"Firebase Cloud Messaging"}}

node_client -.->|"authenticates"| node_user
node_user -->|"validates tokens"| node_authproviders
node_authproviders -.->|"requests identity"| node_social
node_category -->|"reads and writes"| node_categoryrepo
node_client -.->|"manages categories"| node_category
node_client -.->|"manages tasks"| node_todo
node_todo -->|"checks ownership"| node_categoryrepo
node_todo -->|"reads and writes"| node_todorepo
node_client -.->|"manages repeats"| node_recurrence
node_recurrence -->|"loads instances"| node_todorepo
node_recurrence -->|"loads recurrence"| node_recurrencerepo
node_recurrence -->|"synchronizes alarms"| node_alarms
node_client -.->|"views daily results"| node_daily
node_client -.->|"views monthly reports"| node_monthly
node_monthly -->|"reads categories"| node_categoryrepo
node_monthly -->|"queries activity"| node_todorepo
node_client -.->|"shares with groups"| node_groupsvc
node_groupsvc -->|"reads and writes"| node_grouprepo
node_groupsvc -->|"reads public tasks"| node_todorepo
node_category -->|"removes shared category"| node_grouprepo
node_client -.->|"receives live updates"| node_groupstream
node_client -.->|"receives notifications"| node_push
node_push -->|"loads recipients"| node_devices
node_push -.->|"sends messages"| node_fcm
node_client -.->|"reads notices"| node_notices
node_client -.->|"administers service"| node_admin
node_user -.->|"publishes events"| node_eventlog
node_groupsvc -->|"publishes events"| node_eventlog
node_todo -->|"publishes events"| node_eventlog

click node_user "https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/service/user"
click node_authproviders "https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/repository/auth/client"
click node_category "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/CategoryService.java"
click node_categoryrepo "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/CategoryRepository.java"
click node_todo "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/TodoService.java"
click node_recurrence "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java"
click node_todorepo "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/todo/TodoRepository.java"
click node_recurrencerepo "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/todo/RecurrenceRepository.java"
click node_alarms "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/TodoAlarmService.java"
click node_daily "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/DailyResultService.java"
click node_monthly "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/report/MonthlyReportReadService.java"
click node_groupsvc "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/group/GroupService.java"
click node_grouprepo "https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/repository/group"
click node_groupstream "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/group/GroupSseService.java"
click node_eventlog "https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/service/eventlog"
click node_push "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/common/service/push/FcmPushService.java"
click node_devices "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/auth/UserDeviceRepository.java"
click node_notices "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/NoticeService.java"
click node_admin "https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/admin/AdminMetricsService.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_authproviders,node_client toneBlue
class node_category,node_categoryrepo,node_todo,node_recurrence,node_todorepo,node_recurrencerepo,node_alarms,node_daily,node_monthly toneAmber
class node_groupsvc,node_grouprepo,node_groupstream toneMint
class node_eventlog,node_push,node_devices toneRose
class node_notices,node_admin,node_social,node_fcm toneIndigo
```

## Components

### Accounts

- [User Accounts](https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/service/user): `src/main/java/basakan/fryday/service/user`
- [Social Login Providers](https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/repository/auth/client): `src/main/java/basakan/fryday/repository/auth/client`

### Tasks And Reports

- [Categories](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/CategoryService.java): `src/main/java/basakan/fryday/service/CategoryService.java`
- [Category Store](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/CategoryRepository.java): `src/main/java/basakan/fryday/repository/CategoryRepository.java`
- [Todo Management](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/TodoService.java): `src/main/java/basakan/fryday/service/todo/TodoService.java`
- [Recurring Tasks](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java): `src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java`
- [Todo Store](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/todo/TodoRepository.java): `src/main/java/basakan/fryday/repository/todo/TodoRepository.java`
- [Recurrence Store](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/todo/RecurrenceRepository.java): `src/main/java/basakan/fryday/repository/todo/RecurrenceRepository.java`
- [Todo Alarms](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/todo/TodoAlarmService.java): `src/main/java/basakan/fryday/service/todo/TodoAlarmService.java`
- [Daily Results](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/DailyResultService.java): `src/main/java/basakan/fryday/service/DailyResultService.java`
- [Monthly Reports](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/report/MonthlyReportReadService.java): `src/main/java/basakan/fryday/service/report/MonthlyReportReadService.java`

### Social Groups

- [Group Management](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/group/GroupService.java): `src/main/java/basakan/fryday/service/group/GroupService.java`
- [Group Stores](https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/repository/group): `src/main/java/basakan/fryday/repository/group`
- [Group Live Updates](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/group/GroupSseService.java): `src/main/java/basakan/fryday/service/group/GroupSseService.java`

### Events And Notifications

- [User Event Log](https://github.com/fryday-crispycrew/fryday-server/tree/develop/src/main/java/basakan/fryday/service/eventlog): `src/main/java/basakan/fryday/service/eventlog`
- [Push Delivery](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/common/service/push/FcmPushService.java): `src/main/java/basakan/fryday/common/service/push/FcmPushService.java`
- [Device Records](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/repository/auth/UserDeviceRepository.java): `src/main/java/basakan/fryday/repository/auth/UserDeviceRepository.java`

### Admin And Content

- [Notices](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/NoticeService.java): `src/main/java/basakan/fryday/service/NoticeService.java`
- [Admin Analytics](https://github.com/fryday-crispycrew/fryday-server/blob/develop/src/main/java/basakan/fryday/service/admin/AdminMetricsService.java): `src/main/java/basakan/fryday/service/admin/AdminMetricsService.java`

### Other components

- **Mobile App User**
- **Social Providers**
- **Firebase Cloud Messaging**

## Connections

- Mobile App User → User Accounts: authenticates
- User Accounts → Social Login Providers: validates tokens (evidence: `src/main/java/basakan/fryday/service/user/UserAppService.java`)
- Social Login Providers → Social Providers: requests identity
- Categories → Category Store: reads and writes (evidence: `src/main/java/basakan/fryday/service/CategoryService.java`)
- Mobile App User → Categories: manages categories
- Mobile App User → Todo Management: manages tasks
- Todo Management → Category Store: checks ownership (evidence: `src/main/java/basakan/fryday/service/todo/TodoService.java`)
- Todo Management → Todo Store: reads and writes (evidence: `src/main/java/basakan/fryday/service/todo/TodoService.java`)
- Mobile App User → Recurring Tasks: manages repeats
- Recurring Tasks → Todo Store: loads instances (evidence: `src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java`)
- Recurring Tasks → Recurrence Store: loads recurrence (evidence: `src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java`)
- Recurring Tasks → Todo Alarms: synchronizes alarms (evidence: `src/main/java/basakan/fryday/service/todo/RecurrenceInstanceService.java`)
- Mobile App User → Daily Results: views daily results
- Mobile App User → Monthly Reports: views monthly reports
- Monthly Reports → Category Store: reads categories (evidence: `src/main/java/basakan/fryday/service/report/MonthlyReportReadService.java`)
- Monthly Reports → Todo Store: queries activity (evidence: `src/main/java/basakan/fryday/service/report/MonthlyReportReadService.java`)
- Mobile App User → Group Management: shares with groups
- Group Management → Group Stores: reads and writes (evidence: `src/main/java/basakan/fryday/service/group/GroupService.java`)
- Group Management → Todo Store: reads public tasks (evidence: `src/main/java/basakan/fryday/service/group/GroupService.java`)
- Categories → Group Stores: removes shared category (evidence: `src/main/java/basakan/fryday/service/CategoryService.java`)
- Mobile App User → Group Live Updates: receives live updates
- Mobile App User → Push Delivery: receives notifications
- Push Delivery → Device Records: loads recipients (evidence: `src/main/java/basakan/fryday/common/service/push/FcmPushService.java`)
- Push Delivery → Firebase Cloud Messaging: sends messages
- Mobile App User → Notices: reads notices
- Mobile App User → Admin Analytics: administers service
- User Accounts → User Event Log: publishes events (evidence: `src/main/java/basakan/fryday/service/user/UserWriteService.java`)
- Group Management → User Event Log: publishes events (evidence: `src/main/java/basakan/fryday/service/group/GroupService.java`)
- Todo Management → User Event Log: publishes events (evidence: `src/main/java/basakan/fryday/service/todo/TodoService.java`)
