Django新手求助：预订系统开源项目推荐及BooleanFilter参数转换

嘿，作为Django新手搞预订系统学习项目，确实找对参考项目能少走很多弯路，同时那个布尔参数的问题我也帮你捋清楚解决方案～

• django-reservation：轻量级的预订系统框架，代码结构非常清晰，专门针对资源预订场景设计。你能从里面学到基础的预订流程实现，比如时间冲突检测、用户预订状态管理这些核心功能，对新手友好度拉满。
• django-calendar：基于Django的日历型预订项目，集成了直观的日历展示和预订操作。可以学习到如何把日期时间处理和Django的模型、视图层结合起来，代码注释也比较详细，容易上手。
• django-booking：功能相对完整的预订系统，包含用户认证、预订确认邮件、订单管理等模块。适合你在掌握基础之后，参考生产环境中常见的预订系统组件实现，进阶学习。

你遇到的这个问题，是因为CheckboxInput组件在勾选时提交的参数是on，未勾选时可能提交off或者不提交，而django-filters的BooleanFilter默认期望的是标准布尔值。这里有几种实用的解决方法：

方法1：自定义通用布尔过滤器（推荐） #

创建一个自定义的BooleanFilter，自动帮你把"on"/"off"转换成布尔值，一次定义就能复用在所有布尔字段上：

# filters.py
import django_filters
from django.db import models

class CustomBooleanFilter(django_filters.BooleanFilter):
    def filter(self, qs, value):
        # 转换on/off为True/False
        if value == 'on':
            value = True
        elif value == 'off':
            value = False
        # 调用父类的过滤逻辑
        return super().filter(qs, value)

class MymodelFilter(django_filters.FilterSet):
    class Meta:
        model = Mymodel
        fields = ['is_xxx_approved', 'is_contracted_by_yy', 'is_zz_approved']
        exclude = [ 'name', 'address', 'phone', 'email',]
        filter_overrides = {
            models.BooleanField: {
                'filter_class': CustomBooleanFilter,  # 替换成自定义过滤器
                'extra': lambda f: {
                    'widget': forms.CheckboxInput,
                },
            },
        }

方法2：为单个字段指定转换方法 #

如果只想针对特定字段处理，可以给每个布尔过滤器指定一个自定义方法：

# filters.py
from django import forms
import django_filters

class MymodelFilter(django_filters.FilterSet):
    is_xxx_approved = django_filters.BooleanFilter(
        widget=forms.CheckboxInput,
        method='convert_boolean_param'
    )
    is_contracted_by_yy = django_filters.BooleanFilter(
        widget=forms.CheckboxInput,
        method='convert_boolean_param'
    )
    is_zz_approved = django_filters.BooleanFilter(
        widget=forms.CheckboxInput,
        method='convert_boolean_param'
    )

    def convert_boolean_param(self, queryset, name, value):
        # 转换参数值
        bool_value = True if value == 'on' else False
        return queryset.filter(**{name: bool_value})

    class Meta:
        model = Mymodel
        exclude = [ 'name', 'address', 'phone', 'email',]

方法3：在视图层提前处理请求参数 #

要是不想修改过滤器代码，也可以在视图里先处理GET参数：

# views.py
from django.shortcuts import render
from .filters import MymodelFilter
from .models import Mymodel

def my_booking_view(request):
    # 复制GET参数（因为原始GET是不可变对象）
    modified_get = request.GET.copy()
    # 遍历需要转换的布尔参数
    boolean_params = ['is_xxx_approved', 'is_contracted_by_yy', 'is_zz_approved']
    for param in boolean_params:
        if param in modified_get:
            val = modified_get[param]
            modified_get[param] = 'True' if val == 'on' else 'False'
    
    # 使用修改后的参数初始化过滤器
    filter = MymodelFilter(modified_get, queryset=Mymodel.objects.all())
    return render(request, 'your_template.html', {'filter': filter})

个人更推荐方法1，它的复用性最好，不用重复写转换逻辑，适合你项目里多个布尔过滤字段的场景。

内容的提问来源于stack exchange，提问作者selmanceker