nginx: vhost для v2 (порт 4146, 301-карта для legacy WP cyrillic slugs) + CLAUDE.md проекта

2026-05-21 01:26:23 +03:00
parent 76cdeb8b48
commit a0219ee8f3
2 changed files with 191 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,91 @@
+# pushkinohistory.ru — Vite+React v2
+
+Сайт «История города Пушкино». Редизайн с WordPress (v1, контейнер `pushkinohistory-ru:4143`) на статический Vite+React+Tailwind (контейнер `pushkinohistory-ru-v2:4146`).
+
+## Стек
+
+- Vite 6 + React 18 + Tailwind 3
+- PT Serif (заголовки/основной текст) + IBM Plex Sans (UI)
+- Express 4 + compression (runtime сервер, отдаёт prerendered HTML + `/api/news.json` + `/feed/`)
+- Puppeteer для prerender (chromium в build-стадии)
+- fast-xml-parser для агрегатора внешних RSS
+
+## Структура
+
+```
+src/
+  App.jsx              # клиентский роутер (window.history + popstate), 301-карта oldSlug → newSlug
+  components/          # Header, Sidebar, Footer, PostCard
+  content/             # JSON-контент: posts, pages, partners, ads, transport, feeds
+  pages/               # Home, Post, Page, Category, News, NotFound
+server/index.js        # Express: /api/health, /api/news.json, /uploads/, /feed/, статика
+scripts/
+  convert_posts.py     # WP DB → src/content/{posts,pages}.json
+  build-rss.js         # генератор IPB-совместимого RSS (full content в CDATA)
+  build-sitemap.js     # sitemap.xml + robots.txt
+  build-slugs.js       # routes.json для prerender
+  prerender.js         # SPA → статичные HTML по маршрутам через puppeteer
+  pull-external-rss.js # cron: внешние RSS → data/news.json (агрегатор)
+public/uploads/        # картинки, перенесены из WP /wp-content/uploads/
+nginx/                 # vhost для прода (симлинк из /etc/nginx/conf.d/)
+```
+
+## Контент
+
+Скрейп из WP DB (`pushkinohistory_ru` на `db.hhivp.com`):
+- 7 постов + 4 страницы
+- 6 картинок в `public/uploads/`
+- URL-encoded кириллические slugs WP → транслитерированы (`/segodnya-nochyu-rossiyane-uvidyat-pervoe/`); старые URL → 301 через `nginx/map`
+
+## RSS
+
+- **Свой `/feed/`** — IPB-совместимый RSS 2.0 с полным HTML в `<content:encoded>`, стабильными `<guid isPermaLink>`, `<dc:creator>`, категориями. Для импорта в `forum.pushkinohistory.ru`.
+- **Внешние фиды** — `src/content/feeds.json` (список URL), парсятся cron-скриптом `scripts/pull-external-rss.js` → `data/news.json` (bind-mount), фронт читает client-side через `/api/news.json`. Каждое добавление источника = редактирование `feeds.json` + push.
+
+## Деплой
+
+```bash
+# Локально:
+cd E:\Projects\pushkinohistory-ru-v2
+git add . && git commit -m "..." && git push
+
+# На web.hhivp.com:
+ssh striker@web.hhivp.com
+cd /opt/docker/sites/pushkinohistory-ru-v2
+git pull && docker compose up -d --build
+```
+
+CI/CD автоматизация — Gitea Actions с SSH-deploy (см. `.gitea/workflows/deploy.yml`).
+
+## Контейнер
+
+- Image: `pushkinohistory-ru-v2:latest` (мультистейдж: builder с puppeteer/chromium → runtime node:22-alpine + express)
+- Порт: `127.0.0.1:4146`
+- Bind-mounts:
+  - `/opt/www/pushkinohistory.ru/uploads-v2 → /app/public/uploads (ro)` — динамические uploads
+  - `/opt/docker/sites/pushkinohistory-ru-v2/data → /app/data (ro)` — `news.json` от cron
+- nginx vhost: `/etc/nginx/conf.d/pushkinohistory.ru` → симлинк на `nginx/pushkinohistory.ru.conf` в этом репо
+
+## Откат на WP v1
+
+Старый WP в `/opt/docker/sites/pushkinohistory-ru/` (контейнер `pushkinohistory-ru:4143`) сохранён. Чтобы откатиться:
+
+```bash
+ssh striker@web.hhivp.com
+sudo ln -sfn /opt/docker/sites/pushkinohistory-ru/nginx/pushkinohistory.ru.conf /etc/nginx/conf.d/pushkinohistory.ru
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+## БД (WP, v1)
+
+DB на `db.hhivp.com` (45.10.53.205), `pushkinohistory_ru`/`u_pushhist`, prefix `ph_`. **Не удалять** — нужна для отката и как источник для повторного скрейпа.
+
+## Форум
+
+`forum.pushkinohistory.ru` — IPB 4.x в отдельном контейнере `forum-pushkinohistory-ru:4144`. **v2 редизайном не затронут.**
+
+## История
+
+- 2026-05-08: v1 контейнеризован, миграция со str-u-01 на web.hhivp.com
+- 2026-05-14: фикс trust-proxy.conf для Docker bridges (Better WP Security)
+- 2026-05-21: v2 редизайн — Vite+React+Tailwind, отказ от WP, RSS-агрегатор внешних фидов + свой RSS для IPB