Files

T

nineap 899c54e1fc Unify auth with backend cookie sessions; add dev-deploy pipeline

Auth: drop localStorage session token entirely, talk to netrunner-backend
via credentials:"include" HttpOnly cookies shared over the common parent
domain, and redirect to the account subdomain (ЛК) after login instead of
a dead local /profile route.

Config: NEXT_PUBLIC_* values used by client components (API_URL,
ACCOUNT_ORIGIN, BOT_USERNAME, PB_URL) get inlined into the JS bundle at
image build time and can't be overridden by docker-compose environment at
container start. Moved these reads into server components (page.tsx) and
thread them down as props, so one built image can genuinely serve both
prod and dev by config alone.

CI/CD: split the old single auto-deploy-to-prod workflow into build.yml
(build+push on every push to main) and deploy.yml with deploy-dev (auto,
same VPS as netrunner-backend's dev environment) and deploy-prod (manual
dispatch only) — mirrors netrunner-backend's pipeline shape. Added
docker-compose.dev-remote.yml pointing at the dev backend.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-04 15:26:28 +07:00

6.5 KiB

Raw Blame History

`app/` — маршруты Next.js App Router

Весь пользовательский контент живёт под динамическим сегментом app/[lang]/, кроме нескольких файлов верхнего уровня, которые Next.js требует держать вне локализованных сегментов (not-found.tsx, loading.tsx, globals.css, favicon.ico).

Как работает i18n через `[lang]`

Корневой proxy.ts (Next.js middleware) перехватывает каждый запрос. Если путь уже начинается с /en или /ru — пропускает его как есть. Если локали в пути нет (например, /) — определяет язык браузера через заголовок Accept-Language (Negotiator + @formatjs/intl-localematcher) и редиректит на /en... или /ru....
Дальше уже сам Next.js резолвит запрос в app/[lang]/..., а params.lang передаётся во все page.tsx/layout.tsx этого сегмента.
generateStaticParams в проекте не используется — страницы под [lang] не пре-генерируются статически на билде для en/ru, а рендерятся динамически (server-side) по каждому запросу, с точечным ISR-кэшированием там, где это нужно (см. revalidate в запросах к PocketBase в Faq.tsx, BlogPreview.tsx, blog/page.tsx).
Строковый контент (заголовки, лейблы, кнопки) берётся не из PocketBase, а из JSON-словарей dictionaries/en.json / dictionaries/ru.json, которые грузятся через getDictionary(lang) из lib/dictionaries.ts (только на сервере, файл помечен import "server-only").

Паттерн `page.tsx` + `*-client.tsx`

Почти каждый раздел состоит из пары файлов:

page.tsx — серверный async-компонент. Получает params.lang, грузит словарь (getDictionary) и/или данные из PocketBase (lib/pb.ts), передаёт их вниз как пропсы.
*-client.tsx — клиентский компонент ("use client") с интерактивностью: анимации на framer-motion, локальное состояние, realtime-подписки PocketBase, запросы к Rust-шлюзу proxy-ws и т.д.

Разделение оправдано тем, что серверная часть не тянет в клиентский бандл лишний JS (словари, PocketBase SDK для первого запроса), а клиентская часть свободно использует хуки и браузерные API.

Есть и раздел без клиентской пары — blog и blog/[slug], а также Faq.tsx/ BlogPreview.tsx в components/sections/: там контент статичен после загрузки (no client-only interactivity), поэтому они остаются серверными компонентами целиком.

Разделы

Маршрут	Файлы	Назначение
`/`	`page.tsx`	Главная: статично рендерит `Hero`+`Features`, а `Pricing`/`FAQ`/`TerminalGuestbook`/`BlogPreview` подгружает через `next/dynamic` (code-splitting тяжёлых интерактивных секций, см. комментарий в файле)
`/auth`	`page.tsx` + `auth-client.tsx`	Авторизация через Telegram Login Widget против бэкенда на `account.netrunner-vpn.com` (`/users/me`, `/auth/telegram`, `credentials: "include"`); сессия — только HttpOnly cookie с `Domain=.netrunner-vpn.com`, лендинг ничего не хранит сам (ни `localStorage`, ни токен в URL). После успеха — полный переход на `{ACCOUNT_ORIGIN}/profile` (ЛК физически в другом сервисе, не в этом репо)
`/blog`	`page.tsx`	Список опубликованных постов из PocketBase (`posts_{lang}`), ISR-кэш на час
`/blog/[slug]`	`page.tsx`	Отдельный пост блога, контент рендерится как HTML (`dangerouslySetInnerHTML`), без кэша (`cache: "no-store"`)
`/docs`	`page.tsx` + `docs-client.tsx`	"Хранилище" документов (`documents_{lang}`) с поиском и фильтром по категориям, читалка на весь экран
`/download`	`page.tsx` + `download-client.tsx`	Клиенты VPN по платформам из PocketBase (`downloads_{lang}`), ссылки на прямое скачивание/магазины
`/nodes`	`page.tsx` + `nodes-client.tsx`	Список VPN-серверов со статусом/пингом/загрузкой — сейчас данные моковые, реального API ещё нет
`/speedtest`	`page.tsx`	Обёртка вокруг `components/sections/SpeedtestClient.tsx` — измерение скорости через Rust-шлюз `proxy-ws`
`/terminal`	`page.tsx` + `terminal-client.tsx`	Полноэкранная версия гостевой книги с постраничной подгрузкой истории

Откуда берутся данные

Переводы UI — dictionaries/en.json / dictionaries/ru.json через lib/dictionaries.ts.
Динамический контент (посты, FAQ, тарифы, документы, платформы загрузки, комментарии гостевой книги) — PocketBase через синглтон lib/pb.ts. Коллекции обычно разделены по языку суффиксом (posts_en/posts_ru, faqs_en/faqs_ru и т.д.).
Гостевая книга и спидтест отправляют/читают трафик не напрямую в PocketBase, а через Rust-шлюз proxy-ws (см. /api/proxy/* в next.config.ts), т.к. там происходит модерация сообщений и реальные замеры скорости.

6.5 KiB Raw Blame History Unescape Escape

app/ — маршруты Next.js App Router

Как работает i18n через [lang]

Паттерн page.tsx + *-client.tsx