# palanikathirvel/accountstracker architecture

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

- Interactive diagram: https://gitdiagram.com/palanikathirvel/accountstracker
- Repository: https://github.com/palanikathirvel/accountstracker

## Overview

Accounts Tracker is a role-based accounting task platform: accountants create and assign deadline-driven work, while employees view assigned tasks and update status. The frontend drives authentication, task management, AI assistance and reminder views through a service layer into the Spring API. Backend services, MongoDB repositories and the scheduled overdue watcher support task persistence and alerts. README documents workload analysis, compliance breakdowns and reminder automation; their detailed backend wiring was not sampled, so uncertain implementation links are omitted.

Main entry points: [`frontend/src/services/requestService.js`](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/services/requestService.js) (API client), [`frontend/src/App.jsx`](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/App.jsx) (Role dashboards), [`frontend/src/components/LoginForm.jsx`](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/LoginForm.jsx) (Login and registration), [`backend/src/main/java/com/example/accountanttracker/scheduler/OverdueRequestScheduler.java`](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/scheduler/OverdueRequestScheduler.java) (Overdue watcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web experience"]
  node_app["Role dashboards<br/>[App.jsx]"]
  node_login["Login and registration<br/>[LoginForm.jsx]"]
  node_form["Task assignment<br/>[RequestForm.jsx]"]
  node_table["Task list<br/>[RequestTable.jsx]"]
  node_status["Status control<br/>[StatusDropdown.jsx]"]
  node_emailmodal["Email drafting UI<br/>[AiEmailModal.jsx]"]
  node_remindersui["Reminder panel<br/>[RemindersPanel.jsx]"]
  node_themes["Theme selector<br/>[ThemeSelector.jsx]"]
  node_themecontext["Theme state<br/>[ThemeContext.jsx]"]
  node_webservice["API client<br/>[requestService.js]"]
end

subgraph group_api["Backend API"]
  node_authapi["Authentication API"]
  node_requestapi["Task and reminder API"]
  node_aiapi["AI API<br/>[AiController.java]"]
end

subgraph group_domain["Task domain"]
  node_requestservice["Task service"]
  node_requestrepo[("Task repository")]
  node_userrepo[("User repository")]
  node_reminderrepo[("Reminder repository")]
end

subgraph group_automation["Automation"]
  node_scheduler["Overdue watcher"]
  node_emailservice["Email dispatch<br/>[EmailService.java]"]
  node_aiservice["AI workflows<br/>[AiService.java]"]
end

node_accountant(("Accountant"))
node_employee(("Employee"))
node_mongodb[("MongoDB")]
node_llm["AI provider"]
node_smtp["Email provider"]

node_accountant -->|"signs in"| node_login
node_employee -->|"signs in"| node_login
node_login -->|"authenticates"| node_webservice
node_app -->|"renders"| node_login
node_app -->|"renders"| node_form
node_app -->|"renders"| node_table
node_app -->|"renders"| node_remindersui
node_app -->|"renders"| node_themes
node_themes -->|"uses"| node_themecontext
node_form -->|"requests breakdown"| node_webservice
node_table -->|"renders"| node_status
node_table -->|"opens"| node_emailmodal
node_emailmodal -->|"drafts and sends"| node_webservice
node_webservice -->|"calls auth endpoints"| node_authapi
node_webservice -->|"calls task endpoints"| node_requestapi
node_webservice -->|"calls AI endpoints"| node_aiapi
node_remindersui -.->|"triggers scan"| node_webservice
node_requestapi -.->|"delegates tasks"| node_requestservice
node_requestservice -.->|"persists tasks"| node_requestrepo
node_authapi -.->|"accesses users"| node_userrepo
node_aiapi -.->|"delegates AI"| node_aiservice
node_aiservice -.->|"uses provider"| node_llm
node_scheduler -.->|"scans overdue tasks"| node_requestrepo
node_scheduler -.->|"records alerts"| node_reminderrepo
node_scheduler -.->|"dispatches alerts"| node_emailservice
node_emailservice -.->|"sends mail"| node_smtp
node_requestrepo -.->|"stores tasks"| node_mongodb
node_userrepo -.->|"stores users"| node_mongodb
node_reminderrepo -.->|"stores reminders"| node_mongodb

click node_app "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/App.jsx"
click node_login "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/LoginForm.jsx"
click node_form "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RequestForm.jsx"
click node_table "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RequestTable.jsx"
click node_status "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/StatusDropdown.jsx"
click node_emailmodal "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/AiEmailModal.jsx"
click node_remindersui "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RemindersPanel.jsx"
click node_themes "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/ThemeSelector.jsx"
click node_themecontext "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/context/ThemeContext.jsx"
click node_webservice "https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/services/requestService.js"
click node_authapi "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/AuthController.java"
click node_requestapi "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/RequestController.java"
click node_aiapi "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/AiController.java"
click node_requestservice "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/RequestService.java"
click node_requestrepo "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/RequestRepository.java"
click node_userrepo "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/UserRepository.java"
click node_reminderrepo "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/ReminderRepository.java"
click node_scheduler "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/scheduler/OverdueRequestScheduler.java"
click node_emailservice "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/EmailService.java"
click node_aiservice "https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/AiService.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_app,node_login,node_form,node_table,node_status,node_emailmodal,node_remindersui,node_themes,node_themecontext,node_webservice toneBlue
class node_authapi,node_requestapi,node_aiapi,node_mongodb toneAmber
class node_requestservice,node_requestrepo,node_userrepo,node_reminderrepo toneMint
class node_scheduler,node_emailservice,node_aiservice toneRose
class node_accountant,node_employee,node_llm,node_smtp toneIndigo
```

## Components

### Web experience

- [Role dashboards](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and registration](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/LoginForm.jsx): `frontend/src/components/LoginForm.jsx`
- [Task assignment](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RequestForm.jsx): `frontend/src/components/RequestForm.jsx`
- [Task list](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RequestTable.jsx): `frontend/src/components/RequestTable.jsx`
- [Status control](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/StatusDropdown.jsx): `frontend/src/components/StatusDropdown.jsx`
- [Email drafting UI](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/AiEmailModal.jsx): `frontend/src/components/AiEmailModal.jsx`
- [Reminder panel](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/RemindersPanel.jsx): `frontend/src/components/RemindersPanel.jsx`
- [Theme selector](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/components/ThemeSelector.jsx): `frontend/src/components/ThemeSelector.jsx`
- [Theme state](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`
- [API client](https://github.com/palanikathirvel/accountstracker/blob/main/frontend/src/services/requestService.js): `frontend/src/services/requestService.js`

### Backend API

- [Authentication API](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/AuthController.java): `backend/src/main/java/com/example/accountanttracker/controller/AuthController.java`
- [Task and reminder API](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/RequestController.java): `backend/src/main/java/com/example/accountanttracker/controller/RequestController.java`
- [AI API](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/controller/AiController.java): `backend/src/main/java/com/example/accountanttracker/controller/AiController.java`

### Task domain

- [Task service](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/RequestService.java): `backend/src/main/java/com/example/accountanttracker/service/RequestService.java`
- [Task repository](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/RequestRepository.java): `backend/src/main/java/com/example/accountanttracker/repository/RequestRepository.java`
- [User repository](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/UserRepository.java): `backend/src/main/java/com/example/accountanttracker/repository/UserRepository.java`
- [Reminder repository](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/repository/ReminderRepository.java): `backend/src/main/java/com/example/accountanttracker/repository/ReminderRepository.java`

### Automation

- [Overdue watcher](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/scheduler/OverdueRequestScheduler.java): `backend/src/main/java/com/example/accountanttracker/scheduler/OverdueRequestScheduler.java`
- [Email dispatch](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/EmailService.java): `backend/src/main/java/com/example/accountanttracker/service/EmailService.java`
- [AI workflows](https://github.com/palanikathirvel/accountstracker/blob/main/backend/src/main/java/com/example/accountanttracker/service/AiService.java): `backend/src/main/java/com/example/accountanttracker/service/AiService.java`

### Other components

- **Accountant**
- **Employee**
- **MongoDB**
- **AI provider**
- **Email provider**

## Connections

- Accountant → Login and registration: signs in (evidence: `README.md`)
- Employee → Login and registration: signs in (evidence: `README.md`)
- Login and registration → API client: authenticates (evidence: `frontend/src/services/requestService.js`)
- Role dashboards → Login and registration: renders (evidence: `frontend/src/App.jsx`)
- Role dashboards → Task assignment: renders (evidence: `frontend/src/App.jsx`)
- Role dashboards → Task list: renders (evidence: `frontend/src/App.jsx`)
- Role dashboards → Reminder panel: renders (evidence: `frontend/src/App.jsx`)
- Role dashboards → Theme selector: renders (evidence: `frontend/src/App.jsx`)
- Theme selector → Theme state: uses (evidence: `frontend/src/components/ThemeSelector.jsx`)
- Task assignment → API client: requests breakdown (evidence: `frontend/src/components/RequestForm.jsx`)
- Task list → Status control: renders (evidence: `frontend/src/components/RequestTable.jsx`)
- Task list → Email drafting UI: opens (evidence: `frontend/src/components/RequestTable.jsx`)
- Email drafting UI → API client: drafts and sends (evidence: `frontend/src/components/AiEmailModal.jsx`)
- API client → Authentication API: calls auth endpoints (evidence: `frontend/src/services/requestService.js`)
- API client → Task and reminder API: calls task endpoints (evidence: `frontend/src/services/requestService.js`)
- API client → AI API: calls AI endpoints (evidence: `frontend/src/services/requestService.js`)
- Reminder panel → API client: triggers scan
- Task and reminder API → Task service: delegates tasks
- Task service → Task repository: persists tasks
- Authentication API → User repository: accesses users
- AI API → AI workflows: delegates AI
- AI workflows → AI provider: uses provider
- Overdue watcher → Task repository: scans overdue tasks
- Overdue watcher → Reminder repository: records alerts
- Overdue watcher → Email dispatch: dispatches alerts
- Email dispatch → Email provider: sends mail
- Task repository → MongoDB: stores tasks
- User repository → MongoDB: stores users
- Reminder repository → MongoDB: stores reminders
