# SmartGrocery SaaS - Admin Panel & API (Laravel)

This is the backend and admin panel for **SmartGrocery SaaS**, built with **Laravel 12**.

## Features

- 🛠️ **Admin Panel:** Powerful dashboard to manage products, orders, and users.
- 🚀 **REST API:** Secure API for Flutter mobile app and Next.js frontend.
- 🤖 **AI Assistant:** Integrated AI tools for product descriptions and SEO.
- 💳 **Wallet System:** Full wallet and transaction management.
- 🔔 **Notifications:** Push notifications management via OneSignal.
- 📦 **Order Management:** Complete order lifecycle tracking.

## Requirements

- PHP 8.2 or higher
- Composer
- MySQL / MariaDB
- Node.js & NPM (for asset compilation)

## Installation

1.  **Clone & Install Dependencies:**

    ```bash
    composer install
    npm install
    ```

2.  **Environment Setup:**
    Copy `.env.example` to `.env` and configure your database and app settings.

    ```bash
    cp .env.example .env
    php artisan key:generate
    ```

3.  **Database Migration:**

    ```bash
    php artisan migrate --seed
    ```

    *Note: Seeding will create default admin credentials and demo data.*

4.  **Run Development Server:**

    ```bash
    php artisan serve
    ```

## API Documentation

Postman collection is available in `Documentation/Postman/SmartGrocery_SaaS.postman_collection.json`.

## Documentation

For full setup instructions, please refer to the `Documentation` folder in the main package.
