nextjs-template/ai/nextjs-style-guide/MAP.md

Карта документации

Список всех разделов архива с относительными ссылками. Точка входа — DEVELOP.md рядом с этим файлом.

Подсказки

• Подсказки — Короткие ответы на типовые вопросы и решения для спорных ситуаций.

Базовые правила

• Технологии и библиотеки — Какие библиотеки и инструменты используются в проекте.
• Именование — Как называть переменные, файлы и прочие сущности в коде.
• Архитектура: Обзор — Архитектурный подход проекта: что такое SLM и как он устроен.
• Архитектура: Слои — Из каких слоёв состоит SLM-архитектура и как они связаны.
• Архитектура: Модули — Что такое модуль в SLM-архитектуре и как он устроен.
• Архитектура: Сегменты — Что такое сегмент модуля в SLM-архитектуре и какие они бывают.
• Стиль кода — Как оформляется код в проекте.
• Документирование — Что и как документировать в коде.
• Типизация — Как типизируется код в проекте.

Создание проекта

• Из шаблона — Создание нового проекта на основе готового шаблона.
• По гайду вручную — Поэтапное создание нового проекта без использования шаблона.
• Чистый Next.js — Установка Next.js без лишнего шаблона — голый каркас под дальнейшую сборку.

Работа с данными

• Введение — Какие источники данных используются в проекте и как с ними работать.
• REST — Как правильно работать с REST API в проекте.
• REST: Создание клиента — Как выбрать способ создания REST-клиента и где размещать его части.
• REST: Создание клиента: Автогенерация из OpenAPI — Генерация REST-клиента из OpenAPI-спецификации через @gromlab/api-codegen.
• REST: Создание клиента: Ручное создание — Создание REST-клиента вручную, когда OpenAPI нет или он неполный.
• REST: Создание клиента: GET-хуки REST-клиента — Прозрачные SWR-обёртки над GET-методами REST-клиента.
• REST: Использование: Стратегии получения данных — Как выбрать способ получения REST-данных в зависимости от места и сценария.
• REST: Использование: Серверный await — Получение REST-данных на сервере прямым await метода клиента.
• REST: Использование: Параллельные серверные запросы — Как запускать независимые REST-запросы на сервере без waterfall.
• REST: Использование: Передача промиса ниже — Как запускать серверный REST-запрос выше и ожидать его во вложенном server-компоненте.
• REST: Использование: Начальные данные для клиентских хуков — Как передать серверный промис в SWR fallback, чтобы клиентские GET-хуки получили начальные данные.
• REST: Использование: Клиентский GET-хук — Получение REST-данных в Client Components через готовые GET-хуки REST-клиента.
• REST: Использование: Business-композиция — Когда REST-данные нужно объединить или интерпретировать в бизнес-модуле.
• Realtime — Работа с push-данными от сервера: подписки и события.

Прикладные разделы

• Структура проекта — Из чего состоит проект и где что лежит.
• Страницы — Как работать со страницами и другими файлами роутинга Next.js App Router.
• Компонент — Как создавать React-компоненты внутри SLM-модулей.
• Модуль — Как создавать и организовывать SLM-модули в проекте.
• Стили: Настройка — Подготовка стилевой основы проекта: токены, медиа-запросы, глобальные стили.
• Стили: Использование — Как пишутся стили в проекте.
• SVG-спрайты — Что такое SVG-спрайты и какие проблемы они решают.
• SVG-спрайты: Настройка — Подключение SVG-спрайтов в новом проекте.
• SVG-спрайты: Использование — Как добавлять и использовать SVG-иконки в коде.
• Изображения — Как подключать изображения через Next.js Image в проекте.
• Шрифты — Как подключать шрифты через Next.js Font в проекте.
• Алиасы импортов — Какие алиасы импортов есть в проекте и как ими пользоваться.
• Шаблоны генерации — Что такое шаблоны кодогенерации и какие проблемы они решают.
• Шаблоны генерации: Настройка — Первичная установка шаблонов кодогенерации в проект.
• Шаблоны генерации: Создание шаблонов — Структура шаблонов, синтаксис переменных и примеры.
• Шаблоны генерации: Использование — Генерация файлов из шаблонов через VS Code плагин и CLI.
• Biome — Установка и настройка линтера-форматтера в новом проекте.
• PostCSS — Установка и настройка CSS-процессора в новом проекте.
• VS Code — Единые настройки редактора и расширений для команды.
• Локализация — Как организовать локализацию как infrastructure-модуль.