Update README.md

Add files via upload
Файл с дополнительной информацией по ходу журналирования работ
2026-04-16 19:27:16 +03:00 · 2026-04-16 19:24:48 +03:00 · 2026-04-12 22:08:43 +03:00
8 changed files with 26 additions and 366 deletions
@@ -1,59 +1,32 @@
-<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
+# Magic 2.0
+Попытка ретроспективно описать этапы разработки проекта Magic 2.0. 
+Изначально проект реализовывался сумбурно, без структурированной фиксации каждой доработки в расчете описать всю историю перед релизом.

-<p align="center">
-<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
-<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
-</p>
+## Ход работ:
+Есть текущая версия Laravel со <u>всеми</u> реализованными фичами (а также с комментариями, тестовыми настройками и прочим мусором). Была развернута голая Laravel, созданы ветки и в них добавлялись скрипты из текущей версии Laravel по принципу реализованных функциональностей. Версии Laravel отличаются, поэтому некоторые конфиги из коробки могут отличаться от конфигов из текущей версии (впрочем, вроде не критично). Также я приложил excel файл (new_magic в ветку master) к репозиторию, в котором перечислил по каким веткам я разбросал файлы, а к некоторым файлам оставил комментарии

-## About Laravel
+Я знаю, что это не лучший способ фиксировать историчность разработки, но выбор был между отсутствием истории и такой историей. Даже если вы не будете использовать мои разработки как основу для Magic 2.0, по крайней мере пробегитесь глазами по архитектуре и почитайте комментарии. Некоторые фичи полность готовы и могут быть перенесены, другие могут сэкономить время хотя бы за счет готового описания 

-Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
+Не забывайте, что в Confulence тоже кое-что из реализованного уже описано

- [Simple, fast routing engine](https://laravel.com/docs/routing).
- [Powerful dependency injection container](https://laravel.com/docs/container).
- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
- [Robust background job processing](https://laravel.com/docs/queues).
- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
+_Заранее извиняюсь за сумбурность и неработоспособность чего-то - можете лишить меня годовой премии_

-Laravel is accessible, powerful, and provides tools required for large, robust applications.
+## Ветки
+Ниже описание некоторых веток. В основном, они называются очевидным образом, но некоторые требуют пояснения
+ all_changes - по сути это текущая версия Magic 2.0 со всеми изменениям
+ master - голая версия Laravel, от которой наследовались все фичевые ветки
+ doubtfull - сомнительная ветка. Не уверен, что скрипты из нее нужны для запуска проекта. Возможно, конфиги, которые в новой версии Laravel не требуются для запуска
+ trash - мусорная ветка. Скрипты отсюда почти наверняка не нужны для работы проекта. Например, тестовые скрипты или пустые скрипты архитектурных сущностей, которыми мы не пользовались (вроде сидеры к ним относятся). В новых версиях ларавель они создаются не из коробки, а при вызове команды на создание сущностей
+ db_tables - набор конфигов sql таблиц и дампов с имеющимися на текущий момент записями
+ ветки, начинающиеся на **front_** или **react_** - предполагаю, что их должен проанализировать фронтендер
+ laravel_core - основные конфиги для запуска проекта

-## Learning Laravel
-
-Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. You can also check out [Laravel Learn](https://laravel.com/learn), where you will be guided through building a modern Laravel application.
-
-If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
-
-## Laravel Sponsors
-
-We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the [Laravel Partners program](https://partners.laravel.com).
-
-### Premium Partners
-
- **[Vehikl](https://vehikl.com)**
- **[Tighten Co.](https://tighten.co)**
- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**
- **[64 Robots](https://64robots.com)**
- **[Curotec](https://www.curotec.com/services/technologies/laravel)**
- **[DevSquad](https://devsquad.com/hire-laravel-developers)**
- **[Redberry](https://redberry.international/laravel-development)**
- **[Active Logic](https://activelogic.com)**
-
-## Contributing
-
-Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
-
-## Code of Conduct
-
-In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
-
-## Security Vulnerabilities
-
-If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
-
-## License
-
-The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
+## Сборка
+Ниже опишу как бы я смотрел все эти изменения
+1. Начать с версии из ветки all_changes - там вся имеющаяся функциональность
+2. Все таблицы из db_tables экспортировать в свою локальную бд
+3. Просмотрел бы верхнеуровнево все core ветки, начиная от конфигов и core функций типа logging 
+4. На голую версия накинул бы ветку laravel_core и doubtfull
+5. Начал бы накидывать постепенно изменения из веток и смотреть как работает платформа. Я постарался в ветках хранить только ту информацию, которая нужна для работы конкреной функциональности, чтобы вы могли изолированно их посмотреть и даже запустить для тестов перед мержем с master. К сожалению у меня не было времени тестить каждую ветку отдельно
+6. В последнюю очередь накинул бы изменения из веток с реализацией страниц: magic_app_menu и taxi-app
+7. Опциально: можно начать удалять скрипты из ветки doubtfull и смотреть работает ли все как надо, чтобы облегчить платформу от ненужных скриптов
@@ -123,11 +123,4 @@ return [
        'store' => env('APP_MAINTENANCE_STORE', 'database'),
    ],

-    //Типы всплывающих уведомлений, использующихся на фронте. От типа зависит внешний вид уведомления и некоторые другие параметры. Прописаны в resources/js/components/MagicPopup.tsx
-    'FRONT_notification_types' => [
-        'info',
-        'success',
-        'error',
-        'attention'
-    ]
 ];
@@ -1,8 +0,0 @@
-#popup-parent-container{
-  padding: 10px;
-  top: 150px;
-  z-index: 901;
-  position: fixed;
-  left: 50%;
-  transform: translate(-50%, -50px);
-}
@@ -1,104 +0,0 @@
-@import url('./../variables.css');
-@import '@fortawesome/fontawesome-free/css/all.css';
-
-/* Анимация таймера popup, по истечению которого он скроется */
-@keyframes popupTimer {
-  from{
-    width: 100%;
-  }
-  to {
-    width: 0;
-  }
-}
-
-.magic-popup-container{
-  padding: 5px;
-  margin-bottom: 15px;
-  border-radius: 5px;
-  display: flex;
-  box-shadow: 0px 3px 4px 1px #918787;
-  background: var(--color_graphite_main);
-  width: 500px;
-  transition: 0.3s;
-  opacity: 0;
-  transform: translateY(-10px);
-
-  &.hide{
-    opacity: 0;
-  }
-
-  &.show{
-    opacity: 1;
-    transform: translateY(0px);
-  }
-
-  &.hidePopup{
-    transform: translateY(10px);
-    opacity: 0;
-  }
-
-  &>.popup__icon-block{
-    flex-basis: 10%;
-    align-self: center;
-
-    &>i{
-      font-size: 4rem;
-      color: var(--color_purple_main);
-
-      &.fa-circle-check{
-        color: var(--color_emerald_main);
-      }
-      &.fa-circle-xmark{
-        color: var(--color_ruby_main);
-      }
-      &.fa-circle-exclamation{
-        color: orange;
-      }
-    }
-  }
-
-  &>.popup__content-block{
-    flex-basis: 90%;
-    border-left: 2px solid white;
-
-    &>.popup__content__text-block{
-      color: white;
-      padding: 5px;
-      text-align: center;
-      font-size: 1.2rem;
-    }
-
-    &>.popup__button-block{
-      margin: 10px 0;
-
-      &>button{
-        font-size: 1rem;
-        margin: auto;
-        opacity: 0.5;
-        background: var(--color_purple_main);
-        transition: 0.3s;
-
-        &:hover{
-          opacity: 1;
-        }
-      }
-    }
-
-    .popup__timer-block__timer{
-
-      &.popup__timer-block__timer {
-        height: 5px;
-        margin: 0 5px;
-        border-radius: 10px;
-
-        &.timerProgress{
-          background: #63707a;
-          animation: popupTimer;
-          animation-duration: 3s;
-          animation-fill-mode: forwards;
-          animation-timing-function: linear;
-        }
-      }
-    }
-  }
-}
@@ -1,108 +0,0 @@
-import React, { useEffect, useState } from "react";
-import './../../css/components/magicPopup.css';
-import { Button } from '@SharePoint/rencredit_uikit';
-
-/**
- * Компонент всплывающего окна
- */
-
-/**
- * Варианты типов для всплывающих окон: info - стандартный вид, error - произошла ошибка, attention - обратить внимание, success - успешное событие
- */
-type PopupType = 'info' | 'success' | 'error' | 'attention';
-
-//Интерфейс для передаваемых пропсов объекта всплывающего окна
-interface MagicPopupProps {
-  key: number,
-  id: number,            //Уникальный идентификатор, по котором всплывающее окно будет в том числе размонтироваться
-  message: string,        //Текст всплывающего окна
-  renderIndex: number,    //Индекс рендеринга компонента. Так как может отрисовываться сразу несколько popup, чтобы корректно их отрисовывать с анимацией с задержкой по времени, нужно передавать индекс компонента в наборе. Передавать "вручную" не нужно, он сам рассчитывается в компоненте MagicPopupContainer
-  type: PopupType,        //Тип всплывающего окна, определяющий его внешний вид
-  timeOut?: boolean,      //Если передается true, для элемента будет запущен стандартный таймер исчезновения. ВАЖНО! для всплывающих окон типа error таймер не будет активироваться, даже если передается. Пользователь должен гарантированно ознакомиться с сообщением и сам его закрыть
-  onClose?: (id: number) => void  //Колбэк для полного размонтирования компонента со страницы
-}
-
-/**
- * Компонент всплывающих окон
- * @param props 
- * @returns 
- */
-export default function MagicPopup (props: MagicPopupProps)
-{
-  //Объект с классами для иконок font-awesome в зависимости от переданного типа всплывающего окна. При изменении, необходимо поменять названия классов в magicPopup.css!
-  const iconNameObj = {
-    info: 'fa-circle-info',
-    success: 'fa-circle-check',
-    error: 'fa-circle-xmark',
-    attention: 'fa-circle-exclamation'
-  }
-  //С помощью деструктуризации указываем значение типа окна по умолчанию
-  const {message, timeOut = true, onClose} = props;
-  //Задержка исчезновения popup
-  const popupDelay = 300;
-  //Итоговая длительность таймера перед закрытием конкретного popup, учитывая его положение в наборе передаваемых попапов
-  const hideTimeOut: number = 3000 + popupDelay;
-  //Стейт для размонтирования попапа
-  const [popupVisible, setPopupVisible] = useState<boolean>(true)
-  //Стейт для плавного сокрытия popup. Класс плавного сокрытия присваивается за пол секунды до полного исчезновения через popupVisible, чтобы сначала плавно сокрыть блок из интерфейса, а затем полностью удалить его из DOM
-  const [popupHideClass, setPopupHideClass] = useState<string>('popup-visible')
-  //Стейт плавного появления popup. Каждый следующий popup в передаваемом наборе должен появляться с небольшой задержкой
-  const [popupShowClass, setPopupFadeinClass] = useState<string>('');
-  //Стейт запуска анимированного таймера исчезновения popup
-  const [popupTimer, setPopupTimer] = useState<string>('');
-  //Функция сокрытия popup. Сначала присваиваем класс, который анимированно скрывает popup, а через небольшую задержку размонтируем компонент
-  function hidePopupBlock (): void 
-  {
-    setPopupHideClass('hidePopup');
-    setTimeout ( () => {
-      setPopupVisible(false);
-    }, 300)
-    //Вызываем метод удаления экземпляра компонента из набора. Так как попапы отрисовываются на основе компонента PopupContainer с набором компонентов MagicPopup, то после их размонтирования, их необходимо и удалить из набора в PopupContainer. Без их удаления, при вызове новых попапов, весь набор с уже просмотренными попапами будет снова отрисовываться.
-    onClose && onClose(props.id)
-  };
-
-  //При рендеринге сразу же запускается таймер сокрытия popup, если аргумент timeOut = true и тип окна != error
-  useEffect( () => {
-    if (timeOut && props.type !== 'error') {
-      setTimeout( () => {
-        //Задержка для отображения таймера нужна, так как при вызове рендеринга нескольких окон, каждое последующее появляется с задержкой. Без задержки ниже, таймер будет запускаться для всех popup одновременно и когда появится последний popup, его таймер уже может закончиться
-        setPopupTimer('timerProgress')
-      }, popupDelay)
-      //Через небольшую задержку после сокрытия компонента срабатывает таймер на размонтирование компонента и удаления его из набора
-      setTimeout( () => {
-        hidePopupBlock()
-      }, hideTimeOut)
-    }
-    //Появление popup при рендеринге
-    setTimeout ( () => {
-      setPopupFadeinClass('show')
-    }, popupDelay)
-  }, [])
-
-  return (
-    popupVisible ? 
-    // <div onClick = {hidePopupBlock}>Раз</div>
-      <div className = {`magic-popup-container ${popupHideClass} ${popupShowClass}`} >
-        <div className = 'popup__icon-block'>
-          <i className = {`fa-solid ${iconNameObj[props.type]}`}></i>
-        </div>
-        <div className = "popup__content-block">
-          <div className = 'popup__content__text-block'>
-            {message}
-          </div>
-          <div className = "popup__button-block">
-            <Button
-              type = "button"
-              className = "popup__button-block__button"
-              onClick = {hidePopupBlock}
-              text = "OK"
-            />
-          </div>
-          <div className = "popup__timer-block">
-            <div className = {`popup__timer-block__timer ${popupTimer}`}></div>
-          </div>
-        </div>
-      </div>
-    : null
-  );
-};
@@ -1,45 +0,0 @@
-import React, { useContext, ComponentProps } from "react";
-import MagicPopup from "./MagicPopup";
-import './../../css/components/magicPopupContainer.css';
-import { PopupContext } from "../contexts/PopupContext";
-
-/**
- * Компонент контейнера для всплывающих окон, который вызывается на странице и куда передается массив всплывающих окон 
- */
-
-//ГАВРИЛОВ. ЛОГИЧНЕЕ ЭКСПОРТИРОВАТЬ ТИП С ПРОПСАМИ КОМПОНЕНТА ИЗ САМОГО КОМПОНЕНТА MAGICPOPUP? 
-/**
- * Дополнительный экспорт типа MagicPopup из компонента всплывающего окна для возможности его импорта, в свою очередь, из компонента, собирающего страницу, например TaxiPage TaxiPage
- */
-export type MagicPopupType = ComponentProps<typeof MagicPopup>;
-/**
- * Метод рендеринга контейнара для всплывающих окон
- * @param {array} magicPopupArr массив объектов типа MagicPopup с информацией о всплывающем окне: текст, таймер и т.д.
- * @param {callable} delHiddenPopupFunc колбэк для закрытия конкретного всплывающего окна по его уникальному идентификатору
- * @returns ReactNode
- */
-export default function MagicPopupContainer ()
-{
-  const popupArr = useContext(PopupContext);
-
-  return (
-    //Родительский контейнер для всех всплывающих окон
-    <div id = "popup-parent-container">
-      {/* { magicPopupArr.map( (propsObj: MagicPopupType, index: number) => ( */}
-      { popupArr.popupArrTest.map( (propsObj: MagicPopupType, index: number) => (
-        <MagicPopup
-          //Подробнее описание пропсов компонента смотри в MagicPopup.tsx
-          id = {propsObj.id}
-          key = {propsObj.id}
-          message = {propsObj.message}
-          timeOut = {propsObj.timeOut}    
-          type = {propsObj.type}          
-          renderIndex = {index}           
-          //onClose = {delHiddenPopupFunc}
-          onClose = {popupArr.delPopupTest}
-        />
-        ))
-      }
-    </div>
-  )
-}
@@ -1,41 +0,0 @@
-import React, { createContext, useState } from "react";
-import { MagicPopupType } from "../components/MagicPopupContainer";
-import MagicPopupContainer from "../components/MagicPopupContainer";
-
-//гаврилов. передай значением по умолчанию null и спроси у ChatGPT (deepseek не справляется) почему при указании null возникает ошибка в аргументе value 
-export const PopupContext = createContext(''); 
-
-/**
- * Контекст для компонента всплывающих окон
- */
-export const PopupProvider = ({ children }) => {
-  const [popupArrTestVar, setPopupArrTestVar] = useState<MagicPopupType[] | []>( [] );
-
-  function addPopupTest (newPopupArrData: MagicPopupType[]) {
-    setPopupArrTestVar(prev => {
-      //Конкатенируем предыдущее состояние набора попапов и новые попапы, присваивая новому попапу параметр id с уникальным рандомным значением
-      return [...prev, ...newPopupArrData].map(popup => popup.id ? popup : {...popup, id: getRandomId()})
-    });
-  };
-
-  //Колбэк для удаления попапа из набора
-  function delPopupTest (popupDelKey: number) {
-    setPopupArrTestVar(prev => {
-      return prev.filter(popup => popup.id !== popupDelKey);
-    });
-  };
-
-  function getRandomId(): number { return Date.now() - Math.random() };
-
-  const value = {
-    popupArrTest: popupArrTestVar,
-    //ГАВРИЛОВ. переименуй
-    addPopupArrTest: addPopupTest,
-    delPopupArrTest: delPopupTest,
-  };
-
-  return <PopupContext.Provider value={value}>
-    {children}
-    <MagicPopupContainer />
-  </PopupContext.Provider>
-}
Author	SHA1	Message	Date
levgav	30f2d4444c	Update README.md	2026-04-16 19:27:16 +03:00
levgav	470a08ba04	Add files via upload Файл с дополнительной информацией по ходу журналирования работ	2026-04-16 19:24:48 +03:00
levgav	4a3751dfce	Update README.md	2026-04-12 22:08:43 +03:00