🍭 Sweet Shop Management System

A comprehensive web-based management system for confectionery businesses built with Next.js, React, and modern web technologies. This system provides complete functionality for managing products, inventory, orders, customers, and analytics for sweet shops and candy stores.

Complete Sweet Shop Management Solution

🌟 Features

📊 Dashboard & Analytics

• Real-time business metrics and KPIs
• Revenue trends visualization
• Top-selling products analysis
• Sales by category breakdown
• Inventory alerts and notifications
• AI-powered insights and recommendations

Main Dashboard with Analytics Overview

🍬 Product Management

• Complete product catalog management
• Category-based organization (chocolates, gummies, hard candy, lollipops, fudge, caramels)
• Detailed product information including ingredients and allergens
• Nutritional information tracking
• Cost and pricing management with profit margin calculations
• Product image management
• Advanced filtering and sorting capabilities

Product Management Interface

📦 Inventory Management

• Real-time stock level monitoring
• Automated low stock and out-of-stock alerts
• Min/max stock level configuration
• Quick stock adjustment tools
• AI-powered inventory predictions
• Bulk inventory operations
• Inventory value tracking

Inventory Tracking and Management

🛒 Order Management

• Complete order lifecycle management
• Customer order history
• Order status tracking (pending, completed, cancelled)
• Multiple payment method support
• Order filtering and search
• Detailed order breakdown with itemized billing
• Tax calculation and management

Order Management System

New Order Creation Interface

👥 Customer Management

• Comprehensive customer profiles
• Customer segmentation (New, Regular, VIP)
• Purchase history and analytics
• Customer preferences and allergy tracking
• Address and contact information management
• Communication preferences
• Customer loyalty insights

Customer Management and Registration

🤖 AI-Powered Features

• Product recommendation engine
• Inventory demand forecasting
• Customer behavior analysis
• Pricing optimization suggestions
• Sales pattern recognition
• Automated business insights

🛠️ Technology Stack

Frontend

• Next.js 16.0.10 - React framework for production
• React 18.2.0 - UI library
• React Hot Toast - Elegant notifications
• React Icons - Icon library
• Canvas Confetti - Celebration animations

Backend

• Next.js API Routes - Serverless API endpoints
• File-based JSON Database - Simple data persistence
• Custom Database Layer - CRUD operations abstraction

Development & Testing

• Jest - Testing framework
• React Testing Library - Component testing utilities
• ESLint - Code linting and formatting
• Jest Environment JSDOM - DOM testing environment

Styling

• CSS Modules - Scoped styling
• Responsive Design - Mobile-first approach
• Modern UI Components - Clean and intuitive interface

📸 Application Screenshots

The output/ folder contains screenshots demonstrating all major features:

• dashboard_output.png - Main dashboard with analytics
• dashboard.png - Dashboard overview
• project_management.png - Product management interface
• inventory_management.png - Inventory tracking system
• order_management.png - Order processing interface
• new_order.png - New order creation form
• add_customer.png - Customer registration form

📁 Project Structure

sweet-shop-management/
├── components/                 # React components
│   ├── Dashboard.jsx          # Main dashboard component
│   ├── ProductManagement.jsx  # Product CRUD operations
│   ├── InventoryManagement.jsx# Inventory tracking
│   ├── OrderManagement.jsx    # Order processing
│   ├── CustomerManagement.jsx # Customer management
│   ├── Layout.jsx             # App layout wrapper
│   ├── Navbar.jsx             # Navigation component
│   ├── Footer.jsx             # Footer component
│   └── index.js               # Component exports
├── pages/                     # Next.js pages
│   ├── api/                   # API routes
│   │   ├── analytics/         # Analytics endpoints
│   │   ├── customers/         # Customer CRUD APIs
│   │   ├── inventory/         # Inventory management APIs
│   │   ├── orders/            # Order processing APIs
│   │   └── products/          # Product management APIs
│   ├── index.js               # Main application page
│   └── _app.js                # App configuration
├── lib/                       # Utility libraries
│   ├── database.js            # Database operations
│   ├── ai-helpers.js          # AI recommendation engine
│   └── utils.js               # Utility functions
├── data/                      # JSON data files
│   ├── products.json          # Product catalog
│   ├── customers.json         # Customer database
│   ├── orders.json            # Order history
│   ├── inventory.json         # Stock levels
│   └── analytics.json         # Analytics data
├── styles/                    # CSS styles
│   └── globals.css            # Global styles
├── __tests__/                 # Test files
├── output/                    # Application screenshots
└── public/                    # Static assets

🚀 Getting Started

Prerequisites

• Node.js 16.x or higher
• npm or yarn package manager

Installation

1. Clone the repository

   git clone <repository-url>
   cd sweet-shop-management

2. Install dependencies

   npm install
   # or
   yarn install

3. Set up environment variables

   cp .env.example .env

   Edit .env file with your configuration settings.

4. Initialize the database The application will automatically create initial data files on first run.

5. Start the development server

   npm run dev
   # or
   yarn dev

6. Open your browser Navigate to http://localhost:3000

Production Build

# Build the application
npm run build

# Start production server
npm start

🧪 Testing

The project includes comprehensive testing setup with Jest and React Testing Library.

# Run tests in watch mode
npm test

# Run tests with coverage
npm run test:ci

# Run linting
npm run lint

📊 Data Management

The application uses a file-based JSON database system for simplicity and portability:

• Products: Complete product catalog with pricing, ingredients, and nutritional info
• Customers: Customer profiles with preferences and purchase history
• Orders: Order transactions with detailed item breakdown
• Inventory: Real-time stock levels and management data
• Analytics: Business metrics and performance data

🎯 Key Features Explained

AI-Powered Recommendations

• Product Recommendations: Based on sales history and customer preferences
• Inventory Predictions: Forecasts stock needs using historical sales data
• Customer Behavior Analysis: Segments customers and identifies patterns
• Pricing Optimization: Suggests optimal pricing based on market analysis

Real-time Analytics

• Sales Metrics: Revenue, order count, and average order value
• Product Performance: Top-selling items and category breakdown
• Customer Insights: Active customers, segments, and loyalty metrics
• Inventory Health: Stock levels, alerts, and value tracking

Responsive Design

• Mobile-first approach for all screen sizes
• Touch-friendly interface for tablet use
• Optimized for both desktop and mobile workflows
• Consistent user experience across devices

🔧 Configuration

Environment Variables

# Add your environment-specific configurations
NEXT_PUBLIC_APP_NAME=Sweet Shop Management
NEXT_PUBLIC_APP_VERSION=1.0.0

Database Configuration

The system automatically initializes with sample data including:

• 2 sample products (Chocolate Truffles, Gummy Bears)
• Empty customer and order databases
• Initial inventory levels
• Basic analytics structure

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Next.js team for the excellent React framework
• React community for the amazing ecosystem
• All contributors and testers who helped improve this system