# ahmed111hatem/project_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/ahmed111hatem/project_management_system
- Repository: https://github.com/ahmed111hatem/project_management_system

## Overview

This is a Java Swing corporate access-control application. Its documented workflow is role-based sign-in with input validation, followed by access to a role-specific dashboard; users can also launch project documentation through native desktop integration. The README describes a centralized theme shared across the UI. Source excerpts were unavailable, so the diagram relies on README relationships and does not infer behavior for the data files or the application entry point.

Main entry points: [`src/main/java/org/example/theme.java`](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/theme.java) (Theme configuration), [`src/main/java/org/example/LoginScreen.java`](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java) (Role authentication), [`src/main/java/org/example/AdminDashboard.java`](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/AdminDashboard.java) (Admin dashboard), [`src/main/java/org/example/PMDashboard.java`](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/PMDashboard.java) (Project manager dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access control"]
  node_login["Login screen<br/>[LoginScreen.java]"]
  node_authentication["Role authentication<br/>[LoginScreen.java]"]
  node_validation["Input validation<br/>[LoginScreen.java]"]
end

subgraph group_dashboards["Role dashboards"]
  node_admin["Admin dashboard"]
  node_project_manager["Project manager dashboard<br/>[PMDashboard.java]"]
  node_team_leader["Team leader dashboard"]
  node_employee["Employee dashboard"]
end

subgraph group_documentation["Documentation access"]
  node_documentation_viewer["Documentation viewer<br/>[LoginScreen.java]"]
  node_native_desktop["Native desktop integration"]
end

subgraph group_presentation["Presentation"]
  node_theme["Theme configuration<br/>[theme.java]"]
end

node_user(("User"))
node_main["Application entry<br/>[Main.java]"]

node_user -->|"signs in"| node_login
node_login -->|"verifies role"| node_authentication
node_login -->|"validates input"| node_validation
node_authentication -->|"authorizes"| node_admin
node_authentication -->|"authorizes"| node_project_manager
node_authentication -->|"authorizes"| node_team_leader
node_authentication -->|"authorizes"| node_employee
node_user -->|"opens documents"| node_documentation_viewer
node_documentation_viewer -->|"launches natively"| node_native_desktop
node_theme -->|"styles UI"| node_login
node_theme -->|"styles UI"| node_admin
node_theme -->|"styles UI"| node_project_manager
node_theme -->|"styles UI"| node_team_leader
node_theme -->|"styles UI"| node_employee

click node_main "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/Main.java"
click node_login "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java"
click node_authentication "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java"
click node_validation "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java"
click node_admin "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/AdminDashboard.java"
click node_project_manager "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/PMDashboard.java"
click node_team_leader "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LeaderDashboard.java"
click node_employee "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/EmployeeDashboard.java"
click node_documentation_viewer "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java"
click node_theme "https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/theme.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_login,node_authentication,node_validation,node_user toneBlue
class node_admin,node_project_manager,node_team_leader,node_employee toneAmber
class node_documentation_viewer,node_native_desktop toneMint
class node_theme toneRose
class node_main toneTeal
```

## Components

### Access control

- [Login screen](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java): `src/main/java/org/example/LoginScreen.java`
- [Role authentication](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java): `src/main/java/org/example/LoginScreen.java`
- [Input validation](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java): `src/main/java/org/example/LoginScreen.java`

### Role dashboards

- [Admin dashboard](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/AdminDashboard.java): `src/main/java/org/example/AdminDashboard.java`
- [Project manager dashboard](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/PMDashboard.java): `src/main/java/org/example/PMDashboard.java`
- [Team leader dashboard](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LeaderDashboard.java): `src/main/java/org/example/LeaderDashboard.java`
- [Employee dashboard](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/EmployeeDashboard.java): `src/main/java/org/example/EmployeeDashboard.java`

### Documentation access

- [Documentation viewer](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/LoginScreen.java): `src/main/java/org/example/LoginScreen.java`
- **Native desktop integration**

### Presentation

- [Theme configuration](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/theme.java): `src/main/java/org/example/theme.java`

### Other components

- **User**
- [Application entry](https://github.com/ahmed111hatem/project_management_system/blob/main/src/main/java/org/example/Main.java): `src/main/java/org/example/Main.java`

## Connections

- User → Login screen: signs in (evidence: `README.md`)
- Login screen → Role authentication: verifies role (evidence: `README.md`)
- Login screen → Input validation: validates input (evidence: `README.md`)
- Role authentication → Admin dashboard: authorizes (evidence: `README.md`)
- Role authentication → Project manager dashboard: authorizes (evidence: `README.md`)
- Role authentication → Team leader dashboard: authorizes (evidence: `README.md`)
- Role authentication → Employee dashboard: authorizes (evidence: `README.md`)
- User → Documentation viewer: opens documents (evidence: `README.md`)
- Documentation viewer → Native desktop integration: launches natively (evidence: `README.md`)
- Theme configuration → Login screen: styles UI (evidence: `README.md`)
- Theme configuration → Admin dashboard: styles UI (evidence: `README.md`)
- Theme configuration → Project manager dashboard: styles UI (evidence: `README.md`)
- Theme configuration → Team leader dashboard: styles UI (evidence: `README.md`)
- Theme configuration → Employee dashboard: styles UI (evidence: `README.md`)
