# karunakara1817/field-service-management architecture

> Architecture diagram of the GitHub repository karunakara1817/field-service-management, 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/karunakara1817/field-service-management
- Repository: https://github.com/karunakara1817/field-service-management

## Overview

This is a Spring-based field service management application. Administrators manage customers, sites, technicians, inventory, and work orders; technicians have dashboard and work-order workflows. Work-order status changes are validated and recorded, technician availability is updated, and notifications are created. Inventory usage deducts stock and can trigger low-stock notifications. Reporting, authentication, and settings are also represented in the source tree, though their full wiring was not sampled; those branches are shown without speculative call edges.

Main entry points: [`src/main/java/com/zidio/fieldservice/repository`](https://github.com/karunakara1817/field-service-management/tree/main/src/main/java/com/zidio/fieldservice/repository) (JPA repositories), [`src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java`](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java) (Work-order management), [`src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java`](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java) (Status lifecycle), [`src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java`](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java) (Technician work orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Service operations"]
  node_workorder_ui["Work-order management"]
  node_customer_ui["Customer management"]
  node_site_ui["Site management"]
  node_technician_ui["Technician management"]
  node_domain["Domain entities"]
  node_repositories[("JPA repositories")]
end

subgraph group_lifecycle["Work-order lifecycle"]
  node_workorder_lifecycle["Status lifecycle"]
  node_technician_work["Technician work orders"]
  node_technician_dash["Technician dashboard"]
end

subgraph group_resources["Field resources"]
  node_inventory_ui["Inventory management"]
  node_inventory_service["Inventory service"]
  node_usage_service["Work-order stock use"]
  node_notifications["Notifications"]
end

subgraph group_platform["Access and insights"]
  node_reports["Reports<br/>[ReportService.java]"]
  node_dashboard["Operations dashboard"]
  node_auth["Authentication"]
  node_security["JWT security"]
end

node_admin(("Administrator"))
node_technician_user(("Technician"))

node_admin -.->|"manages"| node_workorder_ui
node_admin -.->|"manages"| node_customer_ui
node_admin -.->|"manages"| node_site_ui
node_admin -.->|"manages"| node_technician_ui
node_technician_user -.->|"updates work"| node_technician_work
node_technician_user -.->|"views assignments"| node_technician_dash
node_workorder_ui -->|"reads and saves"| node_repositories
node_workorder_ui -->|"changes status"| node_workorder_lifecycle
node_workorder_ui -->|"uses entities"| node_domain
node_workorder_lifecycle -->|"records transitions"| node_repositories
node_technician_work -->|"changes status"| node_workorder_lifecycle
node_technician_work -->|"reads work orders"| node_repositories
node_technician_dash -->|"reads assignments"| node_repositories
node_workorder_lifecycle -->|"creates notifications"| node_notifications
node_inventory_ui -->|"manages stock"| node_inventory_service
node_inventory_service -->|"reads and saves"| node_repositories
node_usage_service -->|"reads and updates stock"| node_repositories
node_usage_service -->|"creates low-stock alerts"| node_notifications
node_dashboard -->|"reads summaries"| node_repositories
node_dashboard -->|"loads alerts"| node_notifications
node_reports -->|"queries work orders"| node_repositories
node_auth -.->|"authenticates"| node_security

click node_workorder_ui "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java"
click node_customer_ui "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/CustomerController.java"
click node_site_ui "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/SiteController.java"
click node_technician_ui "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianController.java"
click node_workorder_lifecycle "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java"
click node_technician_work "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java"
click node_technician_dash "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianDashboardController.java"
click node_inventory_ui "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/InventoryController.java"
click node_inventory_service "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/InventoryService.java"
click node_usage_service "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/WorkOrderInventoryService.java"
click node_notifications "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/NotificationService.java"
click node_reports "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/ReportService.java"
click node_dashboard "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/DashboardController.java"
click node_auth "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/AuthController.java"
click node_security "https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/security/SecurityConfig.java"
click node_domain "https://github.com/karunakara1817/field-service-management/tree/main/src/main/java/com/zidio/fieldservice/entity"
click node_repositories "https://github.com/karunakara1817/field-service-management/tree/main/src/main/java/com/zidio/fieldservice/repository"

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_workorder_ui,node_customer_ui,node_site_ui,node_technician_ui,node_domain,node_repositories toneBlue
class node_workorder_lifecycle,node_technician_work,node_technician_dash toneAmber
class node_inventory_ui,node_inventory_service,node_usage_service,node_notifications toneMint
class node_reports,node_dashboard,node_auth,node_security toneRose
class node_admin,node_technician_user toneIndigo
```

## Components

### Service operations

- [Work-order management](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java): `src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java`
- [Customer management](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/CustomerController.java): `src/main/java/com/zidio/fieldservice/controller/CustomerController.java`
- [Site management](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/SiteController.java): `src/main/java/com/zidio/fieldservice/controller/SiteController.java`
- [Technician management](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianController.java): `src/main/java/com/zidio/fieldservice/controller/TechnicianController.java`
- [Domain entities](https://github.com/karunakara1817/field-service-management/tree/main/src/main/java/com/zidio/fieldservice/entity): `src/main/java/com/zidio/fieldservice/entity`
- [JPA repositories](https://github.com/karunakara1817/field-service-management/tree/main/src/main/java/com/zidio/fieldservice/repository): `src/main/java/com/zidio/fieldservice/repository`

### Work-order lifecycle

- [Status lifecycle](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java): `src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java`
- [Technician work orders](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java): `src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java`
- [Technician dashboard](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/TechnicianDashboardController.java): `src/main/java/com/zidio/fieldservice/controller/TechnicianDashboardController.java`

### Field resources

- [Inventory management](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/InventoryController.java): `src/main/java/com/zidio/fieldservice/controller/InventoryController.java`
- [Inventory service](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/InventoryService.java): `src/main/java/com/zidio/fieldservice/service/InventoryService.java`
- [Work-order stock use](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/WorkOrderInventoryService.java): `src/main/java/com/zidio/fieldservice/service/WorkOrderInventoryService.java`
- [Notifications](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/NotificationService.java): `src/main/java/com/zidio/fieldservice/service/NotificationService.java`

### Access and insights

- [Reports](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/service/ReportService.java): `src/main/java/com/zidio/fieldservice/service/ReportService.java`
- [Operations dashboard](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/DashboardController.java): `src/main/java/com/zidio/fieldservice/controller/DashboardController.java`
- [Authentication](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/controller/AuthController.java): `src/main/java/com/zidio/fieldservice/controller/AuthController.java`
- [JWT security](https://github.com/karunakara1817/field-service-management/blob/main/src/main/java/com/zidio/fieldservice/security/SecurityConfig.java): `src/main/java/com/zidio/fieldservice/security/SecurityConfig.java`

### Other components

- **Administrator**
- **Technician**

## Connections

- Administrator → Work-order management: manages
- Administrator → Customer management: manages
- Administrator → Site management: manages
- Administrator → Technician management: manages
- Technician → Technician work orders: updates work
- Technician → Technician dashboard: views assignments
- Work-order management → JPA repositories: reads and saves (evidence: `src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java`)
- Work-order management → Status lifecycle: changes status (evidence: `src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java`)
- Work-order management → Domain entities: uses entities (evidence: `src/main/java/com/zidio/fieldservice/controller/WorkOrderController.java`)
- Status lifecycle → JPA repositories: records transitions (evidence: `src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java`)
- Technician work orders → Status lifecycle: changes status (evidence: `src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java`)
- Technician work orders → JPA repositories: reads work orders (evidence: `src/main/java/com/zidio/fieldservice/controller/TechnicianWorkOrderController.java`)
- Technician dashboard → JPA repositories: reads assignments (evidence: `src/main/java/com/zidio/fieldservice/controller/TechnicianDashboardController.java`)
- Status lifecycle → Notifications: creates notifications (evidence: `src/main/java/com/zidio/fieldservice/service/WorkOrderLifecycleService.java`)
- Inventory management → Inventory service: manages stock (evidence: `src/main/java/com/zidio/fieldservice/controller/InventoryController.java`)
- Inventory service → JPA repositories: reads and saves (evidence: `src/main/java/com/zidio/fieldservice/service/InventoryService.java`)
- Work-order stock use → JPA repositories: reads and updates stock (evidence: `src/main/java/com/zidio/fieldservice/service/WorkOrderInventoryService.java`)
- Work-order stock use → Notifications: creates low-stock alerts (evidence: `src/main/java/com/zidio/fieldservice/service/WorkOrderInventoryService.java`)
- Operations dashboard → JPA repositories: reads summaries (evidence: `src/main/java/com/zidio/fieldservice/controller/DashboardController.java`)
- Operations dashboard → Notifications: loads alerts (evidence: `src/main/java/com/zidio/fieldservice/controller/DashboardController.java`)
- Reports → JPA repositories: queries work orders (evidence: `src/main/java/com/zidio/fieldservice/service/ReportService.java`)
- Authentication → JWT security: authenticates
