Eniceberny Bakery & Culinary Hub Platform Documentation

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): Operational manual for Cashiers, Kitchen Dispatchers, Catering Event Crew, and Shift Supervisors.
• Patron & Client User Manual: Customer guide for online ordering, bespoke cakes, Mobile Money checkout, order tracking, and invoice payments.
• Point of Sale (POS) Counter: High-speed counter register, portion selections, Dine-in vs Takeaway modes, quick cash keys, and thermal receipts.
• Administration Panel & Operations: Executive sales metrics, order fulfillment pipelines, customer rosters, modular settings cards, and audit logs.
• Accounts, Financial Ledgers & User Identity: Customer account self-service, staff RBAC provisioning, cash drawer balancing, MoMo reconciliation, and CSV financial exports.
• System Troubleshooting & Incident Runbooks: Step-by-step diagnostic and remediation protocols for cashiers, dispatchers, admins, customers, and DevOps.

🏗️ Architecture & Core Engineering

• Platform Architecture & Multi-Channel ERP: System topography, Laravel 11/12 foundation, service layer architecture, and design decisions.
• Developers & Maintainers Handbook: Technical handbook for future developers, coding standards, design patterns, and debugging runbooks.
• Database & Storage Engine: Entity relationship diagrams, schema definitions, indexing strategies, and transactional locking.
• Security & Ghana Compliance: 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: Public and internal API specifications, cart drawer endpoints, and payload contracts.
• Payment Systems & MoMo Gateways: Multi-gateway architecture (Cash, MTN MoMo, Telecel Cash, Paystack), webhook cryptographic HMAC verification, and PDF invoice generation.
• Catering & Event Quotations: Event inquiry management, banquet packages, custom quotation builder, and automated order conversion.

🎨 Content, Media & SEO

• Content Management & Dynamic CMS: Zero-code homepage section reordering, marketing banners, testimonials, FAQs, and Schema.org SEO.
• Media Asset Management: Secure image uploads, brand logo engine, optimization, and catalog associations.

🚀 DevOps & Quality Assurance

• Automated Testing & QA Guide: Automated 85-test PHPUnit test suite, in-memory SQLite fixtures, CI/CD pipeline, and assertions guide.
• Docker & Render Deployment: Multi-stage container builds, Apache configuration, Render PaaS blueprint, and post-deploy seeding.

💻 Core Technology Stack

⚡ Quick Start for Developers

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

# 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:

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.