feat(post-processing): admin scaffolding precursor (pydantic schema, form base, parameterized template)

[mihow]

Summary

Precursor PR for post-processing admin work. Extracts the shared admin-trigger pattern that PRs #999 (class masking) and #1272 (tracking) each grew independently, using SmallSizeFilterTask as the migration consumer.

No new domain logic. Pure scaffolding + a refactor of the existing small-size-filter trigger to expose its already-coded size_threshold knob via the admin (currently unreachable — admin trigger hardcodes empty config).

What lands

1. config_schema contract on BasePostProcessingTask — pydantic v1 model required as a class attribute, validated at task __init__
2. BasePostProcessingActionForm — django form base with to_config() → dict contract for building Job.params['config']
3. Parameterized confirmation template at admin/post_processing/confirmation.html + _form_fieldset.html partial
4. Migrated SmallSizeFilterTask:
   • SmallSizeFilterConfig(size_threshold: float = 0.0008, source_image_collection_id: int) schema
   • SmallSizeFilterActionForm with size_threshold field (0 < x < 1 validation)
   • Admin trigger rewrites onto new pattern (intermediate confirmation page)
   • Default behavior preserved (same 0.0008 default)
5. 17 tests under ami/ml/post_processing/tests/

Out of scope (deferred to follow-ups)

• Project-partitioning helper (defer to whichever multi-scope adopter lands first — likely feat(tracking): revive occurrence tracking as a post-processing task #1272's tracking, which partitions events across projects)
• REST API surface (eventual primary trigger; admin not future-primary)
• Rank rollup, class masking, tracking — they stay in their own PRs

Rebase impact for downstream PRs

• feat(tracking): revive occurrence tracking as a post-processing task #1272 (tracking, mine): smaller diff after rebase. admin_forms.py → admin/tracking_form.py. Form gains to_config(). Adds TrackingConfig schema. Per-project partition loop stays.
• Implement class masking using the post-processing framework #999 (class masking, @mohamedelabbas1996): hand-rolled HTML <select> becomes ClassMaskingActionForm(BasePostProcessingActionForm) with ModelChoiceFields. Adds ClassMaskingConfig + RankRollupConfig schemas. Will message author once this lands.

Smoke test (manual, against live stack)

End-to-end validated against project 18 capture set 175 (10 images):

1. Action dropdown lists "Run Small Size Filter post-processing task (async)" ✓
2. Click Go → renders intermediate confirmation page (template admin/post_processing/confirmation.html rendered) ✓
3. Form shows size_threshold field with default 0.0008 and help text ✓

4. Submit → redirect with success message; Job 1571 created and enqueued; celeryworker picked up; ran to SUCCESS ✓
5. Job.params payload validated typed: {'task': 'small_size_filter', 'config': {'size_threshold': 0.0008, 'source_image_collection_id': 175}} ✓

Test plan

• test_base_schema.py — subclass without schema raises, bad config raises ValidationError, valid config builds BaseModel instance, unknown keys rejected (extra="forbid")
• test_admin_form.py — to_config() round-trip, size_threshold range validation
• test_small_size_filter_admin.py — POST without confirm renders intermediate page (no Job created), POST with valid confirm=yes creates one Job per collection with threshold in config, invalid threshold re-renders form with error, multi-collection POST creates per-collection jobs with correct project FKs
• Manual smoke: trigger from Django admin against existing test data; verify Job runs to completion with custom threshold

Design doc

docs/claude/planning/2026-05-01-post-processing-admin-scaffolding-design.md (committed in this branch).

Notes

• Pydantic v1 syntax throughout (repo pins pydantic<2.0).
• Pyright will surface __fields__ and validator as deprecated in some envs — these come from local v2 stubs; container is v1 and the syntax is correct.

[netlify]

✅ Deploy Preview for antenna-preview canceled.

Name	Link
🔨 Latest commit	a1c8600
🔍 Latest deploy log	https://app.netlify.com/projects/antenna-preview/deploys/69f52704678d98000856df61

[netlify]

✅ Deploy Preview for antenna-ssec canceled.

Name	Link
🔨 Latest commit	a1c8600
🔍 Latest deploy log	https://app.netlify.com/projects/antenna-ssec/deploys/69f52704b06ff400080794c4

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 47c908d6-fc3b-4dcf-8de3-fa7954cb301e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/post-processing-admin-scaffolding

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}