Казань
Разработчик бизнес-приложений (PHP/Laravel)
Роберт Валиахметов rvaliakhmetov
не верифицирован
Необходимо было разработать REST API для системы управления проектами и задачами. Существующие решения (Jira, ClickUp) не подходили из-за избыточного функционала и высокой стоимости. Требовалось создать гибкую систему с поддержкой разных уровней доступа: от полноправных членов команды до интеграций с внешними сервисами через ограниченные токены. API должен был быть готов к продакшену с первой версии и иметь полную документацию для интеграции.
Разработал API на Laravel 12 + PostgreSQL 16 с domain-driven архитектурой, где код организован по бизнес-доменам (Auth, Projects, Issues, Users) вместо технических слоёв. Это обеспечивает простоту навигации и масштабирования кодовой базы.
Ключевые технические решения:
Двухуровневая авторизация: токены Sanctum с ограниченными правами для CI/CD и внешних сервисов + система ролей внутри проектов (5 ролей с 22 детальными разрешениями)
Централизованная обработка ошибок с единым JSON-форматом и trace ID для упрощения отладки и интеграции
Actions как use-cases — каждая бизнес-операция изолирована в отдельном классе для простоты тестирования и модификации
Отказ от repository pattern в пользу прямого использования Eloquent — меньше слоёв абстракции, проще поддержка
Внедрил строгий контроль качества: PHPStan Level 9, 270 автотестов покрывающих все сценарии авторизации и бизнес-логики, автоматические проверки в CI/CD.
Реализовал production-ready API с 19 эндпоинтами и ~12,000 строк кода. Система покрыта тестами на 270 тест-кейсов с 1184 ассертами, что гарантирует стабильность при доработках.
Подготовил полную документацию:
OpenAPI 3.0 спецификация
Интерактивный UI (Scalar) для тестирования эндпоинтов
Postman коллекция с готовыми примерами запросов
Проект готов к развертыванию: Docker-инфраструктура, трейсинг запросов для мониторинга, версионирование API для безопасных обновлений. Документация позволяет начать интеграцию с минимальными вопросами.
Пожаловаться
