feat: risorsa api per la gestione dei token fcm per l'invio di notifiche all'app

Author: Bacca1997

src/API/App/v1/FcmTokens.php

@@ -0,0 +1,97 @@
+<?php
+
+/*
+ * OpenSTAManager: il software gestionale open source per l'assistenza tecnica e la fatturazione
+ * Copyright (C) DevCode s.r.l.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+namespace API\App\v1;
+
+use API\Interfaces\CreateInterface;
+use API\Interfaces\UpdateInterface;
+use API\Resource;
+use API\Response;
+
+/**
+ * Risorsa API per la gestione dei token FCM (Firebase Cloud Messaging) dei dispositivi.
+ * Permette all'app di salvare e aggiornare i token FCM per l'invio di notifiche push.
+ */
+class FcmTokens extends Resource implements CreateInterface, UpdateInterface
+{
+
+    public function create($request)
+    {
+        $database = database();
+        $user = $this->getUser();
+
+        $fcm_token = $request['token'];
+        $platform = $request['platform'] ?? null;
+        $device_info = $request['device_info'] ?? null;
+        $user_id = $user['id'];
+
+        try {
+            // Verifica se esiste già un token per questo utente
+            $existing_token = $database->fetchOne('SELECT * FROM `zz_app_tokens` WHERE `id_user` = :user_id', [
+                ':user_id' => $user_id,
+            ]);
+
+            if ($existing_token) {
+                // Aggiorna il token esistente
+                $database->update('zz_app_tokens', [
+                    'token' => $fcm_token,
+                    'platform' => $platform,
+                    'device_info' => $device_info ? json_encode($device_info) : null,
+                ], ['id' => $existing_token['id']]);
+
+                $token_id = $existing_token['id'];
+            } else {
+                // Crea un nuovo record
+                $database->insert('zz_app_tokens', [
+                    'id_user' => $user_id,
+                    'token' => $fcm_token,
+                    'platform' => $platform,
+                    'device_info' => $device_info ? json_encode($device_info) : null,
+                ]);
+
+                $token_id = $database->lastInsertedID();
+            }
+
+            return [
+                'id' => $token_id
+            ];
+
+        } catch (\Exception $e) {
+            return [
+                'status' => Response::getStatus()['internal_error']['code'],
+                'message' => 'Errore durante il salvataggio del token',
+            ];
+        }
+    }
+
+    /**
+     * Aggiorna un token FCM esistente.
+     *
+     * @param array $request Dati della richiesta
+     *
+     * @return array Risposta dell'operazione
+     */
+    public function update($request)
+    {
+        // Per i token FCM, l'operazione di update è identica a create
+        // poiché gestiamo automaticamente la creazione o l'aggiornamento
+        return $this->create($request);
+    }
+}

update/2_10.sql

@@ -74,6 +74,23 @@ INSERT INTO `zz_settings_lang` (`id_lang`, `id_record`, `title`, `help`) VALUES
 (2, @id_setting, 'Allow attachment insertion in completed activities', '');
 
 -- Risorsa api per la verifica modifica record
+INSERT INTO `zz_api_resources` (`id`, `version`, `type`, `resource`, `class`, `enabled`) 
+VALUES (NULL, 'app-v1', 'retrieve', 'verifica-aggiornamenti', 'API\\App\\v1\\VerificaAggiornamenti', '1');
+
+-- Tabella per la gestione dei token per l'invio di notifiche all'app
+CREATE TABLE `zz_app_tokens` (`id` INT NOT NULL AUTO_INCREMENT , `token` VARCHAR(500) NOT NULL , `id_user` INT NOT NULL , `created_at` TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP , `updated_at` TIMESTAMP on update CURRENT_TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP , PRIMARY KEY (`id`)) ENGINE = InnoDB;
+
+-- Aggiunta colonne specifiche per FCM
+ALTER TABLE `zz_app_tokens` 
+ADD COLUMN `platform` VARCHAR(50) NULL AFTER `token`,
+ADD COLUMN `device_info` TEXT NULL AFTER `platform`;
+
+-- Aggiunta indice per migliorare le performance
+ALTER TABLE `zz_app_tokens` ADD INDEX `idx_user_fcm` (`id_user`, `token`);
+
+-- Registrazione della risorsa API per la gestione dei token FCM
+INSERT INTO `zz_api_resources` (`id`, `version`, `type`, `resource`, `class`, `enabled`) 
+VALUES (NULL, 'app-v1', 'create', 'fcm-tokens', 'API\\App\\v1\\FcmTokens', '1');
 
 INSERT INTO `zz_api_resources` (`id`, `version`, `type`, `resource`, `class`, `enabled`) 
-VALUES (NULL, 'app-v1', 'retrieve', 'verifica-aggiornamenti', 'API\\App\\v1\\VerificaAggiornamenti', '1');
+VALUES (NULL, 'app-v1', 'update', 'fcm-tokens', 'API\\App\\v1\\FcmTokens', '1');