cacto
bb492785a4
Laravel 13 в laravel-app/, Breeze (Blade) для сессионного логина + Sanctum для API-токенов (задел под Vue/Flutter на этапе 3). Схема Postgres перенесена из сырого SQL в Laravel-миграции (владелец схемы теперь Laravel, Go-сервисы как читали/писали эти таблицы, так и продолжают). Роли/категории/ операторы условий — закрытые PHP-enum'ы (UserRole, DeviceCategory, ConditionOperator); action_type правил намеренно остаётся строкой — открытый, управляемый данными список, а не код. Сидер device_types с growbox-типами как пример данных, не бизнес-логика. Docker: один контейнер (php-fpm + nginx через supervisord, multi-stage сборка vendor/assets). Образ пока не --no-dev — сидер использует fake() для демо-аккаунта. Проверено: миграции применяются на реальном Postgres (в докере и локально), дефолтные тесты Breeze проходят (25/25), Breeze-логин подтверждён вживую через браузер, Sanctum корректно отдаёт 401 на защищённый /api/user без токена.
65 lines
4.1 KiB
Markdown
65 lines
4.1 KiB
Markdown
# laravel-app (PHP/Laravel)
|
||
|
||
Статус: каркас реализован (авторизация, схема БД, модели). CRUD-интерфейсы
|
||
и дашборд — в процессе.
|
||
|
||
Зона ответственности:
|
||
- Аутентификация и роли пользователей (Sanctum: сессии для Blade-UI +
|
||
токены для будущего API/мобильного клиента), owner/viewer.
|
||
- Владеет схемой PostgreSQL (`database/migrations/*.php`) — users, zones,
|
||
device_types, devices, automation_rules. Go-сервисы читают/пишут эти же
|
||
таблицы, но не управляют их структурой.
|
||
- CRUD зон/устройств/правил автоматизации через веб-интерфейс.
|
||
- Просмотр истории телеметрии (запрос к ClickHouse) и текущего состояния
|
||
устройств (чтение Device Shadow из Redis, который ведёт
|
||
device-control-service).
|
||
- Ручная отправка команд устройствам — вызов device-control-service.
|
||
|
||
Не входит в зону ответственности: приём/хранение телеметрии, обработка
|
||
правил в реальном времени, отправка MQTT-команд — это Go-сервисы. Laravel
|
||
только читает их данные и вызывает device-control-service по gRPC/HTTP для
|
||
управления.
|
||
|
||
## Архитектурные решения
|
||
|
||
- **Sanctum, а не просто сессии.** Даже при том, что UI сейчас — Blade
|
||
(Breeze), Sanctum используется с самого начала, чтобы токенная авторизация
|
||
API была готова для будущего Vue/Flutter-клиента (этап 3) без повторной
|
||
переделки авторизации.
|
||
- **Роли и категории как PHP-enum, а не хардкод строк.** `App\Enums\UserRole`
|
||
(owner/viewer), `App\Enums\DeviceCategory` (actuator/sensor),
|
||
`App\Enums\ConditionOperator` (>,<,>=,<=,=,!=) — всё это закрытые,
|
||
архитектурные множества значений. `action_type` в правилах автоматизации
|
||
**намеренно остаётся обычной строкой**, не enum'ом — это открытый,
|
||
расширяемый список, управляемый данными в `device_types.capabilities`, а
|
||
не кодом (иначе новый тип устройства с новой командой потребовал бы правки
|
||
кода — что прямо противоречит идее платформы).
|
||
- **device_types — открытый реестр.** Сидер (`DeviceTypeSeeder`) заполняет
|
||
типы устройств гроубокса (light, pump, fan, sensor_temp_humidity) как
|
||
пример данных, а не как встроенную в код бизнес-логику. Добавление типа
|
||
для другой зоны — просто новая строка.
|
||
|
||
## Docker
|
||
|
||
Собирается в один контейнер (PHP-FPM + Nginx, управляются через supervisord)
|
||
— см. `Dockerfile`. Образ включает `require-dev`-зависимости (в частности
|
||
`fakerphp/faker`), так как сидер намеренно создаёт демо-аккаунт через
|
||
`fake()`; это MVP-образ с демо-данными, а не hardened prod-сборка.
|
||
|
||
## Запуск
|
||
|
||
Локально (вне Docker), с уже поднятыми `postgres`/`redis` из корневого
|
||
`docker-compose.yml`:
|
||
|
||
```bash
|
||
cd laravel-app
|
||
composer install
|
||
cp .env.example .env && php artisan key:generate
|
||
php artisan migrate --seed
|
||
php artisan serve
|
||
```
|
||
|
||
Через Docker — сервис `laravel-app` в корневом `docker-compose.yml`,
|
||
конфигурация берётся из переменных окружения (секция Laravel app в
|
||
корневом `.env.example`).
|