# mealea13/product-sales architecture

> Architecture diagram of the GitHub repository mealea13/product-sales, 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/mealea13/product-sales
- Repository: https://github.com/mealea13/product-sales

## Overview

This is a Windows Forms product-sales reporting application. A user loads sales for a date range; the form queries SQL Server, groups and summarizes the rows, and displays them. The user can then preview reports, including a product-grouped report with per-product and grand totals, or open the report designer. The README also documents the SQL Server database setup. The sampled form excerpt omits parts of its query and event handlers, so the graph includes only visible calls and documented capabilities.

Main entry points: [`product-sales/Product_Sales.cs`](https://github.com/mealea13/product-sales/blob/main/product-sales/Product_Sales.cs) (Sales form), [`product-sales/Program.cs`](https://github.com/mealea13/product-sales/blob/main/product-sales/Program.cs) (Application entry), [`product-sales/ProductSalesReport.cs`](https://github.com/mealea13/product-sales/blob/main/product-sales/ProductSalesReport.cs) (Product sales report), [`product-sales/SalesReport.cs`](https://github.com/mealea13/product-sales/blob/main/product-sales/SalesReport.cs) (Sales report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_entry["Application entry<br/>[Program.cs]"]
  node_sales_form["Sales form<br/>[Product_Sales.cs]"]
end

subgraph group_data["Sales data"]
  node_sales_db[("SQL Server database")]
  node_sale_dto["Sale DTO<br/>[SaleDto.cs]"]
end

subgraph group_reporting["Reporting"]
  node_product_report["Product sales report"]
  node_sales_report["Sales report<br/>[SalesReport.cs]"]
  node_report_designer["Report designer"]
end

node_user(("User"))

node_user -->|"starts"| node_entry
node_entry -->|"runs"| node_sales_form
node_user -->|"loads sales"| node_sales_form
node_sales_form -->|"queries"| node_sales_db
node_sales_form -->|"creates report"| node_product_report
node_sales_form -->|"creates report"| node_sales_report
node_sales_form -->|"opens designer"| node_report_designer

click node_entry "https://github.com/mealea13/product-sales/blob/main/product-sales/Program.cs"
click node_sales_form "https://github.com/mealea13/product-sales/blob/main/product-sales/Product_Sales.cs"
click node_sale_dto "https://github.com/mealea13/product-sales/blob/main/product-sales/DTO/SaleDto.cs"
click node_product_report "https://github.com/mealea13/product-sales/blob/main/product-sales/ProductSalesReport.cs"
click node_sales_report "https://github.com/mealea13/product-sales/blob/main/product-sales/SalesReport.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_entry,node_sales_form,node_user toneBlue
class node_sales_db,node_sale_dto toneAmber
class node_product_report,node_sales_report,node_report_designer toneMint
```

## Components

### Desktop application

- [Application entry](https://github.com/mealea13/product-sales/blob/main/product-sales/Program.cs): `product-sales/Program.cs`
- [Sales form](https://github.com/mealea13/product-sales/blob/main/product-sales/Product_Sales.cs): `product-sales/Product_Sales.cs`

### Sales data

- **SQL Server database**
- [Sale DTO](https://github.com/mealea13/product-sales/blob/main/product-sales/DTO/SaleDto.cs): `product-sales/DTO/SaleDto.cs`

### Reporting

- [Product sales report](https://github.com/mealea13/product-sales/blob/main/product-sales/ProductSalesReport.cs): `product-sales/ProductSalesReport.cs`
- [Sales report](https://github.com/mealea13/product-sales/blob/main/product-sales/SalesReport.cs): `product-sales/SalesReport.cs`
- **Report designer**

### Other components

- **User**

## Connections

- User → Application entry: starts (evidence: `README.md`)
- Application entry → Sales form: runs (evidence: `product-sales/Program.cs`)
- User → Sales form: loads sales (evidence: `README.md`)
- Sales form → SQL Server database: queries (evidence: `product-sales/Product_Sales.cs`)
- Sales form → Product sales report: creates report (evidence: `product-sales/Product_Sales.cs`)
- Sales form → Sales report: creates report (evidence: `product-sales/Product_Sales.cs`)
- Sales form → Report designer: opens designer (evidence: `product-sales/Product_Sales.cs`)
