Update UI and migrations, fix dockerfile

forma_n8_site/README.md

@@ -0,0 +1,55 @@
+# Forma N8 Site
+
+Отдельное SSR-приложение публичного сайта Forma N8. Контент и постоянные URL не зависят от будущего дизайна.
+
+## Возможности
+
+- лента новостей, страницы статей, категорий и производителей;
+- PostgreSQL со стабильными `external_id` и `slug`;
+- idempotent API публикации и отдельный upload API;
+- RSS 2.0, sitemap, robots.txt;
+- canonical, Open Graph и JSON-LD `NewsArticle`;
+- системный деплой через nginx + systemd.
+
+## Локальный запуск
+
+```bash
+python -m venv .venv
+.venv/bin/pip install -r requirements.txt
+export DATABASE_URL=postgresql://forma_n8:forma_n8@127.0.0.1:5432/forma_n8
+PYTHONPATH=src .venv/bin/python scripts/migrate.py
+PYTHONPATH=src .venv/bin/uvicorn forma_n8_site.app:app --port 8090
+```
+
+## Публикационный API
+
+Сначала медиа загружается через `POST /api/v1/media` с заголовком `X-Forma-Token`, затем полученный относительный URL передаётся в статью.
+
+`POST /api/v1/articles`:
+
+```json
+{
+  "external_id": "parser:518",
+  "title": "Заголовок новости",
+  "lead": "Краткое описание",
+  "body": "Основной текст без HTML",
+  "category_name": "Снаряжение",
+  "category_tag": "snaryazhenie",
+  "producer_name": "Производитель",
+  "producer_tag": "producer",
+  "source_url": "https://example.com/source",
+  "status": "published",
+  "published_at": "2026-06-21T10:00:00+05:00",
+  "media": [
+    {"type": "image", "url": "/media/ab/hash.jpg", "alt": "Описание изображения"}
+  ]
+}
+```
+
+Повторный запрос с тем же `external_id` обновляет материал, но сохраняет первоначальные slug и дату первой публикации. Это предотвращает дубли URL и потерю поисковой истории.
+
+Публичное название категории берётся из таблицы `categories` по нормализованному `category_tag`. Описательные названия категорий из AI-контура не используются в URL, H1 и SEO-метаданных.
+
+После подключения домена меняется только `SITE_BASE_URL` в `/etc/forma-n8.env`; затем настраивается TLS и отправляются sitemap в Google Search Console и Яндекс Вебмастер.
+
+До подключения домена `SITE_INDEXING_ENABLED=false`: страницы получают `noindex`, а `robots.txt` запрещает обход IP-адреса. После настройки домена, HTTPS и 301-редиректа с IP значение меняется на `true`.