# FoodFleet Grocery Manager

Advanced multi-shop food and grocery store management software built with Laravel.

## Included Modules

- Multi-shop branch management
- Owner dashboard with consolidated and per-shop metrics
- Product master catalog with SKU, barcode, category, unit, tax, and expiry tracking
- Per-shop inventory, reorder levels, pricing tiers, batch and expiry data
- Touch-friendly POS with cart, customer dues, bKash/Nagad/card/cash options, and stock deduction
- Supplier database and purchase receiving with automatic stock-in
- Customers, loyalty points, and credit/due balance
- Staff accounts, roles, permissions, salaries, and shop assignment
- Expenses, reports, audit trail, and inter-shop stock transfer approval
- Mobile and desktop optimized Blade UI

## XAMPP + Laravel Setup

1. Install Composer if it is not installed.
2. Make sure XAMPP Apache and MySQL are running.
3. Put this project folder inside `xampp/htdocs`.
4. Open a terminal in this project folder.
5. Run:

```bash
composer install
copy .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve
```

Then open:

```text
http://127.0.0.1:8000
```

If you want to use Apache directly instead of `php artisan serve`, point Apache to the `public` folder or open:

```text
http://localhost/Food%20and%20Grocery%20Store%20Software/public/
```

## Default Login

Owner:

```text
owner@example.com
admin123
```

Cashier:

```text
cashier@example.com
cashier123
```

## Database

Default `.env.example` values are ready for XAMPP MySQL:

```text
DB_DATABASE=foodfleet_grocery
DB_USERNAME=root
DB_PASSWORD=
```

Create the database manually in phpMyAdmin if MySQL does not allow Laravel to create it automatically:

```sql
CREATE DATABASE foodfleet_grocery CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

Then run:

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

## Important

This workspace now contains Laravel source code. It still needs Composer dependencies in `vendor/` before it can run. PHP and Composer were not available from this shell, so dependency installation and `php artisan` verification could not be executed here.