Add the filter/rules engine

Implements FilterRule (one condition -> action, scoped to a feed and/or
folder or global) with an evaluation engine applied at ingest time:
after the fetch pipeline commits new/updated articles, each affected
subscriber's enabled rules run in priority order against them, with
tag/star/mark_read actions stacking and hide short-circuiting further
evaluation for that article.

Adds rule management (create/edit/delete) and a "Re-apply" action that
re-evaluates a user's full ruleset against their unread backlog, scoped
by the triggering rule's own feed/folder — so a newly added rule can
retroactively affect already-ingested articles, not just future ones.

Verified live in-browser: created a "title contains 'Show HN' -> star"
rule scoped to the subscribed Hacker News feed, re-applied it against
the existing unread backlog, and confirmed both matching articles were
starred.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
ksmithandClaude Sonnet 5 committed 2026-10-30 16:31:33 -06:00
1 parent 579696efc0
commit 5ed0499845
18 files changed
+1072 -6

No files matched your search

+55 -1
View File
@@ -1 +1,55 @@
# Create your views here.
from django.contrib import messages
from django.contrib.auth.decorators import login_required
from django.shortcuts import get_object_or_404, redirect, render
from django.views.decorators.http import require_POST
from .forms import FilterRuleForm
from .models import FilterRule
from .tasks import reapply_rules_for_user_backlog
@login_required
def rule_list(request):
rules = FilterRule.objects.filter(user=request.user).select_related("feed", "folder")
return render(request, "rules/rule_list.html", {"rules": rules})
@login_required
def create_rule(request):
form = FilterRuleForm(request.POST or None, user=request.user)
if request.method == "POST" and form.is_valid():
form.save()
messages.success(request, "Rule created.")
return redirect("rules:rule_list")
return render(request, "rules/rule_form.html", {"form": form})
@login_required
def edit_rule(request, rule_id):
rule = get_object_or_404(FilterRule, user=request.user, pk=rule_id)
form = FilterRuleForm(request.POST or None, instance=rule, user=request.user)
if request.method == "POST" and form.is_valid():
form.save()
messages.success(request, "Rule updated.")
return redirect("rules:rule_list")
return render(request, "rules/rule_form.html", {"form": form, "rule": rule})
@login_required
@require_POST
def delete_rule(request, rule_id):
rule = get_object_or_404(FilterRule, user=request.user, pk=rule_id)
rule.delete()
messages.success(request, "Rule deleted.")
return redirect("rules:rule_list")
@login_required
@require_POST
def reapply_rule(request, rule_id):
rule = get_object_or_404(FilterRule, user=request.user, pk=rule_id)
# Run synchronously for immediate feedback, same pattern as add_feed —
# a Celery worker isn't required for this to work.
count = reapply_rules_for_user_backlog(rule.pk)
messages.success(request, f"Re-applied your rules to {count} unread article(s).")
return redirect("rules:rule_list")