feat: генерация llms.txt, лендинг с выбором языка и ZIP-архивов

- удалён concat-md.js: вместо единого RULES.md теперь llms.txt
- добавлен generate-llms.ts: собирает llms.txt из sidebar config, копирует
  .md-файлы для отдачи LLM и упаковывает ZIP-архивы по локалям
- добавлен корневой /llms.txt как роутер на /ru/llms.txt и /en/llms.txt
- добавлен манифест /manifest.json со ссылками и версией сборки
- добавлен лендинг docs/index.md (layout: false) с автоопределением
  языка, переключателями языка и темы
- английская локаль временно заблокирована: карточки как заглушки,
  ссылка на /en/ в роутере без href
- добавлены поля llmsBlockquote и llmsContext в локали для
  технодокументационного описания в llms.txt
- разделены VitePress-локали: root (только лендинг), ru (/ru/), en (/en/)
- добавлен srcExclude: ['public/**'] чтобы VitePress не рендерил
  сгенерированные .md как страницы
- добавлен Vite-плагин для отдачи .txt и .md с charset=utf-8
- добавлена секция в Caddyfile для текстовых файлов
- BUILD_VERSION пробрасывается из Gitea CI через docker --build-arg
  и подставляется в лендинг через Vite define
- Dockerfile: установка zip, npm run llms перед npm run build
- обновлены внутренние ссылки в docs/ru/**/*.md на префикс /ru/
- обновлены AGENTS.md и CONTRIBUTING.md под новый процесс
- README/README_RU генерируются из docs/{lang}/index.md, остаются в репо

.vitepress/config.ts

@@ -3,45 +3,45 @@ import { defineConfig } from 'vitepress';
 const ruSidebar = [
   {
     text: 'Workflow',
-    link: '/workflow',
+    link: '/ru/workflow',
   },
   {
     text: 'Базовые правила',
     items: [
-      { text: 'Технологии и библиотеки', link: '/basics/tech-stack' },
-      { text: 'Именование', link: '/basics/naming' },
+      { text: 'Технологии и библиотеки', link: '/ru/basics/tech-stack' },
+      { text: 'Именование', link: '/ru/basics/naming' },
       {
         text: 'Архитектура',
         collapsed: true,
         items: [
-          { text: 'Обзор', link: '/basics/architecture/' },
-          { text: 'Слои', link: '/basics/architecture/reference/layers' },
-          { text: 'Модули', link: '/basics/architecture/reference/modules' },
-          { text: 'Сегменты', link: '/basics/architecture/reference/segments' },
+          { text: 'Обзор', link: '/ru/basics/architecture/' },
+          { text: 'Слои', link: '/ru/basics/architecture/reference/layers' },
+          { text: 'Модули', link: '/ru/basics/architecture/reference/modules' },
+          { text: 'Сегменты', link: '/ru/basics/architecture/reference/segments' },
         ],
       },
-      { text: 'Стиль кода', link: '/basics/code-style' },
-      { text: 'Документирование', link: '/basics/documentation' },
-      { text: 'Типизация', link: '/basics/typing' },
+      { text: 'Стиль кода', link: '/ru/basics/code-style' },
+      { text: 'Документирование', link: '/ru/basics/documentation' },
+      { text: 'Типизация', link: '/ru/basics/typing' },
     ],
   },
   {
     text: 'Прикладные разделы',
     items: [
-      { text: 'Структура проекта', link: '/applied/project-structure' },
-      { text: 'Компоненты', link: '/applied/components' },
-      { text: 'Страницы (App Router)', link: '/applied/page-level' },
-      { text: 'Шаблоны и генерация кода', link: '/applied/templates-generation' },
-      { text: 'Стили', link: '/applied/styles' },
-      { text: 'Изображения', link: '/applied/images-sprites' },
-      { text: 'SVG-спрайты', link: '/applied/svg-sprites' },
-      { text: 'Видео', link: '/applied/video' },
-      { text: 'API', link: '/applied/api' },
-      { text: 'Stores', link: '/applied/stores' },
-      { text: 'Хуки', link: '/applied/hooks' },
-      { text: 'Шрифты', link: '/applied/fonts' },
-      { text: 'Локализация', link: '/applied/localization' },
-      { text: 'Настройка VS Code', link: '/applied/vscode' },
+      { text: 'Структура проекта', link: '/ru/applied/project-structure' },
+      { text: 'Компоненты', link: '/ru/applied/components' },
+      { text: 'Страницы (App Router)', link: '/ru/applied/page-level' },
+      { text: 'Шаблоны и генерация кода', link: '/ru/applied/templates-generation' },
+      { text: 'Стили', link: '/ru/applied/styles' },
+      { text: 'Изображения', link: '/ru/applied/images-sprites' },
+      { text: 'SVG-спрайты', link: '/ru/applied/svg-sprites' },
+      { text: 'Видео', link: '/ru/applied/video' },
+      { text: 'API', link: '/ru/applied/api' },
+      { text: 'Stores', link: '/ru/applied/stores' },
+      { text: 'Хуки', link: '/ru/applied/hooks' },
+      { text: 'Шрифты', link: '/ru/applied/fonts' },
+      { text: 'Локализация', link: '/ru/applied/localization' },
+      { text: 'Настройка VS Code', link: '/ru/applied/vscode' },
     ],
   },
 ];
@@ -92,30 +92,71 @@ const enSidebar = [
   },
 ];
 
+/**
+ * Vite-плагин: отдаёт `.txt` и `.md` с явной кодировкой UTF-8.
+ * Без этого браузер декодирует как ISO-8859-1 и кириллица ломается.
+ */
+const utf8TextPlugin = {
+  name: 'utf8-text-files',
+  configureServer(server: any) {
+    server.middlewares.use((req: any, res: any, next: any) => {
+      const url: string = req.url || '';
+      if (url.endsWith('.txt') || url.endsWith('.md')) {
+        res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+      }
+      next();
+    });
+  },
+};
+
 export default defineConfig({
   srcDir: 'docs',
+  // `docs/public/` содержит сгенерированные `.md`-копии и `llms.txt` для LLM
+  // (попадают в корень `dist/` как статика). Исключаем из сканирования
+  // страниц, иначе VitePress рендерит их как HTML-страницы.
+  srcExclude: ['public/**'],
   title: 'NextJS Style Guide',
   description: 'Правила и стандарты разработки на NextJS и TypeScript',
 
-  rewrites: {
-    'ru/:rest*': ':rest*',
+  vite: {
+    plugins: [utf8TextPlugin],
+    define: {
+      __BUILD_VERSION__: JSON.stringify(process.env.BUILD_VERSION || 'dev'),
+    },
   },
 
   locales: {
     root: {
+      label: 'Languages',
+      lang: 'en',
+    },
+    ru: {
       label: 'Русский',
       lang: 'ru-RU',
+      link: '/ru/',
+      description: 'Стандарты разработки на Next.js + TypeScript с архитектурой SLM',
       themeConfig: {
         sidebar: ruSidebar,
       },
+      // Расширенный блок описания для llms.txt — даёт LLM полный
+      // технический контекст: стек, методология, охват тем.
+      llmsBlockquote:
+        'Стандарты разработки frontend-приложений на Next.js (App Router) + TypeScript + React с архитектурой SLM (Scoped Layered Module Design — модульная архитектура со слоями ответственности, где каждый модуль содержит всё необходимое: компоненты, хуки, сторы, типы, стили).',
+      llmsContext:
+        'Стек: React, TypeScript, Next.js App Router, Mantine UI, SWR, Zustand, i18next, PostCSS Modules, Vitest, clsx.\n\nДокументация покрывает архитектуру SLM (слои, модули, сегменты, направление зависимостей, публичный API), правила оформления кода (именование, форматирование, импорты, типизация, JSDoc), реализацию компонентов и хуков, работу с App Router, кодогенерацию из шаблонов, стилизацию (Mobile First, токены), работу с API и сокетами, управление состоянием через Zustand, локализацию, ассеты (шрифты, изображения, SVG-спрайты) и настройку VS Code.',
     },
     en: {
       label: 'English',
       lang: 'en-US',
       link: '/en/',
+      description: 'Next.js + TypeScript development standards with SLM architecture',
       themeConfig: {
         sidebar: enSidebar,
       },
+      llmsBlockquote:
+        'Frontend development standards for Next.js (App Router) + TypeScript + React projects with SLM architecture (Scoped Layered Module Design — a modular architecture with responsibility layers, where each module contains everything it needs: components, hooks, stores, types, styles).',
+      llmsContext:
+        'Stack: React, TypeScript, Next.js App Router, Mantine UI, SWR, Zustand, i18next, PostCSS Modules, Vitest, clsx.\n\nThe documentation covers SLM architecture (layers, modules, segments, dependency direction, public API), code conventions (naming, formatting, imports, typing, JSDoc), component and hook implementation, App Router usage, code generation from templates, styling (Mobile First, design tokens), API and socket integration, state management via Zustand, localization, assets (fonts, images, SVG sprites), and VS Code setup.',
     },
   },
 });