Fullstack Boilerplate
localhost:3000
Демонстрация проекта
// Описание
Готовый fullstack-шаблон с предустановленной инфраструктурой: FastAPI + Next.js (сайт + админка) + PostgreSQL + Traefik + Docker Compose. Основа для быстрого старта новых проектов.
// Ключевые возможности
✓FastAPI backend с автодокументацией OpenAPI
✓Next.js фронтенд + отдельная админ-панель
✓PostgreSQL + Docker Compose + Traefik с SSL
// Технические детали
technical-details.md
Архитектура
- ▸Чистая архитектура с разделением слоёв представления, бизнес-логики и данных
Backend
- ▸FastAPI для высокопроизводительных REST API
- ▸Pydantic для валидации данных и type safety
- ▸SQLAlchemy ORM с миграциями Alembic
Frontend
- ▸React с TypeScript для type safety
- ▸Server-Side Rendering (SSR) для оптимизации SEO
DevOps
- ▸Docker для контейнеризации
- ▸Docker Compose для локальной разработки
- ▸CI/CD pipeline для автоматического деплоя
// Задачи и решения
Переиспользование инфраструктуры
Сложнее всего было сделать шаблон достаточно гибким, чтобы покрывать разные типы проектов, не усложняя при этом точку входа. Решение — многоуровневые docker-compose файлы (base / dev / prod).
SSL и маршрутизация из коробки
Настройка Traefik с автоматическим Let's Encrypt потребовала отдельного решения для dev-режима без реального домена. Вышли из ситуации через self-signed сертификаты и отдельный traefik.dev.yml.