When running OMA ERP for the first time, the Onboarding Wizard automatically appears to configure the base environment. The wizard consists of the following steps:

1. Language Selection: Select the default interface language (Arabic, French, English). The system switches the layout direction (RTL for Arabic) instantly.

2. Network Mode Selection: Choose between Standalone / Master (host terminal) or Node (workstation connected via LAN).

3. Access Permissions: Select Solo Mode (skips login, ideal for single operators) or Team Mode (enforces individual login, PINs, and roles).

Step 1: On first launch, select your system language from the drop-down menu.

Step 2: Choose the station mode: standalone Master server or Node terminal.

Step 3: Pick the authorization mode and define the initial administrator PIN.

Pro Tip: Save your Admin PIN in a secure location. It is required to approve all critical operations.

The program functions on a lifetime license (One-time Purchase) with no monthly or annual subscriptions.

1. Trial Period: The system grants a 3-day free trial at first install. The trial period is hardened locally against clock manipulation (Time Travel) using encrypted timestamps.

2. Activation Method: The app calculates a unique Hardware ID (HWID) based on motherboard, CPU, and disk serial numbers, linking the license key to this device identity.

3. Offline Work: Once activated, the software functions fully offline without needing an active internet connection.

Step 1: Copy the unique Hardware ID (HWID) shown on the activation prompt.

Step 2: Enter your activation license key and click 'Activate' to lock the software to your PC.

When Team Mode is enabled: upon launching the application, a central lock screen called the 'Technician Gate' is displayed.

It showcases staff names and avatars, requiring employees to click their profile and enter their secret access PIN.

Access is governed by Role-Based Access Control (Admin, Accountant, Technician) to safeguard sensitive operational data.

Security Tip: We recommend enabling auto-session locking for each staff member during break times.

To preserve 100% data privacy, OMA ERP does not rely on external cloud servers for password recovery. If the Admin password is forgotten, recovery is performed using the license key and email.

The system compares inputs locally with encrypted license records to bypass the login screen and prompt for password reset.

Security Notice: No external key files are downloaded. Recovery occurs strictly inside the local closed database to prevent unauthorized access.

Security Note: Password recovery is local only to maintain the privacy of your customer files.

The lifecycle of a repair ticket flows through the following stages:

Stage 1: Intake - Log client name, phone, device model, and IMEI. Assign storage location (Bin Code), lock patterns/passcodes, and initial cost estimates.

Stage 2: Diagnosis & Labeling - The system prints a ticket receipt or barcode sticker to attach to the device.

Stage 3: Assignment & Labor - Assign the ticket to a technician. Status changes to 'In Progress'. Spare parts used are temporarily reserved in inventory.

Stage 4: Delivery & Invoicing - Once repaired, status becomes 'Ready'. Upon checkout, it converts into a sales invoice, capturing revenue, updating stocks, and allocating commissions.

manual.chapters.c2_s1_step5

Operational Tip: Assign tickets to technicians based on specialization to ensure maximum efficiency.

1. 9-Item Checklist: Upon intake, staff inspect nine core components (Network, Display, Cameras, Audio, Battery, Buttons, Sensors, Bluetooth, Housing) to avoid liability for pre-existing damage.

2. Parts Tracking: Spare parts assigned to a repair carry their unique serial number and actual cost price for accurate profit margins.

Inventory levels are only permanently decremented when the status changes to 'Delivered', allowing easy rollback or cancellation at any time prior.

Golden Rule: Inspecting the 9 core checklist items protects your shop against claims of pre-existing damage.

Stock Policy: Parts are only permanently decremented from inventory after the ticket is checked out and delivered.

A custom feature designed to manage donor devices purchased for extracting second-hand parts.

Workflow: Log the purchase of a scrap device, strip components (motherboard, screen, camera), and add them to standard inventory as scrap parts with custom cost allocation.

Track parts statuses as Available, Used (in a customer repair), or Damaged.

Pro Tip: Use scrap phones as donor devices to get original parts at zero cost, boosting profit margins.

manual.chapters.c2_s4_p1

manual.chapters.c2_s4_p2

Step 1: Once fixed, set status to 'Ready' to automatically alert the client.

Step 2: On client pickup, click 'Deliver & Invoice' to close the repair and assign commissions.

The POS interface is optimized for speed, supporting touch screens and barcode scanners.

Discounts: Apply flat rate or percentage-based discounts to individual items or the entire cart.

Split Payments: Allows customers to divide checkout totals between cash, card, and bank transfer.

Receipt Printing: Sends print commands directly to default thermal printers without preview popups, while offering clean A4 printing with QR verification.

Step 1: Search products by name or scan barcodes using a laser reader at checkout.

Step 2: Select the payment method (cash, card, split) and enter the amount received.

Step 3: Click 'Checkout & Print' to print the receipt and update stock levels.

Quick Tip: Use keyboard shortcuts displayed on the POS interface to speed up sales during busy hours.

OMA ERP incorporates a strict security protocol to prevent checkout fraud. Standard cashiers cannot delete or cancel finalized transactions without Admin PIN authorization.

Atomic Rollback: Voiding an invoice updates status to voided, reverses ledger entries, restores items to inventory, and subtracts loyalty points in one transaction.

This atomic design prevents half-written data and keeps financials perfectly balanced.

Step 1: To cancel a sale, select 'Void Transaction' in the invoice history panel.

Supports workshops selling both to retail customers and wholesale clients (e.g., other repair shops).

Inventory items carry distinct retail and wholesale pricing values.

Toggling Wholesale Mode instantly recalculates cart items to reflect wholesale pricing schedules.

Step 1: For B2B or trade clients buying in bulk, toggle 'Wholesale Mode' at the top of the POS screen.

Step 2: The system will instantly recalculate totals using wholesale pricing schedules.

Item Management: Categorize stock into spare parts, accessories, and devices. Track buy price, retail price, wholesale price, and safety stock levels.

Low Stock Alerts: Visual red indicators flag items that fall below set safety stock minimums.

Smart Restock: Scans inventory to compile low-stock orders, generating purchase sheets to send directly to suppliers.

Stock Adjustment: Log lost or damaged goods to deduct them from inventory, posting losses to the general ledger.

Restock Tip: Check the Smart Restock report weekly to purchase items that fall below safety thresholds.

Unlike basic sales software, OMA ERP runs a true double-entry accounting engine to track and reconcile financials.

Every operation logs balanced debits and credits: Σ Debits = Σ Credits. Any imbalance prompts a fatal system alert and blocks data updates.

The chart of accounts covers cash box, sales income, repair revenue, accounts receivable, and accounts payable. Values are processed in integer cents to eliminate decimal errors.

Step 1: Double-entry ledger postings are recorded automatically in the background for all sales.

Step 2: The system verifies debits equal credits on the fly to protect ledger balance.

Step 3: Export statements and accounts reports anytime without manual ledger entry.

Weighted Average Costing (WAC): Dynamically updates product costs when acquiring batches of parts at varying prices.

Cost of Goods Sold (COGS): Checkout calculations post cost of sales to the COGS account for correct gross profit tracking: Gross Profit = Revenue - COGS.

Net Profit: Automatically calculated by subtracting operating expenses and technician commissions from gross profit.

Step 1: Weighted Average Cost (WAC) updates automatically as new purchase orders are logged.

Margin Tip: Net profits are calculated by subtracting operating expenses and staff commissions from gross profit.

Client credit limits restrict outstanding balances, preventing transactions from proceeding unless overridden by Admin PIN.

Detailed statements print transaction history, payments made, and running balances.

Record payments to instantly decrease outstanding debt and increase cash balances.

Risk Management: Set conservative credit limits for new clients to avoid unpaid accounts.

Features an automated Zakat calculator for computing annual dues on business assets.

Zakat Base = Total Stock Cost + Cash Balance - Short-Term Payables. Dues are calculated at 2.5% of the total base.

Zakat Tip: The Zakat calculator is designed to help estimate annual dues on stock cost and cash balances.

manual.chapters.c4_s5_p1

manual.chapters.c4_s5_p2

manual.chapters.c4_s5_step1

Enforces register controls by requiring opening cash amounts before starting sales operations.

Closing a shift prompts for actual drawer counts, comparing them against expected values to log discrepancies (over/under).

Prints a Z-Report summary detailing payment methods, repair receipts, and register discrepancies before resetting totals.

Step 1: Open the register in the morning by logging the initial starting cash drawer amount.

Step 2: At closing, count the physical drawer cash and input the value.

Step 3: Print the Z-Report and close the register to log any cash discrepancies.

Drawer Rule: Never leave the register open without an active shift, and avoid off-system cash sales.

Connects multiple terminals over a local area network (LAN) without internet access requirements.

The Master station hosts the SQLite database and internal server, while Node stations auto-discover the Master IP via UDP broadcasts.

Security permissions block Nodes from performing administrative tasks like factory resets, backups, and Z-Reports.

Step 1: Configure the main PC as the 'Master' station and connect it to your local network.

Step 2: Launch secondary terminals in 'Node' mode; they will connect to the Master automatically.

Print modes support HTML universal printing, raw ESC/POS commands, and TSPL label printing.

Offset calibration fine-tunes margins (X/Y axis offset) in millimeters for perfect text centering on thermal printers.

Step 1: Navigate to hardware options and configure the port for your thermal or label printer.

Calibration Tip: Use X/Y offset settings in millimeters to center text on thermal printouts.

Protects historical accounting files from modification. The system locks transactions past the configurable editing period.

Frozen records reject edits, deletions, or reversals, preserving historical financial reporting integrity.

Attempts to edit locked files yield a RECORD_LOCKED exception and are blocked.

Step 1: Set the archive seal period (e.g. 7 days) to freeze past sales against editing.

Security Tip: Locking historic records prevents staff from altering past sales and receipts.

The 14-Layer Forensic Matrix scans the database for ledger imbalances, negative stocks, and timestamp manipulation.

IPC Guard maintains a strict whitelist of allowed communication channels, blocking unauthorized system commands.

Step 1: Run Forensic Diagnostics regularly to scan for ledger imbalances or stock discrepancies.

Step 2: The IPC guard filters communication channels to block unauthorized background execution.

The erp_audit_log table registers all business actions. It operates on an append-only basis and cannot be edited.

The security log file tracks hardware/license tamper attempts, invalid PIN codes, and integrity check failures.

Step 1: Access the Audit Trail ledger to review a detailed log of every action taken by staff.

WhatsApp Normalization auto-formats telephone input to include international country codes and supports templates.

Technician commissions are strictly calculated from labor costs, excluding raw hardware/part costs to prevent losses.

Keyboard shortcuts enable swift POS checkout and tab navigation using function keys.

The database schema enforces WAL mode and automatic integrity checkpoints for high concurrency.

Step 1: Set up WhatsApp message templates to send automated ready-for-pickup notifications.

Commission Rule: Staff commissions are strictly calculated from labor fees, excluding hardware costs to prevent shop losses.