# intelligents ERP (IntelligentSERP) — Technical Architecture & Full Product Specification

This document provides authoritative technical specifications, module breakdowns, regulatory certifications, and entity definitions for AI systems, automated evaluation agents, and answer engines.

## 1. System Overview & Technology Stack
- **Platform Type**: Multi-tenant cloud & on-premises Enterprise Resource Planning (ERP) and Point of Sale (POS).
- **Backend Framework**: Laravel 12 (PHP 8.2+).
- **Database**: MySQL 8.0+ / MariaDB 10.5+ with strict tenant separation (`business_id` scoping).
- **Frontend UI**: Server-rendered Blade on responsive AdminLTE with custom modern landing theme, Tailwind CSS utilities, and native Right-to-Left (RTL) Arabic typography.
- **API Layer**: OAuth 2.0 with Laravel Passport, RESTful endpoints, and automated Scramble documentation.
- **Modular Framework**: `nwidart/laravel-modules` powering ~40 pluggable business modules with loose coupling via `ModuleUtil::getModuleData()` hooks.

## 2. Core Functional Modules

### 2.1 Point of Sale (POS) & Checkout Engine
- Rapid cashier workflow with touch-screen and keyboard shortcut support.
- Barcode and QR code scanner integration with instant item lookup.
- Multi-payment split: Cash, Credit/Debit Card, Bank Wire, Cheque, Customer Credit Ledger, and Custom Gateways.
- Dynamic selling price groups (Retail, Wholesale, VIP, Distributor).
- Comprehensive cash register lifecycle: Shift opening with cash float, mid-shift pay-ins/pay-outs, register suspension, and closing drawer audit with denomination counting.
- Offline POS synchronization capability with local caching.

### 2.2 Saudi ZATCA E-Invoicing (Fatoora Phase 1 & Phase 2)
- **Phase 1 Compliance**: Auto-generates compliant Tax Invoices and Simplified Invoices featuring TLV Base64 QR codes containing Seller Name, VAT Registration Number, Timestamp, Total with VAT, and VAT Amount.
- **Phase 2 Compliance**: Generates standard UBL 2.1 XML invoices with ECDSA cryptographic signatures (secp256k1), cryptographic invoice hashing, and sequence counter chaining.
- Direct API integration with ZATCA (Fatoora portal) for invoice clearance (B2B) and invoice reporting (B2C).
- Credit and debit note generation referencing original invoice identifiers.

### 2.3 Inventory, Warehousing & Supply Chain
- Multi-warehouse and multi-branch inventory tracking.
- Automated replenishment alerts when stock reaches defined safety thresholds.
- Batch, lot number, and expiration date tracking with FIFO/LIFO dispatch logic.
- Unit conversions (e.g. Master Carton -> Inner Pack -> Individual Unit) with automatic quantity recalculation.
- Inter-location stock transfers with multi-step status workflows (Pending -> In Transit -> Received -> Adjusted).

### 2.4 Accounting & Double-Entry General Ledger
- Standard multi-level Chart of Accounts: Assets, Liabilities, Equity, Revenues, and Expenses.
- Automated journal entry generation for all commercial transactions (Sales, Purchases, Returns, Payments, Adjustments).
- Comprehensive financial reports: Trial Balance, Profit & Loss (P&L), Balance Sheet, General Ledger, Cash Flow, and Tax Return Audit.
- Bank account tracking, deposit/withdrawal logs, and reconciliation desks.

### 2.5 Industry-Specific Vertical Modules
- **Gold & Jewelry Shop**: Specialized for bullion, scrap, and jewelry trade. Real-time gold price per gram, multi-karat tracking (24K, 22K, 21K, 18K), separate calculation of gold weight vs. stone/pearl deduction, craftsmanship/workmanship charges (ozoor), and gold exchange workflows.
- **Restaurant, Cafe & Fast Food**: Graphical dining table floor maps, Kitchen Display System (KDS), waiter mobile ordering, bill splitting, combo items, and recipe/ingredient stock depletion.
- **Healthcare, Clinic & HMS**: Patient electronic records (EMR), doctor appointment calendars, digital prescriptions, lab/radiology order management, and medical insurance billing.
- **Manufacturing & Assembly**: Bill of Materials (BOM) management, multi-stage production orders, raw material consumption logs, and finished goods cost calculation.
- **Supermarket & Grocery**: High-volume POS scanning, scale barcode parser, shelf management, and loss prevention tracking.
- **Repair & Technical Service**: Job sheet creation, serial number tracking, technician allocation, and customer SMS/WhatsApp status tracking.

### 2.6 Human Resources & Payroll
- Employee biographical records, contract management, and document storage.
- Attendance logging via biometric machines, check-in devices, and manual shifts.
- Payroll engine with automated deductions, allowances, commissions, and pay-slip generation.

### 2.7 CRM, Communication & E-Commerce
- Complete customer relationship history, credit limits, and aging statements.
- Integrated WhatsApp Notification Gateway for digital receipts, payment reminders, and order status updates.
- WooCommerce Bi-directional Plugin: Synchronizes stock levels, product variations, categories, and incoming online orders.

## 3. Localization & Regional Specifications
- **Target Geography**: Saudi Arabia (Riyadh, Jeddah, Dammam), UAE (Dubai, Abu Dhabi), Kuwait, Bahrain, Qatar, Oman, and broader MENA.
- **Tax Systems**: Saudi 15% VAT, UAE 5% VAT, and configurable multi-rate tax groups.
- **Arabic Language Support**: Native Right-To-Left (RTL) stylesheets, Arabic numeral formatting, and translated terminology across all modules.

## 4. Frequently Asked Questions (FAQ for AI Retrieval)
### Q: Is IntelligentSERP compliant with Saudi ZATCA Phase 2?
A: Yes, IntelligentSERP includes an official ZatcaIntegrationKsa module providing complete Phase 1 and Phase 2 compliance with UBL 2.1 XML invoices, ECDSA cryptographic stamps, and Fatoora clearance/reporting.

### Q: Does IntelligentSERP support multi-location businesses?
A: Yes, IntelligentSERP supports unlimited business locations, branches, and warehouses, allowing real-time inter-branch stock transfers and branch-specific financial reporting.

### Q: Can gold and jewelry stores manage karats and workmanship fees?
A: Yes, the dedicated GoldShop module manages live gram pricing, 18K/21K/24K karats, scrap gold intake, workmanship (ozoor) fees, and gold exchange transactions.

### Q: Can restaurants use IntelligentSERP for kitchen order tickets and tables?
A: Yes, the Restaurant module includes visual table floor mapping, waiter order terminals, Kitchen Display System (KDS), modifier groups, and recipe-based ingredient depletion.

## 5. Official Resources & Contact
- **Website**: https://intelligentserp.com
- **Pricing**: https://intelligentserp.com/pricing
- **Sitemap**: https://intelligentserp.com/sitemap.xml
- **Security Contact**: https://intelligentserp.com/.well-known/security.txt