chore: drop agent/plan docs, unify .env for Docker stack

- Remove PLAN/agent instruction files; single root .env.example for DB + API
- Stack compose uses env_file .env; delete stack env example duplicate
- Refresh README, backend docs, API doc; trim gitignore/dockerignore

Made-with: Cursor

.env.example

@@ -1,23 +1,33 @@
-# ─── PostgreSQL ───────────────────────────────────────────────
-# Не обязательны, если CALENDAR_RUN_MOCK_DB=1 (только HTTP API без БД).
+# =============================================================================
+# Корневой шаблон окружения: локальная разработка, docker-compose.yml (Postgres)
+# и docker-compose.stack.yml (backend + frontend в общей сети с Postgres).
+# Скопируйте в .env и подставьте значения. Файл .env не коммитьте.
+# =============================================================================
+
+# ─── Подключение бэкенда к PostgreSQL ──────────────────────────
+# Локально + docker-compose из этого репо: DB_HOST=localhost, DB_PORT=5432
+# Backend в Docker рядом с Postgres: DB_HOST = имя контейнера/сервиса в той же
+# docker-сети (например postgres_budget), DB_PORT=5432 (внутренний порт Postgres).
 DB_HOST=localhost
 DB_PORT=5432
 DB_NAME=calendar_run
 DB_USER=calendar_user
-DB_PASSWORD=calendar_pass
+DB_PASSWORD=replace_with_strong_secret
 
-# ─── Backend API ──────────────────────────────────────────────
-# Порт: сначала читается PORT (если задан), иначе API_PORT, иначе 3001.
-# PORT=3001
+# ─── Backend API ───────────────────────────────────────────────
+# Порт процесса: сначала PORT, иначе API_PORT, иначе 3001.
+# В docker-compose.stack.yml для контейнера задаётся PORT=3000 (см. compose).
+# PORT=3000
 API_PORT=3001
 
-# ─── Dev/CI: без PostgreSQL для smoke API (не для migrate/seed) ─
+# ─── Режим без БД (только тесты / smoke API, не для migrate/seed) ─
 # CALENDAR_RUN_MOCK_DB=1
 
-# ─── CORS ─────────────────────────────────────────────────────
-# Allowed origin for the frontend (Vite dev server default)
+# ─── CORS ────────────────────────────────────────────────────
+# Локальный Vite: http://localhost:5173
+# Стек с фронтом на 3033: http://localhost:3033
 CORS_ORIGIN=http://localhost:5173
 
-# ─── Frontend (Vite) ─────────────────────────────────────────
-# Public URL of the API, used in SPA code via import.meta.env
+# ─── Frontend (Vite, локально из каталога frontend/) ─────────
+# В Docker-образе фронта базовый URL API задаётся при сборке (/api), не из .env.
 VITE_API_BASE_URL=http://localhost:3001