chore: repo cleanup + docs for admin API and DB schema (v1.2.8)

- remove stale docs/admin-frontend-spec.md (old Express/EJS admin), unused templates/ (SmartAdmin copy), dead scripts/sync-agents.cjs, committed dev.pid
- add docs/API.md (admin REST API reference) and docs/DATABASE.md (DB schema)
- refresh .env.example: drop stale ADMIN_PORT/SHOP_CONTAINER, add ADMIN_URL, HEALTH_PORT, DEFAULT_LANGUAGE, CHATBOT_API_*
- add npm run lint so Gitea workflows pass
- rebrand web-testing suite from APAW to telegram-shop

.env.example

@@ -12,6 +12,7 @@ SUPER_ADMIN_IDS=123456789
 SUPPORT_LINK=https://t.me/your_support
 
 # --- Catalog ---
+# Путь к каталогу (используется ботом; по умолчанию не требуется)
 CATALOG_PATH=./catalog
 
 # --- Encryption (ОБЯЗАТЕЛЬНО! Без этого приложение упадёт) ---
@@ -46,13 +47,26 @@ WG_ALLOWED_IPS=0.0.0.0/0,::/0
 # --- Tor Proxy ---
 # SSH backend: куда Tor перенаправляет SSH (по умолчанию хост-машина)
 SSH_HOST_IP=host.docker.internal
-# Имя контейнера магазина (для проброса админки через Tor)
-SHOP_CONTAINER=telegram_shop_prod
+# Имя контейнера админки (onion target). Жёстко задано в docker-compose.yml как tg_shop_admin.
+SHOP_CONTAINER=tg_shop_admin
 
-# --- Admin Panel ---
+# --- Admin Panel (Next.js, admin-next/) ---
+# Секрет входа в админку (токен, вводится на /login)
 ADMIN_SECRET=your_admin_token_here
 # SUPER_ADMIN_SECRET: If set to a different value than ADMIN_SECRET, users logging in
 # with this token get super_admin role (seed phrase access, commission management).
 # If not set or same as ADMIN_SECRET, all admins are super admins.
 SUPER_ADMIN_SECRET=
-ADMIN_PORT=3001
+# Публичный URL админки (для фото товаров и внешних ссылок)
+ADMIN_URL=http://your-host:3000
+# Порт health-сервера бота (Docker healthcheck)
+HEALTH_PORT=3001
+
+# --- Bot i18n ---
+# Язык по умолчанию: en / es / de
+DEFAULT_LANGUAGE=en
+
+# --- AI Chatbot (admin-next) ---
+# OpenAI-совместимый endpoint и ключ (используются, если не заданы в site_settings)
+CHATBOT_API_ENDPOINT=https://api.openai.com/v1
+CHATBOT_API_KEY=