Socar

The Loyalty Program Management System and Mobile App backend required deep integration with SOCAR’s core systems.

We kicked off the project with comprehensive workshops and interviews with SOCAR stakeholders to define clear requirements. These sessions allowed us to map out all necessary services and API endpoints for integration, ensuring compatibility with SOCAR’s existing infrastructure.

Charting user flows helped us pinpoint integration points and identify where adjustments or new endpoints were needed to meet the project’s requirements. This groundwork set the stage for smooth communication between the app and SOCAR’s systems.

With requirements defined, we moved into system architecture design.

For loyalty program management, we developed a Filament-based interface tailored to SOCAR’s business needs. To handle the complex business logic and ensure secure communication with SOCAR’s core systems, we built an intermediary service layer. This layer aggregates data from SOCAR’s internal services and securely makes it available to the app.

A key milestone was enabling communication with gas station fuel dispensers, allowing fueling sessions to be initiated through the app. For streamlined API communication, we utilized Saloon, a PHP library that treats each API request as an object, ensuring clean and maintainable code.

The backend, built with Laravel and Filament, powers the mobile app and SOCAR’s Loyalty Program Management System. Filament provided a streamlined way to create the admin panel, ensuring an intuitive interface for SOCAR’s marketing team to manage loyalty campaigns and customer data.

We developed a comprehensive API for the mobile app and additional services for loyalty program and payment method management. These APIs are now utilized across SOCAR’s ecosystem, supporting other web platforms beyond the app.

Our development process followed best practices, using Laravel Pint for linting, PHPStan for static analysis, and Pest for testing. API documentation was generated using Laravel Request Doc, ensuring clear and accessible documentation for future integrations.

The SOCAR mobile app was built using React Native, providing a seamless cross-platform experience that balances performance and user experience. To manage the app’s complex state requirements, we integrated Redux Toolkit, ensuring efficient and scalable state management across various features.

For improved development efficiency and error reduction, the app was developed in Typescript, offering robust type safety and enhancing code readability. To streamline form interactions, we utilized Formik, which simplified the handling of user inputs and validation processes. Additionally, we created a React Native version of Laravel Precognition, enabling efficient and real-time validation of form data directly in the app.

The entire build and deployment process was fully automated, ensuring smooth and consistent releases across all environments.

Our infrastructure was built using an Infrastructure as Code approach with CloudFormation, Ansible, Docker, and AWS ECS. We also utilized AWS services like S3 and Elasticache for storage and caching needs.

We established CI/CD pipelines powered by GitHub Actions, automating the build, test, and deployment processes for both the backend and mobile app. These pipelines spanned four environments: development, staging, pre-release, and production.

Integrations with Slack and Jira streamlined communication, with automated notifications for successful deployments and environment updates.