Función de favoritos y administración de backend

En este capítulo aprenderás a implementar la función de favoritos usando relaciones muchos a muchos y a crear rápidamente una administración de backend con Flask-Admin.


Diseño de relaciones muchos a muchos

Requisitos de la función de favoritos:Un usuario puede marcar como favoritos múltiples artículos, y un artículo puede ser marcado como favorito por múltiples usuarios。

En SQLAlchemy, las relaciones muchos a muchos se implementan medianteTabla de asociación (Association Table).

Ejemplo

# Ruta del archivo: agregar tabla de asociación y modificar el modelo Post en models.py
from datetime import datetime

# Tabla de asociación: no es necesario definirla como clase de modelo, se crea directamente con db.Table
favorites = db.Table('favorites',
    db.Column('user_id', db.Integer, db.ForeignKey('users.id'), primary_key=True),
    db.Column('post_id', db.Integer, db.ForeignKey('posts.id'), primary_key=True),
    db.Column('created_at', db.DateTime, default=datetime.utcnow)
)

class Post(db.Model):
    __tablename__ = 'posts'
    # ... los campos existentes no cambian ...

Luego ejecuta la migración:

(venv) $ flask db migrate -m "新增收藏关联表"
(venv) $ flask db upgrade

Vistas de favoritos y cancelar favoritos

Ejemplo

# Ruta del archivo: app/blueprints/user.py (archivo nuevo)
from flask import Blueprint, render_template, redirect, url_for, request, flash
from flask_login import login_required, current_user
from app.models import Post, db, favorites

user_bp = Blueprint('user', __name__)

@user_bp.route("/favorite/<int:post_id>", methods=['POST'])
@login_required
def toggle_favorite(post_id):
    """Alternar estado de favorito"""
    post = Post.query.get_or_404(post_id)

    # Verificar si ya está en favoritos: consultar si existe esta combinación de usuario-artículo en la tabla de asociación
    is_faved = db.session.query(favorites).filter(
        favorites.c.user_id == current_user.id,
        favorites.c.post_id == post.id
    ).first() is not None

    if is_faved:
        # Cancelar favorito
        db.session.execute(
            favorites.delete().where(
                (favorites.c.user_id == current_user.id) &
                (favorites.c.post_id == post.id)
            )
        )
        db.session.commit()
        flash(f'Se ha cancelado el favorito de «{post.title}»', 'info')
    else:
        # Agregar a favoritos
        db.session.execute(
            favorites.insert().values(user_id=current_user.id, post_id=post.id)
        )
        db.session.commit()
        flash(f'Se ha agregado «{post.title}» a favoritos', 'success')

    return redirect(request.referrer or url_for('main.index'))


@user_bp.route("/favorites")
@login_required
def favorites_list():
    """Lista de favoritos del usuario actual"""
    # Consultar los artículos favoritos del usuario a través de la tabla de asociación
    faved_posts = Post.query.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 render_template('favorites.html', posts=faved_posts)

Registrar Blueprint en app.py

Ejemplo

from app.blueprints.user import user_bp
app.register_blueprint(user_bp)

Agregar botón de favoritos en la página de detalles y la página de listado

Ejemplo

<!-- Agregar en el área de operaciones de artículos de post_detail.html e index.html -->
{% if current_user.is_authenticated %}
<form method="post" action="{{ url_for('user.toggle_favorite', post_id=post.id) }}">
    <button type="submit" class="fav-btn">
        {% set is_faved = false %}
{# Verificar si el usuario actual está en la lista de favoritos del artículo #}
♡ Favorito
    </button>
</form>
{% endif %}

La operación de favorito utiliza una solicitud POST (envío de formulario), no un enlace GET. Las solicitudes GET no deben producir efectos secundarios (modificar la base de datos); este es un principio básico del desarrollo web.


Flask-Admin — Administración de backend

Flask-AdminEs la extensión en el ecosistema Flask equivalente a Django Admin.

Después de la configuración, puedes gestionar los datos de artículos y categorías en el navegador.

(venv) $ pip install flask-admin

Ejemplo

# Ruta del archivo: app.py o crea un nuevo admin_setup.py
from flask_admin import Admin
from flask_admin.contrib.sqla import ModelView
from app.models import Post, Category, User

# Personalizar ModelView: controlar qué campos se muestran en el backend
class PostAdmin(ModelView):
    column_list = ['title', 'category', 'created_at', 'updated_at']
    column_searchable_list = ['title', 'summary']
    column_filters = ['category', 'created_at']
    form_columns = ['title', 'slug', 'summary', 'content', 'category']

class CategoryAdmin(ModelView):
    column_list = ['name', 'slug']
    form_columns = ['name', 'slug']

# Crear instancia de Admin
admin = Admin(app, name='Panel de administración del blog EJEMPLO', template_mode='bootstrap4')
admin.add_view(PostAdmin(Post, db.session, name='Artículos'))
admin.add_view(CategoryAdmin(Category, db.session, name='Categorías'))
admin.add_view(ModelView(User, db.session, name='Usuarios'))

Inicia el servidor y visita/adminpara acceder a la interfaz de administración de backend.

Flask-Admin vs Django Admin

CaracterísticaFlask-AdminDjango Admin
Método de integraciónExtensión de terceros, requiere pip installIntegrado en django.contrib.admin
Registro de modelosadmin.add_view(ModelView(Model, session))admin.site.register(Model)
Campos de listacolumn_listlist_display
Búsquedacolumn_searchable_listsearch_fields
Filtradocolumn_filterslist_filter
Requiere autenticaciónNo integrado (requiere agregar @login_required manualmente)Permisos de administrador integrados

Flask-Admin no requiere inicio de sesión para acceder por defecto; es necesario combinarlo con Flask-Login para agregar control de permisos. Una forma sencilla es agregar antes de la función de vista@login_required, o sobrescribir el método de ModelViewis_accessiblepara verificar los permisos de administrador.


Resumen del capítulo

En este capítulo implementaste dos funciones importantes: la relación muchos a muchos de favoritos usando la tabla de asociación db.Table + operaciones db.session.execute; y la creación rápida del sistema de administración de backend con Flask-Admin.

Ahora las funciones interactivas del blog (usuarios, favoritos) y las funciones de administración (backend) están completas.

Otras extensiones