chore: dev environment cleanup

.gitignore

@@ -190,6 +190,11 @@ TODO-*.md
 # kasowany na exit.
 .run-site-config
 
+# Runtime state dir run-site: dev secret_key i inne ephemeralne dotfiles.
+# Tworzone na uruchomieniu, NIE wolno commitowac (secret_key to dev key
+# generowany per maszyne; commit byly faktycznym wyciekiem klucza).
+.run-site/
+
 # Dotfiles django-dev-helpers (token + porty), tworzone przez
 # `django-dev-helpers` w korzeniu repo gdy aktywne (run-site ustawia
 # DJANGO_DEV_HELPERS_ENABLED). Ulotne; kasowane na exit.

CLAUDE.md

@@ -21,6 +21,19 @@ management system built with Django. Python >=3.10,<3.15.
 - **Ask questions** if anything is unclear before taking on non-trivial tasks
 - **NEVER modify existing migration files** in `src/*/migrations/`
 - **Max line length: 88 characters** (enforced by ruff)
+- **Worktrees NIGDY w `bpp/` (ani w `.claude/worktrees/`).** Wszystkie
+  worktree mają lądować jako siostrzane katalogi obok głównego checkoutu,
+  tzn. w `~/Programowanie/`. Nazwa: `bpp-<feature-slug>`.
+  - ❌ `bpp/.claude/worktrees/<slug>` — zaśmieca repo, łatwo wpada do `find`,
+    `grep`, edytora, snapshotów IDE.
+  - ✅ `~/Programowanie/bpp-<slug>` — jako siostra `~/Programowanie/bpp`.
+  - Domyślny `EnterWorktree name=<slug>` claude'a tworzy worktree w
+    `bpp/.claude/worktrees/` — to **NIE** jest akceptowalne. Zamiast tego:
+    ```bash
+    git worktree add ~/Programowanie/bpp-<slug> -b worktree-<slug>
+    ```
+    a potem `EnterWorktree path=~/Programowanie/bpp-<slug>` żeby wejść
+    w już-istniejący worktree zamiast tworzyć kolejny.
 - **Icons in templates:**
   - Public frontend (Foundation CSS): monochrome Foundation-Icons
     (`<span class="fi-icon"/>`)

pyproject.toml

@@ -462,7 +462,7 @@ dev = [
     # django-run-site: CLI orchestrator dev stack-u. Dawniej `manage.py run_site`
     # + helpery w `_run_site_helpers/`. Instalowany w dev-deps zeby `uv run run-site`
     # mialo dostep do CLI bez globalnego `uv tool install`. Konfiguracja: runsite.toml.
-    "run-site>=0.4.0",
+    "django-run-site>=0.14.0",
     # django-dev-helpers: autologin endpoint + dotfiles dla agentow LLM. Dawniej
     # `src/django_bpp/views_run_site_autologin.py`. Aktywuje sie tylko gdy run-site
     # ustawi DJANGO_DEV_HELPERS_ENABLED=1 — w produkcji no-op.

runsite.toml

@@ -63,6 +63,7 @@ db_password = "DJANGO_BPP_DB_PASSWORD"
 redis_url = "DJANGO_BPP_REDIS_URL"
 redis_host = "DJANGO_BPP_REDIS_HOST"
 redis_port = "DJANGO_BPP_REDIS_PORT"
+allowed_hosts = "mac-mini"
 
 [env.extra]
 # Wymusza pominiecie .env w base.py — zmienne dostarcza run-site, .env mogloby

src/django_bpp/settings/local.py

@@ -43,7 +43,7 @@ def setenv_default(varname, default_value):
     "dockerhost",
     "localhost",
     "127.0.0.1",
-    "mac.iplweb",
+    "mac-mini",
     "publikacje-test",
     "test.unexistenttld",
     env("DJANGO_BPP_HOSTNAME"),  # noqa