Розробка бекенду сайту на Python (Flask)

Ми розробляємо бекенд на Flask для проєктів, де потрібен повний контроль без переплати за функціонал. Flask — мікрофреймворк, який дає тільки HTTP-маршрутизацію та контекст запиту/відповіді. Все інше: ORM, серіалізацію, аутентифікацію, кешування — ви збираєте самі під задачу. Для досвідченої команди це перевага: жодної магії, тільки чистий Python. Flask ідеальний для REST API, прототипів та сервісів з нестандартною логікою — там, де Django надлишковий, а FastAPI може бути оверинжинірингом.

На практиці такий підхід знижує вартість розробки на 40-60% порівняно з монолітними фреймворками — ви платите тільки за потрібні компоненти. Швидкість запуску API зростає вдвічі: мінімальне робоче ядро — за 2–3 дні. Замовте розробку бекенду на Flask, і ми забезпечимо гнучкість та продуктивність.

У цій статті розберемо, як ми будуємо продакшен-готовий бекенд: від структури проєкту до деплою. Ви дізнаєтеся, чому вибір Flask знижує вартість володіння на 30% порівняно з монолітними фреймворками, і які практики ми застосовуємо, щоб API працювало швидко та стабільно.

Навіщо вибирати Flask для бекенду?

Flask — правильний вибір, коли потрібен інструмент, а не фреймворк з жорсткими рамками. Порівняємо з популярними альтернативами:

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.

Як ми працюємо: процес і результати

Весь процес можна розбити на послідовні кроки:

1. Архітектурне проектування — ER-діаграми, вибір стеку, розподіл по модулях.
2. Розробка API — CRUD, аутентифікація, кешування, пагінація, валідація.
3. Документація — OpenAPI (Swagger) через flasgger або ручний опис.
4. Тести — юніт-тести (pytest + flask test client), інтеграційні тести.
5. Деплой — Docker-контейнери, Gunicorn + Nginx, CI/CD (GitLab CI або GitHub Actions).
6. Підтримка — моніторинг помилок (Sentry), логування (ELK), гарантія 1 місяць.

Кожен етап включає код-рев'ю та перевірку якості. Такий підхід дозволяє уникнути типових помилок і заощадити ресурси.

Що входить в результат роботи

Після завершення розробки ви отримуєте:

• Вихідний код із повним покриттям тестами (pytest, coverage > 80%)
• Документацію API у форматі OpenAPI (Swagger)
• Docker-образи для продакшену та розробки
• Інструкцію з розгортання та налаштування середовища
• Доступ до репозиторію з історією комітів
• 1 місяць гарантійної підтримки (виправлення дефектів)
• Коротке навчання команди: структура проєкту, запуск тестів, деплой

Орієнтовні строки

Повноцінний API для сайту — від 3 до 7 тижнів. Точна оцінка — після аналізу вимог. Звертайтеся за консультацією, і ми допоможемо спланувати роботи. Наші інженери мають досвід у високонавантажених проєктах і гарантують стабільність.

Отримайте консультацію по вашому проєкту — ми оцінимо архітектуру та строки. Замовте розробку бекенду на Flask, і ми реалізуємо вашу ідею з гарантією якості.