Sales Data Analytics Dashboard

A full-stack dashboard for visualizing sales data, exploring trends, and monitoring KPIs.

Overview

This repository contains a frontend (Vite + modern JS/TS stack) and a Python backend API. The app provides interactive charts, tables, and filters to analyze sales performance.

Tech Stack

• Frontend: Vite, TailwindCSS (see frontend/)
• Backend: Python (FastAPI/Flask) in backend/

Project Structure

Sales_Data_Analytics_Dashboard/
├── frontend/   # Vite-based frontend
├── backend/    # Python backend API
└── instructions.md

Getting Started

Prerequisites:

• Node.js 18+
• Python 3.10+

Frontend

cd frontend
npm install
npm run dev
# Visit http://localhost:5173 (default Vite port) or as configured

Build:

npm run build
npm run preview

Backend

cd backend
python -m venv .venv
source .venv/bin/activate   # macOS/Linux
# .venv\Scripts\activate    # Windows PowerShell
pip install -r requirements.txt

# Start the API (example)
python -m app
# or uvicorn if using FastAPI:
# uvicorn app.main:app --reload --port 8000

Configuration

• Check any .env or configuration files under backend/app and frontend/.
• Ensure data sources and API endpoints are aligned between frontend and backend.

Testing

• Frontend: npm run test (if configured)
• Backend: pytest or python -m pytest (if test suite is present)

Deployment

• Frontend: build static assets with npm run build and serve via a static host
• Backend: package and run under Gunicorn/Uvicorn or containerize

Contributing

PRs are welcome. Please follow code style conventions and include tests where practical.

License

Refer to the repository license if present; otherwise consult maintainers before redistribution.