Функция «Избранное» и администрирование

В этой главе вы узнаете, как реализовать функцию избранного с помощью связи «многие ко многим» и использовать sqladmin для настройки административной панели.


Проектирование связи «многие ко многим»

Пример

# Путь к файлу: models.py - добавить таблицу связей и изменить модель Post
from sqlalchemy import Table

# Таблица связей: промежуточная таблица «многие ко многим» между User и Post
favorites = Table(
    "favorites",
    Base.metadata,
    Column("user_id", Integer, ForeignKey("users.id"), primary_key=True),
    Column("post_id", Integer, ForeignKey("posts.id"), primary_key=True),
    Column("created_at", DateTime, default=datetime.utcnow)
)

Выполнить миграцию:

(venv) $ alembic revision --autogenerate -m "新增收藏关联表"
(venv) $ alembic upgrade head

Маршруты добавления и удаления из избранного

Пример

# Путь к файлу: routers/favorites.py
from fastapi import APIRouter, Depends, HTTPException, Запрос
from sqlalchemy.orm import Session
from database import get_db
from models import Post, favorites
from routers.users import get_current_user
from fastapi.templating import Jinja2Templates

router = APIRouter(prefix="/favorites", tags=["Избранное"])
templates = Jinja2Templates(directory="templates")

@router.post("/toggle/{post_id}")
def toggle_favorite(
    post_id: int,
    request: Request,
    db: Session = Depends(get_db),
    current_user = Depends(get_current_user)    # Требуется вход
):
    """Переключить статус избранного"""
    post = db.query(Post).filter(Post.id == post_id).first()
    if not post:
        raise HTTPException(status_code=404, detail=“Статья не существует”)

    # Проверить, добавлено ли уже в избранное
    is_faved = db.query(favorites).filter(
        favorites.c.user_id == current_user.id,
        favorites.c.post_id == post.id
    ).first() is not None

    if is_faved:
        # Убрать из избранного
        db.execute(
            favorites.delete().where(
                (favorites.c.user_id == current_user.id) &
                (favorites.c.post_id == post.id)
            )
        )
        db.commit()
    else:
        # Добавить в избранное
        db.execute(
            favorites.insert().values(user_id=current_user.id, post_id=post.id)
        )
        db.commit()

    from fastapi.responses import RedirectResponse
    return RedirectResponse(url=request.headers.get("referer", "/"), status_code=303)


@router.get("/", name="favorites_list")
def favorites_list(
    request: Request,
    db: Session = Depends(get_db),
    current_user = Depends(get_current_user)
):
    """Мой список избранного"""
    faved_posts = db.query(Post).join(
        favorites, (favorites.c.post_id == Post.id)
    ).filter(
        favorites.c.user_id == current_user.id
    ).order_by(favorites.c.created_at.desc()).all()

    return templates.TemplateResponse("favorites.html", {
        "request": request,
        "posts": faved_posts
    })

Добавить кнопку «В избранное» на странице сведений

Пример

Начальные параметры установлены.
<div class="post-header">
    <h1>{{ post.title }}</h1>
    <form method="post" action="/favorites/toggle/{{ post.id }}">
        <button type="submit" class="fav-btn">♡ В избранное</кнопка>
    </форма>
</div>

sqladmin — Администрирование

sqladminЭто расширение административного бэкенда в экосистеме FastAPI, аналогичное Django Admin.

Он разработан специально для SQLAlchemy и бесшовно интегрируется с FastAPI.

(venv) $ pip install sqladmin

Пример

# Путь к файлу: настройка sqladmin в main.py
from sqladmin import Admin, ModelView
from database import engine
from models import Post, Category, User

class PostAdmin(ModelView, model=Post):
    column_list = [Post.id, Post.title, Post.category, Post.created_at]
    column_searchable_list = [Post.title, Post.summary]
    column_sortable_list = [Post.created_at, Post.title]
    form_columns = [Post.title, Post.slug, Post.summary, Post.content, Post.category_id]

class CategoryAdmin(ModelView, model=Category):
    column_list = [Category.id, Category.name, Category.slug]
    form_columns = [Category.name, Category.slug]

class UserAdmin(ModelView, model=User):
    column_list = [User.id, User.username, User.email]
    column_searchable_list = [User.username, User.email]
    # Не отображать поле пароля (для безопасности)
    form_excluded_columns = [User.hashed_password]

# Создайте экземпляр Admin и привяжите его к приложению FastAPI
admin = Admin(app, engine, title=ПРИМЕР Админка блога)
admin.add_view(PostAdmin)
admin.add_view(CategoryAdmin)
admin.add_view(UserAdmin)

Перейдите по адресу /admin, чтобы войти в интерфейс администратора.

sqladmin против Flask-Admin против Django Admin

ОсобенностиDjango AdminFlask-Adminsqladmin
Метод регистрацииadmin.site.register()admin.add_view(ModelView())Админка + add_view
Поддержка ORMDjango ORMSQLAlchemy / MongoEngineSQLAlchemy (только)
Поддержка аутентификацииВстроенныйТребуется ручная интеграцияВстроенный authentication_backend
Поддержка асинхронностиНе поддерживаетсяНе поддерживаетсянативная асинхронность

sqladmin по умолчанию доступен без входа в систему. Его необходимо настроить для продакшн-сред.authentication_backendЧтобы добавить защиту аутентификации, см. официальную документацию sqladmin.


Итоги главы

В этой главе вы реализовали две важные функции: использование Table в качестве ассоциативной таблицы для реализации связи многие-ко-многим для избранного; и использование sqladmin для быстрого создания системы управления административной панелью.

Теперь в блоге есть полноценные функции взаимодействия с пользователем (регистрация, вход, избранное) и функции управления (админ-бэкенд).

Другие расширения