# olehkaliniuk/adminpanel architecture

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

- Interactive diagram: https://gitdiagram.com/olehkaliniuk/adminpanel
- Repository: https://github.com/olehkaliniuk/adminpanel

## Overview

This is an ASP.NET Core MVC administrative panel for managing organizational units, people, addresses, categories/groups, configuration, and operational logs. The main workflow is an administrator request handled by a controller, which delegates data operations to a repository and returns a view or action result. Sampled controller and repository excerpts support several delegation paths; the README documents additional capabilities whose implementations were not sampled. Dashed entry edges represent the documented web/MVC interaction, not inspected route wiring.

Main entry points: [`AdminPanelDB/Controllers/KaGruppenController.cs`](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/KaGruppenController.cs) (Category groups), [`AdminPanelDB/Repository/AuthRepository.cs`](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AuthRepository.cs) (Login repository), [`AdminPanelDB/Controllers/AuthController.cs`](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AuthController.cs) (Authentication), [`AdminPanelDB/Controllers/AdminController.cs`](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AdminController.cs) (Admin management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access"]
  node_auth["Authentication<br/>[AuthController.cs]"]
  node_authrepo["Login repository<br/>[AuthRepository.cs]"]
  node_api["Organization API<br/>[APIController.cs]"]
end

subgraph group_organization["Organization"]
  node_adminctl["Admin management<br/>[AdminController.cs]"]
  node_adminrepo["Organization repository<br/>[AdminRepository.cs]"]
  node_userctl["User data<br/>[UserController.cs]"]
  node_userrepo["User repository<br/>[UserRepository.cs]"]
end

subgraph group_records["Records"]
  node_addressctl["Address management"]
  node_addressrepo["Address repository"]
  node_groupsctl["Category groups"]
  node_groupsrepo["Groups repository"]
end

subgraph group_configuration["Configuration"]
  node_configctl["Configuration"]
  node_configrepo["Configuration repository"]
  node_configservice["Current config<br/>[ConfigService.cs]"]
  node_configlogctl["Configuration logs"]
  node_configlogrepo["Config log repository"]
end

subgraph group_operations["Operations"]
  node_logsctl["Error logs<br/>[LogsController.cs]"]
  node_eventlog["Windows event logs"]
  node_errorctl["Error handling"]
end

node_admin(("Administrator"))
node_sql[("SQL database")]

node_admin -.->|"signs in"| node_auth
node_admin -.->|"manages records"| node_adminctl
node_admin -.->|"manages addresses"| node_addressctl
node_admin -.->|"manages groups"| node_groupsctl
node_admin -.->|"manages config"| node_configctl
node_admin -.->|"reviews logs"| node_configlogctl
node_admin -.->|"reviews errors"| node_logsctl
node_auth -->|"checks credentials"| node_authrepo
node_api -->|"loads user"| node_authrepo
node_adminctl -->|"manages data"| node_adminrepo
node_userctl -->|"loads user data"| node_userrepo
node_addressctl -->|"manages addresses"| node_addressrepo
node_groupsctl -->|"manages groups"| node_groupsrepo
node_groupsctl -->|"loads config"| node_configservice
node_configservice -->|"loads config"| node_configrepo
node_logsctl -->|"loads event logs"| node_eventlog
node_adminrepo -->|"queries and updates"| node_sql
node_groupsrepo -->|"queries and updates"| node_sql
node_authrepo -->|"checks credentials"| node_sql
node_addressrepo -->|"stores addresses"| node_sql

click node_auth "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AuthController.cs"
click node_authrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AuthRepository.cs"
click node_api "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/APIController.cs"
click node_adminctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AdminController.cs"
click node_adminrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AdminRepository.cs"
click node_userctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/UserController.cs"
click node_userrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/UserRepository.cs"
click node_addressctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AdresseController.cs"
click node_addressrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AdresseRepository.cs"
click node_groupsctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/KaGruppenController.cs"
click node_groupsrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/KaGruppenRepository.cs"
click node_configctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ConfigController.cs"
click node_configrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/ConfigRepository.cs"
click node_configservice "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Services/ConfigService.cs"
click node_configlogctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ConfigLogController.cs"
click node_configlogrepo "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/ConfigLogRepository.cs"
click node_logsctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/LogsController.cs"
click node_eventlog "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Services/WindowsEventLogService.cs"
click node_errorctl "https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ExceptionsErrorController.cs"

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_auth,node_authrepo,node_api toneBlue
class node_adminctl,node_adminrepo,node_userctl,node_userrepo,node_sql toneAmber
class node_addressctl,node_addressrepo,node_groupsctl,node_groupsrepo toneMint
class node_configctl,node_configrepo,node_configservice,node_configlogctl,node_configlogrepo toneRose
class node_logsctl,node_eventlog,node_errorctl,node_admin toneIndigo
```

## Components

### Access

- [Authentication](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AuthController.cs): `AdminPanelDB/Controllers/AuthController.cs`
- [Login repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AuthRepository.cs): `AdminPanelDB/Repository/AuthRepository.cs`
- [Organization API](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/APIController.cs): `AdminPanelDB/Controllers/APIController.cs`

### Organization

- [Admin management](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AdminController.cs): `AdminPanelDB/Controllers/AdminController.cs`
- [Organization repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AdminRepository.cs): `AdminPanelDB/Repository/AdminRepository.cs`
- [User data](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/UserController.cs): `AdminPanelDB/Controllers/UserController.cs`
- [User repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/UserRepository.cs): `AdminPanelDB/Repository/UserRepository.cs`

### Records

- [Address management](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/AdresseController.cs): `AdminPanelDB/Controllers/AdresseController.cs`
- [Address repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/AdresseRepository.cs): `AdminPanelDB/Repository/AdresseRepository.cs`
- [Category groups](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/KaGruppenController.cs): `AdminPanelDB/Controllers/KaGruppenController.cs`
- [Groups repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/KaGruppenRepository.cs): `AdminPanelDB/Repository/KaGruppenRepository.cs`

### Configuration

- [Configuration](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ConfigController.cs): `AdminPanelDB/Controllers/ConfigController.cs`
- [Configuration repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/ConfigRepository.cs): `AdminPanelDB/Repository/ConfigRepository.cs`
- [Current config](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Services/ConfigService.cs): `AdminPanelDB/Services/ConfigService.cs`
- [Configuration logs](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ConfigLogController.cs): `AdminPanelDB/Controllers/ConfigLogController.cs`
- [Config log repository](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Repository/ConfigLogRepository.cs): `AdminPanelDB/Repository/ConfigLogRepository.cs`

### Operations

- [Error logs](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/LogsController.cs): `AdminPanelDB/Controllers/LogsController.cs`
- [Windows event logs](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Services/WindowsEventLogService.cs): `AdminPanelDB/Services/WindowsEventLogService.cs`
- [Error handling](https://github.com/olehkaliniuk/adminpanel/blob/master/AdminPanelDB/Controllers/ExceptionsErrorController.cs): `AdminPanelDB/Controllers/ExceptionsErrorController.cs`

### Other components

- **Administrator**
- **SQL database**

## Connections

- Administrator → Authentication: signs in
- Administrator → Admin management: manages records
- Administrator → Address management: manages addresses
- Administrator → Category groups: manages groups
- Administrator → Configuration: manages config
- Administrator → Configuration logs: reviews logs
- Administrator → Error logs: reviews errors
- Authentication → Login repository: checks credentials (evidence: `AdminPanelDB/Controllers/AuthController.cs`)
- Organization API → Login repository: loads user (evidence: `AdminPanelDB/Controllers/APIController.cs`)
- Admin management → Organization repository: manages data (evidence: `AdminPanelDB/Controllers/AdminController.cs`)
- User data → User repository: loads user data (evidence: `AdminPanelDB/Controllers/UserController.cs`)
- Address management → Address repository: manages addresses (evidence: `AdminPanelDB/Controllers/AdresseController.cs`)
- Category groups → Groups repository: manages groups (evidence: `AdminPanelDB/Controllers/KaGruppenController.cs`)
- Category groups → Current config: loads config (evidence: `AdminPanelDB/Controllers/KaGruppenController.cs`)
- Current config → Configuration repository: loads config (evidence: `AdminPanelDB/Services/ConfigService.cs`)
- Error logs → Windows event logs: loads event logs (evidence: `AdminPanelDB/Controllers/LogsController.cs`)
- Organization repository → SQL database: queries and updates (evidence: `AdminPanelDB/Repository/AdminRepository.cs`)
- Groups repository → SQL database: queries and updates (evidence: `AdminPanelDB/Repository/KaGruppenRepository.cs`)
- Login repository → SQL database: checks credentials (evidence: `AdminPanelDB/Repository/AuthRepository.cs`)
- Address repository → SQL database: stores addresses (evidence: `AdminPanelDB/Repository/AdresseRepository.cs`)
