From 22e4be15485dd89ddef2f9cbb46f551380a5bf06 Mon Sep 17 00:00:00 2001
From: stumpylog <797416+stumpylog@users.noreply.github.com>
Date: Wed, 29 Jul 2026 12:11:53 -0700
Subject: [PATCH] feat(benchmark): scaffold paperless_benchmark app

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .gitignore                                              | 3 +++
 src/paperless/settings/__init__.py                      | 1 +
 src/paperless_benchmark/__init__.py                     | 0
 src/paperless_benchmark/apps.py                         | 8 ++++++++
 src/paperless_benchmark/management/__init__.py          | 0
 src/paperless_benchmark/management/commands/__init__.py | 0
 6 files changed, 12 insertions(+)
 create mode 100644 src/paperless_benchmark/__init__.py
 create mode 100644 src/paperless_benchmark/apps.py
 create mode 100644 src/paperless_benchmark/management/__init__.py
 create mode 100644 src/paperless_benchmark/management/commands/__init__.py

diff --git a/.gitignore b/.gitignore
index d4b1403a6..cbaa0dd53 100644
--- a/.gitignore
+++ b/.gitignore
@@ -115,3 +115,6 @@ celerybeat-schedule*
 
 # Git worktree local folder
 .worktrees
+
+# Benchmark tooling output (local only, never committed)
+/benchmark_results/
diff --git a/src/paperless/settings/__init__.py b/src/paperless/settings/__init__.py
index 55aac5a91..129fa9b3e 100644
--- a/src/paperless/settings/__init__.py
+++ b/src/paperless/settings/__init__.py
@@ -150,6 +150,7 @@ INSTALLED_APPS = [
     "drf_spectacular",
     "drf_spectacular_sidecar",
     "treenode",
+    "paperless_benchmark.apps.PaperlessBenchmarkConfig",
     *env_apps,
 ]
 
diff --git a/src/paperless_benchmark/__init__.py b/src/paperless_benchmark/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/src/paperless_benchmark/apps.py b/src/paperless_benchmark/apps.py
new file mode 100644
index 000000000..05cbdc0b4
--- /dev/null
+++ b/src/paperless_benchmark/apps.py
@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class PaperlessBenchmarkConfig(AppConfig):
+    name = "paperless_benchmark"
+
+    verbose_name = _("Paperless benchmark")
diff --git a/src/paperless_benchmark/management/__init__.py b/src/paperless_benchmark/management/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/src/paperless_benchmark/management/commands/__init__.py b/src/paperless_benchmark/management/commands/__init__.py
new file mode 100644
index 000000000..e69de29bb