Добро пожаловать в документацию модульного Go бэкенда с чистой архитектурой. Этот проект разработан для создания гибких и масштабируемых API-сервисов, готовых к работе с различными типами приложений: CRM, CMS, чаты, дашборды и многое другое.
- Архитектура проекта - Обзор архитектуры, слоев приложения и принципов проектирования
- Разработка - Руководство по разработке, структура кода и лучшие практики
- Развертывание - Инструкции по деплою на различные платформы
- Примеры использования - Готовые сценарии для разных типов приложений
Если вы только начинаете работу с проектом, начните с Quickstart Guide.
Этот проект специально разработан с учетом потребностей начинающих разработчиков. Каждый раздел содержит:
- Подробные объяснения концепций
- Примеры кода с комментариями
- Пошаговые инструкции
- Часто задаваемые вопросы
- ✅ Чистая архитектура - Разделение на слои (Domain, UseCase, Repository, API)
- ✅ Высокая производительность - Использование fasthttp для минимальных задержек
- ✅ Offline Resilience - Автоматическая буферизация операций при недоступности БД
- ✅ Модульность - Легкое добавление новых модулей без изменения ядра
- ✅ Готовность к продакшену - Docker, health checks, graceful shutdown
- ✅ Масштабируемость - Поддержка горизонтального и вертикального масштабирования
- Язык: Go 1.21+
- HTTP сервер: fasthttp
- База данных: PostgreSQL (pgx/v5)
- Кэш/Сессии: Redis
- Буфер: BoltDB (для offline операций)
- Логирование: Zap
- Миграции: golang-migrate
- Прочитайте Quickstart Guide для локальной настройки
- Изучите Архитектуру проекта для понимания структуры
- Выберите интересующий вас пример из Примеров использования
- Следуйте инструкциям по Развертыванию для деплоя на сервер
Если у вас возникли вопросы или проблемы:
- Проверьте соответствующий раздел документации
- Изучите примеры в директории
examples/ - Обратитесь к FAQ в каждом разделе
Приятной разработки! 🎉