Compare commits

..

3 Commits

10 changed files with 346 additions and 313 deletions
-7
View File
@@ -123,11 +123,4 @@ return [
'store' => env('APP_MAINTENANCE_STORE', 'database'), '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);
}
+121
View File
@@ -0,0 +1,121 @@
@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;
}
}
}
}
}
}
}
}
-104
View File
@@ -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;
}
}
}
}
}
-108
View File
@@ -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>
)
}
@@ -0,0 +1,120 @@
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
)
: ''
)
}
+97
View File
@@ -0,0 +1,97 @@
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>
}
-41
View File
@@ -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>
}
+8
View File
@@ -0,0 +1,8 @@
<?php
use Illuminate\Support\Facades\Route;
use \App\Http\Controllers;
//Получение истории по сущности приложения
Route::get('{app_name}/history/{subject_id}', [Controllers\AppHistoryController::class, 'getAppHistory']);