Sales Dashboard — Technical Overview

1. Introduction

Sales Dashboard is a web application that transforms raw data from customers, products, and sales into clear and interactive visualizations. It allows monitoring sales performance, identifying behavioral patterns, and performing detailed analysis within a chosen date range.

2. Main Features

Dynamic sales visualization in a table view.
Query products, clients, and totals for each transaction.
Backend now uses Next.js API routes and Server Components.
Frontend built with React + Next.js + TailwindCSS.
Modular architecture based on classes (Client, Product, Sale, etc.).
Prepared for filters, date range analysis, and chart visualization.

3. Project Structure

sales-dashboard-next/
├── app/
│   ├── layout.js
│   ├── page.js
│   ├── dashboard/
│   │   ├── page.js
│   │   └── DashboardView.jsx
│   ├── api/
│   │   └── sales/
│   │       └── route.js
│   └── globals.css
├── components/
│   ├── ChartView.jsx
│   ├── SalesTable.jsx
│   └── ReportsPanel.jsx
├── lib/
│   ├── db.js
│   ├── dataAccess/
│   │   └── SalesRepository.js
│   ├── models/
│   │   ├── Client.js
│   │   ├── Product.js
│   │   ├── Sale.js
│   │   └── EnumProductType.js
│   ├── database/
│   │   └── schemas/
│   │       ├── ClientSchema.js
│   │       ├── ProductSchema.js
│   │       └── SaleSchema.js
│   ├── controllers/
│   │   └── SalesController.js
│   └── reports/
│       ├── TotalSales.js
│       ├── SalesByProduct.js
│       ├── SalesByClient.js
│       └── SalesByRangeAnalitics.js
├── package.json
├── next.config.js
└── node_modules/

4. Technologies Used

Frontend: Next.js (React), TailwindCSS
Backend: Next.js API routes, Server Components
Architecture: OOP with clear separation of models and presentation logic

5. Planned Improvements

Sales analysis by hour, day, week, month, or year
Trading-view style comparative charts
Filters by client, product, or date range
Data and report exporting
MongoDB or other persistent storage integration

6. Installation & Usage

Clone the repository:

git clone https://github.com/your-username/sales-dashboard.git
cd sales-dashboard-next

Install dependencies:
```
npm install
```
Run the development server:
```
npm run dev
```
Open your browser at:
```
http://localhost:3000/dashboard
```

7. License

This project is released under the MIT License.