# MokoDoliJoomShop

A Joomla 4/5 storefront component backed by Dolibarr ERP for product management, orders, and invoicing.

## Architecture

- **Dolibarr** = backend commerce engine (products, inventory, pricing, invoicing)
- **Joomla** = frontend storefront (catalog, cart, checkout, customer UI)
- **Integration** = Dolibarr REST API

## Features

- Browse products synced from Dolibarr
- Product categories and filtering
- Shopping cart (session-based)
- Checkout with order creation in Dolibarr
- Automatic invoice generation
- Customer sync (Joomla users <> Dolibarr thirdparties)
- Admin dashboard with sync status and order overview

## Requirements

- Joomla 4.4+ or 5.x
- PHP 8.1+
- Dolibarr 17.0+ with REST API enabled
- Dolibarr API key with appropriate permissions

## License

GPL-3.0-or-later -- Moko Consulting