# alicancnrk0/pa.companymanagement architecture

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

- Interactive diagram: https://gitdiagram.com/alicancnrk0/pa.companymanagement
- Repository: https://github.com/alicancnrk0/pa.companymanagement

## Overview

This repository is a company-management application composed of employee, accounting, notification, user, gateway, and web-UI projects. The clearest user-to-result workflow is employee management: a user acts through the WebUI, whose HTTP client calls the employee REST API; its controller delegates employee operations to a repository backed by an EF context. Accounting exposes income, expense, and their types; notifications expose message operations. The tree also shows gRPC entry points, but their runtime behavior and service wiring are not established by the excerpts. Evidence is limited to the README (empty), source index, and sampled files.

Main entry points: [`PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Program.cs) (Accounting REST API), [`PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs`](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs) (Employee repository), [`PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs`](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs) (Expense repository), [`PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs`](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs) (Message repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webui["Web UI<br/>[Program.cs]"]
  node_employee_client["Employee HTTP client"]
end

subgraph group_employee["Employee service"]
  node_employee_api["Employee REST API"]
  node_employee_repo["Employee repository"]
  node_employee_context[("Employee data context")]
  node_employee_entity["Employee records<br/>[Employee.cs]"]
end

subgraph group_accounting["Accounting service"]
  node_accounting_api["Accounting REST API<br/>[Program.cs]"]
  node_expense_controller["Expense operations"]
  node_income_controller["Income operations"]
  node_expense_types["Expense types"]
  node_income_types["Income types"]
  node_expense_repo["Expense repository"]
  node_income_repo["Income repository"]
  node_expense_type_repo["Expense-type repository"]
  node_income_type_repo["Income-type repository"]
  node_accounting_context[("Accounting data context")]
end

subgraph group_notification["Notification service"]
  node_notification_api["Message REST API"]
  node_message_repo["Message repository"]
  node_notification_context[("Notification data context")]
  node_message_entity["Message records<br/>[Message.cs]"]
end

subgraph group_platform["Shared and entry points"]
  node_gateway["Gateway<br/>[Program.cs]"]
  node_grpc_apis["gRPC endpoints<br/>[Program.cs]"]
  node_core_exceptions["Shared data exceptions"]
end

node_user(("Application user"))

node_user -.->|"uses"| node_webui
node_webui -->|"configures"| node_employee_client
node_employee_client -->|"sends HTTP requests"| node_employee_api
node_employee_api -->|"delegates operations"| node_employee_repo
node_employee_repo -->|"queries and saves"| node_employee_context
node_employee_repo -->|"maps records"| node_employee_entity
node_accounting_api -.->|"maps controllers"| node_expense_controller
node_accounting_api -.->|"maps controllers"| node_income_controller
node_accounting_api -.->|"maps controllers"| node_expense_types
node_accounting_api -.->|"maps controllers"| node_income_types
node_accounting_api -->|"registers repository"| node_expense_repo
node_accounting_api -->|"registers repository"| node_income_repo
node_accounting_api -->|"registers repository"| node_expense_type_repo
node_accounting_api -->|"registers repository"| node_income_type_repo
node_expense_controller -.->|"delegates operations"| node_expense_repo
node_income_controller -->|"delegates operations"| node_income_repo
node_expense_repo -->|"queries and saves"| node_accounting_context
node_notification_api -->|"delegates operations"| node_message_repo
node_message_repo -->|"uses context"| node_notification_context
node_message_repo -->|"maps records"| node_message_entity
node_employee_repo -->|"raises errors"| node_core_exceptions
node_expense_repo -->|"raises errors"| node_core_exceptions

click node_webui "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.WebUI/Program.cs"
click node_employee_client "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.WebUI/Clients/Employee/EmployeeApiClient.cs"
click node_employee_api "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Api.Rest/Controllers/EmployeesController.cs"
click node_employee_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs"
click node_employee_context "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Infrastructure/Contexts/EmployeeDbContext.cs"
click node_employee_entity "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Domain/Entities/Employee.cs"
click node_accounting_api "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Program.cs"
click node_expense_controller "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/ExpenseController.cs"
click node_income_controller "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/IncomeController.cs"
click node_expense_types "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/ExpenseTypesController.cs"
click node_income_types "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/IncomeTypesController.cs"
click node_expense_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs"
click node_income_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/IncomeRepository.cs"
click node_expense_type_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/ExpenseTypeRepository.cs"
click node_income_type_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/IncomeTypeRepository.cs"
click node_accounting_context "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Contexts/AccountingDbContext.cs"
click node_notification_api "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Api.Rest/Controllers/MessagesController.cs"
click node_message_repo "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs"
click node_notification_context "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Infrastructure/Contexts/NotificationDbContext.cs"
click node_message_entity "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Domain/Entities/Message.cs"
click node_gateway "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.Gateway/Program.cs"
click node_grpc_apis "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Api.Grpc/Program.cs"
click node_core_exceptions "https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.Core/Exceptions/PAContextQueryException.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_webui,node_employee_client,node_user toneBlue
class node_employee_api,node_employee_repo,node_employee_context,node_employee_entity toneAmber
class node_accounting_api,node_expense_controller,node_income_controller,node_expense_types,node_income_types,node_expense_repo,node_income_repo,node_expense_type_repo,node_income_type_repo,node_accounting_context toneMint
class node_notification_api,node_message_repo,node_notification_context,node_message_entity toneRose
class node_gateway,node_grpc_apis,node_core_exceptions toneIndigo
```

## Components

### Web experience

- [Web UI](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.WebUI/Program.cs): `PA.CompanyManagement.WebUI/Program.cs`
- [Employee HTTP client](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.WebUI/Clients/Employee/EmployeeApiClient.cs): `PA.CompanyManagement.WebUI/Clients/Employee/EmployeeApiClient.cs`

### Employee service

- [Employee REST API](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Api.Rest/Controllers/EmployeesController.cs): `PA.CompanyManagement.EmployeeService.Api.Rest/Controllers/EmployeesController.cs`
- [Employee repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs): `PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs`
- [Employee data context](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Infrastructure/Contexts/EmployeeDbContext.cs): `PA.CompanyManagement.EmployeeService.Infrastructure/Contexts/EmployeeDbContext.cs`
- [Employee records](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Domain/Entities/Employee.cs): `PA.CompanyManagement.EmployeeService.Domain/Entities/Employee.cs`

### Accounting service

- [Accounting REST API](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Program.cs): `PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`
- [Expense operations](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/ExpenseController.cs): `PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/ExpenseController.cs`
- [Income operations](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/IncomeController.cs): `PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/IncomeController.cs`
- [Expense types](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/ExpenseTypesController.cs): `PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/ExpenseTypesController.cs`
- [Income types](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/IncomeTypesController.cs): `PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Types/IncomeTypesController.cs`
- [Expense repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs): `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs`
- [Income repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/IncomeRepository.cs): `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/IncomeRepository.cs`
- [Expense-type repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/ExpenseTypeRepository.cs): `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/ExpenseTypeRepository.cs`
- [Income-type repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/IncomeTypeRepository.cs): `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Types/IncomeTypeRepository.cs`
- [Accounting data context](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.AccountingService.Infrastructure/Contexts/AccountingDbContext.cs): `PA.CompanyManagement.AccountingService.Infrastructure/Contexts/AccountingDbContext.cs`

### Notification service

- [Message REST API](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Api.Rest/Controllers/MessagesController.cs): `PA.CompanyManagement.NotificationService.Api.Rest/Controllers/MessagesController.cs`
- [Message repository](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs): `PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs`
- [Notification data context](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Infrastructure/Contexts/NotificationDbContext.cs): `PA.CompanyManagement.NotificationService.Infrastructure/Contexts/NotificationDbContext.cs`
- [Message records](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.NotificationService.Domain/Entities/Message.cs): `PA.CompanyManagement.NotificationService.Domain/Entities/Message.cs`

### Shared and entry points

- [Gateway](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.Gateway/Program.cs): `PA.CompanyManagement.Gateway/Program.cs`
- [gRPC endpoints](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.EmployeeService.Api.Grpc/Program.cs): `PA.CompanyManagement.EmployeeService.Api.Grpc/Program.cs`
- [Shared data exceptions](https://github.com/alicancnrk0/pa.companymanagement/blob/master/PA.CompanyManagement.Core/Exceptions/PAContextQueryException.cs): `PA.CompanyManagement.Core/Exceptions/PAContextQueryException.cs`

### Other components

- **Application user**

## Connections

- Application user → Web UI: uses
- Web UI → Employee HTTP client: configures (evidence: `PA.CompanyManagement.WebUI/Program.cs`)
- Employee HTTP client → Employee REST API: sends HTTP requests (evidence: `PA.CompanyManagement.WebUI/Clients/Employee/EmployeeApiClient.cs`)
- Employee REST API → Employee repository: delegates operations (evidence: `PA.CompanyManagement.EmployeeService.Api.Rest/Controllers/EmployeesController.cs`)
- Employee repository → Employee data context: queries and saves (evidence: `PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs`)
- Employee repository → Employee records: maps records (evidence: `PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs`)
- Accounting REST API → Expense operations: maps controllers
- Accounting REST API → Income operations: maps controllers
- Accounting REST API → Expense types: maps controllers
- Accounting REST API → Income types: maps controllers
- Accounting REST API → Expense repository: registers repository (evidence: `PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`)
- Accounting REST API → Income repository: registers repository (evidence: `PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`)
- Accounting REST API → Expense-type repository: registers repository (evidence: `PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`)
- Accounting REST API → Income-type repository: registers repository (evidence: `PA.CompanyManagement.AccountingService.Api.Rest/Program.cs`)
- Expense operations → Expense repository: delegates operations
- Income operations → Income repository: delegates operations (evidence: `PA.CompanyManagement.AccountingService.Api.Rest/Controllers/Metas/IncomeController.cs`)
- Expense repository → Accounting data context: queries and saves (evidence: `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs`)
- Message REST API → Message repository: delegates operations (evidence: `PA.CompanyManagement.NotificationService.Api.Rest/Controllers/MessagesController.cs`)
- Message repository → Notification data context: uses context (evidence: `PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs`)
- Message repository → Message records: maps records (evidence: `PA.CompanyManagement.NotificationService.Infrastructure/Repositories/MessageRepository.cs`)
- Employee repository → Shared data exceptions: raises errors (evidence: `PA.CompanyManagement.EmployeeService.Infrastructure/Repositories/EmployeeRepository.cs`)
- Expense repository → Shared data exceptions: raises errors (evidence: `PA.CompanyManagement.AccountingService.Infrastructure/Repositories/Metas/ExpenseRepository.cs`)
