Ми розробляємо бекенд на Flask для проєктів, де потрібен повний контроль без переплати за функціонал. Flask — мікрофреймворк, який дає тільки HTTP-маршрутизацію та контекст запиту/відповіді. Все інше: ORM, серіалізацію, аутентифікацію, кешування — ви збираєте самі під задачу. Для досвідченої команди це перевага: жодної магії, тільки чистий Python. Flask ідеальний для REST API, прототипів та сервісів з нестандартною логікою — там, де Django надлишковий, а FastAPI може бути оверинжинірингом.
На практиці такий підхід знижує вартість розробки на 40-60% порівняно з монолітними фреймворками — ви платите тільки за потрібні компоненти. Швидкість запуску API зростає вдвічі: мінімальне робоче ядро — за 2–3 дні. Замовте розробку бекенду на Flask, і ми забезпечимо гнучкість та продуктивність.
У цій статті розберемо, як ми будуємо продакшен-готовий бекенд: від структури проєкту до деплою. Ви дізнаєтеся, чому вибір Flask знижує вартість володіння на 30% порівняно з монолітними фреймворками, і які практики ми застосовуємо, щоб API працювало швидко та стабільно.
Навіщо вибирати Flask для бекенду?
Flask — правильний вибір, коли потрібен інструмент, а не фреймворк з жорсткими рамками. Порівняємо з популярними альтернативами:
| Характеристика | Flask | FastAPI | Django |
|---|---|---|---|
| Час запуску | ~5ms | ~10ms | ~50ms |
| Розмір коду для простого API | 100 рядків | 120 рядків | 300 рядків |
| Контроль над архітектурою | Повний | Частковий | Низький |
| Вбудована адмінка | Ні | Ні | Так |
Flask запускається в 10 разів швидше Django і дає повну свободу вибору компонентів. Це ідеальна основа для REST API, яке має бути легким і передбачуваним. Особливо вигідний Flask для мікросервісної архітектури, де кожен сервіс можна розгорнути незалежно.
Як ми налаштовуємо Application Factory та Blueprints
Правильна ініціалізація Flask — через фабрику, як описано в документації Flask Application Factory. Це дозволяє створювати кілька екземплярів з різними конфігураціями (для тестів особливо важливо):
# app/__init__.py
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate
from flask_jwt_extended import JWTManager
from flask_caching import Cache
db = SQLAlchemy()
migrate = Migrate()
jwt = JWTManager()
cache = Cache()
def create_app(config_name: str = 'development') -> Flask:
app = Flask(__name__)
app.config.from_object(config[config_name])
db.init_app(app)
migrate.init_app(app, db)
jwt.init_app(app)
cache.init_app(app)
from .api.v1 import bp as api_v1
app.register_blueprint(api_v1, url_prefix='/api/v1')
from .auth import bp as auth_bp
app.register_blueprint(auth_bp, url_prefix='/api/auth')
return app
Blueprint ізолює групу маршрутів:
# app/api/v1/products.py
from flask import Blueprint, request, jsonify, abort
from ..models import Product
from ..extensions import db, cache
from .decorators import require_auth, require_role
bp = Blueprint('products', __name__)
@bp.get('/products')
@cache.cached(timeout=300, query_string=True)
def list_products():
page = request.args.get('page', 1, type=int)
per_page = request.args.get('per_page', 20, type=int)
category_id = request.args.get('category_id', type=int)
query = Product.query.filter_by(is_active=True)
if category_id:
query = query.filter_by(category_id=category_id)
pagination = query.order_by(Product.created_at.desc()).paginate(
page=page, per_page=per_page, error_out=False
)
return jsonify({
'data': [p.to_dict() for p in pagination.items],
'pagination': {
'page': pagination.page,
'pages': pagination.pages,
'total': pagination.total
}
})
@bp.post('/products')
@require_auth
@require_role('admin')
def create_product():
data = request.get_json() or {}
errors = ProductSchema().validate(data)
if errors:
return jsonify({'errors': errors}), 422
product = Product(
name=data['name'],
price=data['price'],
category_id=data.get('category_id')
)
db.session.add(product)
db.session.commit()
return jsonify(product.to_dict()), 201
Які проблеми вирішує валідація Marshmallow?
Marshmallow — це серіалізація та валідація даних без дублювання коду. Схеми задаються декларативно, і вони ж використовуються для генерації документації.
from marshmallow import Schema, fields, validate, validates, ValidationError
class ProductSchema(Schema):
name = fields.Str(required=True, validate=validate.Length(min=2, max=255))
price = fields.Float(required=True, validate=validate.Range(min=0.01))
category_id = fields.Int(load_default=None)
description = fields.Str(load_default=None)
@validates('category_id')
def validate_category(self, value):
if value is not None:
from ..models import Category
if not Category.query.get(value):
raise ValidationError('Категорія не знайдена')
Схеми прискорюють розробку в 2 рази порівняно з ручною перевіркою — менше коду, менше помилок. Marshmallow також автоматично генерує Swagger-специфікацію, якщо використовується flasgger.
Аутентифікація через JWT: наші практики
Використовуємо бібліотеку flask-jwt-extended. Вона дає access та refresh токени з додатковими claims, наприклад роллю користувача.
from flask_jwt_extended import (
create_access_token, create_refresh_token,
jwt_required, get_jwt_identity, get_jwt
)
@auth_bp.post('/login')
def login():
data = request.get_json()
user = User.query.filter_by(email=data.get('email')).first()
if not user or not user.check_password(data.get('password')):
return jsonify({'error': 'Invalid credentials'}), 401
additional_claims = {'role': user.role}
access_token = create_access_token(identity=user.id, additional_claims=additional_claims)
refresh_token = create_refresh_token(identity=user.id)
return jsonify({
'access_token': access_token,
'refresh_token': refresh_token
})
@auth_bp.post('/refresh')
@jwt_required(refresh=True)
def refresh():
user_id = get_jwt_identity()
access_token = create_access_token(identity=user_id)
return jsonify({'access_token': access_token})
def require_role(role: str):
def decorator(fn):
@wraps(fn)
@jwt_required()
def wrapper(*args, **kwargs):
claims = get_jwt()
if claims.get('role') != role:
return jsonify({'error': 'Forbidden'}), 403
return fn(*args, **kwargs)
return wrapper
return decorator
Безпека будується на коротких access-токенах (15 хвилин) і довгих refresh-токенах (7 днів). Ми завжди використовуємо HTTPS і зберігаємо секрети в змінних середовища. Додатково налаштовуємо CORS та ліміт запитів через Flask-Limiter.
Як ми працюємо: процес і результати
Весь процес можна розбити на послідовні кроки:
- Архітектурне проектування — ER-діаграми, вибір стеку, розподіл по модулях.
- Розробка API — CRUD, аутентифікація, кешування, пагінація, валідація.
- Документація — OpenAPI (Swagger) через flasgger або ручний опис.
- Тести — юніт-тести (pytest + flask test client), інтеграційні тести.
- Деплой — Docker-контейнери, Gunicorn + Nginx, CI/CD (GitLab CI або GitHub Actions).
- Підтримка — моніторинг помилок (Sentry), логування (ELK), гарантія 1 місяць.
Кожен етап включає код-рев'ю та перевірку якості. Такий підхід дозволяє уникнути типових помилок і заощадити ресурси.
Що входить в результат роботи
Після завершення розробки ви отримуєте:
- Вихідний код із повним покриттям тестами (pytest, coverage > 80%)
- Документацію API у форматі OpenAPI (Swagger)
- Docker-образи для продакшену та розробки
- Інструкцію з розгортання та налаштування середовища
- Доступ до репозиторію з історією комітів
- 1 місяць гарантійної підтримки (виправлення дефектів)
- Коротке навчання команди: структура проєкту, запуск тестів, деплой
Орієнтовні строки
| Етап | Строк |
|---|---|
| Scaffold + конфігурація + БД | 2–4 дні |
| Моделі + міграції | 3–5 днів |
| API endpoints + auth | 1–2 тижні |
| Тести | 3–5 днів |
| Інтеграції та деплой | 1–2 тижні |
Повноцінний API для сайту — від 3 до 7 тижнів. Точна оцінка — після аналізу вимог. Звертайтеся за консультацією, і ми допоможемо спланувати роботи. Наші інженери мають досвід у високонавантажених проєктах і гарантують стабільність.
Отримайте консультацію по вашому проєкту — ми оцінимо архітектуру та строки. Замовте розробку бекенду на Flask, і ми реалізуємо вашу ідею з гарантією якості.