Архитектура Laravel API

Установка

npx skills add streeboga/laravel-api-skill

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл задает цепочку Controller, Service, Repository, QueryBuilder, Model и четкие границы ответственности слоев. По запросу на новую сущность агент генерирует 14 файлов: миграцию, модель с ULID-ключами, enum, DTO на Spatie Data, FormRequest, QueryBuilder, репозиторий, сервис, контроллер, JsonApiResource, маршруты и feature-тесты. При первом запуске скилл создает или дополняет CLAUDE.md проекта, чтобы правила действовали в каждой сессии. Справочники по слоям загружаются только под текущую задачу.

Для кого. Для PHP-разработчиков и команд, которые пишут API на Laravel и хотят единообразный код от агента.

Пример запроса к агенту

Создай сущность Invoice с CRUD-эндпоинтами, фильтрацией по статусу и тестами

Ограничения

Требуются PHP 8.2+, Laravel 10+ и конкретный набор пакетов: timacdonald/json-api, spatie/laravel-query-builder, spatie/laravel-data и другие. Архитектура жесткая, например scopes в моделях запрещены. Скилл сам меняет CLAUDE.md в корне проекта.

Как отключить. Удалите скилл laravel-api из каталога скиллов и уберите секцию Laravel-архитектуры из CLAUDE.md проекта.

Проверка безопасности

• Скилл состоит из инструкций и шаблонов
• При первом запуске изменяет CLAUDE.md проекта

Коротко о README

README открытого проекта EQ Platform описывает скилл для Laravel API с установкой через npx skills и автоматической настройкой CLAUDE.md. Приведены таблица границ слоев, список 14 генерируемых файлов, структура справочников и список обязательных пакетов. Разделы MUST DO и MUST NOT DO фиксируют строгие типы, final-классы, покрытие тестами от 85% и запрет на baseline PHPStan. Подробные сценарии работы описаны в README.ru.md.

SKILL.md

---
name: laravel-api
description: "Laravel API architecture and code generation guide. JSON:API v1.1 spec compliant. Enforces layered architecture: Controller → Service → Repository → QueryBuilder. Uses timacdonald/json-api for resources, spatie/laravel-query-builder for filtering/sorting. Covers DTOs, Enums, public keys, Scramble docs, testing. MANDATORY TRIGGERS: Laravel API, REST API, JSON:API, создание API, архитектура Laravel, генерация CRUD, сервисный слой, репозиторий, DTO, API ресурс. Use this skill whenever the user works on a Laravel API project, creates new entities/endpoints, reviews Laravel code, or asks about Laravel API architecture patterns."
license: MIT
compatibility: "Requires PHP 8.2+, Laravel 10+, Composer"
metadata:
  author: streeboga
  version: "1.0"
---

# Laravel API Production-Ready Architecture (JSON:API v1.1)

## SETUP GATE (выполни перед любой работой)

При первом вызове этого скилла в проекте проверь CLAUDE.md в корне проекта:

1. Если файла CLAUDE.md нет — прочитай `templates/CLAUDE.md` из директории этого скилла и создай CLAUDE.md в корне проекта с его содержимым.
2. Если CLAUDE.md существует, но НЕ содержит секцию "## Архитектура (нарушение = баг)" — прочитай `templates/CLAUDE.md` и ДОПИШИ его содержимое в конец существующего CLAUDE.md.
3. Если секция уже есть — всё ок, продолжай работу.

---

This skill defines the architecture and code patterns for all Laravel API projects. Every new entity, endpoint, or feature must follow these rules.

## Core Architecture

```
HTTP Request → Route → Middleware → Controller → Service → Repository → QueryBuilder (scopes) → Model → DB
Response    ← JsonApiResource      ← Service   ← Repository ← QueryBuilder
```

### Strict Layer Boundaries (CRITICAL)

```
Controller ──→ Service ONLY (never Repository, never Model)
Service    ──→ Repository (never Model::query() directly)
Repository ──→ QueryBuilder + Model
```

**DB access policy:** Only Repository and QueryBuilder may touch the database. No `Model::query()`, `::create()`, `->save()`, `->delete()` in Controllers or Services.

Похожие