# koppelit101424-art/koppel-itsm architecture

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

- Interactive diagram: https://gitdiagram.com/koppelit101424-art/koppel-itsm
- Repository: https://github.com/koppelit101424-art/koppel-itsm

## Overview

Koppel-ITSM is a role-based IT service-management application, with separate admin and user portals. The visible workflow routes portal requests to ticket and purchasing functions; admins also manage inventory and organization data. The repository additionally contains a separate Evaluation-System application. The README provides no product details, and many routes and integrations are unsampled; edges below are limited to routing or dependencies shown in the excerpts or SOURCE INDEX.

Main entry points: [`ITSM/admin/index.php`](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/admin/index.php) (Admin portal), [`ITSM/user/index.php`](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/index.php) (User portal), [`ITSM/user/ticket`](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket) (User ticketing), [`ITSM/user/ticket/includes`](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket/includes) (Purchasing requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Portals and access"]
  node_admin_portal["Admin portal<br/>[index.php]"]
  node_user_portal["User portal<br/>[index.php]"]
  node_admin_auth["Admin access control<br/>[auth.php]"]
  node_user_auth["User access control<br/>[auth.php]"]
end

subgraph group_service["Tickets and purchasing"]
  node_admin_tickets["Admin ticketing"]
  node_user_tickets["User ticketing"]
  node_purchasing["Purchasing requests"]
end

subgraph group_operations["IT operations"]
  node_inventory["Asset inventory"]
  node_organization["Organization management"]
  node_announcements["Announcements"]
end

subgraph group_shared["Shared infrastructure"]
  node_mail["Email transport<br/>[PHPMailer.php]"]
  node_mail_exception["Mail exceptions<br/>[Exception.php]"]
  node_database[("MySQL database<br/>[db.php]")]
  node_user_database[("User DB connection<br/>[db.php]")]
end

subgraph group_evaluation["Evaluation app"]
  node_evaluation["Evaluation system<br/>[index.php]"]
end

node_admin_actor(("Admin user"))
node_user_actor(("Service user"))

node_admin_actor -->|"opens"| node_admin_portal
node_admin_portal -->|"checks access"| node_admin_auth
node_admin_portal -->|"routes requests"| node_admin_tickets
node_admin_portal -->|"routes requests"| node_inventory
node_admin_portal -->|"routes requests"| node_organization
node_admin_portal -->|"routes requests"| node_announcements
node_user_actor -->|"opens"| node_user_portal
node_user_portal -->|"checks access"| node_user_auth
node_user_portal -->|"routes requests"| node_user_tickets
node_user_portal -->|"routes requests"| node_purchasing
node_purchasing -->|"sends notifications"| node_mail
node_mail -->|"throws"| node_mail_exception
node_inventory -->|"queries"| node_database
node_user_tickets -->|"uses connection"| node_user_database
node_evaluation -.->|"serves evaluations"| node_admin_actor

click node_admin_portal "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/admin/index.php"
click node_user_portal "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/index.php"
click node_admin_auth "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/includes/auth.php"
click node_user_auth "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/includes/auth.php"
click node_admin_tickets "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/ticket"
click node_user_tickets "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket"
click node_purchasing "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket/includes"
click node_mail "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/PHPMailer/PHPMailer.php"
click node_mail_exception "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/PHPMailer/Exception.php"
click node_inventory "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/inventory"
click node_organization "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/organization"
click node_announcements "https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/announcement"
click node_database "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/includes/db.php"
click node_user_database "https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/includes/db.php"
click node_evaluation "https://github.com/koppelit101424-art/koppel-itsm/blob/main/Evaluation-System/index.php"

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_admin_portal,node_user_portal,node_admin_auth,node_user_auth,node_admin_actor,node_user_actor toneBlue
class node_admin_tickets,node_user_tickets,node_purchasing toneAmber
class node_inventory,node_organization,node_announcements toneMint
class node_mail,node_mail_exception,node_database,node_user_database toneRose
class node_evaluation toneIndigo
```

## Components

### Portals and access

- [Admin portal](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/admin/index.php): `ITSM/admin/index.php`
- [User portal](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/index.php): `ITSM/user/index.php`
- [Admin access control](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/includes/auth.php): `ITSM/includes/auth.php`
- [User access control](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/includes/auth.php): `ITSM/user/includes/auth.php`

### Tickets and purchasing

- [Admin ticketing](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/ticket): `ITSM/admin/ticket`
- [User ticketing](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket): `ITSM/user/ticket`
- [Purchasing requests](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/user/ticket/includes): `ITSM/user/ticket/includes`

### IT operations

- [Asset inventory](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/inventory): `ITSM/admin/inventory`
- [Organization management](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/organization): `ITSM/admin/organization`
- [Announcements](https://github.com/koppelit101424-art/koppel-itsm/tree/main/ITSM/admin/announcement): `ITSM/admin/announcement`

### Shared infrastructure

- [Email transport](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/PHPMailer/PHPMailer.php): `ITSM/PHPMailer/PHPMailer.php`
- [Mail exceptions](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/PHPMailer/Exception.php): `ITSM/PHPMailer/Exception.php`
- [MySQL database](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/includes/db.php): `ITSM/includes/db.php`
- [User DB connection](https://github.com/koppelit101424-art/koppel-itsm/blob/main/ITSM/user/includes/db.php): `ITSM/user/includes/db.php`

### Evaluation app

- [Evaluation system](https://github.com/koppelit101424-art/koppel-itsm/blob/main/Evaluation-System/index.php): `Evaluation-System/index.php`

### Other components

- **Admin user**
- **Service user**

## Connections

- Admin user → Admin portal: opens
- Admin portal → Admin access control: checks access (evidence: `ITSM/admin/index.php`)
- Admin portal → Admin ticketing: routes requests (evidence: `ITSM/admin/index.php`)
- Admin portal → Asset inventory: routes requests (evidence: `ITSM/admin/index.php`)
- Admin portal → Organization management: routes requests (evidence: `ITSM/admin/index.php`)
- Admin portal → Announcements: routes requests (evidence: `ITSM/admin/index.php`)
- Service user → User portal: opens
- User portal → User access control: checks access (evidence: `ITSM/user/index.php`)
- User portal → User ticketing: routes requests (evidence: `ITSM/user/index.php`)
- User portal → Purchasing requests: routes requests (evidence: `ITSM/user/index.php`)
- Purchasing requests → Email transport: sends notifications (evidence: `ITSM/user/ticket/includes/bulk_update_requests.php`)
- Email transport → Mail exceptions: throws (evidence: `ITSM/PHPMailer/PHPMailer.php`)
- Asset inventory → MySQL database: queries (evidence: `ITSM/admin/inventory/asset_listing.php`)
- User ticketing → User DB connection: uses connection (evidence: `ITSM/user/ticket/preview_purch_attachment.php`)
- Evaluation system → Admin user: serves evaluations
