gromov/nextjs-fetch-data-example
1
0
Fork 0
forked from templates/nextjs-template
Code Pull Requests Activity
Files
f2358da397d8bcd3b960c60053aa42ae558b415b
nextjs-fetch-data-example/ai/nextjs-style-guide/applied/templates/templates-intro.md
S.Gromov f2358da397 docs: добавить стайлгайд nextjs-style-guide в репозиторий 
- Добавлена документация SLM-архитектуры, базовых правил и прикладных разделов
- Добавлены разделы: стили, SVG-спрайты, шаблоны генерации, PostCSS, REST, Realtime
- Удалены устаревшие файлы (спрайты, скрипты, стили из app/)
2026-04-30 19:32:10 +03:00

2.9 KiB
Raw Blame History

title, description
title description
Шаблоны генерации Что такое шаблоны кодогенерации и какие проблемы они решают.

Шаблоны генерации

Что такое шаблоны кодогенерации и какие проблемы они решают.

Проблема

Каждый новый модуль в проекте — компонент, стор, бизнес-модуль — требует однотипной структуры файлов и boilerplate-кода. Ручное создание приводит к трём проблемам:

  • Расхождения. Разные разработчики создают модули по-разному: забывают index.ts, называют типы не по канону, пропускают стили.
  • Время. Создание одного компонента с типами, стилями и экспортом — 5–10 минут рутины. За спринт набегают часы.
  • Ошибки копипасты. Копирование существующего модуля и переименование — источник опечаток и забытых ссылок.

Решение

Шаблоны кодогенерации — это папки с файлами-заготовками в .templates/. Вместо ручного создания файлов разработчик вызывает генератор, указывает имя — и получает готовый модуль со всей структурой, именами и boilerplate, подставленными автоматически.

Что дают шаблоны:

  • Единообразие. Все модули одного типа идентичны по структуре. Канон живёт в шаблоне, а не в памяти разработчика.
  • Скорость. Генерация модуля — одна команда. Остальное время — на бизнес-логику.
  • Согласованность с архитектурой. Шаблоны учитывают SLM: правильные слои, сегменты, экспорты. Отклонение от стайлгайда требует осознанного усилия, а не случайного упущения.

Состав раздела