Vesp 3.0

Vesp/Core

abstract class ModelController extends Controller
{
    /** @var string $model */
    protected $model;
    protected $primaryKey = 'id';
    protected $maxLimit = 1000;

abstract class ModelController extends Controller
{
    protected string $model;
    protected string|array $primaryKey = 'id';
    protected int $maxLimit = 1000;

class MyController extends Controller
{
    public function __invoke(RequestInterface $request, ResponseInterface $response): ResponseInterface
    {
        // Выставление $this->request, $this->response, $this->route, $this->user 
        // и свойств, доступных через $this->getProperties()
        $this->initController($request, $response);

        // Дальше ваша особенная логика
    }
}

git clone https://github.com/bezumkin/vesp-core.git
cd ./vesp-core
docker-compose up

@Vesp/Frontend

• Vue 3
• Nuxt 3
• Typescript
• Bootstrap 5 SCSS
• Bootstrap Vue Next
• Pinia вместо Vuex
• Vue Toastification для всплывающих уведомлений

@import 'bootstrap-scss/bootstrap';
@import '@vesp/frontend/assets/components';
@import '@vesp/frontend/assets/toast';
@import '@fortawesome/fontawesome-svg-core/styles.css';

• vesp-table - компонент для вывода таблиц админки
• vesp-modal - модалка с поддержкой отправки форм и обновления соответствующей таблицы
• vesp-fa - иконки FontAwesome
• vesp-change-locale - компонент для переключения языка
• vesp-input-alias - компонент для ввода адресов страниц, использует slugify
• vesp-input-combo-box - ввод с автодополнением через запросы к API
• vesp-input-date-picker - ввод даты или диапазона дат, использует vue-datepicker-next
• vesp-input-password - ввод пароля с кнопочкой "показать\скрыть"
• vesp-input-remote-links - ввод JSON массива "название сервиса-адрес", например для ссылок на соцсети
• vesp-input-text-mask - ввод телефонов или других данных по маске, использует text-mask-core

• useGet, usePost, usePut, usePatch, useDelete - простые запросы в API с поддержкой авторизации и безо всяких наворотов, вроде сохранения состояния и кэширования.
• useApi - тоже самое, но с возможностью более тонкого указания параметров - функции выше используют эту функцию внутри себя
• useCustomFetch - а это как раз запрос в API со всеми наворотами, плюс поддержка авторизации. Подробнее читать в документации Nuxt

try {
  const data = await useGet('user/profile')
  console.log(data)
} catch (e) {
  console.error(e)
}

const {loggedIn, token, user, login, logout, loadUser, setToken} = useAuth()

console.log(loggedIn.value, user.value, token.value)

• loggedIn - computed переменная со статусом авторизации, внутри true или false.
• token - ref на куку с токеном, может быть строкой или undefined.
• user - ref на юзера, может быть объектом типа VespUser или undefined.

• login(username, password) - авторизация
• logout() - выход и удаление токена на сервере
• loadUser() - загрузка профиля с сервера
• setToken(string) - выставление нового токена в куку авторизации

<template>
  <div v-if="loggedIn">
    <pre>{{ user }}</pre>
    <b-button @click="() => logout()">Logout</b-button>
  </div>
  <div v-else>
    <b-form @submit.prevent="onSubmit">
      <b-form-group label="Username">
        <b-form-input v-model="form.username" required />
      </b-form-group>
      <b-form-group label="Password">
        <vesp-input-password v-model="form.password" required />
      </b-form-group>

      <b-button type="submit">Submit</b-button>
    </b-form>
  </div>
</template>

<script setup lang="ts">
const {loggedIn, user, login, logout} = useAuth()
const form = ref({username: '', password: ''})

async function onSubmit() {
  try {
    await login(form.value.username, form.value.password)
    form.value = {username: '', password: ''}
  } catch (e) {
    console.error(e)
  }
}
</script>

• useToastInfo(message, options)
• useToastSuccess(message, options)
• useToastError(message, options)
• useToastsClear() - убирает выведенные сообщения

• getApiUrl() - определяет базовый адрес для запроса в API
• getImageLink(VespFile, VespFileOptions) - формирует ссылку на вывод картинки из API, принимает переменные указанных типов
• hasScope(permission) - проверяет, есть ли у юзера разрешение на что-то, типа users/get

Docker

Заключение

git clone https://github.com/bezumkin/vesp.git
cd vesp
cp .env.dist .env
cp docker-compose.override.yml.dist docker-compose.override.yml
docker-compose up --build

COMPOSE_PROJECT_NAME=vesp-new