Начало работы с redis, попытки сделать SOLIDно

app/Console/Commands/BaseScheduleCommand.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Базовый класс для описания команд по расписанию
+ * Создан, в частности, чтобы предоставить универсальный функционал для всех команд, запускаемых по расписанию
+ */
+abstract class BaseScheduleCommand extends Command
+{
+    /**
+     * Метод выполнения команды
+     *
+     * @param callable $execFunc функция с логикой выполнения команды
+     * @return void
+     */
+    protected function executeCommand(callable $execFunc): void
+    {
+        try {
+            $execFunc();
+            
+        } catch (\Throwable $th) {
+            $this->logExecErr($th);
+        }
+    }
+
+
+    /**
+     * Метод логирования ошибки выполнения скриптов по расписанию
+     *
+     * @param \Throwable $th
+     * @return void
+     */
+    private function logExecErr(\Throwable $th): void
+    {
+        $context = [
+            //Скрипт откуда запустилась задача
+            'command' => static::class,
+            //Скрипт, в котором произошла ошибка
+            'file' => $th->getFile(),
+            'line' => $th->getLine(),
+        ];
+        \Log::channel('schedule_err')->error($th->getMessage(), $context);
+    }
+}

app/Faceds/RedisNotifications.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Facades;
+
+use Illuminate\Support\Facades\Facade;
+use App\Services\RedisNotificationService;
+
+class RedisNotifications extends Facade
+{
+  protected static function getFacadeAccessor()
+  {
+    return \App\Services\RedisNotificationService::class;
+  }
+}
+

app/Job/BaseJob.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Job;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Базовый класс для выполнения джобы
+ */
+class BaseJob implements ShouldQueue
+{
+
+  use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+  /**
+   * Метод обработки ошибки при выполнении джобы
+   *
+   * @param \Throwable $th
+   * @return void
+   */
+  public function failed(\Throwable $th): void
+  {
+    $context = [
+      //Скрипт откуда запустилась задача
+      'command' => static::class,
+      //Скрипт, в котором произошла ошибка
+      'file' => $th->getFile(),
+      'line' => $th->getLine(),
+  ];
+    \Log::channel('job_err')->error($th->getMessage(), $context);
+  }
+
+}
+

app/Providers/RedisNotificationProvider.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Providers;
+
+use App\Services\RedisNotificationService;
+use Illuminate\Support\ServiceProvider;
+
+/**
+ * Провайдер для работы с сервисом Redis для хранения нотификаций для отображения на фронте 
+ */
+class RedisNotificationProvider extends ServiceProvider
+{
+    /**
+     * Register services.
+     */
+    public function register(): void
+    {
+        $this->app->bind(RedisNotificationService::class, function($app){
+            return new RedisNotificationService;
+        });
+    }
+
+    /**
+     * Bootstrap services.
+     */
+    public function boot(): void
+    {
+        //
+    }
+}

config/cache.php

@@ -74,8 +74,8 @@ return [
 
         'redis' => [
             'driver' => 'redis',
-            'connection' => env('REDIS_CACHE_CONNECTION', 'cache'),
-            'lock_connection' => env('REDIS_CACHE_LOCK_CONNECTION', 'default'),
+            'connection' => 'cache',
+            'lock_connection' => 'default',
         ],
 
         'dynamodb' => [

config/database.php

@@ -138,7 +138,7 @@ return [
     |
     | Redis is an open source, fast, and advanced key-value store that also
     | provides a richer body of commands than a typical key-value system
-    | such as Memcached. You may define your connection settings here.
+    | such as APC or Memcached. Laravel makes it easy to dig right in.
     |
     */
 
@@ -148,8 +148,9 @@ return [
 
         'options' => [
             'cluster' => env('REDIS_CLUSTER', 'redis'),
-            'prefix' => env('REDIS_PREFIX', Str::slug((string) env('APP_NAME', 'laravel')).'-database-'),
-            'persistent' => env('REDIS_PERSISTENT', false),
+            //'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_').'_database_'),
+            //Нижний прочерк нужен, чтобы отделить платформу_модуль от сущность:id:значение. Если после нижнего прочерка ничего нет, значение было установлено из "корня" платформы
+            'prefix' => env('REDIS_PREFIX', 'uknown|'),
         ],
 
         'default' => [
@@ -159,10 +160,6 @@ return [
             'password' => env('REDIS_PASSWORD'),
             'port' => env('REDIS_PORT', '6379'),
             'database' => env('REDIS_DB', '0'),
-            'max_retries' => env('REDIS_MAX_RETRIES', 3),
-            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
-            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
-            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
         ],
 
         'cache' => [
@@ -171,13 +168,26 @@ return [
             'username' => env('REDIS_USERNAME'),
             'password' => env('REDIS_PASSWORD'),
             'port' => env('REDIS_PORT', '6379'),
-            'database' => env('REDIS_CACHE_DB', '1'),
-            'max_retries' => env('REDIS_MAX_RETRIES', 3),
-            'backoff_algorithm' => env('REDIS_BACKOFF_ALGORITHM', 'decorrelated_jitter'),
-            'backoff_base' => env('REDIS_BACKOFF_BASE', 100),
-            'backoff_cap' => env('REDIS_BACKOFF_CAP', 1000),
+            'database' => '1',
         ],
 
+        'queue' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => '2',
+        ],
+
+        'notifications' => [
+            'url' => env('REDIS_URL'),
+            'host' => env('REDIS_HOST', '127.0.0.1'),
+            'username' => env('REDIS_USERNAME'),
+            'password' => env('REDIS_PASSWORD'),
+            'port' => env('REDIS_PORT', '6379'),
+            'database' => '3',
+        ],
     ],
 
 ];

config/queue.php

@@ -7,25 +7,24 @@ return [
     | Default Queue Connection Name
     |--------------------------------------------------------------------------
     |
-    | Laravel's queue supports a variety of backends via a single, unified
-    | API, giving you convenient access to each backend using identical
-    | syntax for each. The default queue connection is defined below.
+    | Laravel's queue API supports an assortment of back-ends via a single
+    | API, giving you convenient access to each back-end using the same
+    | syntax for every one. Here you may define a default connection.
     |
     */
 
-    'default' => env('QUEUE_CONNECTION', 'database'),
+    'default' => env('QUEUE_CONNECTION', 'sync'),
 
     /*
     |--------------------------------------------------------------------------
     | Queue Connections
     |--------------------------------------------------------------------------
     |
-    | Here you may configure the connection options for every queue backend
-    | used by your application. An example configuration is provided for
-    | each backend supported by Laravel. You're also free to add more.
+    | Here you may configure the connection information for each server that
+    | is used by your application. A default configuration has been added
+    | for each back-end shipped with Laravel. You are free to add more.
     |
-    | Drivers: "sync", "database", "beanstalkd", "sqs", "redis",
-    |          "deferred", "background", "failover", "null"
+    | Drivers: "sync", "database", "beanstalkd", "sqs", "redis", "null"
     |
     */
 
@@ -37,18 +36,17 @@ return [
 
         'database' => [
             'driver' => 'database',
-            'connection' => env('DB_QUEUE_CONNECTION'),
-            'table' => env('DB_QUEUE_TABLE', 'jobs'),
-            'queue' => env('DB_QUEUE', 'default'),
-            'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
+            'table' => 'jobs',
+            'queue' => 'default',
+            'retry_after' => 90,
             'after_commit' => false,
         ],
 
         'beanstalkd' => [
             'driver' => 'beanstalkd',
-            'host' => env('BEANSTALKD_QUEUE_HOST', 'localhost'),
-            'queue' => env('BEANSTALKD_QUEUE', 'default'),
-            'retry_after' => (int) env('BEANSTALKD_QUEUE_RETRY_AFTER', 90),
+            'host' => 'localhost',
+            'queue' => 'default',
+            'retry_after' => 90,
             'block_for' => 0,
             'after_commit' => false,
         ],
@@ -64,31 +62,17 @@ return [
             'after_commit' => false,
         ],
 
+        #Гаврилов
+        //ЗАЧЕМ ЭТОТ КОНФИГ? В .ENV НЕТ ПАРАМЕТРА REDIS_QUEUE
         'redis' => [
             'driver' => 'redis',
-            'connection' => env('REDIS_QUEUE_CONNECTION', 'default'),
+            'connection' => 'default',
             'queue' => env('REDIS_QUEUE', 'default'),
-            'retry_after' => (int) env('REDIS_QUEUE_RETRY_AFTER', 90),
+            'retry_after' => 90,
             'block_for' => null,
             'after_commit' => false,
         ],
 
-        'deferred' => [
-            'driver' => 'deferred',
-        ],
-
-        'background' => [
-            'driver' => 'background',
-        ],
-
-        'failover' => [
-            'driver' => 'failover',
-            'connections' => [
-                'database',
-                'deferred',
-            ],
-        ],
-
     ],
 
     /*
@@ -103,7 +87,7 @@ return [
     */
 
     'batching' => [
-        'database' => env('DB_CONNECTION', 'sqlite'),
+        'database' => env('DB_CONNECTION', 'mysql'),
         'table' => 'job_batches',
     ],
 
@@ -113,16 +97,14 @@ return [
     |--------------------------------------------------------------------------
     |
     | These options configure the behavior of failed queue job logging so you
-    | can control how and where failed jobs are stored. Laravel ships with
-    | support for storing failed jobs in a simple file or in a database.
-    |
-    | Supported drivers: "database-uuids", "dynamodb", "file", "null"
+    | can control which database and table are used to store the jobs that
+    | have failed. You may change them to any database / table you wish.
     |
     */
 
     'failed' => [
         'driver' => env('QUEUE_FAILED_DRIVER', 'database-uuids'),
-        'database' => env('DB_CONNECTION', 'sqlite'),
+        'database' => env('DB_CONNECTION', 'mysql'),
         'table' => 'failed_jobs',
     ],
 

resources/css/components/entityHistory.css

@@ -1,121 +0,0 @@
-@import url('./../variables.css');
-
-/* #modal-window__background{
-  position: fixed;
-  display: block;
-  width: 100%;
-  height: 100%;
-  background: #6a6a6ab5;
-  top: 0;
-  z-index: 99;
-} */
-
-.entity-hist-container{
-  position: fixed;
-  width: 50%;
-  top: 10%;
-  left: 25%;
-  z-index: 100;
-  background: white;
-  border-radius: 10px;
-  box-shadow: 0px 0px 15px 1px #9b9999;
-
-  &>.hist__header-block{
-    display: flex;
-      align-items: center;
-      justify-content: space-between;
-    background: var(--color_graphite_main);
-    min-height: 7%;
-    height: auto;
-    border-radius: 10px;
-    color: white;
-    padding: 10px;
-
-    &>.hist__header__buttons{
-
-      &>.header__buttons__close{
-        transform: rotate(45deg);
-        font-size: 2rem;
-        color: var(--color_ruby_main);
-        cursor: pointer;
-      }
-    }
-  }
-
-  &>.hist__content-block{
-    overflow-y: scroll;
-    padding: 10px;
-    max-height: 500px;
-
-    &>.hist-container__date-block{
-      display: flex;
-    
-      &>.date-block__date{
-        flex-basis: 15%;
-
-        &>div{
-          position: sticky;
-          top: 0px;
-          padding: 3px;
-          background: var(--color_purple_main);
-          border-radius: 5px 0 0 5px;
-          color: white;
-        }
-      }
-
-      &>.date-block__changes{
-        flex-basis: 85%;
-        border-left: 2px solid black;
-        padding: 0 10px;
-
-        &>.changes__action-block{
-
-          & .action-block__action-name{
-            padding: 3px;
-            border-radius: 3px;
-            font-size: 1.2rem;
-            /* border-bottom: 3px solid var(--color_purple_main); */
-            background: color-mix(in srgb, var(--color_purple_main) 20%, transparent);
-            box-shadow: 0px 2px 3px 0px #c0bdd3;
-          }
-
-          &:last-child{
-            margin-bottom: 30px;
-          }
-
-          &>.changes__date-time-block{
-            display: flex;
-              justify-content: space-between;
-            margin: 5px 0px 10px 0px;
-            color: rgb(173 173 173);
-          }
-
-          &>.changes__details{
-            margin-bottom: 15px;
-
-            & .changes__details__el{
-              display: flex;
-                justify-content: space-between;
-              margin-bottom: 10px;
-
-              &>.changes__details__el__prop-name{
-                flex-basis: 30%;
-                font-weight: 500;
-              }
-
-              &>.changes__details__el__prop-val{
-                flex-basis: 70%;
-                background: #91919121;
-                border-radius: 5px;
-                padding: 5px;
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-
-} 
-
-

resources/js/components/entityHistory/EntityHistory.tsx

@@ -1,120 +0,0 @@
-
-import React, { useEffect, useMemo, useState, useContext } from "react";
-import { createPortal } from "react-dom";
-import './../../../css/components/entityHistory.css';
-import { HistoryContext } from "../../contexts/HistoryContext";
-
-//Тип с параметрами сущности, история по которой будет выводиться
-export type EntityHistoryProps = { 
-  changeAction: string,   //Совершенное действие: создание, удаление, редактирование, архивирование и т.д.
-  changeAuthor: string,   //Автор изменения: логин, сервисная УЗ 
-  changeDate: Date        //Объект даты изменения. В объекте будет либо время (тогда показываем), либо время будет отсутствовать (тогда не показываем) //что будем передавать? объект new Date или библиотечный объект для работы с датами?
-  changeTime?: string     //Время изменений. Передавать не нужно, на этабе сборки компонента будет формироваться на основе пропса changeDate
-  // changeDetails?: HistoryEntityElDetails[]  //Массив объектов с деталями изменений формата: изменяемое свойство(поле, например) - значение изменяемого свойства
-  changeDetails?: Record<string, string>  //Массив объектов с деталями изменений формата: изменяемое свойство(поле, например) - значение изменяемого свойства
-};
-
-//Тип с деталями изменений
-// type HistoryEntityElDetails = {
-//   propName: string,   //Имя измененного свойства 
-//   propValue: string   //Значение измененного свойства
-// }
-
-//Компонент отображения истории изменений сущности
-export default function EntityHistory ()
-{
-  //ГАВРИЛОВ
-  //ИДЕНТИЧНЫЙ СПРАВОЧНИК УКАЗАН НА СТОРОНЕ ЛАРАВЕЛЬ APP/ENUMS/LOGBUSINESSEVENTS. ЕСТЬ ВОЗМОЖНОСТЬ ОБЪЕДИНИТЬ ИХ?
-  const HistoryActions = {
-    create: 'создание',
-    edit: 'редактирование',
-    archive: 'архивация',
-    restore: 'восстановление',
-    delete: 'удаление',
-    cancel: 'отмена',
-  }
-  const historyContext = useContext(HistoryContext);
-  //Перестраиваем объект с изменениями, группируя их по датам
-  const groupDataByDate = useMemo( () => {
-    let changesByDate = {},
-        historyContent = historyContext.content.length ? historyContext.content : []
-    //Сортируем все изменения от большего к меньшему по дате и времени
-    //ГАВРИЛОВ. или нужно отсортировать от меньшего к большему? мы хотим сверху самые актуальные данные а ниже менее актуальные или наоборот?
-    //ПРОВЕРИТЬ СОРТИРУЕТСЯ ЛИ ПО ДАТАМ
-    historyContent.sort( (a, b) => {return b.changeDate - a.changeDate} )
-    //console.log(historyContext)
-    historyContent.forEach( (changeEl: EntityHistoryProps) => {
-      let dateToString = changeEl.changeDate.toLocaleString('ru-RU').split(',')[0];
-      if ( !(dateToString in changesByDate) ) {
-        changesByDate[dateToString] = [];
-      }
-      changesByDate[dateToString].push(changeEl);
-    });
-
-    return changesByDate;
-  }, [historyContext.content]);
-
-
-  //Сокрытие блока показа истории
-  function hideHistoryBlock(){
-    historyContext.hideHistory()
-  }
-
-  return (
-    historyContext.content && historyContext.visible ?
-      createPortal(
-        <div>
-          <div className="entity-hist-container">
-            <div className="hist__header-block">
-              <div className="hist__header__title">
-                <h3>{ historyContext.headerText.length ? historyContext.headerText : `История изменений запроса ${historyContext.entityId}` }</h3>
-              </div>
-              <div className="hist__header__buttons" onClick={hideHistoryBlock}>
-                <i className="fa fa-plus header__buttons__close"></i>
-              </div>
-            </div>
-            <div className="hist__content-block">
-              {Object.entries(groupDataByDate).map( (dateChanges, dateIndex) => 
-                <div key={dateIndex} className="hist-container__date-block">
-                  <div className="date-block__date">
-                    <div>{ dateChanges[0] }</div>
-                  </div>
-                  <div className="date-block__changes">
-                    { dateChanges[1].map( (changeEl: EntityHistoryProps, elIndex: number) => 
-                      <div className="changes__action-block" key={ elIndex }>
-                        <div className="action-block__action-name">
-                        { HistoryActions[changeEl.changeAction] }
-                        </div>
-                        <div className="changes__date-time-block">
-                          <div>
-                            { changeEl.changeAuthor }
-                          </div>
-                          <div>
-                            { changeEl.changeTime }
-                          </div>
-                        </div>
-                        <div className="changes__details">
-                          {Object.entries(changeEl.changeDetails).map( (detail, detailIndex) => 
-                            <div className="changes__details__el" key={ detailIndex }>
-                              <div className="changes__details__el__prop-name">
-                                { (historyContext.dataFields && historyContext.dataFields[detail[0]]) ? historyContext.dataFields[detail[0]] : detail[0] }
-                              </div>
-                              <div className="changes__details__el__prop-val">
-                                { detail[1] }
-                              </div>
-                            </div>
-                          )}
-                        </div>
-                      </div>
-                    )}
-                  </div>
-                </div>
-              )}
-            </div>
-          </div>
-        </div>,
-      document.body
-    )
-    : ''
-  )
-}

resources/js/contexts/HistoryContext.tsx

@@ -1,97 +0,0 @@
-import React, { createContext, useState, useContext } from "react";
-import EntityHistory, { EntityHistoryProps } from "../components/entityHistory/EntityHistory";
-import api from "../api";
-import { PreloaderContext } from "./PreloaderContext";
-
-//Тип с пропсами для взаимодействия с контекстом
-interface HistoryContextType {
-  visible: boolean,   //Пропс видимости компонента
-  historyDataFields: HistoryDataFields,  //Объект с названиями полей, по которым было совершено изменение. В БД они будут храниться, скорее всего, на латинице, на фронте их надо расшифровать
-  hideHistory: () => void,    //Колбек для сокрытия блока с историей 
-  content: Record<string, string> | null,   //Контент для отображения истории
-  headerText: string,   //Текст в заголовке окна с историей
-  entityId: number,   //Уникальный идентификатор сущности, по которой показываем историю (заявки, запрос и т.д.)
-  showHistory: (entityId: number, content: EntityHistoryProps[], windowHeader?: string) => void,   //Колбек для вызова окна с историей
-  getHistoryFromMagic: (appname: string, subjectId: string | number, historyDataFields: HistoryDataFields, windowHeader?: string) => void //Метод получения истории из приложения Magic
-}
-
-type HistoryDataFields = Record<string, string>;
-
-export const HistoryContext = createContext<HistoryContextType | null>(null);
-
-export const HistoryProvider = ( {children} ) => {
-  const [historyVisible, setHistoryVisible] = useState<boolean>(false);
-  const [historyContent, setHistoryContent] = useState<EntityHistoryProps[] | []>( [] );
-  const [historyWindowHeader, setHistoryWindowHeader] = useState<string>('');
-  const [historyEntityId, setHistoryEntityId] = useState<number>();
-  const [historyDataFields, setHistoryDataFields] = useState<HistoryDataFields | null>( null );
-
-  /**
-   * Сокрытие окна с историей
-   */
-  function hideHistoryBlock() {
-    setHistoryVisible(false);
-    setHistoryWindowHeader('');
-    setHistoryContent( [] );
-    setHistoryEntityId(0);
-  }
-
-  const preloaderContext = useContext(PreloaderContext);
-
-  //ГАВРИЛОВ. ПРАВИЛЬНО ЛИ В КОНТЕКСТЕ РЕАЛИЗОВЫВАТЬ ЛОГИКУ ФУНКЦИОНАЛА? ИЛИ ПРАВИЛЬНЕЕ ЕЕ РАЗМЕСТИТЬ В ФАЙЛЕ КОМПОНЕНТА?
-  async function getHistoryFromMagic(appName: string, subjectId: number | string, historyDataFields: HistoryDataFields, windowHeader?: string){
-    preloaderContext.setPreloaderVisible(true)
-    const appHistory = await api.get(`${appName}/history/${subjectId}`).then(history => history.data.data);
-
-    // console.log(appHistory)
-
-    if (appHistory) {
-      appHistory.forEach( changeData => {
-        changeData.changeDetails = JSON.parse(changeData.changeDetails)
-      });
-      //appHistory.changeDetails = JSON.parse(appHistory.changeDetails)
-    }
-    //ГАВРИЛОВ
-    //ПРОВЕРКА НА НАЛИЧИЕ НУЖНЫХ СВОЙСТВ. ЧТОБЫ ОБЪЕКТ СООТВЕТСТВОВАЛ ТИПУ
-    //УБРАТЬ CHANGE. ПРОСТО AUTHOR,DETAILS и так далее
-    
-    // console.log(appHistory)
-
-    showHistoryBlock(subjectId, appHistory, historyDataFields, windowHeader)
-    
-    // return appHistory;
-  }
-
-  /**
-   * Показываем историю
-   * @param entityId идентификатор бизнес-сущности
-   * @param content контент для отображения
-   * @param windowHeader заголовок для окна с историей
-   */
-  //ГАВРИЛОВ. сделать пропс historyDataFields необязательным (пустой объект по умолчанию), так как details могут не передаваться, тогда и словарь не нужен (В ТОМ ЧИСЛЕ И В МЕТОДЕ getHistoryFromMagic). сделай интерфейс для аргументов идентичным
-  function showHistoryBlock(subjectId: number | string, content: EntityHistoryProps[], historyDataFields: HistoryDataFields, windowHeader?: string){
-    preloaderContext.setPreloaderVisible(true)
-    setHistoryVisible(true);
-    setHistoryEntityId(subjectId);
-    setHistoryContent(content);
-    windowHeader ? setHistoryWindowHeader(windowHeader) : true;
-    historyDataFields ? setHistoryDataFields(historyDataFields) : true;
-    preloaderContext.setPreloaderVisible(false)
-  }
-
-  const value = {
-    getHistoryFromMagic: getHistoryFromMagic,
-    showHistory: showHistoryBlock,
-    hideHistory: hideHistoryBlock,
-    visible: historyVisible,
-    content: historyContent,
-    headerText: historyWindowHeader,
-    entityId: historyEntityId,
-    dataFields: historyDataFields
-  };
-
-  return <HistoryContext.Provider value={value}> 
-    {children}
-    <EntityHistory/>
-  </HistoryContext.Provider>
-}

routes/api.php

@@ -1,8 +0,0 @@
-<?php
-use Illuminate\Support\Facades\Route;
-use \App\Http\Controllers;
-
-
-//Получение истории по сущности приложения
-Route::get('{app_name}/history/{subject_id}', [Controllers\AppHistoryController::class, 'getAppHistory']);
-