# ossous-dev-coder/retail-pos-system architecture

> Architecture diagram of the GitHub repository ossous-dev-coder/retail-pos-system, 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/ossous-dev-coder/retail-pos-system
- Repository: https://github.com/ossous-dev-coder/retail-pos-system

## Overview

This is a retail POS backend exposing REST endpoints for product and user operations, with business validation and ADO.NET data access to SQL Server. The README also describes sales, inventory, customer-history, and reporting capabilities; those branches are represented, but some are documented or visible only in the file tree, so their internal call paths are not asserted. The sampled code shows product and user flows clearly; unsampled source limits detail on sales and inventory.

Main entry points: [`GroceryPOS_APIs/Controllers/ProductsController.cs`](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GroceryPOS_APIs/Controllers/ProductsController.cs) (Product endpoints), [`GSData/Data/UserData.cs`](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/UserData.cs) (User access), [`Database design/SQL Queries/DatabaseCreation.sql`](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/Database%20design/SQL%20Queries/DatabaseCreation.sql) (SQL Server), [`GSData/Data/ProductData.cs`](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/ProductData.cs) (Product access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API layer"]
  node_product_api["Product endpoints"]
  node_user_api["User endpoints<br/>[UsersController.cs]"]
end

subgraph group_business["Business logic"]
  node_product_logic["Product rules<br/>[Product.cs]"]
  node_category_logic["Category lookup<br/>[Category.cs]"]
  node_user_logic["User rules<br/>[User.cs]"]
  node_validation["Validation utilities<br/>[GSUtility.cs]"]
end

subgraph group_data["Data access"]
  node_product_data["Product access<br/>[ProductData.cs]"]
  node_category_data["Category access<br/>[CategoryData.cs]"]
  node_user_data["User access<br/>[UserData.cs]"]
  node_bill_data["Sales data access<br/>[BillData.cs]"]
  node_stock_data["Stock data access<br/>[StockData.cs]"]
  node_db_config["Connection settings<br/>[DataSetting.cs]"]
end

subgraph group_domain["POS capabilities"]
  node_product_dto["Product DTOs<br/>[ProductDTO.cs]"]
  node_new_product_dto["New product input<br/>[NewProductDTO.cs]"]
  node_user_dto["User DTOs<br/>[UserDTOs.cs]"]
  node_bill_dto["Bill DTO<br/>[BillDTO.cs]"]
  node_movement_dto["Movement DTO<br/>[MovementDTO.cs]"]
  node_sales["Sales processing<br/>[BillData.cs]"]
  node_inventory["Inventory control<br/>[StockData.cs]"]
  node_customer_history["Customer history<br/>[UserData.cs]"]
  node_reporting["Sales reporting"]
end

subgraph group_storage["Persistence"]
  node_sql_server[("SQL Server")]
end

node_client(("POS client"))

node_client -->|"calls"| node_product_api
node_client -->|"calls"| node_user_api
node_product_api -->|"dispatches"| node_product_logic
node_product_api -->|"checks category"| node_category_logic
node_user_api -->|"dispatches"| node_user_logic
node_product_api -->|"accepts"| node_new_product_dto
node_product_api -->|"returns"| node_product_dto
node_user_api -->|"accepts and returns"| node_user_dto
node_product_logic -->|"delegates to"| node_product_data
node_product_logic -->|"validates with"| node_validation
node_category_logic -->|"delegates to"| node_category_data
node_user_logic -->|"delegates to"| node_user_data
node_user_logic -->|"validates with"| node_validation
node_product_data -->|"maps data"| node_product_dto
node_user_data -->|"maps data"| node_user_dto
node_product_data -->|"uses connection"| node_db_config
node_user_data -->|"uses connection"| node_db_config
node_category_data -->|"uses connection"| node_db_config
node_bill_data -->|"uses DTO"| node_bill_dto
node_stock_data -->|"uses DTO"| node_movement_dto
node_product_data -->|"queries"| node_sql_server
node_user_data -->|"queries"| node_sql_server
node_bill_data -.->|"persists sales"| node_sql_server
node_stock_data -.->|"updates stock"| node_sql_server
node_sales -.->|"uses data access"| node_bill_data
node_inventory -.->|"uses data access"| node_stock_data
node_customer_history -.->|"uses user records"| node_user_data
node_reporting -.->|"summarizes sales"| node_sql_server

click node_product_api "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GroceryPOS_APIs/Controllers/ProductsController.cs"
click node_user_api "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GroceryPOS_APIs/Controllers/UsersController.cs"
click node_product_logic "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/Product.cs"
click node_category_logic "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/Category.cs"
click node_user_logic "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/User.cs"
click node_validation "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/GSUtility.cs"
click node_product_dto "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/ProductDTO.cs"
click node_new_product_dto "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/NewProductDTO.cs"
click node_user_dto "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/UserDTOs.cs"
click node_bill_dto "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/BillDTO.cs"
click node_movement_dto "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/MovementDTO.cs"
click node_product_data "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/ProductData.cs"
click node_category_data "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/CategoryData.cs"
click node_user_data "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/UserData.cs"
click node_bill_data "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/BillData.cs"
click node_stock_data "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/StockData.cs"
click node_db_config "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/DataSetting.cs"
click node_sql_server "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/Database%20design/SQL%20Queries/DatabaseCreation.sql"
click node_sales "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/BillData.cs"
click node_inventory "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/StockData.cs"
click node_customer_history "https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/UserData.cs"
click node_reporting "https://github.com/ossous-dev-coder/retail-pos-system/tree/main/Database%20design/SQL%20Queries"

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_product_api,node_user_api,node_client toneBlue
class node_product_logic,node_category_logic,node_user_logic,node_validation toneAmber
class node_product_data,node_category_data,node_user_data,node_bill_data,node_stock_data,node_db_config toneMint
class node_product_dto,node_new_product_dto,node_user_dto,node_bill_dto,node_movement_dto,node_sales,node_inventory,node_customer_history,node_reporting toneRose
class node_sql_server toneIndigo
```

## Components

### API layer

- [Product endpoints](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GroceryPOS_APIs/Controllers/ProductsController.cs): `GroceryPOS_APIs/Controllers/ProductsController.cs`
- [User endpoints](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GroceryPOS_APIs/Controllers/UsersController.cs): `GroceryPOS_APIs/Controllers/UsersController.cs`

### Business logic

- [Product rules](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/Product.cs): `GS_Business/Product.cs`
- [Category lookup](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/Category.cs): `GS_Business/Category.cs`
- [User rules](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_Business/User.cs): `GS_Business/User.cs`
- [Validation utilities](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/GSUtility.cs): `GSData/GSUtility.cs`

### Data access

- [Product access](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/ProductData.cs): `GSData/Data/ProductData.cs`
- [Category access](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/CategoryData.cs): `GSData/Data/CategoryData.cs`
- [User access](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/UserData.cs): `GSData/Data/UserData.cs`
- [Sales data access](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/BillData.cs): `GSData/Data/BillData.cs`
- [Stock data access](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/StockData.cs): `GSData/Data/StockData.cs`
- [Connection settings](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/DataSetting.cs): `GSData/Data/DataSetting.cs`

### POS capabilities

- [Product DTOs](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/ProductDTO.cs): `GS_DTOs/ProductDTO.cs`
- [New product input](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/NewProductDTO.cs): `GS_DTOs/NewProductDTO.cs`
- [User DTOs](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/UserDTOs.cs): `GS_DTOs/UserDTOs.cs`
- [Bill DTO](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/BillDTO.cs): `GS_DTOs/BillDTO.cs`
- [Movement DTO](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GS_DTOs/MovementDTO.cs): `GS_DTOs/MovementDTO.cs`
- [Sales processing](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/BillData.cs): `GSData/Data/BillData.cs`
- [Inventory control](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/StockData.cs): `GSData/Data/StockData.cs`
- [Customer history](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/GSData/Data/UserData.cs): `GSData/Data/UserData.cs`
- [Sales reporting](https://github.com/ossous-dev-coder/retail-pos-system/tree/main/Database%20design/SQL%20Queries): `Database design/SQL Queries`

### Persistence

- [SQL Server](https://github.com/ossous-dev-coder/retail-pos-system/blob/main/Database%20design/SQL%20Queries/DatabaseCreation.sql): `Database design/SQL Queries/DatabaseCreation.sql`

### Other components

- **POS client**

## Connections

- POS client → Product endpoints: calls (evidence: `README.md`)
- POS client → User endpoints: calls (evidence: `README.md`)
- Product endpoints → Product rules: dispatches (evidence: `GroceryPOS_APIs/Controllers/ProductsController.cs`)
- Product endpoints → Category lookup: checks category (evidence: `GroceryPOS_APIs/Controllers/ProductsController.cs`)
- User endpoints → User rules: dispatches (evidence: `GroceryPOS_APIs/Controllers/UsersController.cs`)
- Product endpoints → New product input: accepts (evidence: `GroceryPOS_APIs/Controllers/ProductsController.cs`)
- Product endpoints → Product DTOs: returns (evidence: `GroceryPOS_APIs/Controllers/ProductsController.cs`)
- User endpoints → User DTOs: accepts and returns (evidence: `GroceryPOS_APIs/Controllers/UsersController.cs`)
- Product rules → Product access: delegates to (evidence: `GS_Business/Product.cs`)
- Product rules → Validation utilities: validates with (evidence: `GS_Business/Product.cs`)
- Category lookup → Category access: delegates to (evidence: `GS_Business/Category.cs`)
- User rules → User access: delegates to (evidence: `GS_Business/User.cs`)
- User rules → Validation utilities: validates with (evidence: `GS_Business/User.cs`)
- Product access → Product DTOs: maps data (evidence: `GSData/Data/ProductData.cs`)
- User access → User DTOs: maps data (evidence: `GSData/Data/UserData.cs`)
- Product access → Connection settings: uses connection (evidence: `GSData/Data/ProductData.cs`)
- User access → Connection settings: uses connection (evidence: `GSData/Data/UserData.cs`)
- Category access → Connection settings: uses connection (evidence: `GSData/Data/CategoryData.cs`)
- Sales data access → Bill DTO: uses DTO (evidence: `GSData/Data/BillData.cs`)
- Stock data access → Movement DTO: uses DTO (evidence: `GSData/Data/StockData.cs`)
- Product access → SQL Server: queries (evidence: `README.md`)
- User access → SQL Server: queries (evidence: `README.md`)
- Sales data access → SQL Server: persists sales
- Stock data access → SQL Server: updates stock
- Sales processing → Sales data access: uses data access (evidence: `GSData/Data/BillData.cs`)
- Inventory control → Stock data access: uses data access (evidence: `GSData/Data/StockData.cs`)
- Customer history → User access: uses user records (evidence: `GSData/Data/UserData.cs`)
- Sales reporting → SQL Server: summarizes sales
