Documentation — LedgerOS

Introduction

System Philosophy

LedgerOS is an integrated ERP solution designed for Saudi Small and Medium Enterprises (SMEs). It bridges the gap between simple invoicing and complex accounting systems while maintaining full ZATCA Phase 2 compliance.

Integrated

Every action in Sales or Purchases automatically flows into the General Ledger and Inventory — no double entry.

Compliant

Built with Saudi VAT rules and ZATCA Phase 2 requirements in mind from the ground up.

Real-time

Dynamic dashboards and reports reflect your business health the moment a document is approved.

Architecture

Core Technical Stack

Backend — Laravel (PHP)

Robust routing, security middleware, Eloquent ORM, and queued jobs for async processing.

Frontend — Alpine.js & Bootstrap 5

Fast, responsive, mobile-friendly interface with SPA-like interactivity in tables and forms.

Database — MySQL

Relational data management with ACID compliance ensuring financial data integrity.

Compliance — ZATCA Phase 2

UBL 2.1 XML generation, cryptographic signing, CSID onboarding, and real-time clearance APIs.

Design Patterns

Key System Patterns

Modular Table Engine

Most list views use a custom moduleTable Alpine.js component that handles AJAX filtering, pagination, and real-time refresh without full page reloads.

Approval-Based Workflow

Documents (Invoices, Transfers) exist in Draft until Approved. Only approved documents impact financial accounts and inventory levels.

Key Rule: A Draft document has zero financial impact. Always review carefully before approving — approvals trigger ledger entries and stock movements that require a Credit Note to reverse.