# omar-abdo1/dom-erp architecture

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

- Interactive diagram: https://gitdiagram.com/omar-abdo1/dom-erp
- Repository: https://github.com/omar-abdo1/dom-erp

## Overview

DomCoreERP is a multi-tenant ERP API for company administration, users, customers, products, inventory, invoicing, payments, dashboards, and activity logs. Users enter through the API; authentication establishes identity and tenant context, and domain endpoints expose the business operations. The sampled authentication flow validates credentials, issues access and refresh tokens, and persists refresh-token changes. The database applies company-scoped query filters. Several domain services and endpoints are present in the tree but were not sampled, so their internal calls are not inferred here.

Main entry points: [`src/DomCoreERP.Service/AuthService.cs`](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/AuthService.cs) (Authentication), [`src/DomCoreERP.Repository/DomCoreContext.cs`](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Repository/DomCoreContext.cs) (Tenant-aware context), [`src/DomCoreERP.API/Controllers/CompaniesController.cs`](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CompaniesController.cs) (Companies API), [`src/DomCoreERP.API/Controllers/CustomersController.cs`](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CustomersController.cs) (Customers API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_companies_api["Companies API"]
  node_customers_api["Customers API"]
  node_products_api["Products API"]
  node_invoices_api["Invoices API"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_inventory_api["Inventory API"]
  node_payments_api["Payments API"]
  node_users_api["Users API<br/>[UsersController.cs]"]
  node_dashboard_api["Dashboard API"]
  node_logs_api["Activity logs API"]
end

subgraph group_identity["Identity"]
  node_auth_service["Authentication<br/>[AuthService.cs]"]
  node_token_service["Token issuance<br/>[TokenService.cs]"]
  node_current_user["Tenant identity"]
end

subgraph group_business["ERP domains"]
  node_company_service["Company management<br/>[CompanyService.cs]"]
  node_customer_service["Customer management<br/>[CustomerService.cs]"]
  node_product_service["Product catalog<br/>[ProductService.cs]"]
  node_inventory_service["Inventory operations"]
  node_invoice_service["Invoicing<br/>[InvoiceService.cs]"]
  node_payment_service["Payments<br/>[PaymentService.cs]"]
  node_user_service["User management<br/>[UserService.cs]"]
  node_dashboard_service["Dashboard reporting"]
  node_activity_service["Activity logging"]
end

subgraph group_persistence["Persistence"]
  node_uow["Unit of work<br/>[UnitOfWork.cs]"]
  node_context["Tenant-aware context<br/>[DomCoreContext.cs]"]
  node_database[("ERP database")]
end

node_actor(("API client"))

node_actor -->|"requests"| node_companies_api
node_actor -->|"requests"| node_customers_api
node_actor -->|"requests"| node_products_api
node_actor -->|"requests"| node_invoices_api
node_actor -.->|"authenticates"| node_auth_api
node_actor -.->|"requests"| node_inventory_api
node_actor -.->|"requests"| node_payments_api
node_actor -.->|"requests"| node_users_api
node_actor -.->|"requests"| node_dashboard_api
node_actor -.->|"requests"| node_logs_api
node_companies_api -->|"delegates to"| node_company_service
node_customers_api -->|"delegates to"| node_customer_service
node_products_api -->|"delegates to"| node_product_service
node_invoices_api -->|"delegates to"| node_invoice_service
node_auth_api -.->|"delegates to"| node_auth_service
node_inventory_api -.->|"delegates to"| node_inventory_service
node_payments_api -.->|"delegates to"| node_payment_service
node_users_api -.->|"delegates to"| node_user_service
node_dashboard_api -.->|"delegates to"| node_dashboard_service
node_logs_api -.->|"delegates to"| node_activity_service
node_auth_service -->|"issues tokens"| node_token_service
node_auth_service -->|"persists tokens"| node_uow
node_auth_service -->|"queries tokens"| node_context
node_context -->|"filters by tenant"| node_current_user
node_context -.->|"reads and writes"| node_database

click node_companies_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CompaniesController.cs"
click node_customers_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CustomersController.cs"
click node_products_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/ProductsController.cs"
click node_invoices_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/InvoicesController.cs"
click node_auth_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/AuthController.cs"
click node_inventory_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/InventoryController.cs"
click node_payments_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/PaymentsController.cs"
click node_users_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/UsersController.cs"
click node_dashboard_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/DashboardController.cs"
click node_logs_api "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/ActivityLogsController.cs"
click node_auth_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/AuthService.cs"
click node_token_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/TokenService.cs"
click node_current_user "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Services/CurrentUserService.cs"
click node_company_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/CompanyService.cs"
click node_customer_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/CustomerService.cs"
click node_product_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/ProductService.cs"
click node_inventory_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/InventoryService.cs"
click node_invoice_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/InvoiceService.cs"
click node_payment_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/PaymentService.cs"
click node_user_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/UserService.cs"
click node_dashboard_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/DashboardService.cs"
click node_activity_service "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/ActivityLogService.cs"
click node_uow "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Repository/UnitOfWork.cs"
click node_context "https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Repository/DomCoreContext.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_companies_api,node_customers_api,node_products_api,node_invoices_api,node_auth_api,node_inventory_api,node_payments_api,node_users_api,node_dashboard_api,node_logs_api,node_actor toneBlue
class node_auth_service,node_token_service,node_current_user toneAmber
class node_company_service,node_customer_service,node_product_service,node_inventory_service,node_invoice_service,node_payment_service,node_user_service,node_dashboard_service,node_activity_service toneMint
class node_uow,node_context,node_database toneRose
```

## Components

### API

- [Companies API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CompaniesController.cs): `src/DomCoreERP.API/Controllers/CompaniesController.cs`
- [Customers API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/CustomersController.cs): `src/DomCoreERP.API/Controllers/CustomersController.cs`
- [Products API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/ProductsController.cs): `src/DomCoreERP.API/Controllers/ProductsController.cs`
- [Invoices API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/InvoicesController.cs): `src/DomCoreERP.API/Controllers/InvoicesController.cs`
- [Authentication API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/AuthController.cs): `src/DomCoreERP.API/Controllers/AuthController.cs`
- [Inventory API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/InventoryController.cs): `src/DomCoreERP.API/Controllers/InventoryController.cs`
- [Payments API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/PaymentsController.cs): `src/DomCoreERP.API/Controllers/PaymentsController.cs`
- [Users API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/UsersController.cs): `src/DomCoreERP.API/Controllers/UsersController.cs`
- [Dashboard API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/DashboardController.cs): `src/DomCoreERP.API/Controllers/DashboardController.cs`
- [Activity logs API](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Controllers/ActivityLogsController.cs): `src/DomCoreERP.API/Controllers/ActivityLogsController.cs`

### Identity

- [Authentication](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/AuthService.cs): `src/DomCoreERP.Service/AuthService.cs`
- [Token issuance](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/TokenService.cs): `src/DomCoreERP.Service/TokenService.cs`
- [Tenant identity](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.API/Services/CurrentUserService.cs): `src/DomCoreERP.API/Services/CurrentUserService.cs`

### ERP domains

- [Company management](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/CompanyService.cs): `src/DomCoreERP.Service/CompanyService.cs`
- [Customer management](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/CustomerService.cs): `src/DomCoreERP.Service/CustomerService.cs`
- [Product catalog](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/ProductService.cs): `src/DomCoreERP.Service/ProductService.cs`
- [Inventory operations](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/InventoryService.cs): `src/DomCoreERP.Service/InventoryService.cs`
- [Invoicing](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/InvoiceService.cs): `src/DomCoreERP.Service/InvoiceService.cs`
- [Payments](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/PaymentService.cs): `src/DomCoreERP.Service/PaymentService.cs`
- [User management](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/UserService.cs): `src/DomCoreERP.Service/UserService.cs`
- [Dashboard reporting](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/DashboardService.cs): `src/DomCoreERP.Service/DashboardService.cs`
- [Activity logging](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Service/ActivityLogService.cs): `src/DomCoreERP.Service/ActivityLogService.cs`

### Persistence

- [Unit of work](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Repository/UnitOfWork.cs): `src/DomCoreERP.Repository/UnitOfWork.cs`
- [Tenant-aware context](https://github.com/omar-abdo1/dom-erp/blob/main/src/DomCoreERP.Repository/DomCoreContext.cs): `src/DomCoreERP.Repository/DomCoreContext.cs`
- **ERP database**

### Other components

- **API client**

## Connections

- API client → Companies API: requests (evidence: `src/DomCoreERP.API/Controllers/CompaniesController.cs`)
- API client → Customers API: requests (evidence: `src/DomCoreERP.API/Controllers/CustomersController.cs`)
- API client → Products API: requests (evidence: `src/DomCoreERP.API/Controllers/ProductsController.cs`)
- API client → Invoices API: requests (evidence: `src/DomCoreERP.API/Controllers/InvoicesController.cs`)
- API client → Authentication API: authenticates
- API client → Inventory API: requests
- API client → Payments API: requests
- API client → Users API: requests
- API client → Dashboard API: requests
- API client → Activity logs API: requests
- Companies API → Company management: delegates to (evidence: `src/DomCoreERP.API/Controllers/CompaniesController.cs`)
- Customers API → Customer management: delegates to (evidence: `src/DomCoreERP.API/Controllers/CustomersController.cs`)
- Products API → Product catalog: delegates to (evidence: `src/DomCoreERP.API/Controllers/ProductsController.cs`)
- Invoices API → Invoicing: delegates to (evidence: `src/DomCoreERP.API/Controllers/InvoicesController.cs`)
- Authentication API → Authentication: delegates to
- Inventory API → Inventory operations: delegates to
- Payments API → Payments: delegates to
- Users API → User management: delegates to
- Dashboard API → Dashboard reporting: delegates to
- Activity logs API → Activity logging: delegates to
- Authentication → Token issuance: issues tokens (evidence: `src/DomCoreERP.Service/AuthService.cs`)
- Authentication → Unit of work: persists tokens (evidence: `src/DomCoreERP.Service/AuthService.cs`)
- Authentication → Tenant-aware context: queries tokens (evidence: `src/DomCoreERP.Service/AuthService.cs`)
- Tenant-aware context → Tenant identity: filters by tenant (evidence: `src/DomCoreERP.Repository/DomCoreContext.cs`)
- Tenant-aware context → ERP database: reads and writes
