> For the complete documentation index, see [llms.txt](https://docs.enicebakerygh.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enicebakerygh.com/readme.md).

# Platform Overview

Welcome to the official technical, architectural, operational, and user documentation for the **Eniceberny Bakery & Culinary Hub** platform.

This platform powers a multi-channel artisan bakery, culinary kitchen, and hospitality enterprise in Ghana — seamlessly unifying consumer storefront e-commerce, in-store Point of Sale (POS) counter terminals, corporate catering quotation workflows, real-time financial ledgers, and cash drawer reconciliation.

***

## 🎯 Platform Mission & Core Capabilities

Eniceberny Bakery & Culinary Hub provides a unified digital ecosystem serving four distinct constituencies:

1. **Patrons & Corporate Clients**: Browse artisan bread, gourmet pastries, continental dishes, authentic Ghanaian delicacies, and celebratory cakes with seamless Mobile Money (MTN & Telecel) and card checkout.
2. **In-Store Staff & Cashiers**: High-speed Point of Sale (POS) terminal with instant search, portion selection, quick cash tenders, and thermal receipt generation.
3. **Kitchen Chefs & Dispatchers**: Real-time order fulfillment display, portion tracking, holding temperature protocols, and courier handoff checklists.
4. **Operations & Executive Leadership**: Centralized administrative console overseeing orders, multi-channel ledgers, catering proposals, inventory valuations, automated audit trails, and modular CMS branding.

***

## 🗺️ Documentation Map

The documentation is organized into six structured domains:

### 👥 User Guides & Operations

* [**Staff Training & Standard Operating Procedures (SOP)**](/user-guides-and-operations/staff-training.md): Operational manual for Cashiers, Kitchen Dispatchers, Catering Event Crew, and Shift Supervisors.
* [**Patron & Client User Manual**](/user-guides-and-operations/customer-guide.md): Customer guide for online ordering, bespoke cakes, Mobile Money checkout, order tracking, and invoice payments.
* [**Point of Sale (POS) Counter**](/user-guides-and-operations/pos.md): High-speed counter register, portion selections, Dine-in vs Takeaway modes, quick cash keys, and thermal receipts.
* [**Administration Panel & Operations**](/user-guides-and-operations/admin.md): Executive sales metrics, order fulfillment pipelines, customer rosters, modular settings cards, and audit logs.
* [**Accounts, Financial Ledgers & User Identity**](/user-guides-and-operations/accounts.md): Customer account self-service, staff RBAC provisioning, cash drawer balancing, MoMo reconciliation, and CSV financial exports.
* [**System Troubleshooting & Incident Runbooks**](/user-guides-and-operations/troubleshooting.md): Step-by-step diagnostic and remediation protocols for cashiers, dispatchers, admins, customers, and DevOps.

### 🏗️ Architecture & Core Engineering

* [**Platform Architecture & Multi-Channel ERP**](/architecture-and-engineering/architecture.md): System topography, Laravel 11/12 foundation, service layer architecture, and design decisions.
* [**Developers & Maintainers Handbook**](/architecture-and-engineering/developer-handbook.md): Technical handbook for future developers, coding standards, design patterns, and debugging runbooks.
* [**Database & Storage Engine**](/architecture-and-engineering/database.md): Entity relationship diagrams, schema definitions, indexing strategies, and transactional locking.
* [**Security & Ghana Compliance**](/architecture-and-engineering/security.md): CIA triad enforcement, role-based access control (RBAC), and Ghana Data Protection Act 2012 (Act 843) compliance.

### 🛍️ Storefront & Digital Commerce

* [**REST API (v1) & Web Endpoints**](/storefront-and-digital-commerce/api.md): Public and internal API specifications, cart drawer endpoints, and payload contracts.
* [**Payment Systems & MoMo Gateways**](/storefront-and-digital-commerce/payments.md): Multi-gateway architecture (Cash, MTN MoMo, Telecel Cash, Paystack), webhook cryptographic HMAC verification, and PDF invoice generation.
* [**Catering & Event Quotations**](/storefront-and-digital-commerce/catering.md): Event inquiry management, banquet packages, custom quotation builder, and automated order conversion.

### 🎨 Content, Media & SEO

* [**Content Management & Dynamic CMS**](/content-media-and-seo/cms.md): Zero-code homepage section reordering, marketing banners, testimonials, FAQs, and Schema.org SEO.
* [**Media Asset Management**](/content-media-and-seo/media.md): Secure image uploads, brand logo engine, optimization, and catalog associations.

### 🚀 DevOps & Quality Assurance

* [**Automated Testing & QA Guide**](/devops-and-quality-assurance/testing.md): Automated 85-test PHPUnit test suite, in-memory SQLite fixtures, CI/CD pipeline, and assertions guide.
* [**Docker & Render Deployment**](/devops-and-quality-assurance/deployment.md): Multi-stage container builds, Apache configuration, Render PaaS blueprint, and post-deploy seeding.

***

## 💻 Core Technology Stack

| Layer                       | Technologies                | Key Responsibilities                                                           |
| --------------------------- | --------------------------- | ------------------------------------------------------------------------------ |
| **Backend Framework**       | **Laravel 11/12 (PHP 8.4)** | Business services, routing, validation, security middleware, mail engine       |
| **Frontend Rendering**      | **Blade + Alpine.js**       | Server-rendered luxury UI with reactive client-side micro-interactions         |
| **Styling & Design System** | **Tailwind CSS v3**         | Warm luxury palette (Cream `#F6F3EC`, Deep Burgundy `#4A1521`, Gold `#C29B38`) |
| **Database**                | **PostgreSQL 16 / SQLite**  | Relational transactions, JSON fields, ACID compliance, in-memory CI testing    |
| **Asset Bundler**           | **Vite**                    | Lightning-fast asset compilation, tree-shaking, production minification        |
| **Document Engine**         | **DomPDF + php-qrcode**     | Formal customer receipts, quote printouts, offline QR code embedding           |
| **Containerization**        | **Docker (PHP 8.4 Apache)** | Production runtime, multi-stage builder, health check probes (`/up`)           |
| **CI / CD Automation**      | **GitHub Actions**          | Automated testing matrix (PHP 8.4, Node 20), build validation, deploy hooks    |

***

## ⚡ Quick Start for Developers

Clone the repository and spin up the development environment in minutes:

```bash
# 1. Clone repository
git clone https://github.com/mhiskall282/enicebakery-website.git
cd enicebakery-website

# 2. Install PHP and Node dependencies
composer install
npm install

# 3. Configure environment
cp .env.example .env
php artisan key:generate

# 4. Run migrations and seed operational data
php artisan migrate --seed

# 5. Build frontend assets and run local dev server
npm run dev
php artisan serve
```

Run the complete automated test suite:

```bash
php artisan test
```

> \[!TIP] **Production Credentials**: The initial administrative superuser is seeded as `admin@enicebakerygh.com` with password `password`. In production, update this password immediately upon first deployment.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.enicebakerygh.com/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.