README

⛵open-admin-core - это конструктор административного интерфейса для Laravel, который поможет вам создать CRUD-функции всего с помощью нескольких строк кода.

Данный конструктор является форком проекта https://github.com/open-admin-org/open-admin и адаптирован для Bootstrap 5.3.

Документация | Расширения

Возможности

• ✅ Bootstrap 5.3 — современный адаптивный интерфейс
• ✅ CRUD конструктор — создание админки в несколько строк кода
• ✅ Управление ролями и правами — гибкая система RBAC
• ✅ Восстановление пароля — полный цикл сброса пароля через email
• ✅ AJAX формы — без перезагрузки страницы, с прелоадерами
• ✅ Безопасность — throttle, логирование, принудительный выход из всех устройств
• ✅ Email уведомления — с информацией об IP, времени, браузере и ОС
• ✅ Журнал операций — логирование действий администраторов
• ✅ Расширения — медиа-менеджер, редактор, конструктор страниц и другие

Требования

• PHP ^8.2
• Laravel >= 12.0
• Fileinfo PHP Extension
• База данных: MySQL 8.0+ или PostgreSQL 12+

Установка

1. Создание нового проекта Laravel

composer create-project laravel/laravel example-app
cd example-app

2. Настройка приложения

Отредактируйте файл config/app.php:

'url' => env('APP_URL', null),
'asset_url' => env('ASSET_URL', null),
'timezone' => 'Europe/Moscow',
'locale' => 'ru',

Создайте символическую ссылку для публичных файлов:

php artisan storage:link

3. Настройка базы данных

PostgreSQL (рекомендуется) В файле .env:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=your_database
DB_USERNAME=postgres
DB_PASSWORD=postgres

Для оптимальной работы установите расширение pg_trgm:

CREATE EXTENSION IF NOT EXISTS pg_trgm;

Проверить наличие расширения:

SELECT extname FROM pg_extension;

MySQL

В файле .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=root
DB_PASSWORD=root

Для MySQL 8.0+ рекомендуется использовать utf8mb4_unicode_ci:

DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci

4. Установка пакета

composer require dedermus/open-admin-core

5. Публикация ресурсов

php artisan vendor:publish --provider="OpenAdminCore\Admin\AdminServiceProvider"

Эта команда опубликует:

• Конфигурацию в config/admin.php
• Языковые файлы в resources/lang
• Миграции в database/migrations
• Ассеты в public/vendor/open-admin

6. Настройка дисков для загрузки файлов

В файле config/filesystems.php добавьте или обновите диски:

'disks' => [
    // ... другие диски

    'uploads' => [
        'driver' => 'local',
        'root' => public_path('uploads'),
        'url' => env('APP_URL').'/uploads',
        'visibility' => 'public',
        'throw' => false,
        'permissions' => [
            'file' => [
                'public' => 0644,
                'private' => 0600,
            ],
            'dir' => [
                'public' => 0755,
                'private' => 0700,
            ],
        ],
    ],

    'admin' => [
        'driver' => 'local',
        'root' => public_path('uploads'),
        'url' => env('APP_URL').'/uploads',
        'visibility' => 'public',
        'throw' => false,
        'permissions' => [
            'file' => [
                'public' => 0644,
                'private' => 0600,
            ],
            'dir' => [
                'public' => 0755,
                'private' => 0700,
            ],
        ],
    ],
],

7. Настройка HTTPS (опционально)

В файле config/admin.php:

'https' => env('ADMIN_HTTPS', true),

8. Завершение установки

php artisan admin:install

Эта команда выполнит:

• Запуск всех миграций (php artisan migrate)
• Заполнение таблиц начальными данными (пользователь admin, роли, разрешения)
• Создание директории app/Admin со следующей структурой:

app/Admin/
├── Controllers/
│   ├── HomeController.php
│   ├── AuthController.php
│   └── ExampleController.php
├── bootstrap.php
└── routes.php

9. Доступ к админ-панели

Откройте в браузере: http://localhost/admin

Учетные данные по умолчанию:

• Логин: admin
• Пароль: admin

|⚠️ Важно: После первого входа обязательно смените пароль администратора!

Восстановление пароля

Пакет поддерживает функционал восстановления пароля через email. Для его работы необходимо:

1. Настроить отправку email в файле .env:

MAIL_MAILER=smtp
MAIL_HOST=smtp.mail.ru
MAIL_PORT=465
MAIL_USERNAME=your-email@example.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=your-email@example.com
MAIL_FROM_NAME="Admin Panel"

1. Убедиться, что у пользователей заполнен email. Если email отсутствует, пользователь не сможет восстановить пароль.

2. Настроить параметры восстановления в config/admin.php:

'auth' => [
    'password_reset' => [
    'enabled' => true,           // Включить/отключить функционал
    'expire' => 60,              // Время жизни ссылки (минут)
    'throttle' => 3,             // Максимум попыток
    'throttle_decay_minutes' => 60, // Время блокировки после превышения
    ],
],

1. Настроить логирование в config/logging.php:

'channels' => [
    'password_reset' => [
    'driver' => 'daily',
    'path' => storage_path('logs/password-reset.log'),
    'level' => 'info',
    'days' => 30,
    ],
],

Процесс восстановления

1. Пользователь нажимает "Забыли пароль?" на странице входа

2. Вводит логин или email

3. На почту приходит ссылка для сброса пароля

4. Пользователь переходит по ссылке и устанавливает новый пароль

5. После успешного сброса:

   • Происходит принудительный выход из всех устройств

   • На почту приходит уведомление с информацией:

     • Время изменения пароля

     • IP-адрес

     • Браузер, ОС и тип устройства

6. Пользователь перенаправляется на страницу входа

Безопасность

✅ Ограничение количества попыток (throttle)

✅ Токены сброса имеют ограниченное время жизни

✅ Общие сообщения об успехе (не сообщаем, существует ли пользователь)

✅ Логирование всех попыток в отдельный канал

✅ Принудительный выход из всех устройств после сброса

✅ Email-уведомление с информацией об IP и устройстве

✅ AJAX-отправка форм с защитой от двойной отправки

1. Очистка устаревших токенов:

php artisan admin:clear-resets

Рекомендуется добавить эту команду в расписание (cron):

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
$schedule->command('admin:clear-resets')->daily();
}

Процесс восстановления пароля

1. Пользователь нажимает "Забыли пароль?" на странице входа
2. Вводит логин или email
3. Если учетная запись существует и имеет email, отправляется ссылка на сброс
4. Пользователь переходит по ссылке и устанавливает новый пароль
5. После успешного сброса выполняется перенаправление на страницу входа

Безопасность

• Ограничение количества попыток (throttle)
• Токены сброса имеют ограниченное время жизни
• Общие сообщения об успехе (не сообщаем, существует ли пользователь)
• Логирование всех попыток в отдельный канал
• Пароль должен соответствовать требованиям безопасности (минимум 8 символов)

Конфигурация

Основные настройки находятся в файле config/admin.php:

Команды админ-панели

Пакет предоставляет набор Artisan-команд для управления админ-панелью:

Примеры использования команд

Создание контроллера для модели Post:

php artisan admin:make "App\Models\Post" --title="Статьи"

После выполнения команды будет создан контроллер app/Admin/Controllers/PostController.php с готовыми методами для CRUD операций.

Добавление маршрута в app/Admin/routes.php:

$router->resource('posts', PostController::class);

Генерация разрешений для таблицы posts:

php artisan admin:permissions --tables=posts

Обновление

Обновление до новой версии пакета:

composer update dedermus/open-admin-core
php artisan vendor:publish --tag=open-admin-assets --force
php artisan view:clear
php artisan config:clear

Расширения

Пакет поддерживает расширения, адаптированные для Bootstrap 5.3:

Установка расширения

composer require dedermus/helpers
php artisan admin:import helpers

Локализация

Поддержка RTL (справа налево)

Для поддержки языков с направлением письма справа налево:

1. Откройте файл vendor/dedermus/open-admin-core/src/Traits/HasAssets.php

2. В массиве $baseCss замените:

   • bootstrap.min.css → bootstrap.rtl.min.css
   • AdminLTE.min.css → AdminLTE.rtl.min.css

Устранение неполадок

Проблема: Class "OpenAdminCore\Admin\AdminServiceProvider" not found

Решение: Запустите composer dump-autoload:

composer dump-autoload

Проблема: Ошибка при миграции с PostgreSQL

Решение: Убедитесь, что установлено расширение pg_trgm:

CREATE EXTENSION IF NOT EXISTS pg_trgm;

Проблема: Ошибка 404 при доступе к админке

Решение: Проверьте файл app/Admin/routes.php и убедитесь, что префикс маршрутов в config/admin.php совпадает с URL.

Лицензия

open-admin-core распространяется под лицензией The MIT License (MIT).