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

docker-compose.stack.yml

@@ -1,15 +1,19 @@
-# Запуск приложения в сети с уже поднятым PostgreSQL (как у family-budget).
+# Backend + frontend в сети с уже поднятым PostgreSQL (external network).
 #
-# 1) Скопируйте пример переменных (не коммитьте файл с паролями):
-#    cp docker-compose.stack.env.example docker-compose.stack.env
-#    отредактируйте docker-compose.stack.env
+# Подготовка: из корня репозитория скопируйте .env.example → .env и задайте DB_*
+# и CORS_ORIGIN (для фронта на :3033 — http://localhost:3033).
 #
-# NPM / reverse proxy: проброс на порт фронта 3033 (внутри контейнера nginx слушает 80).
-# Фронт в браузере ходит на /api → nginx проксирует на backend:3000.
+# Сеть (имя должно существовать, как у вашего Postgres):
+#   docker network ls
 #
-# Первая инициализация БД (один раз, когда Postgres уже доступен по DB_HOST):
+# Запуск:
+#   docker compose -f docker-compose.stack.yml up -d --build
+#
+# Миграции и seed (один раз после появления БД):
 #   docker compose -f docker-compose.stack.yml exec backend node dist/migrate.js
 #   docker compose -f docker-compose.stack.yml exec backend node dist/seed.js
+#
+# NPM: проброс на порт 3033. Браузер ходит на /api → nginx во фронте → backend:3000.
 
 services:
   backend:
@@ -18,7 +22,7 @@ services:
       dockerfile: Dockerfile.backend
     container_name: runners-calendar-backend
     env_file:
-      - docker-compose.stack.env
+      - .env
     environment:
       - PORT=3000
     ports: