# anbuganeshpdmr/worklens architecture

> Architecture diagram of the GitHub repository anbuganeshpdmr/worklens, 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/anbuganeshpdmr/worklens
- Repository: https://github.com/anbuganeshpdmr/worklens

## Overview

Worklens is a work-planning and time-tracking application. Users enter through routed, role-aware web pages to manage projects, sprints, activities, statuses and team members; the backend models those domains and supports starting, closing and searching work entries. The graph separates the frontend, planning domains, time execution and shared configuration/access. Frontend route imports and selected backend service dependencies are visible; because most controllers and frontend API calls were not sampled, those links are omitted rather than inferred.

Main entry points: [`apps/worklens-frontend/src/routes/AppRoutes.jsx`](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/routes/AppRoutes.jsx) (Application routes), [`apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java) (Activities), [`apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java) (Sprint activities), [`apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java) (Time entries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_routes["Application routes<br/>[AppRoutes.jsx]"]
  node_projects_page["Project pages"]
  node_project_page["Project view<br/>[ProjectPage.jsx]"]
  node_sprint_page["Sprint management"]
  node_activity_page["Activity management<br/>[ActivitiesPage.jsx]"]
  node_entry_page["Entry dashboard<br/>[EntryDashboard.jsx]"]
  node_general_page["General activities"]
  node_my_entries["Personal entries<br/>[MyEntriesPage.jsx]"]
  node_user_admin["User management<br/>[UserManagement.jsx]"]
  node_profile["User profile<br/>[ProfilePage.jsx]"]
  node_reports["Reports<br/>[ReportChart.jsx]"]
end

subgraph group_planning["Planning domains"]
  node_projects["Projects"]
  node_sprints["Sprints"]
  node_activities["Activities"]
  node_sprint_activities["Sprint activities"]
  node_project_store[("Project repository<br/>[ProjectRepo.java]")]
end

subgraph group_execution["Work execution"]
  node_entries["Time entries<br/>[EntryService.java]"]
  node_history["Activity history"]
  node_entry_store[("Entry repository<br/>[EntryRepo.java]")]
end

subgraph group_shared["Shared configuration"]
  node_categories["Categories"]
  node_types["Activity types"]
  node_statuses["Record statuses<br/>[StatusService.java]"]
  node_users["Users and roles<br/>[User.java]"]
  node_resources["Resources"]
  node_category_store[("Category repository<br/>[CategoryRepo.java]")]
  node_status_store[("Status repository<br/>[StatusRepo.java]")]
end

node_user(("User"))

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_projects_page
node_routes -->|"routes to"| node_project_page
node_routes -->|"routes to"| node_sprint_page
node_routes -->|"routes to"| node_activity_page
node_routes -->|"routes to"| node_entry_page
node_routes -->|"routes to"| node_general_page
node_routes -->|"routes to"| node_my_entries
node_routes -->|"routes to"| node_user_admin
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_reports
node_projects -->|"reads and writes"| node_project_store
node_projects -->|"looks up status"| node_statuses
node_projects -->|"gets current user"| node_users
node_categories -->|"reads and writes"| node_category_store
node_activities -->|"looks up type"| node_types
node_activities -->|"looks up category"| node_categories
node_activities -->|"looks up project"| node_projects
node_activities -->|"looks up status"| node_statuses
node_activities -->|"gets current user"| node_users
node_statuses -->|"reads and writes"| node_status_store
node_entries -->|"reads and writes"| node_entry_store
node_entries -->|"gets activity"| node_activities
node_entries -->|"gets sprint activity"| node_sprint_activities
node_entries -->|"looks up status"| node_statuses
node_entries -->|"gets current user"| node_users
node_sprint_activities -->|"uses entry service"| node_entries
node_sprint_activities -->|"uses activity service"| node_activities
node_sprint_activities -->|"uses status service"| node_statuses
node_sprint_activities -->|"references project"| node_projects
node_sprint_activities -->|"uses sprint service"| node_sprints

click node_routes "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/routes/AppRoutes.jsx"
click node_projects_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProjectsAndSprintsPage.jsx"
click node_project_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProjectPage.jsx"
click node_sprint_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/SprintManagementPage.jsx"
click node_activity_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ActivitiesPage.jsx"
click node_entry_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/EntryDashboard.jsx"
click node_general_page "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/GeneralActivitiesPage.jsx"
click node_my_entries "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/MyEntriesPage.jsx"
click node_user_admin "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/UserManagement.jsx"
click node_profile "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProfilePage.jsx"
click node_reports "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/components/reports/ReportChart.jsx"
click node_projects "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java"
click node_sprints "https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint"
click node_activities "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java"
click node_sprint_activities "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java"
click node_entries "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java"
click node_history "https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_history"
click node_categories "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryService.java"
click node_types "https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity_type"
click node_statuses "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusService.java"
click node_users "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_user/User.java"
click node_resources "https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_resource"
click node_project_store "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectRepo.java"
click node_category_store "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryRepo.java"
click node_status_store "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusRepo.java"
click node_entry_store "https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryRepo.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_routes,node_projects_page,node_project_page,node_sprint_page,node_activity_page,node_entry_page,node_general_page,node_my_entries,node_user_admin,node_profile,node_reports,node_user toneBlue
class node_projects,node_sprints,node_activities,node_sprint_activities,node_project_store toneAmber
class node_entries,node_history,node_entry_store toneMint
class node_categories,node_types,node_statuses,node_users,node_resources,node_category_store,node_status_store toneRose
```

## Components

### Web application

- [Application routes](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/routes/AppRoutes.jsx): `apps/worklens-frontend/src/routes/AppRoutes.jsx`
- [Project pages](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProjectsAndSprintsPage.jsx): `apps/worklens-frontend/src/pages/ProjectsAndSprintsPage.jsx`
- [Project view](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProjectPage.jsx): `apps/worklens-frontend/src/pages/ProjectPage.jsx`
- [Sprint management](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/SprintManagementPage.jsx): `apps/worklens-frontend/src/pages/SprintManagementPage.jsx`
- [Activity management](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ActivitiesPage.jsx): `apps/worklens-frontend/src/pages/ActivitiesPage.jsx`
- [Entry dashboard](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/EntryDashboard.jsx): `apps/worklens-frontend/src/pages/EntryDashboard.jsx`
- [General activities](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/GeneralActivitiesPage.jsx): `apps/worklens-frontend/src/pages/GeneralActivitiesPage.jsx`
- [Personal entries](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/MyEntriesPage.jsx): `apps/worklens-frontend/src/pages/MyEntriesPage.jsx`
- [User management](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/UserManagement.jsx): `apps/worklens-frontend/src/pages/UserManagement.jsx`
- [User profile](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/pages/ProfilePage.jsx): `apps/worklens-frontend/src/pages/ProfilePage.jsx`
- [Reports](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-frontend/src/components/reports/ReportChart.jsx): `apps/worklens-frontend/src/components/reports/ReportChart.jsx`

### Planning domains

- [Projects](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java`
- [Sprints](https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint`
- [Activities](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`
- [Sprint activities](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`
- [Project repository](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectRepo.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectRepo.java`

### Work execution

- [Time entries](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`
- [Activity history](https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_history): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_history`
- [Entry repository](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryRepo.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryRepo.java`

### Shared configuration

- [Categories](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryService.java`
- [Activity types](https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity_type): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity_type`
- [Record statuses](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusService.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusService.java`
- [Users and roles](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_user/User.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_user/User.java`
- [Resources](https://github.com/anbuganeshpdmr/worklens/tree/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_resource): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_resource`
- [Category repository](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryRepo.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryRepo.java`
- [Status repository](https://github.com/anbuganeshpdmr/worklens/blob/develop/apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusRepo.java): `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusRepo.java`

### Other components

- **User**

## Connections

- User → Application routes: uses (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Project pages: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Project view: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Sprint management: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Activity management: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Entry dashboard: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → General activities: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Personal entries: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → User management: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → User profile: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Application routes → Reports: routes to (evidence: `apps/worklens-frontend/src/routes/AppRoutes.jsx`)
- Projects → Project repository: reads and writes (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java`)
- Projects → Record statuses: looks up status (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java`)
- Projects → Users and roles: gets current user (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_project/ProjectService.java`)
- Categories → Category repository: reads and writes (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_category/CategoryService.java`)
- Activities → Activity types: looks up type (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`)
- Activities → Categories: looks up category (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`)
- Activities → Projects: looks up project (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`)
- Activities → Record statuses: looks up status (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`)
- Activities → Users and roles: gets current user (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_activity/ActivityService.java`)
- Record statuses → Status repository: reads and writes (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_status/StatusService.java`)
- Time entries → Entry repository: reads and writes (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`)
- Time entries → Activities: gets activity (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`)
- Time entries → Sprint activities: gets sprint activity (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`)
- Time entries → Record statuses: looks up status (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`)
- Time entries → Users and roles: gets current user (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_entry/EntryService.java`)
- Sprint activities → Time entries: uses entry service (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`)
- Sprint activities → Activities: uses activity service (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`)
- Sprint activities → Record statuses: uses status service (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`)
- Sprint activities → Projects: references project (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`)
- Sprint activities → Sprints: uses sprint service (evidence: `apps/worklens-backend/src/main/java/com/pdmrindia/worklens/module_sprint_activity/SprintActivityService.java`)
