Фреймворк отвечает, как код работает. Он не отвечает, где в этом проекте лежит контроллер, кто пишет миграцию для пользователей и в каком файле настройки очереди. Эти ответы даёт скелет, и первое решение принимается до того, как появится первая строка.
Код: Atomic-Framework-Application, лицензия GPL-3.0-or-later.
Решение 1: скелет это отдельный репозиторий
Скелет живёт отдельно от фреймворка, и это не формальность. Фреймворк обновляется по своим правилам, проект по своим, и между ними остаётся граница, которую видно в composer.
Плюс в том, что новый проект начинается командой, а не переписыванием прошлого. Минус в том, что скелет тоже надо обновлять, и об этом стоит помнить на второй год.
Скелет и фреймворк версионируются отдельно, поэтому проект фиксирует версию фреймворка в composer и обновляет её тогда, когда команда готова пройти по изменениям. Скелет при этом остаётся тем же набором папок и примеров: его задача не меняться каждый месяц, а держать форму, к которой привыкли.
Решение 2: папки это контракт
app/ держит контроллеры, модели, middleware и провайдер пользователей, bootstrap/ константы, загрузчик конфига и обработку ошибок, config/ базу, кеш, почту, аутентификацию и очередь, routes/ маршруты по типу запроса, public/ точку входа, database/ миграции и сиды, resources/ шаблоны, storage/ логи, кеш и сессии.
Договорённость про папки экономит не время разработки, а время ревью. Когда все кладут файл в одно место, спор о структуре не начинается на каждом пулл-реквесте.
Решение 3: аутентификация приходит рабочим срезом
Три контроллера, middleware Authenticate, модель User с uuid, email, password и role, провайдер из базы, миграция таблицы пользователей.
Срез выбран потому, что он проверяет весь вертикальный путь: маршрут, middleware, сессию, модель, миграцию, шаблон. Заглушка проверяет только то, что код собирается, и это дешёвая проверка с дорогими последствиями.
Решение 4: требования записаны в README
PHP 8.1 с расширениями json, session, mbstring, fileinfo, pdo, pdo_mysql, curl, MySQL или MariaDB, Redis по желанию, Composer.
Список кажется мелочью до первого деплоя на чужой сервер. Отсутствующее расширение это не ошибка в коде, а час переписки с поддержкой, и лучше, чтобы список был в репозитории, а не в голове одного человека.
Решение 5: генератора CRUD в скелете нет
Скелет не создаёт админку, экраны списков и формы. Миграции остаются файлами с метками времени, и изменение схемы пишется руками.
Я выбираю это сознательно. Сгенерированный экран живёт до первого нестандартного требования, а потом его переписывают целиком, и никто не помнит, что там было. Файл, написанный человеком, читается в тот же день.
Что это даёт на практике
Проект поднимается за час: установка, ключи, миграции, первый вход. Дальше работа идёт по бизнес-правилам, а не по инфраструктуре. Если скелета нет, эту же неделю оплачивает клиент, а описания папок не остаётся нигде: следующий человек восстанавливает структуру по коду, и восстанавливает по-своему.
Проверить стоит три вещи: .env не попал в репозиторий, storage/ доступен на запись и закрыт снаружи, миграции прогнаны на сервере. Дальше воркер под supervisor и schedule/run в cron, иначе очередь копит письма, а ночной отчёт не выходит.
Чему это учит
Стандарт важнее удобства. Папки, имена и требования, записанные до кода, экономят месяцы объяснений, и единственная цена этого решения в том, что кто-то должен его принять и записать.
Тот же довод в заметке создание фреймворка: сначала граница, потом код. И тот же принцип в прогрессивном улучшении, где работает то, что уже умеет платформа.
Правило простое: то, что повторяется в каждом проекте, должно лежать в репозитории до начала работы.
Скелет выходит под GPL-3.0-or-later и ставится одной командой Composer.