Freecoffee – Administration and API for mobile app with Laravel

The Project

The administration platform and its Laravel API described in this article were designed to ensure the smooth operation and management of the Freecoffee mobile application, as well as the PrestaShop sites for managing Freecoffee’s Coffee Point partners and B2B Advertisers, responsible for feeding the application with daily surveys. In this article, we will detail the different facets of this ambitious and innovative project.

Context and Objectives

Freecoffee is an innovative project imagined by our client, centered around a fun mobile application, available on Android and iOS, allowing users to reward through surveys and daily challenges. Rewards are of two types: coffee beans that can be used in the Freecoffee store, and coffees that can be picked up at partner coffee points located throughout France.

Technologies Used

To carry out this project, we chose Laravel 10, a powerful and flexible PHP framework known for its robustness and ability to manage complex applications. Laravel allowed us to develop a robust and secure administration platform capable of meeting Freecoffee’s specific needs.

On this platform, we also developed an extensive and detailed API, available in several versions to track project developments and updates. This API is the heart of communication between the different platforms and the mobile application, ensuring seamless data synchronization and an optimal user experience.

Key Features

1. Laravel Administration Platform:
   • User Management: The platform allows centralized user management, with customizable roles and permissions for each user type (administrators, cafe managers, advertisers, etc.).
   • Dashboard: An intuitive and customizable dashboard provides an overview of the platform’s activities and performance.
   • Content Management: The platform allows the management of dynamic content, such as promotions, announcements, and cafe information.
2. Extensive API:
   • Multiple Versions: The API is available in multiple versions, allowing Forward and backward compatibility, facilitating future updates.
   • Security: The API is secured with robust authentication and authorization mechanisms thanks to Sanctum, ensuring the protection of sensitive data.
   • Cache Management: API calls are cached as often as possible to ensure fast response times, thus improving the user experience while reducing server resource burden.
   • Comprehensive Documentation: Detailed and up-to-date documentation is available for developers, facilitating integration and use of the API.
3. Integration with PrestaShop:
   • Coffee Point Management: The Freecoffee PrestaShop platform allows members of the Freecoffee coffee point network to manage their supply chain, their inventory, and their Freecoffee machine efficiently.
   • Data Synchronization: Integration with PrestaShop ensures real-time data synchronization between the administration platform and the coffee outlets.

Challenges and Solutions

Developing Freecoffee presented several challenges, particularly in terms of integrating different platforms and managing real-time data. However, thanks to the use of Laravel and a well-designed architecture, we were able to overcome these challenges and deliver a robust and high-performance solution.

One of the main challenges was ensuring optimal performance during API calls from the mobile application and the PrestaShop platforms. To achieve this, we have implemented synchronization mechanisms through CRON tasks on the server, and a cache system to ensure the shortest possible response times.