def yard_sign_voters(request):
    """
    Manage yard sign requests. Groups voters who want a yard sign by household.
    """
    selected_tenant_id = request.session.get("tenant_id")
    if not selected_tenant_id:
        messages.warning(request, "Please select a campaign first.")
        return redirect("index")

    tenant = get_object_or_404(Tenant, id=selected_tenant_id)
    
    city_filter = request.GET.get("city", "").strip()
    district_filter = request.GET.get('district', '').strip()
    neighborhood_filter = request.GET.get('neighborhood', '').strip()
    address_filter = request.GET.get('address', '').strip()

    # Initial queryset: voters who want a yard sign for this tenant
    voters = Voter.objects.filter(tenant=tenant, yard_sign='wants')

    if city_filter:
        voters = voters.filter(city__icontains=city_filter)
    if district_filter:
        voters = voters.filter(district=district_filter)
    if neighborhood_filter:
        voters = voters.filter(neighborhood__icontains=neighborhood_filter)
    if address_filter:
        voters = voters.filter(Q(address__icontains=address_filter) | Q(address_street__icontains=address_filter))

    # Grouping by household (unique address)
    households_dict = {}
    for voter in voters:
        key = (voter.address_street, voter.city, voter.state, voter.zip_code)
        if key not in households_dict:
            street_number = ""
            street_name = voter.address_street or ""
            match = re.match(r'^(\d+)\s+(.*)$', voter.address_street)
            if match:
                street_number = match.group(1)
                street_name = match.group(2)
            
            try:
                street_number_sort = int(street_number)
            except ValueError:
                street_number_sort = 0

            households_dict[key] = {
                'address_street': voter.address_street,
                'city': voter.city,
                'state': voter.state,
                'zip_code': voter.zip_code,
                'neighborhood': voter.neighborhood,
                'district': voter.district,
                'latitude': float(voter.latitude) if voter.latitude else None,
                'longitude': float(voter.longitude) if voter.longitude else None,
                'street_name_sort': street_name.lower(),
                'street_number_sort': street_number_sort,
                'voters_who_want_sign': [],
            }
        households_dict[key]['voters_who_want_sign'].append(voter)

    households_list = list(households_dict.values())
    households_list.sort(key=lambda x: (
        (x['neighborhood'] or '').lower(),
        x['street_name_sort'],
        x['street_number_sort']
    ))

    # Prepare data for Google Map
    map_data = [
        {
            'lat': h['latitude'],
            'lng': h['longitude'],
            'address': f"{h['address_street']}, {h['city']}, {h['state']}",
            'voters': ", ".join([f"{v.first_name} {v.last_name}" for v in h['voters_who_want_sign']]),
            'voter_ids': [v.id for v in h['voters_who_want_sign']]
        }
        for h in households_list if h['latitude'] and h['longitude']
    ]

    paginator = Paginator(households_list, 50)
    page_number = request.GET.get('page')
    households_page = paginator.get_page(page_number)

    context = {
        'selected_tenant': tenant,
        'households': households_page,
        'district_filter': district_filter,
        'neighborhood_filter': neighborhood_filter,
        'address_filter': address_filter,
        "city_filter": city_filter,
        'map_data_json': json.dumps(map_data),
        'GOOGLE_MAPS_API_KEY': getattr(settings, 'GOOGLE_MAPS_API_KEY', ''),
    }
    return render(request, 'core/yard_sign_voters.html', context)