# amarpandav/capacity-planning architecture

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

- Interactive diagram: https://gitdiagram.com/amarpandav/capacity-planning
- Repository: https://github.com/amarpandav/capacity-planning

## Overview

Capacity Planning is a web application for organizing Pods, viewing team membership and availability, and planning or changing user assignments across date and half-day slots. The main evidenced workflow is a scheduler client requesting a Pod’s assignments, with the web controller delegating retrieval or assignment changes to service-layer operations. The backend also exposes Pod, user, and “my Pods” capabilities. Source excerpts show the assignment path and user-query construction; several other listed capabilities are represented from the tree, with their internal connections omitted where wiring was not shown.

Main entry points: [`modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java`](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java) (Assignment API), [`modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts) (Scheduler client), [`modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java`](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java) (User search), [`modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodAssignmentRepository.java`](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodAssignmentRepository.java) (Assignment records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_angular_app["Angular app<br/>[app.component.ts]"]
  node_scheduler_ui["Scheduler client"]
  node_pod_ui["Pod client<br/>[pod.service.ts]"]
  node_user_ui["User client<br/>[user.service.ts]"]
  node_error_ui["Error display<br/>[error.service.ts]"]
end

subgraph group_web["HTTP API"]
  node_assignment_api["Assignment API"]
  node_my_pods_api["My Pods API"]
  node_pod_api["Pod API<br/>[PodController.java]"]
  node_user_api["User API"]
end

subgraph group_services["Domain services"]
  node_assignment_read["Assignment queries"]
  node_assignment_create["Create assignments"]
  node_assignment_remove["Unassign slots"]
  node_pod_management["Pod management"]
  node_my_pods["Member and watcher Pods"]
  node_user_search["User search<br/>[UserQuery.java]"]
end

subgraph group_domain["Domain and persistence"]
  node_assignment_store[("Assignment records")]
  node_pod_store[("Pod records<br/>[PodRepository.java]")]
  node_user_store[("User records")]
  node_pod_entity["Pod and membership<br/>[Pod.java]"]
  node_user_entity["User identity<br/>[User.java]"]
  node_availability["Availability model<br/>[Availability.java]"]
  node_query_tools["Query utilities<br/>[QueryBuilder.java]"]
  node_entity_id["Entity ID<br/>[EntityId.java]"]
end

node_planner(("Planner user"))

node_planner -.->|"uses"| node_angular_app
node_angular_app -.->|"opens scheduler"| node_scheduler_ui
node_scheduler_ui -->|"requests assignments"| node_assignment_api
node_scheduler_ui -->|"posts assignments"| node_assignment_api
node_scheduler_ui -->|"puts unassignments"| node_assignment_api
node_scheduler_ui -->|"reports errors"| node_error_ui
node_assignment_api -->|"delegates retrieval"| node_assignment_read
node_assignment_api -->|"delegates creation"| node_assignment_create
node_assignment_api -->|"delegates removal"| node_assignment_remove
node_my_pods_api -->|"delegates"| node_my_pods
node_my_pods_api -->|"searches users"| node_user_search
node_user_api -->|"delegates search"| node_user_search
node_user_search -->|"queries"| node_user_entity
node_user_search -->|"builds query"| node_query_tools
node_user_search -.->|"reads users"| node_user_store
node_assignment_read -.->|"reads assignments"| node_assignment_store
node_assignment_create -.->|"writes assignments"| node_assignment_store
node_assignment_remove -.->|"updates assignments"| node_assignment_store
node_pod_management -.->|"uses Pod data"| node_pod_store
node_my_pods -.->|"returns Pod details"| node_pod_entity
node_pod_entity -.->|"models availability"| node_availability
node_user_entity -.->|"identifies users"| node_entity_id

click node_angular_app "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/app.component.ts"
click node_scheduler_ui "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts"
click node_pod_ui "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/pod/pod.service.ts"
click node_user_ui "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/user/user.service.ts"
click node_error_ui "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/error-dialog/error.service.ts"
click node_assignment_api "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java"
click node_my_pods_api "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/MyPodsController.java"
click node_pod_api "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodController.java"
click node_user_api "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/UserController.java"
click node_assignment_read "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodAssignmentServiceImpl.java"
click node_assignment_create "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/CreateAssignmentsServiceImpl.java"
click node_assignment_remove "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/UnassignPodServiceImpl.java"
click node_pod_management "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodServiceImpl.java"
click node_my_pods "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/MyPodServiceImpl.java"
click node_user_search "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java"
click node_assignment_store "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodAssignmentRepository.java"
click node_pod_store "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodRepository.java"
click node_user_store "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/UserRepository.java"
click node_pod_entity "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/pod/Pod.java"
click node_user_entity "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/user/User.java"
click node_availability "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/availability/Availability.java"
click node_query_tools "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-utils/src/main/java/com/ubs/cpt/infra/query/QueryBuilder.java"
click node_entity_id "https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/EntityId.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_angular_app,node_scheduler_ui,node_pod_ui,node_user_ui,node_error_ui,node_planner toneBlue
class node_assignment_api,node_my_pods_api,node_pod_api,node_user_api toneAmber
class node_assignment_read,node_assignment_create,node_assignment_remove,node_pod_management,node_my_pods,node_user_search toneMint
class node_assignment_store,node_pod_store,node_user_store,node_pod_entity,node_user_entity,node_availability,node_query_tools,node_entity_id toneRose
```

## Components

### Web client

- [Angular app](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/app.component.ts): `modules/cpt-ui/cpt-ui-angular/src/app/app.component.ts`
- [Scheduler client](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts): `modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`
- [Pod client](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/pod/pod.service.ts): `modules/cpt-ui/cpt-ui-angular/src/app/pod/pod.service.ts`
- [User client](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/user/user.service.ts): `modules/cpt-ui/cpt-ui-angular/src/app/user/user.service.ts`
- [Error display](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-ui/cpt-ui-angular/src/app/error-dialog/error.service.ts): `modules/cpt-ui/cpt-ui-angular/src/app/error-dialog/error.service.ts`

### HTTP API

- [Assignment API](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java): `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java`
- [My Pods API](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/MyPodsController.java): `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/MyPodsController.java`
- [Pod API](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodController.java): `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodController.java`
- [User API](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/UserController.java): `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/UserController.java`

### Domain services

- [Assignment queries](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodAssignmentServiceImpl.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodAssignmentServiceImpl.java`
- [Create assignments](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/CreateAssignmentsServiceImpl.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/CreateAssignmentsServiceImpl.java`
- [Unassign slots](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/UnassignPodServiceImpl.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/UnassignPodServiceImpl.java`
- [Pod management](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodServiceImpl.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/PodServiceImpl.java`
- [Member and watcher Pods](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/MyPodServiceImpl.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/MyPodServiceImpl.java`
- [User search](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java`

### Domain and persistence

- [Assignment records](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodAssignmentRepository.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodAssignmentRepository.java`
- [Pod records](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodRepository.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/PodRepository.java`
- [User records](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/UserRepository.java): `modules/cpt-service/src/main/java/com/ubs/cpt/service/repository/UserRepository.java`
- [Pod and membership](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/pod/Pod.java): `modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/pod/Pod.java`
- [User identity](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/user/User.java): `modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/user/User.java`
- [Availability model](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/availability/Availability.java): `modules/cpt-entities/src/main/java/com/ubs/cpt/domain/entity/availability/Availability.java`
- [Query utilities](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-utils/src/main/java/com/ubs/cpt/infra/query/QueryBuilder.java): `modules/cpt-utils/src/main/java/com/ubs/cpt/infra/query/QueryBuilder.java`
- [Entity ID](https://github.com/amarpandav/capacity-planning/blob/main/modules/cpt-entities/src/main/java/com/ubs/cpt/domain/EntityId.java): `modules/cpt-entities/src/main/java/com/ubs/cpt/domain/EntityId.java`

### Other components

- **Planner user**

## Connections

- Planner user → Angular app: uses
- Angular app → Scheduler client: opens scheduler
- Scheduler client → Assignment API: requests assignments (evidence: `modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`)
- Scheduler client → Assignment API: posts assignments (evidence: `modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`)
- Scheduler client → Assignment API: puts unassignments (evidence: `modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`)
- Scheduler client → Error display: reports errors (evidence: `modules/cpt-ui/cpt-ui-angular/src/app/scheduler/scheduler.service.ts`)
- Assignment API → Assignment queries: delegates retrieval (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java`)
- Assignment API → Create assignments: delegates creation (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java`)
- Assignment API → Unassign slots: delegates removal (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/PodAssignmentController.java`)
- My Pods API → Member and watcher Pods: delegates (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/MyPodsController.java`)
- My Pods API → User search: searches users (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/MyPodsController.java`)
- User API → User search: delegates search (evidence: `modules/cpt-web-app/src/main/java/com/ubs/cpt/web/rest/UserController.java`)
- User search → User identity: queries (evidence: `modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java`)
- User search → Query utilities: builds query (evidence: `modules/cpt-service/src/main/java/com/ubs/cpt/service/query/UserQuery.java`)
- User search → User records: reads users
- Assignment queries → Assignment records: reads assignments
- Create assignments → Assignment records: writes assignments (evidence: `modules/cpt-service/src/main/java/com/ubs/cpt/service/impl/CreateAssignmentsServiceImpl.java`)
- Unassign slots → Assignment records: updates assignments
- Pod management → Pod records: uses Pod data
- Member and watcher Pods → Pod and membership: returns Pod details
- Pod and membership → Availability model: models availability
- User identity → Entity ID: identifies users
