# parineethakr/successionplanning architecture

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

- Interactive diagram: https://gitdiagram.com/parineethakr/successionplanning
- Repository: https://github.com/parineethakr/successionplanning

## Overview

This is a Java/Spring succession-planning subsystem presented through a Swing desktop application. A user selects a panel in the main window to manage roles, successors, development plans, readiness, risk, notifications, reports, or bonus inputs. Core workflows include importing employees into a talent pool, calculating readiness, matching successors, tracking development progress, and analyzing role risk. The sampled services show repository-backed operations and simulated HRMS data providers. Some panels and integrations are documented but not sampled, so their internal call paths are not inferred.

Main entry points: [`src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java) (Bonus aggregation), [`src/main/java/com/hrms/succession/service/RiskAnalyzerService.java`](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/RiskAnalyzerService.java) (Risk analysis), [`src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java`](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java) (Readiness scoring), [`src/main/java/com/hrms/succession/ui/MainFrame.java`](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/ui/MainFrame.java) (Main window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_application["Application startup"]
  node_mainframe["Main window<br/>[MainFrame.java]"]
  node_panels["Workflow panels"]
end

subgraph group_domain["Succession workflows"]
  node_roles["Role management<br/>[RoleService.java]"]
  node_talent["Talent pool"]
  node_readiness["Readiness scoring"]
  node_matching["Successor matching"]
  node_development["Development plans"]
  node_progress["Progress tracking"]
  node_risk["Risk analysis"]
  node_notifications["Notifications"]
  node_bonus["Bonus aggregation"]
end

subgraph group_integrations["HRMS integrations"]
  node_gateway["Integration gateway"]
  node_providers["Mock HRMS providers"]
end

subgraph group_data["Data contracts"]
  node_dto["Data transfer objects"]
end

node_user(("HR user"))
node_database[("Succession database")]

node_user -->|"uses"| node_mainframe
node_application -->|"opens"| node_mainframe
node_mainframe -->|"displays"| node_panels
node_talent -->|"loads employees"| node_providers
node_readiness -->|"gets reviews"| node_providers
node_risk -->|"sends alerts"| node_notifications
node_risk -->|"triggers hiring"| node_gateway
node_progress -->|"creates overdue alerts"| node_notifications
node_gateway -->|"dispatches requests"| node_providers
node_bonus -->|"reads scores"| node_readiness
node_bonus -->|"reads role"| node_roles
node_bonus -->|"reads rankings"| node_matching
node_bonus -->|"reads risk"| node_risk
node_bonus -->|"reads progress"| node_development
node_roles -->|"reads and writes"| node_database
node_talent -->|"reads and writes"| node_database
node_readiness -->|"reads and writes"| node_database
node_matching -->|"reads and writes"| node_database
node_development -->|"reads and writes"| node_database
node_progress -->|"reads and writes"| node_database
node_risk -->|"reads and writes"| node_database
node_notifications -->|"reads and writes"| node_database

click node_application "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/SuccessionPlanningApplication.java"
click node_mainframe "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/ui/MainFrame.java"
click node_panels "https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/ui"
click node_roles "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/RoleService.java"
click node_talent "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/TalentPoolService.java"
click node_readiness "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java"
click node_matching "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/SuccessorMatcherService.java"
click node_development "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/DevelopmentPlanService.java"
click node_progress "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/ProgressTrackerService.java"
click node_risk "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/RiskAnalyzerService.java"
click node_notifications "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/NotificationService.java"
click node_bonus "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java"
click node_gateway "https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/IntegrationGateway.java"
click node_providers "https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/integration"
click node_dto "https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/dto"

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_application,node_mainframe,node_panels,node_user toneBlue
class node_roles,node_talent,node_readiness,node_matching,node_development,node_progress,node_risk,node_notifications,node_bonus,node_database toneAmber
class node_gateway,node_providers toneMint
class node_dto toneRose
```

## Components

### Desktop interface

- [Application startup](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/SuccessionPlanningApplication.java): `src/main/java/com/hrms/succession/SuccessionPlanningApplication.java`
- [Main window](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/ui/MainFrame.java): `src/main/java/com/hrms/succession/ui/MainFrame.java`
- [Workflow panels](https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/ui): `src/main/java/com/hrms/succession/ui`

### Succession workflows

- [Role management](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/RoleService.java): `src/main/java/com/hrms/succession/service/RoleService.java`
- [Talent pool](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/TalentPoolService.java): `src/main/java/com/hrms/succession/service/TalentPoolService.java`
- [Readiness scoring](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java): `src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java`
- [Successor matching](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/SuccessorMatcherService.java): `src/main/java/com/hrms/succession/service/SuccessorMatcherService.java`
- [Development plans](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/DevelopmentPlanService.java): `src/main/java/com/hrms/succession/service/DevelopmentPlanService.java`
- [Progress tracking](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/ProgressTrackerService.java): `src/main/java/com/hrms/succession/service/ProgressTrackerService.java`
- [Risk analysis](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/RiskAnalyzerService.java): `src/main/java/com/hrms/succession/service/RiskAnalyzerService.java`
- [Notifications](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/NotificationService.java): `src/main/java/com/hrms/succession/service/NotificationService.java`
- [Bonus aggregation](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java): `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`

### HRMS integrations

- [Integration gateway](https://github.com/parineethakr/successionplanning/blob/main/src/main/java/com/hrms/succession/service/IntegrationGateway.java): `src/main/java/com/hrms/succession/service/IntegrationGateway.java`
- [Mock HRMS providers](https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/integration): `src/main/java/com/hrms/succession/integration`

### Data contracts

- [Data transfer objects](https://github.com/parineethakr/successionplanning/tree/main/src/main/java/com/hrms/succession/dto): `src/main/java/com/hrms/succession/dto`

### Other components

- **HR user**
- **Succession database**

## Connections

- HR user → Main window: uses
- Application startup → Main window: opens (evidence: `src/main/java/com/hrms/succession/SuccessionPlanningApplication.java`)
- Main window → Workflow panels: displays (evidence: `src/main/java/com/hrms/succession/ui/MainFrame.java`)
- Talent pool → Mock HRMS providers: loads employees (evidence: `src/main/java/com/hrms/succession/service/TalentPoolService.java`)
- Readiness scoring → Mock HRMS providers: gets reviews (evidence: `src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java`)
- Risk analysis → Notifications: sends alerts (evidence: `src/main/java/com/hrms/succession/service/RiskAnalyzerService.java`)
- Risk analysis → Integration gateway: triggers hiring (evidence: `src/main/java/com/hrms/succession/service/RiskAnalyzerService.java`)
- Progress tracking → Notifications: creates overdue alerts (evidence: `src/main/java/com/hrms/succession/service/ProgressTrackerService.java`)
- Integration gateway → Mock HRMS providers: dispatches requests (evidence: `src/main/java/com/hrms/succession/service/IntegrationGateway.java`)
- Bonus aggregation → Readiness scoring: reads scores (evidence: `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`)
- Bonus aggregation → Role management: reads role (evidence: `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`)
- Bonus aggregation → Successor matching: reads rankings (evidence: `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`)
- Bonus aggregation → Risk analysis: reads risk (evidence: `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`)
- Bonus aggregation → Development plans: reads progress (evidence: `src/main/java/com/hrms/succession/facade/SuccessionBonusFacade.java`)
- Role management → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/RoleService.java`)
- Talent pool → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/TalentPoolService.java`)
- Readiness scoring → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/ReadinessCalculatorService.java`)
- Successor matching → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/SuccessorMatcherService.java`)
- Development plans → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/DevelopmentPlanService.java`)
- Progress tracking → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/ProgressTrackerService.java`)
- Risk analysis → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/RiskAnalyzerService.java`)
- Notifications → Succession database: reads and writes (evidence: `src/main/java/com/hrms/succession/service/NotificationService.java`)
