# eujanjumetilco/bumberoos architecture

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

- Interactive diagram: https://gitdiagram.com/eujanjumetilco/bumberoos
- Repository: https://github.com/eujanjumetilco/bumberoos

## Overview

Bumberoos is a staff, incident, and inventory management application. Its services hold in-memory records, assign IDs, support CRUD-style operations, and persist data through text files; the sampled incident controller invokes the incident service. Staff and inventory management are also represented in the source tree, though their complete request wiring was not shown. Storage uses shared text serialization, and entities normalize selected fields through StringUtil. The README is empty, so broader product capabilities and unsampled controller relationships cannot be confirmed.

Main entry points: [`src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java`](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java) (Text storage), [`src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java`](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java) (Staff records), [`src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java`](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java) (Incident records), [`src/main/java/com/groupnine/bumberoos/services/StaffService.java`](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/StaffService.java) (Staff service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Application"]
  node_incident_controller["Incident controller"]
  node_staff_controller["Staff controller"]
end

subgraph group_operations["Management services"]
  node_incident_service["Incident service"]
  node_staff_service["Staff service<br/>[StaffService.java]"]
  node_inventory_service["Inventory service"]
end

subgraph group_domain["Domain model"]
  node_incident_entity["Incident records"]
  node_staff_entity["Staff records<br/>[StaffEntity.java]"]
  node_item_entity["Inventory items<br/>[ItemEntity.java]"]
  node_incident_states["Incident states"]
  node_incident_severity["Severity levels"]
  node_staff_availability["Staff availability"]
  node_item_condition["Item condition<br/>[ItemCondition.java]"]
  node_inventory_exception["Inventory validation"]
  node_string_util["String normalization<br/>[StringUtil.java]"]
end

subgraph group_persistence["File persistence"]
  node_text_storage["Text storage"]
  node_binary_storage["Binary storage utility"]
  node_staff_file["Staff data file<br/>[staff_data.txt]"]
end

node_user(("User"))

node_user -.->|"submits requests"| node_incident_controller
node_user -.->|"submits requests"| node_staff_controller
node_incident_controller -->|"invokes"| node_incident_service
node_app -->|"references"| node_staff_service
node_app -->|"references"| node_staff_entity
node_staff_controller -->|"references"| node_staff_entity
node_incident_service -->|"loads and saves"| node_text_storage
node_staff_service -->|"loads and saves"| node_text_storage
node_inventory_service -->|"loads and saves"| node_text_storage
node_incident_service -->|"manages"| node_incident_entity
node_staff_service -->|"manages"| node_staff_entity
node_inventory_service -->|"manages"| node_item_entity
node_inventory_service -->|"throws"| node_inventory_exception
node_incident_entity -->|"uses"| node_incident_states
node_incident_entity -->|"uses"| node_incident_severity
node_staff_entity -->|"uses"| node_staff_availability
node_item_entity -->|"uses"| node_item_condition
node_incident_entity -->|"normalizes text"| node_string_util
node_staff_entity -->|"normalizes fields"| node_string_util
node_item_entity -->|"normalizes fields"| node_string_util
node_text_storage -->|"serializes"| node_incident_entity
node_text_storage -->|"serializes"| node_staff_entity
node_text_storage -->|"serializes"| node_item_entity
node_staff_service -->|"configures path"| node_staff_file

click node_app "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/BumberoosApplication.java"
click node_incident_controller "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/controllers/IncidentController.java"
click node_staff_controller "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/controllers/StaffController.java"
click node_incident_service "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/IncidentService.java"
click node_staff_service "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/StaffService.java"
click node_inventory_service "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/InventoryService.java"
click node_incident_entity "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java"
click node_staff_entity "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java"
click node_item_entity "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/ItemEntity.java"
click node_incident_states "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/IncidentStatus.java"
click node_incident_severity "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/IncidentSeverityLevel.java"
click node_staff_availability "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/StaffAvailability.java"
click node_item_condition "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/ItemCondition.java"
click node_inventory_exception "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/exceptions/InvalidInventoryExceptions.java"
click node_string_util "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/StringUtil.java"
click node_text_storage "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java"
click node_binary_storage "https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/BinaryStorageUtil.java"
click node_staff_file "https://github.com/eujanjumetilco/bumberoos/blob/master/data/staff_data.txt"

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_incident_controller,node_staff_controller,node_user toneBlue
class node_incident_service,node_staff_service,node_inventory_service toneAmber
class node_incident_entity,node_staff_entity,node_item_entity,node_incident_states,node_incident_severity,node_staff_availability,node_item_condition,node_inventory_exception,node_string_util toneMint
class node_text_storage,node_binary_storage,node_staff_file toneRose
```

## Components

### Application entry

- [Application](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/BumberoosApplication.java): `src/main/java/com/groupnine/bumberoos/BumberoosApplication.java`
- [Incident controller](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/controllers/IncidentController.java): `src/main/java/com/groupnine/bumberoos/controllers/IncidentController.java`
- [Staff controller](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/controllers/StaffController.java): `src/main/java/com/groupnine/bumberoos/controllers/StaffController.java`

### Management services

- [Incident service](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/IncidentService.java): `src/main/java/com/groupnine/bumberoos/services/IncidentService.java`
- [Staff service](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/StaffService.java): `src/main/java/com/groupnine/bumberoos/services/StaffService.java`
- [Inventory service](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/services/InventoryService.java): `src/main/java/com/groupnine/bumberoos/services/InventoryService.java`

### Domain model

- [Incident records](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java): `src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java`
- [Staff records](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java): `src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java`
- [Inventory items](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/entities/ItemEntity.java): `src/main/java/com/groupnine/bumberoos/domain/entities/ItemEntity.java`
- [Incident states](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/IncidentStatus.java): `src/main/java/com/groupnine/bumberoos/domain/enums/IncidentStatus.java`
- [Severity levels](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/IncidentSeverityLevel.java): `src/main/java/com/groupnine/bumberoos/domain/enums/IncidentSeverityLevel.java`
- [Staff availability](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/StaffAvailability.java): `src/main/java/com/groupnine/bumberoos/domain/enums/StaffAvailability.java`
- [Item condition](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/enums/ItemCondition.java): `src/main/java/com/groupnine/bumberoos/domain/enums/ItemCondition.java`
- [Inventory validation](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/domain/exceptions/InvalidInventoryExceptions.java): `src/main/java/com/groupnine/bumberoos/domain/exceptions/InvalidInventoryExceptions.java`
- [String normalization](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/StringUtil.java): `src/main/java/com/groupnine/bumberoos/util/StringUtil.java`

### File persistence

- [Text storage](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java): `src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java`
- [Binary storage utility](https://github.com/eujanjumetilco/bumberoos/blob/master/src/main/java/com/groupnine/bumberoos/util/BinaryStorageUtil.java): `src/main/java/com/groupnine/bumberoos/util/BinaryStorageUtil.java`
- [Staff data file](https://github.com/eujanjumetilco/bumberoos/blob/master/data/staff_data.txt): `data/staff_data.txt`

### Other components

- **User**

## Connections

- User → Incident controller: submits requests
- User → Staff controller: submits requests
- Incident controller → Incident service: invokes (evidence: `src/main/java/com/groupnine/bumberoos/controllers/IncidentController.java`)
- Application → Staff service: references (evidence: `src/main/java/com/groupnine/bumberoos/BumberoosApplication.java`)
- Application → Staff records: references (evidence: `src/main/java/com/groupnine/bumberoos/BumberoosApplication.java`)
- Staff controller → Staff records: references (evidence: `src/main/java/com/groupnine/bumberoos/controllers/StaffController.java`)
- Incident service → Text storage: loads and saves (evidence: `src/main/java/com/groupnine/bumberoos/services/IncidentService.java`)
- Staff service → Text storage: loads and saves (evidence: `src/main/java/com/groupnine/bumberoos/services/StaffService.java`)
- Inventory service → Text storage: loads and saves (evidence: `src/main/java/com/groupnine/bumberoos/services/InventoryService.java`)
- Incident service → Incident records: manages (evidence: `src/main/java/com/groupnine/bumberoos/services/IncidentService.java`)
- Staff service → Staff records: manages (evidence: `src/main/java/com/groupnine/bumberoos/services/StaffService.java`)
- Inventory service → Inventory items: manages (evidence: `src/main/java/com/groupnine/bumberoos/services/InventoryService.java`)
- Inventory service → Inventory validation: throws (evidence: `src/main/java/com/groupnine/bumberoos/services/InventoryService.java`)
- Incident records → Incident states: uses (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java`)
- Incident records → Severity levels: uses (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java`)
- Staff records → Staff availability: uses (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java`)
- Inventory items → Item condition: uses (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/ItemEntity.java`)
- Incident records → String normalization: normalizes text (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/IncidentEntity.java`)
- Staff records → String normalization: normalizes fields (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/StaffEntity.java`)
- Inventory items → String normalization: normalizes fields (evidence: `src/main/java/com/groupnine/bumberoos/domain/entities/ItemEntity.java`)
- Text storage → Incident records: serializes (evidence: `src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java`)
- Text storage → Staff records: serializes (evidence: `src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java`)
- Text storage → Inventory items: serializes (evidence: `src/main/java/com/groupnine/bumberoos/util/TextStorageUtil.java`)
- Staff service → Staff data file: configures path (evidence: `src/main/java/com/groupnine/bumberoos/services/StaffService.java`)
