Osool Daema Contracting Application

Project Overview

This project delivers an end-to-end contract and client management system for Alosool Aldaema, a company operating across Saudi Arabia and the United Arab Emirates. The platform centralizes the management of contracts, clients, installments, payments, and automated document generation, while supporting region-specific workflows for different branches and countries.
Built as a fully dynamic, bilingual system, it provides a robust admin panel and a dedicated client portal, each designed for efficiency, transparency, and operational control.

Admin Panel – Key Modules

The admin system includes a wide range of operational, financial, and configuration modules:

  • Admin Authentication & Profile Management – Secure login, profile editing, password management, and session control.
  • Admins & Roles – Role-based access control with granular permission assignment.
  • Clients Management – Comprehensive control over client details, contracts, installments, notes, payments, and case tracking.
  • Calculator Module – Automated calculation engine for contract and installment percentages, including VAT, legal fees, and additional financial ratios.
  • Contracts Management – Generate dynamic, branch-specific documents (contracts, sponsorship forms, receipts, bond documents, etc.) with editable installments and full contract lifecycle tracking.
  • Contract Credits – Credit/rollback contracts with admin-level locking and review capabilities.
  • Installments Management – Track installment details, due dates, statuses, and progress.
  • Sponsors Module – Add, manage, and monitor sponsor data.
  • Payments Module – Register and track payments linked to approved client contracts.
  • Admin Reports – Monitor admin activity, contract counts, and performance metrics.
  • SMS Notifications – Send automated updates to clients regarding contracts and installments.
  • Client Cases – Add, assign, update, and archive client cases with permission controls.
  • Client Notes – Add and categorize internal notes per client.
  • Branches, Countries & Nationalities – Manage core organizational and location-based data.
  • Case, Note, Notification & Ratio Categories – Create and configure categorization systems for all operational modules.
  • Ratios & Pricing Rules – Manage default and branch-specific financial ratios.
  • Branch Settings – Define and update configuration settings per branch.

 

Client Portal – Key Features

The client-facing panel empowers users to access all essential information related to their accounts:

  • Client Authentication & Profile Management
  • Contract Viewer – Access, track, and download all associated contract documents.
  • Installments Tracking – View schedules, due dates, and installment statuses.
  • Payments Tracking – Review payment history and confirmation details.

Both admin and client portals support multiple languages and dynamic workflows tailored to branch- and country-level rules.

 

Technologies Used

  • Laravel 9
  • PHP
  • MySQL
  • JavaScript (AJAX, jQuery)
  • Bootstrap 5
  • HTML / CSS
  • Git / GitHub

 

Notable Features & Innovations

  • Automated Document Generation for contracts, sponsorship forms, receipts, endorsements, and more.
  • Extensive use of PHP 8 Enums to improve maintainability and reduce code complexity.
  • Fully Multilingual System, supporting region-specific templates and document structures.
  • Highly Dynamic Architecture, enabling efficient scaling with minimal repetitive code.
  • Advanced Role & Permission System tailored to real operational teams and project modules.