# recepbaykara/stock-mgmt architecture

> Architecture diagram of the GitHub repository recepbaykara/stock-mgmt, 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/recepbaykara/stock-mgmt
- Repository: https://github.com/recepbaykara/stock-mgmt

## Overview

StockMgmt is an ASP.NET Core inventory and order-management API. Its primary workflow accepts order requests, validates users/products and stock, persists orders while adjusting inventory, then sends confirmation or cancellation email. It also exposes direct user, product, and order CRUD endpoints and audit-log queries; EF Core captures changes as audit records. The README is empty, so capabilities and links here rely on the shown source and index; controller routing and some audit-service details were not sampled.

Main entry points: [`Services/EmailService.cs`](https://github.com/recepbaykara/stock-mgmt/blob/main/Services/EmailService.cs) (Email Delivery), [`Services/OrderService.cs`](https://github.com/recepbaykara/stock-mgmt/blob/main/Services/OrderService.cs) (Order Operations), [`Program.cs`](https://github.com/recepbaykara/stock-mgmt/blob/main/Program.cs) (Application Setup), [`Controllers/OrderController.cs`](https://github.com/recepbaykara/stock-mgmt/blob/main/Controllers/OrderController.cs) (Order Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_startup["Application Setup<br/>[Program.cs]"]
  node_order_routes["Order Routes<br/>[OrderController.cs]"]
  node_audit_routes["Audit Routes"]
  node_direct_crud["User Product CRUD<br/>[Program.cs]"]
end

subgraph group_orders["Order Management"]
  node_order_service["Order Operations<br/>[OrderService.cs]"]
  node_order_contract["Order Contract<br/>[IOrderService.cs]"]
  node_order_inputs["Order Inputs<br/>[OrderCreate.cs]"]
  node_order_updates["Update Inputs<br/>[OrderUpdate.cs]"]
  node_patch_input["Patch Input"]
  node_payment["Payment Method<br/>[PaymentMethod.cs]"]
  node_order_model["Order Record<br/>[Order.cs]"]
  node_user_model["User Record<br/>[User.cs]"]
  node_product_model["Product Record<br/>[Product.cs]"]
end

subgraph group_persistence["Persistence and Audit"]
  node_db_context["EF Data Context<br/>[AppDbContext.cs]"]
  node_database[("PostgreSQL")]
  node_audit_record["Audit Record<br/>[AuditLog.cs]"]
  node_audit_service["Audit Queries<br/>[AuditLogService.cs]"]
  node_audit_contract["Audit Contract"]
end

subgraph group_notifications["Email Notifications"]
  node_email_service["Email Delivery<br/>[EmailService.cs]"]
  node_email_contract["Email Contract<br/>[IEmailService.cs]"]
  node_email_settings["SMTP Settings<br/>[EmailSettings.cs]"]
  node_email_templates["Order Templates"]
end

node_client(("API Client"))
node_smtp["SMTP Server"]

node_client -->|"calls"| node_order_routes
node_client -->|"calls"| node_audit_routes
node_client -->|"calls"| node_direct_crud
node_startup -->|"maps"| node_order_routes
node_startup -->|"maps"| node_audit_routes
node_order_routes -->|"delegates to"| node_order_service
node_audit_routes -->|"delegates to"| node_audit_service
node_startup -->|"registers"| node_order_service
node_startup -->|"registers"| node_audit_service
node_startup -->|"registers"| node_email_service
node_order_routes -->|"uses"| node_order_contract
node_audit_routes -->|"uses"| node_audit_contract
node_order_service -->|"reads and writes"| node_db_context
node_audit_service -->|"queries"| node_db_context
node_db_context -.->|"persists"| node_database
node_db_context -->|"creates audit entries"| node_audit_record
node_order_service -->|"sends order emails"| node_email_service
node_email_service -->|"loads"| node_email_templates
node_email_service -->|"reads settings"| node_email_settings
node_email_service -->|"sends mail"| node_smtp
node_order_service -->|"creates and updates"| node_order_model
node_order_service -->|"looks up"| node_user_model
node_order_service -->|"checks stock"| node_product_model
node_email_service -->|"formats details"| node_order_model
node_email_service -->|"formats recipient"| node_user_model
node_email_service -->|"formats item"| node_product_model
node_order_model -->|"uses"| node_payment
node_order_inputs -->|"uses"| node_payment
node_order_updates -->|"uses"| node_payment
node_patch_input -->|"uses"| node_payment

click node_startup "https://github.com/recepbaykara/stock-mgmt/blob/main/Program.cs"
click node_order_routes "https://github.com/recepbaykara/stock-mgmt/blob/main/Controllers/OrderController.cs"
click node_audit_routes "https://github.com/recepbaykara/stock-mgmt/blob/main/Controllers/AuditLogController.cs"
click node_direct_crud "https://github.com/recepbaykara/stock-mgmt/blob/main/Program.cs"
click node_order_service "https://github.com/recepbaykara/stock-mgmt/blob/main/Services/OrderService.cs"
click node_order_contract "https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IOrderService.cs"
click node_order_inputs "https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderCreate.cs"
click node_order_updates "https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderUpdate.cs"
click node_patch_input "https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderUpdatePatch.cs"
click node_payment "https://github.com/recepbaykara/stock-mgmt/blob/main/Enums/PaymentMethod.cs"
click node_order_model "https://github.com/recepbaykara/stock-mgmt/blob/main/Models/Order.cs"
click node_user_model "https://github.com/recepbaykara/stock-mgmt/blob/main/Models/User.cs"
click node_product_model "https://github.com/recepbaykara/stock-mgmt/blob/main/Models/Product.cs"
click node_db_context "https://github.com/recepbaykara/stock-mgmt/blob/main/Context/AppDbContext.cs"
click node_audit_record "https://github.com/recepbaykara/stock-mgmt/blob/main/Models/AuditLog.cs"
click node_audit_service "https://github.com/recepbaykara/stock-mgmt/blob/main/Services/AuditLogService.cs"
click node_audit_contract "https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IAuditLogService.cs"
click node_email_service "https://github.com/recepbaykara/stock-mgmt/blob/main/Services/EmailService.cs"
click node_email_contract "https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IEmailService.cs"
click node_email_settings "https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/EmailSettings.cs"
click node_email_templates "https://github.com/recepbaykara/stock-mgmt/tree/main/Templates"

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_startup,node_order_routes,node_audit_routes,node_direct_crud,node_client toneBlue
class node_order_service,node_order_contract,node_order_inputs,node_order_updates,node_patch_input,node_payment,node_order_model,node_user_model,node_product_model toneAmber
class node_db_context,node_database,node_audit_record,node_audit_service,node_audit_contract,node_smtp toneMint
class node_email_service,node_email_contract,node_email_settings,node_email_templates toneRose
```

## Components

### HTTP API

- [Application Setup](https://github.com/recepbaykara/stock-mgmt/blob/main/Program.cs): `Program.cs`
- [Order Routes](https://github.com/recepbaykara/stock-mgmt/blob/main/Controllers/OrderController.cs): `Controllers/OrderController.cs`
- [Audit Routes](https://github.com/recepbaykara/stock-mgmt/blob/main/Controllers/AuditLogController.cs): `Controllers/AuditLogController.cs`
- [User Product CRUD](https://github.com/recepbaykara/stock-mgmt/blob/main/Program.cs): `Program.cs`

### Order Management

- [Order Operations](https://github.com/recepbaykara/stock-mgmt/blob/main/Services/OrderService.cs): `Services/OrderService.cs`
- [Order Contract](https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IOrderService.cs): `Interfaces/IOrderService.cs`
- [Order Inputs](https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderCreate.cs): `DTOs/OrderCreate.cs`
- [Update Inputs](https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderUpdate.cs): `DTOs/OrderUpdate.cs`
- [Patch Input](https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/OrderUpdatePatch.cs): `DTOs/OrderUpdatePatch.cs`
- [Payment Method](https://github.com/recepbaykara/stock-mgmt/blob/main/Enums/PaymentMethod.cs): `Enums/PaymentMethod.cs`
- [Order Record](https://github.com/recepbaykara/stock-mgmt/blob/main/Models/Order.cs): `Models/Order.cs`
- [User Record](https://github.com/recepbaykara/stock-mgmt/blob/main/Models/User.cs): `Models/User.cs`
- [Product Record](https://github.com/recepbaykara/stock-mgmt/blob/main/Models/Product.cs): `Models/Product.cs`

### Persistence and Audit

- [EF Data Context](https://github.com/recepbaykara/stock-mgmt/blob/main/Context/AppDbContext.cs): `Context/AppDbContext.cs`
- **PostgreSQL**
- [Audit Record](https://github.com/recepbaykara/stock-mgmt/blob/main/Models/AuditLog.cs): `Models/AuditLog.cs`
- [Audit Queries](https://github.com/recepbaykara/stock-mgmt/blob/main/Services/AuditLogService.cs): `Services/AuditLogService.cs`
- [Audit Contract](https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IAuditLogService.cs): `Interfaces/IAuditLogService.cs`

### Email Notifications

- [Email Delivery](https://github.com/recepbaykara/stock-mgmt/blob/main/Services/EmailService.cs): `Services/EmailService.cs`
- [Email Contract](https://github.com/recepbaykara/stock-mgmt/blob/main/Interfaces/IEmailService.cs): `Interfaces/IEmailService.cs`
- [SMTP Settings](https://github.com/recepbaykara/stock-mgmt/blob/main/DTOs/EmailSettings.cs): `DTOs/EmailSettings.cs`
- [Order Templates](https://github.com/recepbaykara/stock-mgmt/tree/main/Templates): `Templates`

### Other components

- **API Client**
- **SMTP Server**

## Connections

- API Client → Order Routes: calls (evidence: `Controllers/OrderController.cs`)
- API Client → Audit Routes: calls (evidence: `Controllers/AuditLogController.cs`)
- API Client → User Product CRUD: calls (evidence: `Program.cs`)
- Application Setup → Order Routes: maps (evidence: `Program.cs`)
- Application Setup → Audit Routes: maps (evidence: `Program.cs`)
- Order Routes → Order Operations: delegates to (evidence: `Controllers/OrderController.cs`)
- Audit Routes → Audit Queries: delegates to (evidence: `Controllers/AuditLogController.cs`)
- Application Setup → Order Operations: registers (evidence: `Program.cs`)
- Application Setup → Audit Queries: registers (evidence: `Program.cs`)
- Application Setup → Email Delivery: registers (evidence: `Program.cs`)
- Order Routes → Order Contract: uses (evidence: `Controllers/OrderController.cs`)
- Audit Routes → Audit Contract: uses (evidence: `Controllers/AuditLogController.cs`)
- Order Operations → EF Data Context: reads and writes (evidence: `Services/OrderService.cs`)
- Audit Queries → EF Data Context: queries (evidence: `Services/AuditLogService.cs`)
- EF Data Context → PostgreSQL: persists
- EF Data Context → Audit Record: creates audit entries (evidence: `Context/AppDbContext.cs`)
- Order Operations → Email Delivery: sends order emails (evidence: `Services/OrderService.cs`)
- Email Delivery → Order Templates: loads (evidence: `Services/EmailService.cs`)
- Email Delivery → SMTP Settings: reads settings (evidence: `Services/EmailService.cs`)
- Email Delivery → SMTP Server: sends mail (evidence: `Services/EmailService.cs`)
- Order Operations → Order Record: creates and updates (evidence: `Services/OrderService.cs`)
- Order Operations → User Record: looks up (evidence: `Services/OrderService.cs`)
- Order Operations → Product Record: checks stock (evidence: `Services/OrderService.cs`)
- Email Delivery → Order Record: formats details (evidence: `Services/EmailService.cs`)
- Email Delivery → User Record: formats recipient (evidence: `Services/EmailService.cs`)
- Email Delivery → Product Record: formats item (evidence: `Services/EmailService.cs`)
- Order Record → Payment Method: uses (evidence: `Models/Order.cs`)
- Order Inputs → Payment Method: uses (evidence: `DTOs/OrderCreate.cs`)
- Update Inputs → Payment Method: uses (evidence: `DTOs/OrderUpdate.cs`)
- Patch Input → Payment Method: uses (evidence: `DTOs/OrderUpdatePatch.cs`)
