входной typescript для фронта с меню приложений magic

app/DTO/ApiResponseDto.php

@@ -1,27 +0,0 @@
-<?php
-
-namespace App\Dto;
-
-class ApiResponseDto
-{
-  public function __construct(
-    public readonly ?string $message = null,
-    // public readonly ?int $statusCode = 200,
-    public readonly mixed $data = null,
-    public readonly mixed $meta = null,
-  )
-  {
-    // return new self($this->message, $this->statusCode, $this->data, $this->meta);
-  }
-
-  // public static function success()
-  // {
-  //   return new self($message, $data, $statusCode = 200);
-  // }
-
-  // public static function error()
-  // {
-  //   return new self($message, $data, $statusCode = 400);
-  // }
-
-}

app/Http/Controllers/MenuController.php

@@ -0,0 +1,133 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+use App\Models;
+
+class MenuController extends Controller
+{
+    public function __construct()
+    {
+        $this->userLogin = 'dgavrilov';
+    }
+
+
+    /**
+     * Получение всех записей из таблицы с приложениями для меню
+     * TODO
+     * передавай флаг isActive и используй его для получения записей с приложениями меню архивных и не архивных
+     * 
+     * @return mixed
+     */
+    public function getApps()
+    {
+        //Приложения старого мэджик из скрипта Config_AD
+        $oldApps = $this->getOldApps();
+        #Гаврилов
+        //НОВЫЕ ПРИЛОЖЕНИЯ НЕ ИСПОЛЬЗУЕШЬ
+        //Приложения нового мэджик из базы данных
+        #Гаврилов
+        //отрисовывать только то, что может видеть пользователь
+        $newApps = Models\MagicApps::get()->toArray();
+        
+        return response()->json($oldApps);
+    }
+
+
+    /**
+     * Метод получает конфиг со старыми приложениями Magic
+     *
+     * @return string
+     */
+    public function getOldApps()
+    {
+        $oldAppConf = json_decode(file_get_contents('http://cs/magic/return_config.AD.php'));
+
+        return $oldAppConf; 
+    }
+
+
+    /**
+     * Метод должен проверить есть ли избранные приложения у пользователя. Если есть, их необходимо обновить либо добавив, либо убрав то приложение, по которому кликнул пользователь. Если избранных приложений нет - вставить новую запись
+     *
+     * @return boolean
+     */
+    public function updateUserFavApp(Request $rqst)
+    {
+        #Гаврилов
+        //ВНИЗУ ИСПОЛЬЗУЕТСЯ ЛОГИН DGAVRILOV, ПЕРЕПИШИ НА ЛОГИН ПОЛЬЗОВАТЕЛЯ MAGIC
+        $userFavApp = $this->getUserFavApp('dgavrilov');
+        $appName = $rqst->all()['appName'];
+        $newFavAppList = null;
+        //Если массив с избранными приложениями пустой - пользователь не добавил ни 1 приложения мэджик в избранное
+        if (!$userFavApp) {
+            $newFavAppList = $appName;
+        } else {
+            $currentFavApp = $userFavApp;
+            if (in_array($appName, $currentFavApp) !== false) {
+                $newFavAppList = implode(';', array_filter($currentFavApp, function($el) use($appName) {return $el !== $appName;}));
+            } else {
+                $newFavAppList = implode(';', array_merge($currentFavApp, [$appName]));
+            }
+        }
+
+        if ($newFavAppList) {
+            #Гаврилов
+            //ПРИ ВЫЗОВЕ ИЗ REACT НЕ ОБНОВЛЯЕТСЯ ПОЛЕ UPDATE_AT
+            $this->insertFavApp($newFavAppList);
+        //Если список приложений пуст - просто удаляем запись с избранными приложениями пользователя
+        } else {
+            $this->delAllUserFavApp('dgavrilov');
+        }
+        return $this->getUserFavApp('dgavrilov');
+    }
+
+    #Гаврилов
+    //try catch для отслеживания ошибок вставки записей в БД?
+
+    /**
+     * Метод вставки новой записи с избранными приложениями
+     *
+     * @return boolean
+     */
+    public function insertFavApp($appName)
+    {
+        Models\UserFavApp::updateOrCreate(
+            ['user_login' => $this->userLogin],
+            ['fav_apps' => $appName]
+        );
+
+        return true;
+    }
+    
+    
+    /**
+     * Метод удаляет запись с избранными приложениями пользователя
+     *
+     * @param string $userLogin логин пользователя
+     * @return boolean
+     */
+    public function delAllUserFavApp($userLogin)
+    {
+        Models\UserFavApp::where('user_login', $userLogin)->delete();
+
+        return true;
+    }
+
+
+    /**
+     * Метод получает избранные приложения пользователя
+     *
+     * @param string $userLogin логин пользователя
+     * @return array
+     */
+    public function getUserFavApp(string $userLogin): array
+    {
+        #Гаврилов
+        //ЗДЕСЬ ВМЕСТО DGAVRILOV ДОЛЖНО БЫТЬ ОБРАЩЕНИЕ К КУКАСАМ, ЧТОБЫ БРАТЬ ЛОГИН ОТТУДА
+        $userFavApp = Models\UserFavApp::where('user_login', $userLogin)->first();
+
+        return $userFavApp ? explode(';', $userFavApp['fav_apps']) : [];
+    }
+}

app/Models/AppRoles.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use App\Models\MagicApps;
+
+class AppRoles extends Model
+{
+    protected $table = 'app_roles';
+    use HasFactory;
+
+    public function magicApp()
+    {
+        return $this->belongsTo(MagicApps::class, 'app_id', 'id');
+    }
+}

app/Models/MagicApps.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use App\Models\AppRoles;
+
+class MagicApps extends Model
+{
+    protected $table = 'magic_apps';
+    use HasFactory;
+
+    public function appRoles()
+    {
+        return $this->hasMany(AppRoles::class, 'app_id', 'id')
+            ->orderBy('role_priority', 'asc');
+    }
+}

app/Models/UserFavApp.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class UserFavApp extends Model
+{
+    use HasFactory;
+
+    public $incrementing = true;
+    public $timestamps = true;
+    protected $table = 'user_fav_app';
+    protected $connection = "mysql";
+    protected $fillable = ['user_login', 'fav_apps'];
+}

app/Providers/ApiResponderProvider.php

@@ -1,27 +0,0 @@
-<?php
-
-namespace App\Providers;
-
-use Illuminate\Support\ServiceProvider;
-use App\Services\ApiResponder;
-
-class ApiResponderProvider extends ServiceProvider
-{
-    /**
-     * Register services.
-     */
-    public function register(): void
-    {
-        $this->app->bind(ApiResponder::class, function($app){
-            return new ApiResponder();
-        }); 
-    }
-
-    /**
-     * Bootstrap services.
-     */
-    public function boot(): void
-    {
-        //
-    }
-}

app/Services/ApiResponder.php

@@ -1,51 +0,0 @@
-<?php
-
-namespace App\Services;
-
-use App\Dto\ApiResponseDto;
-use Illuminate\Http\JsonResponse;
-
-class ApiResponder{
-  public $dto;
-
-
-  public function __construct(
-  )
-  {}
-
-  public function success(): JsonResponse
-  {
-    return $this->buildResponse();
-  }
-
-  public function error()
-  {
-    return $this->buildResponse(); 
-  }
-
-  public function setDto(ApiResponseDto $dto)
-  {
-    $this->dto = $dto;
-  }
-
-  // public function fromDTO(ApiResponseDto $dto)
-  // {
-  //   return $dto;
-  // }
-
-  #Гаврилов
-  //СБОР СТАТИСТИКИ ПО ВЫЗЫВАЕМЫМ API ЕНДПОИНТАМ. ВНЕСТИ В TODO ПРОЕКТА
-  private function setStatistics()
-  {
-  }
-
-#Гаврилов
-//ДОБАВЬ ЛОГИРОВАНИЕ ОШИБОК В TRY CATCH В .LOG ФАЙЛ
-
-  private function buildResponse(): JsonResponse
-  {
-    //echo '<pre>'; var_dump((array)$this->dto); echo'</pre>';
-    //return (array) $this->dto;
-    return response()->json((array) $this->dto);
-  }
-}

database/tables_for_magic2.0/app_roles.sql

@@ -0,0 +1,13 @@
+-- custom.app_roles definition
+
+CREATE TABLE `app_roles` (
+  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+  `app_id` bigint(20) unsigned NOT NULL COMMENT 'id приложения (связь с таблицей magic_apps)',
+  `app_role` text COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'Роль в приложении',
+  `app_title` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'Название роли на русском',
+  `role_priority` smallint(6) NOT NULL COMMENT 'Приоритет роли',
+  `role_access` text COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'Кому доступна роль (зависит от драйвера в magic_apps)',
+  PRIMARY KEY (`id`),
+  KEY `app_roles_app_id_foreign` (`app_id`),
+  CONSTRAINT `app_roles_app_id_foreign` FOREIGN KEY (`app_id`) REFERENCES `magic_apps` (`id`)
+) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='Ролевая модель приложений';

database/tables_for_magic2.0/app_roles_202602271730.sql

@@ -0,0 +1,3 @@
+INSERT INTO custom.app_roles (app_id,app_role,app_title,role_priority,role_access) VALUES
+	 (4,'admin','Администратор',1,'# Magic_admins'),
+	 (4,'user','Пользователь',2,'# Test');

database/tables_for_magic2.0/magic_apps.sql

@@ -0,0 +1,13 @@
+-- custom.magic_apps definition
+
+CREATE TABLE `magic_apps` (
+  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+  `app_name` varchar(100) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'Имя приложения',
+  `app_title` varchar(255) COLLATE utf8mb4_unicode_ci NOT NULL COMMENT 'Название приложения на русском',
+  `app_link` varchar(150) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `role_driver` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'Драйвер определения ролей: по группам AD, по почтовым рассылкам, по логинам. NULL, если ролевая модель не предусмотрена',
+  `access_groups_email` varchar(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'Доступ к приложениям по почтовым рассылкам',
+  `access_groups_ad` text COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT 'Доступ к приложениям по группам AD',
+  `is_active` tinyint(4) NOT NULL DEFAULT 1 COMMENT 'Активно ли приложение',
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

database/tables_for_magic2.0/magic_apps_202602271731.sql

@@ -0,0 +1,5 @@
+INSERT INTO custom.magic_apps (app_name,app_title,app_link,role_driver,access_groups_email,access_groups_ad,is_active) VALUES
+	 ('Test','','test.index',NULL,NULL,'CTXAL.CryptoPRO',1),
+	 ('About','','about',NULL,NULL,'CTXAL.CryptoPRO',1),
+	 ('Test create','','test.create',NULL,NULL,'CTXAL.CryptoPRO',1),
+	 ('taxi','Реестр заказа такси','test','email','# Magic_admins',NULL,1);

database/tables_for_magic2.0/user_fav_app.sql

@@ -0,0 +1,10 @@
+-- custom.user_fav_app definition
+
+CREATE TABLE `user_fav_app` (
+  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+  `created_at` timestamp NULL DEFAULT NULL,
+  `updated_at` timestamp NULL DEFAULT NULL,
+  `user_login` varchar(50) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `fav_apps` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB AUTO_INCREMENT=11 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='Избранные приложения пользователя из меню Magic';

database/tables_for_magic2.0/user_fav_app_202602271736.sql

@@ -0,0 +1,2 @@
+INSERT INTO custom.user_fav_app (created_at,updated_at,user_login,fav_apps) VALUES
+	 ('2025-03-28 18:16:10','2025-11-14 10:35:04','dgavrilov','reestr_send_app;dadata;amlpor;accext;prlog;anketa;pilotIVI;limcut;nsr;minjust;mcocardreporting;taxi');

resources/css/app.css

@@ -1,11 +1,189 @@
-@import 'tailwindcss';
+/* ГАВРИЛОВ. ВЫЯСНИТЬ, ГДЕ ИСПОЛЬЗУЮТСЯ */
 
-@source '../../vendor/laravel/framework/src/Illuminate/Pagination/resources/views/*.blade.php';
-@source '../../storage/framework/views/*.php';
-@source '../**/*.blade.php';
-@source '../**/*.js';
-
-@theme {
-    --font-sans: 'Instrument Sans', ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
-        'Segoe UI Symbol', 'Noto Color Emoji';
+html {
+  overflow-y: scroll;
+}
+
+#root{
+  --color_ruby: #ff0078;
+}
+
+.container {
+  background-color: lightblue;
+  padding: 20px;
+}
+
+#menu-container{
+  display: flex;
+
+  &>#menu__left-block{
+    flex-basis: 15%;
+
+    &>.menu__left-block__call-app{
+      display: flex;
+
+      &>.fa{
+        flex-basis: 20%;
+      }
+    }
+  }
+}
+
+.switcher-container{
+  position: fixed;
+  top: 0;
+  right: 0;
+  display: flex;
+    justify-content: flex-end;
+    align-items: center;
+  
+  &>.switch {
+    position: relative;
+    display: inline-block;
+    width: 60px;
+    height: 34px;
+    margin: 9px;
+  
+    &>.switcher__favorite-app { 
+      opacity: 0;
+      width: 0;
+      height: 0;
+
+      &.showFav + .slider{
+        background-color: var(--color_ruby);
+
+        &:before{
+          transform: translateX(26px);
+          color: var(--color_ruby);
+          padding: 2px 0 0 0;
+          align-content: baseline;
+        }
+      }
+    }
+
+    &>.slider {
+      position: absolute;
+      cursor: pointer;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background-color: #ccc;
+      -webkit-transition: .4s;
+      transition: .4s cubic-bezier(0,1,0.5,1);
+      border-radius: 4px;
+    
+      @import url('https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css');
+      &:before {
+        position: absolute;
+        content: "\f006";
+        font-family: FontAwesome;
+        text-align: center;
+        font-size: 1.2rem;
+        height: 26px;
+        width: 26px;
+        left: 4px;
+        bottom: 4px;
+        background-color: white;
+        -webkit-transition: .4s;
+        transition: .4s cubic-bezier(0,1,0.5,1);
+        border-radius: 3px;
+      }
+
+      &.round {
+        border-radius: 34px;
+      
+        &:before {
+          border-radius: 50%;
+        }
+      }
+    }
+  }
+}
+
+
+
+
+.switcher__favorite-app.showFav + .slider {
+  background-color: var(--color_ruby);
+}
+.switcher__favorite-app.showFav + .slider:before {
+  transform: translateX(26px);
+}
+/* Rounded sliders */
+/* .slider.round {
+  border-radius: 34px;
+
+  &:before {
+    border-radius: 50%;
+  }
+} */
+
+#round {
+  border-radius: 34px;
+
+  &:before {
+    border-radius: 50%;
+  }  
+}
+
+#menu__app-container__app-block{
+  /* display: grid;
+    grid-template-columns: 50% 50%; */
+  column-count: 2;
+
+  >.apps-block__proc{
+    margin-bottom: 20px;
+
+    >.proc__title{
+      font-size: 1.1rem;
+      padding: 10px 0;
+      font-weight: 600;
+    }
+
+    >.proc__title.proc-hide{
+      display: none;
+    }
+  }
+
+  .script-list__el{
+    display: flex;
+
+    >.script-list__el__script-name{
+      margin-bottom: 5px;
+      transition: 0.2s;
+      &:hover{
+        transform: translateY(-1px);
+      }
+
+      >a{
+        text-decoration: none;
+        color: black;
+        
+        &:hover{
+          color: var(--color_ruby);
+        }
+      }
+    }
+
+    >.fa-star{
+      margin-left: 5px;
+      cursor: pointer;
+      opacity: 0.2;
+      transition: 0.3s;
+    }
+
+    >.fa-star:hover{
+      opacity: 1;
+    }
+
+    >.fa-star.favorite{
+      opacity: 1;
+      color: var(--color_ruby);
+    }
+  }
+
+  .script-list__el.script-hide{
+    display: none;
+  }
 }

resources/js/app.tsx

@@ -0,0 +1,14 @@
+import { createRoot } from 'react-dom/client';
+import '@SharePoint/rencredit_uikit/dist/static/fonts/mont/Mont.css';
+import '@fortawesome/fontawesome-free/css/all.css';
+import { UIKitThemeProvider } from '@SharePoint/rencredit_uikit';
+import MenuApp from './components/MenuApp.tsx'; // Создайте этот файл, если используете React
+import React from 'react';
+
+const container:HTMLElement = document.getElementById('root')!;
+const root = createRoot(container);
+root.render(
+  <UIKitThemeProvider>
+    <MenuApp />
+  </UIKitThemeProvider>
+);

resources/js/components/MenuApp.tsx

@@ -0,0 +1,231 @@
+import { Button } from '@SharePoint/rencredit_uikit';
+import React, { useEffect, useState } from "react";
+
+function MenuApp ()
+{
+  //Приложения и процессы Magic для отображения в меню
+  const [menuApps, setMenuApps] = useState<{
+    'proccesses': object,
+    'scripts': object
+  }>({
+    'proccesses': {},
+    'scripts': {}
+  });
+  //TODO
+  //ВНЕДРИ В КОНТРОЛЛЕРЕ ПРОВЕРКУ ДОСТУПОВ, А НЕ ВОЗВРАЩАЙ ВСЕ ПОДРЯД ПРИЛОЖЕНИЯ
+  //Избранные приложения пользователя
+  const [favApps, setFavApps] = useState<string[]>([]);
+  //Массив избраннных процессов, в приложениях которых есть хотя бы одно избранное
+  const [favProcs, setFavProcs] = useState<string[]>([]);
+  //Состояния видимости скрипта
+  const [hideScriptClass, setHideScriptClass] = useState('');
+  //const [sanctumToken, setSanctumToken] = useState('');
+
+  const sanctumToken = () => {
+    const metaTag = document.getElementById('sanctum_token_block') as HTMLMetaElement;
+    return metaTag.dataset.token;
+  }
+
+  //Получаем при рендере страницы все приложения Magic и все избранные приложения пользователя
+  useEffect( () => {
+    Promise.all(
+      [
+        fetch('api/magic_apps').then(menuAppsRes => menuAppsRes.json()),
+        //TODO
+        //СЮДА ПОТЯГИВАЙ ЛОГИН ПОЛЬЗОВАТЕЛЯ, А НЕ DGAVRILOV
+        fetch('api/user_fav_app/dgavrilov').then(favAppsRes => favAppsRes.json())
+      ]
+    ).then(
+      ([
+        responseMenuApp,
+        responseFavApp
+      ]) => {
+        setMenuApps(responseMenuApp);
+        setFavApps(responseFavApp);
+      }
+    )
+  }, []);
+
+
+  //Обновление видимости процесса (собрания приложений) в зависимости от того находится ли в избранном хотя бы одно приложение
+  useEffect( () => {
+    if (menuApps === null) { return }
+    //Массив с процессами, в которых есть хотя бы одно избранное приложение
+    const favProcsArr:string[] = [];
+    //Мы собираем все избранные приложения в массив-состояние, чтобы при изменении состояния каждого приложения (например при переключении switcher) проверять входит ли это приложение в избранные. Если входит - его родительский процесс не прячем, так как в его дочерних приложениях есть избранные
+    Object.entries(menuApps.proccesses).forEach( (procData) => {
+      //Флаг - есть ли в приложениях процесса хотя бы 1 избранное
+      const hasFavorite: boolean = procData[1].tabs.split(';').some( (tab: string) => {
+        return favApps.includes(tab);
+      })
+      if (hideScriptClass !== 'script-hide' || hasFavorite) {
+        favProcsArr.push(procData[0]);
+      }
+    })
+    setFavProcs(favProcsArr);
+  }, [hideScriptClass, menuApps, favApps]);
+
+  //console.log(sanctumToken())
+
+  //ГАВРИЛОВ
+  //ПОЧЕМУ КОД НИЖЕ ИСПОЛНЯЕТСЯ ПОСТОЯННО ПОКА НЕ БУДЕТ ПОЛУЧЕН КОНТЕНТ ДЛЯ СТРАНИЦЫ ИЗ ПРОМИСОВ ВЫШЕ, А НЕ ОТРАБАТЫВАЕТ ТОЛЬКО ПРИ РЕНДЕРИНГЕ СТРАНИЦЫ
+  //Уместно ли отслеживать состояние до получения запросов fetch в подобном виде?
+  if (menuApps === null || favApps === null) {
+    return <span>прелоадер</span>
+  } else {
+    return (
+      <div id = 'menu-container'>
+        <div id = 'menu__left-block'>
+          <div className = 'menu__left-block__call-app'>
+            <i className = 'fa fa-th-large'></i>
+            <div className = 'mleft-block__call-app__title'>Приложения</div>
+          </div>
+        </div>
+        <div id = 'menu__app-container'>
+          <Button text='Текст' />
+          <div id = 'menu__app-container__app-block'>
+            {/* {console.log(menuApps.scripts)} */}
+              {Object.entries(menuApps.proccesses).map( (proc_val, proc_index) => (
+                <div className = "apps-block__proc" key = { proc_index } data-proc = {proc_val[0]}>
+                  {/* В зависимости от того входит процесс в массив избранных делаем его видимым или скрываем */}
+                  <div className = {`proc__title ${favProcs.includes(proc_val[0]) ? 'proc-visible' : 'proc-hide'}`}>{proc_val[1].title}</div>
+                  <div className = "proc__script-list">
+                    {proc_val[1].tabs.split(';').map( (app_el, app_index) => (
+                      <AppElem 
+                        appIndex = { app_index }
+                        appName = { app_el }
+                        appTitle = { menuApps.scripts[app_el]?.title || "Неизвестный скрипт - " + app_el }
+                        appUrl = { menuApps.scripts[app_el]?.url }
+                        favIconClassName = { favApps.includes(app_el) ? 'favorite' : 'not_favorite' }
+                        hideAppClass = { hideScriptClass }
+                        //Функция обновления актуальный список избранных приложений
+                        setUpdateFavApps = { (newFavApp) => setFavApps(newFavApp) }
+                      />
+                    ))}
+                  </div>
+                </div>
+              )) }
+          </div>
+          <Switcher 
+            toggleAppsVisible = { setHideScriptClass }
+            switcherId = "switcher-menu"
+          />
+        </div>
+      </div>
+    )
+  }
+}
+
+
+//Гаврилов
+//ПЕРЕПИСАТЬ АРГУМЕНТЫ ПОД ОБЪЕКТ СО СВОЙСТВАМИ, ИСПОЛЬЗОВАТЬ ...obj
+/**
+ * 
+ * @param {int} appIndex ключ для экземлпяра компонента 
+ * @param {string} appName уникальное имя скрипта 
+ * @param {string} appTitle название скрипта в меню 
+ * @param {string} favIconClassName класс для иконки избранного
+ * @param {string} hideAppClass класс для видимости приложения
+ * @param {string} setUpdateFavApps функция для обновления состояния избранны приложений (при снятия, установки признака избранности)
+ * @returns 
+ */
+function AppElem({ 
+  appIndex, 
+  appName, 
+  appTitle, 
+  appUrl, 
+  favIconClassName, 
+  hideAppClass, 
+  setUpdateFavApps 
+} : {
+  appIndex: string, 
+  appName: string, 
+  appTitle: string, 
+  appUrl: string, 
+  favIconClassName: string, 
+  hideAppClass: string, 
+  setUpdateFavApps: string
+}) {
+  const [appElemClass, changeFav] = useState(favIconClassName);
+  const callChangeFav = ( changeAppName: string ) => {
+    fetch('api/user_fav_app', {
+        method: 'post',
+        body: JSON.stringify({ appName: changeAppName }),
+        headers: {
+          'content-type': 'application/json'
+        }
+      }
+    )
+    .then( (response) => response.json() )
+    .then( (response) => {
+      //Если скрипт был избранным - удаляем из избранного и наоборот
+      appElemClass == 'favorite' ? changeFav('not_favorite') : changeFav('favorite');
+      //Возвращаем обновленный список избранных приложений пользователя
+      setUpdateFavApps(response?.fav_apps?.split( ';' ) || [])
+    } )
+  }
+  
+  return (
+    //Если приложение в избранном - оно всегда должно быть "видимо", даже если переключатель в положении Скрыть неизбранные приложения
+    <div key = { appIndex } className = {`script-list__el ${appElemClass == 'favorite' ? '' : hideAppClass}`} data-scriptname = { appName }>
+      <div className = "script-list__el__script-name"><a target="_blank" href={ appUrl }>{ appTitle }</a></div>
+      {/* Анонимная функция нужна для создания функции смены состояния для каждого компонента в отдельности, в противном случае вызов функции в одном экземпляре компонента вызывает функцию изменения для каждого экземпляра компонента */}
+      <i className = {`${(appElemClass == 'favorite' ? 'fas' : 'far')} fa-star ${appElemClass}`} onClick = { () => callChangeFav(appName) }></i>
+    </div>
+  )
+}
+
+
+//TODO
+//ВЫНЕСИ В ПАПКУ COMPONENTS/MAIN
+/**
+ * Компонент переключателя В ДАННОМ СЛУЧАЕ видимости скриптов (видны только избранные или все)
+ * @param {string} switcherId идентификатор переключателя (для стилей css), так как в будущем, на странице можно будет размещать несколько переключателей
+ * @param {function} toggleAppsVisible функция обновления состояния hideScriptClass
+ * @returns 
+ */
+function Switcher({ switcherId, toggleAppsVisible }) {
+  const [favSwitcherClass, setFavSwitcherClass] = useState('showAll');
+
+  //Переключение состояния переключателя после рендеринга страницы
+  useEffect( () => {
+    //Получаем из локал сторадж состояние переключателя
+    const savedState = localStorage.getItem('magicMenuFavSwitcher');
+    if (savedState) {
+      setFavSwitcherClass(savedState);
+    }
+  }, []);
+
+  //При изменении состояния Переключателя изменяется состояние всех приложени (переключается их видимость в зависимости от состояния переключателя - только избранные или все)
+  useEffect( () => {
+    //Синхронизируем зависимые компоненты
+    toggleAppsVisible(favSwitcherClass === 'showFav' ? 'script-hide' : '');
+  }, [favSwitcherClass] );
+
+  const callToggleFavSwitcher = () => {
+    let switcherState = (favSwitcherClass === 'showFav' ? 'showAll' : 'showFav');
+    //favSwitcherClass => favSwitcherClass = ... - функциональное обновление. Здесь оно не особо нужно, но чтобы не забыть
+    //Меняем класс switcher, а также меняем состояние видимости всех приложений (в зависимости от того избранные они или нет)
+    setFavSwitcherClass( favSwitcherClass => {
+      if (favSwitcherClass === 'showFav') {
+        toggleAppsVisible('script-hide')
+      } else {
+        toggleAppsVisible('')
+      }
+      localStorage.setItem('magicMenuFavSwitcher', switcherState)
+
+      return switcherState;
+    } )
+  }
+
+  return (
+    <div id = { switcherId } className = "switcher-container">
+      <label className = "switch">
+        <input type = "checkbox" className = {`switcher__favorite-app ${favSwitcherClass}`} onChange = { callToggleFavSwitcher }/>
+        <span className = "slider round"></span>
+      </label>
+    </div>
+  )
+}
+
+export default MenuApp;

resources/views/menu_start.blade.php

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Laravel + React</title>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
+    <!-- Без команды ниже корректно не обрабатывается React скрипт -->
+    @viteReactRefresh
+    @vite(['resources/css/app.css', 'resources/js/app.jsx'])
+    <!-- Отрисовываем meta-тег с sanctum-токеном, чтобы на фронте его могли получить и передавать при api  -->
+    <meta id="sanctum_token_block" data-token="{{ session('sanctum-token') ?? '' }}"/>
+</head>
+<body>
+    <div id="root"></div>
+</body>
+</html>

routes/api.php

@@ -0,0 +1,23 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use \App\Http\Controllers;
+
+
+#Гаврилов
+//НАВЕРНОЕ, НУЖНО ВСЕ ТАКИ СГРУППИРОВАТЬ API РОУТЫ НИЖЕ В ГРУППУ /api/MENU/endpoint
+/**
+ * Получение всех приложений Magic
+ * todo
+ * возвращать только приложения, доступные согласно роли
+ */
+Route::get('magic_apps', [Controllers\MenuController::class, 'getApps']);
+/**
+ * Получение избранных приложений
+ * {userLogin} - логин пользователя, чьи приложения необходимо вернуть
+ */
+Route::get('user_fav_app/{userLogin}', [Controllers\MenuController::class, 'getUserFavApp']);
+/**
+ * Обновление избранных приложений
+ */
+Route::post('user_fav_app', [Controllers\MenuController::class, 'updateUserFavApp']);

routes/web.php

@@ -5,3 +5,6 @@ use Illuminate\Support\Facades\Route;
 Route::get('/', function () {
     return view('welcome');
 });
+Route::get('/menu', function () {
+    return view('menu_start');
+})->name('magic_menu');