reupload

2026-02-03 15:31:29 +05:00
commit 326c677e8d
2800 changed files with 1489388 additions and 0 deletions
--- a/app/Http/Controllers/Api/System/VersionManagement/AppVersionController.php
+++ b/app/Http/Controllers/Api/System/VersionManagement/AppVersionController.php
@@ -0,0 +1,88 @@
+<?php
+
+namespace App\Http\Controllers\Api\System\VersionManagement;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Api\System\VersionManagement\CheckForUpdateRequest;
+use App\Models\System\VersionManagement\AppVersion;
+use Illuminate\Http\JsonResponse;
+
+class AppVersionController extends Controller
+{
+    /**
+     * Check for app updates
+     * 
+     * This api should be triggered when the app is **launched**, and **current version** and **operating system** should be sent in body. It should check if there is any update available for the app.\
+     * **Handle Response**:\
+     *     *   **Update Required**: If the update is critical/mandatory, show a **blocking modal**. The user cannot dismiss it and must click a button to go to the App Store or Google Play Store.\
+     *     *   **Update Optional**: If a new version is available but not mandatory, show a **dismissible notification** or modal suggesting the user to update for a better experience.\
+     *     *   **Latest Version**: If the app is up-to-date, proceed to the app home screen silently.\
+     *     *   **Version Not Found**: If the version is not recognized (e.g., development build), do not show any update prompts.\
+     */
+    public function checkForUpdate(CheckForUpdateRequest $request): JsonResponse
+    {
+        $app_version = AppVersion::latest()->where('os', $request->os)->first();
+
+        if (! $app_version) {
+            return $this->versionNotFound();
+        }
+
+        if ($request->version === $app_version->version) {
+            return $this->latestVersion($app_version);
+        }
+
+        if ($request->version < $app_version->version && $app_version->important) {
+            return $this->requiredToUpdate($app_version);
+        }
+
+        if ((int) $request->version < (int) $app_version->version) {
+            return $this->optionalToUpdate($app_version);
+        }
+
+        return $this->versionNotFound();
+    }
+
+    /**
+     * Latest version
+     */
+    public function latestVersion(AppVersion $app_version): JsonResponse
+    {
+        return response()->json([
+            'update' => 'latest',
+            'notes' => sprintf('You are using the latest version of the app (%s).', $app_version->version),
+        ]);
+    }
+
+    /**
+     * Required to update
+     */
+    public function requiredToUpdate(AppVersion $app_version): JsonResponse
+    {
+        return response()->json([
+            'update' => 'required',
+            'notes' => sprintf('A critical update is available. Please update to the latest version (%s).', $app_version->version),
+        ]);
+    }
+
+    /**
+     * Update not required, but should be
+     */
+    public function optionalToUpdate(AppVersion $app_version): JsonResponse
+    {
+        return response()->json([
+            'update' => 'optional',
+            'notes' => sprintf('A new version is available. Please update to the latest version (%s).', $app_version->version),
+        ]);
+    }
+
+    /**
+     * App version not found
+     */
+    public function versionNotFound(): JsonResponse
+    {
+        return response()->json([
+            'update' => 'version-not-found',
+            'notes' => 'The version is not recognized (e.g., development build).',
+        ]);
+    }
+}