# t-h-e-silence/incidentmanagmenttool architecture

> Architecture diagram of the GitHub repository t-h-e-silence/incidentmanagmenttool, 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/t-h-e-silence/incidentmanagmenttool
- Repository: https://github.com/t-h-e-silence/incidentmanagmenttool

## Overview

This is a Java/Spring monolith whose only user-action entry point is an injected controller, not an HTTP API. Users report and work incidents; the documented lifecycle includes team ownership, reassignment, escalation, comments, and resolution. Actions are audited, notifications are persisted and delivered through periodic SMTP processing, and escalation history includes receiver-specific emails. The README describes module responsibilities, but no source excerpts were supplied, so internal service-call and repository wiring is not asserted.

Main entry points: [`src/main/java/org/example/controller/IncidentManagementController.java`](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/controller/IncidentManagementController.java) (Action controller), [`src/main/java/org/example/escalations/service/EscalationServiceImpl.java`](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/escalations/service/EscalationServiceImpl.java) (Escalation service), [`src/main/java/org/example/incidents/service/IncidentServiceImpl.java`](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/incidents/service/IncidentServiceImpl.java) (Incident service), [`src/main/java/org/example/notifications/service/NotificationServiceImpl.java`](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/NotificationServiceImpl.java) (Notification service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_organization["Organization"]
  node_org_service["Organization service"]
  node_org_repository["Organization repository"]
end

subgraph group_incident["Incident workflow"]
  node_controller["Action controller"]
  node_incident_service["Incident service"]
  node_incident_repository["Incident repository"]
end

subgraph group_history["History and escalation"]
  node_audit_service["Audit service"]
  node_audit_repository["Audit repository"]
  node_escalation_service["Escalation service"]
  node_escalation_repository["Escalation repository"]
  node_escalation_email["Escalation emails"]
end

subgraph group_delivery["Email delivery"]
  node_notification_service["Notification service"]
  node_notification_repository["Notification repository"]
  node_email_job["Email delivery job"]
  node_email_sender["Email sender<br/>[EmailSender.java]"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]
node_smtp["SMTP server"]

node_user -->|"invokes actions"| node_controller
node_controller -.->|"incident actions"| node_incident_service
node_controller -.->|"organization queries"| node_org_service
node_controller -.->|"audited actions"| node_audit_service
node_controller -.->|"escalation actions"| node_escalation_service
node_controller -.->|"notification actions"| node_notification_service
node_incident_service -.->|"escalates incidents"| node_escalation_service
node_incident_service -.->|"uses team ownership"| node_org_service
node_notification_service -->|"stores notifications"| node_postgres
node_email_job -->|"sends emails"| node_smtp
node_escalation_service -.->|"creates receiver emails"| node_escalation_email
node_escalation_service -.->|"stores escalation history"| node_postgres

click node_controller "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/controller/IncidentManagementController.java"
click node_org_service "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/organization/service/OrganizationServiceImpl.java"
click node_org_repository "https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/organization/repository"
click node_incident_service "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/incidents/service/IncidentServiceImpl.java"
click node_incident_repository "https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/incidents/repository"
click node_audit_service "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/audit/service/AuditServiceImpl.java"
click node_audit_repository "https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/audit/repository"
click node_escalation_service "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/escalations/service/EscalationServiceImpl.java"
click node_escalation_repository "https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/escalations/repository"
click node_escalation_email "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/escalations/service/EscalationEmails.java"
click node_notification_service "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/NotificationServiceImpl.java"
click node_notification_repository "https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/notifications/repository"
click node_email_job "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/EmailDeliveryJob.java"
click node_email_sender "https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/EmailSender.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_org_service,node_org_repository,node_user toneBlue
class node_controller,node_incident_service,node_incident_repository,node_postgres toneAmber
class node_audit_service,node_audit_repository,node_escalation_service,node_escalation_repository,node_escalation_email,node_smtp toneMint
class node_notification_service,node_notification_repository,node_email_job,node_email_sender toneRose
```

## Components

### Organization

- [Organization service](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/organization/service/OrganizationServiceImpl.java): `src/main/java/org/example/organization/service/OrganizationServiceImpl.java`
- [Organization repository](https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/organization/repository): `src/main/java/org/example/organization/repository`

### Incident workflow

- [Action controller](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/controller/IncidentManagementController.java): `src/main/java/org/example/controller/IncidentManagementController.java`
- [Incident service](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/incidents/service/IncidentServiceImpl.java): `src/main/java/org/example/incidents/service/IncidentServiceImpl.java`
- [Incident repository](https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/incidents/repository): `src/main/java/org/example/incidents/repository`

### History and escalation

- [Audit service](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/audit/service/AuditServiceImpl.java): `src/main/java/org/example/audit/service/AuditServiceImpl.java`
- [Audit repository](https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/audit/repository): `src/main/java/org/example/audit/repository`
- [Escalation service](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/escalations/service/EscalationServiceImpl.java): `src/main/java/org/example/escalations/service/EscalationServiceImpl.java`
- [Escalation repository](https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/escalations/repository): `src/main/java/org/example/escalations/repository`
- [Escalation emails](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/escalations/service/EscalationEmails.java): `src/main/java/org/example/escalations/service/EscalationEmails.java`

### Email delivery

- [Notification service](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/NotificationServiceImpl.java): `src/main/java/org/example/notifications/service/NotificationServiceImpl.java`
- [Notification repository](https://github.com/t-h-e-silence/incidentmanagmenttool/tree/master/src/main/java/org/example/notifications/repository): `src/main/java/org/example/notifications/repository`
- [Email delivery job](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/EmailDeliveryJob.java): `src/main/java/org/example/notifications/service/EmailDeliveryJob.java`
- [Email sender](https://github.com/t-h-e-silence/incidentmanagmenttool/blob/master/src/main/java/org/example/notifications/service/EmailSender.java): `src/main/java/org/example/notifications/service/EmailSender.java`

### Other components

- **User**
- **PostgreSQL**
- **SMTP server**

## Connections

- User → Action controller: invokes actions (evidence: `README.md`)
- Action controller → Incident service: incident actions
- Action controller → Organization service: organization queries
- Action controller → Audit service: audited actions
- Action controller → Escalation service: escalation actions
- Action controller → Notification service: notification actions
- Incident service → Escalation service: escalates incidents
- Incident service → Organization service: uses team ownership
- Notification service → PostgreSQL: stores notifications (evidence: `README.md`)
- Email delivery job → SMTP server: sends emails (evidence: `README.md`)
- Escalation service → Escalation emails: creates receiver emails
- Escalation service → PostgreSQL: stores escalation history
