English version | Русская версия
This template provides a ready-to-use environment for developing scalable microservices using FastAPI. It includes infrastructure for database management (PostgreSQL), caching storage (Valkey), and reverse proxying (Nginx). The architecture supports polyglot development but is currently optimized for Python services.
- Framework: FastAPI
- Database: PostgreSQL
- Cache/Queue: Valkey (Redis-compatible)
- ORM: SQLAlchemy 2.0
- Migrations: Alembic
- Proxy: Nginx
- Containerization: Docker & Docker Compose
git clone [email protected]:unidoka/simplebase.git
cd simplebaseCopy the example env file and fill in your secrets (JWT keys, DB passwords, SMTP credentials):
cp .env.example .envBuild and start all containers in detached mode:
docker compose up -d --build- Swagger: http://localhost/docs
- Health check: http://localhost/health
- Main Service: http://localhost/api/main/v1
English version | Русская версия
Этот шаблон предоставляет готовую среду для разработки масштабируемых микросервисов с использованием FastAPI. Он включает инфраструктуру для управления базами данных (PostgreSQL), кэширования (Valkey) и обратного проксирования (Nginx). Архитектура поддерживает полиглотную разработку, но в настоящее время оптимизирована для сервисов на Python.
- Фреймворк: FastAPI
- База данных: PostgreSQL
- Кэш/Очередь: Valkey (совместим с Redis)
- ORM: SQLAlchemy 2.0
- Миграции: Alembic
- Прокси-сервер: Nginx
- Контейнеризация: Docker и Docker Compose
git clone [email protected]:unidoka/simplebase.git
cd simplebaseСкопируйте пример файла переменных окружения и заполните его секретными данными (ключи JWT, пароли БД, учетные данные SMTP):
cp .env.example .envСоберите и запустите все контейнеры в фоновом режиме:
docker compose up -d --build- Swagger: http://localhost/docs
- Health check: http://localhost/health
- Main Service: http://localhost/api/main/v1