Osool Daema Contracting Application

Overview

This is an end-to-end contract and client management system for Alosool Aldaema, a company operating across Saudi Arabia and the United Arab Emirates. It centralises clients, contracts, installments, payments and document generation.

The system has a full admin panel for the operations team and a client portal for customers. Both are bilingual and support workflows that differ by branch and country.

The challenge

The company issues many contracts, each with its own installments, fees and paperwork, under rules that change between branches and countries. Doing this by hand is slow and error-prone. The system needed to calculate amounts correctly, generate every document automatically, track payments, and keep clients informed.

My role

I designed and built the system's back end and admin panel: the calculation engine, document generation, roles and permissions, and the client portal.

Technical challenges

• Rules that vary by place. Ratios, fees and document templates differ by branch and country, so nothing could be hard-coded.
• Accurate calculations. Contract values, installments, VAT, legal fees and other ratios must always add up.
• Many document types. Contracts, sponsorship forms, receipts, bonds and endorsements are all generated from live data, in more than one language.
• Controlled changes. Contracts can be credited or rolled back, so changes need admin-level locking and review.

Outcomes

Contracts, installments and payments now live in one system. Documents are generated automatically from contract data, clients receive SMS updates and can follow their contracts online, and managers can see team activity and contract numbers in reports.

Lessons learned

• Make business rules data, not code, when they change by branch or country.
• PHP 8 enums keep statuses and types clear and reduce repeated code.
• Generated documents save the most time when templates are built from the start.