Сравнение фреймворков и кросс-совместимость

❌ НЕ СОВМЕСТИМЫ

Streamlit — отдельный процесс, не интегрируется в FastAPI.
Нельзя: встроить Streamlit компонент в FastAPI приложение.

АЛЬТЕРНАТИВА:
FastAPI + Jinja2 + htmx + Alpine.js
  → Тот же результат, но production-ready

# Было (Streamlit)
import streamlit as st
import pandas as pd

st.title("Dashboard")
data = pd.read_csv("data.csv")
st.dataframe(data)
st.line_chart(data["value"])

# Стало (FastAPI + Jinja2 + Chart.js)
# app/routers/dashboard.py
from fastapi import APIRouter, Request
from fastapi.templating import Jinja2Templates

router = APIRouter()
templates = Jinja2Templates(directory="templates")

@router.get("/dashboard")
async def dashboard(request: Request):
    data = await get_data()
    return templates.TemplateResponse("dashboard.html", {
        "request": request,
        "data": data
    })

⚠️ ОГРАНИЧЕННО СОВМЕСТИМЫ

Можно:
1. Django как монолит + FastAPI микросервисы
2. Django для админки + FastAPI для API
3. Общая БД (PostgreSQL)

Нельзя:
1. Использовать Django ORM в FastAPI (несовместимы)
2. Django views в FastAPI (разные фреймворки)

АРХИТЕКТУРА:
┌─────────────┐     ┌─────────────┐
│   Django    │     │   FastAPI   │
│   Админка   │     │     API     │
└──────┬──────┘     └──────┬──────┘
       │                   │
       └───────┬───────────┘
               ▼
        ┌─────────────┐
        │  PostgreSQL │
        └─────────────┘

# FastAPI читает ту же БД, что Django
# settings.py (Django)
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'myapp',
        'HOST': 'localhost',
    }
}

# config.py (FastAPI)
class Settings(BaseSettings):
    database_url: str = "postgresql+asyncpg://localhost/myapp"

# Модели должны быть синхронизированы!
# Django ORM ↔ SQLAlchemy — разные модели, одна таблица

✅ ХОРОШО СОВМЕСТИМЫ (миграция)

Flask и FastAPI — оба WSGI/ASGI.
Можно постепенно мигрировать.

СТРАТЕГИЯ МИГРАЦИИ:
1. Запустить FastAPI рядом с Flask
2. Перенести endpoints по одному
3. Переключить трафик
4. Выключить Flask

МОЖНО:
- Общие библиотеки (SQLAlchemy, requests/httpx)
- Общая БД
- Общий Redis/Celery

НЕЛЬЗЯ:
- Flask extensions в FastAPI
- Flask-Login → fastapi-users

# Flask
from flask import Flask, request, jsonify
from marshmallow import Schema, fields

app = Flask(__name__)

class UserSchema(Schema):
    name = fields.Str(required=True)
    email = fields.Email(required=True)

@app.route("/users", methods=["POST"])
def create_user():
    schema = UserSchema()
    data = schema.load(request.json)
    user = create_user_in_db(data)
    return jsonify(schema.dump(user))

# FastAPI
from fastapi import FastAPI
from pydantic import BaseModel, EmailStr

app = FastAPI()

class UserCreate(BaseModel):
    name: str
    email: EmailStr

class UserRead(BaseModel):
    id: int
    name: str
    email: EmailStr

@app.post("/users", response_model=UserRead)
async def create_user(user: UserCreate):
    return await create_user_in_db(user.model_dump())

✅ ПОЛНОСТЬЮ СОВМЕСТИМЫ

httpx создан как drop-in замена requests.
API практически идентичен.

МИГРАЦИЯ: Замена импорта!

# requests (sync)
import requests

response = requests.get("https://api.example.com/users")
data = response.json()

# httpx (sync) — просто замена импорта!
import httpx

response = httpx.get("https://api.example.com/users")
data = response.json()

# httpx (async) — для FastAPI
import httpx

async def get_users():
    async with httpx.AsyncClient() as client:
        response = await client.get("https://api.example.com/users")
        return response.json()

# requests — timeout опционален (опасно!)
requests.get(url)  # может висеть бесконечно

# httpx — timeout обязателен
httpx.get(url)  # default timeout есть
httpx.get(url, timeout=30)  # явный timeout

                Streamlit  Django  Flask  FastAPI
Streamlit          —        ❌      ❌      ❌
Django             ❌        —      ⚠️      ⚠️
Flask              ❌       ⚠️       —      ✅
FastAPI            ❌       ⚠️      ✅       —

❌ = Несовместимы
⚠️ = Можно совмещать (разные сервисы)
✅ = Миграция возможна

ВСЕГДА → FastAPI

Причины:
1. Async native
2. Автодокументация
3. Type safety (Pydantic)
4. Скорость
5. Современный стек

Flask → Мигрировать на FastAPI (постепенно)
Django → Оставить (если монолит с админкой)
Streamlit → Переписать на FastAPI + htmx
requests → Заменить на httpx

┌─────────────────────────────────────────────┐
│                   Gateway                    │
│                  (Traefik)                   │
└─────────────────────────────────────────────┘
         │              │              │
         ▼              ▼              ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│  FastAPI    │ │  FastAPI    │ │   Django    │
│  Users API  │ │ Products API│ │   Admin     │
└─────────────┘ └─────────────┘ └─────────────┘
         │              │              │
         └──────────────┴──────────────┘
                        │
                        ▼
                 ┌─────────────┐
                 │  PostgreSQL │
                 └─────────────┘