лооооч
Урок 5

Журнал стройки

Что за код написал ИИ, что такое файлы, фреймворк и git — без единой страшной аббревиатуры

Цели урока

К концу этого урока вы:

  • Откроете папку проекта и поймёте, что за файлы там лежат — без страха.
  • Узнаете, что такое фреймворк (Next.js) — в одно дыхание, не глубже нужного.
  • Поймёте git как машину сохранёнок: коммит, ветка — своими словами.
  • Сделаете первый коммит своего проекта — руками Claude Code по вашей просьбе.
Гравитация

О, ты здесь! Отлично — у меня для тебя кое-что есть.

Урок 5 из 10

Журнал стройки

Что за код написал ИИ, что такое файлы, фреймворк и git — без единой страшной аббревиатуры
Прораб листает толстый журнал стройки на столе: разложены чертежи, рядом папки с аккуратными подписями

Код — это магия. Так думает большинство людей до того, как открывают папку с проектом первый раз. После — удивляются: внутри просто текстовые файлы. Обычный текст, который можно открыть блокнотом. Никакой магии — только слова, знаки препинания и чёткая логика, которую не вы писали.

Страница из урока 4 уже существует на вашем компьютере в виде таких файлов. Сегодня мы посмотрим, что там внутри, и поймём главное: не для того, чтобы учиться это писать, а чтобы не бояться и говорить с прорабом увереннее. Хозяин дома не обязан знать, как паяют провода, — но он должен понимать, где щиток, что такое автомат и почему «просто выдернуть провод» — плохая идея [1].

И ещё один инструмент: git — машина сохранёнок. В уроке 4 мы поняли, что «надо бы сохраниться» — сейчас объясним, как именно, и сделаем первый коммит. Коммит в конце урока будет настоящий — на вашем проекте.

Быстрый конспект: откуда мы пришли

Урок 1 Карта дома: стены = видимое, проводка = под капотом. Вы — прораб, Claude Code — строитель.
Урок 2 Четыре элемента хорошей задачи. Точная постановка — главный навык прораба.
Урок 3 Выбор инструмента: Claude Code, Cursor, Conductor.
Урок 4 Страница-визитка собрана: имя, фото, ссылки. Dev-сервер запущен, превью в браузере. Тизер git.
Урок 5 — сегодня Открываем папку, понимаем файлы, фреймворк, git и делаем первый коммит.
🕑 Холодный прогрев — три вопроса
Из урока 4: Страница в браузере открывается по адресу localhost:3000. Что это за адрес — публичный или только ваш? Что происходит с этим адресом, когда вы закрываете терминал?

Из урока 2: Вы хотите попросить Claude Code изменить цвет кнопки. Напишите полную задачу по четырём элементам — одним абзацем, как будто отправляете прорабу прямо сейчас.

Из урока 1: Зачем нетеху вообще «заглядывать под капот», если прораб всё делает за него? Ответьте своими словами — без подглядывания.
Если третий вопрос вызвал паузу — это хороший знак. Ответ был в уроке 1: чтобы чувствовать себя хозяином, а не гостем, и раньше замечать, если что-то пошло не туда.

Что вы возьмёте из этого урока

  • Откроете папку проекта и поймёте, что за файлы там лежат — без страха.
  • Узнаете, что такое фреймворк (Next.js) — в одно дыхание, не глубже нужного.
  • Поймёте git как машину сохранёнок: коммит, ветка — своими словами.
  • Сделаете первый коммит своего проекта — руками Claude Code по вашей просьбе.

Часть 1. Открываем папку: файлы и папки — просто коробки с листами

Откройте проводник (Windows) или Finder (Mac) и найдите папку, которую Claude Code создал в уроке 4. Кликните по ней — внутри будет что-то похожее на это:

my-page/ ├── app/ │ ├── page.tsx ← главный файл страницы │ ├── layout.tsx ← общая обёртка (шапка, подвал) │ └── globals.css ← стили (цвета, шрифты) ├── public/ │ └── photo.jpg ← ваше фото ├── package.json ← список ингредиентов проекта └── next.config.js ← настройки

Каждый файл — это лист с текстом. Каждая папка — коробка для листов. Всё. Никакой магии: это обычная файловая система, та же, где лежат ваши документы и фотографии. Разница только в том, что некоторые «листы» написаны на языке, который браузер понимает как инструкцию — «нарисуй заголовок», «поставь фото» [1].

Самый важный файл — page.tsx. Это и есть ваша страница. Откройте его в любом текстовом редакторе (даже в Блокноте) — внутри будет текст, похожий на смесь обычного языка и технических знаков. Это и есть тот код, который написал Claude Code. Вы его не обязаны понимать — но видеть, что он существует и это просто текст, — важно.

Расширение .tsx — что это? Это просто тип файла, как .docx для Word. Означает, что внутри — файл на языке TypeScript с HTML-подобными вставками. Звучит страшнее, чем есть. Браузер его не читает напрямую — перед показом фреймворк переводит его в обычный HTML. Подробнее — прямо в следующей части.

Папка my-page/ page.tsx layout.tsx globals.css фреймворк переводит Next.js готовый каркас HTML для браузера Браузер ваша страница Текстовые файлы → фреймворк → браузер → страница. Никакой магии.
Файл — это лист с текстом. Фреймворк переводит его в то, что видит браузер.

Часть 2. Что такое фреймворк — готовый каркас дома

Одно дыхание про Next.js — и больше не возвращаемся.

Когда строят типовой дом, никто не изобретает фундамент с нуля. Берут проверенный проект: стандартный фундамент, типовые перекрытия, известный набор коммуникаций. Строители знают его, материалы известны, ошибок меньше. Хозяин получает дом быстрее и дешевле — потому что не платит за изобретение того, что уже изобретено.

Next.js — это такой типовой проект для веб-страниц [1]. Claude Code использует его, потому что в нём уже есть: маршрутизация (у каждой страницы есть адрес), оптимизация картинок, hot reload (обновление в браузере без нажатия F5), и ещё пятьдесят вещей, которые вам не нужно знать. Вы говорите прорабу, что хотите — он строит на этом каркасе.

Где аналогия ломается: типовой дом сложнее переделать, чем построенный с нуля. Next.js тоже накладывает ограничения: некоторые нестандартные вещи делать сложнее. Для личной страницы-визитки это не важно. Для будущих больших проектов — учтите, что каркас выбирают под задачу.

Часть 3. Git — машина сохранёнок

В видеоиграх есть система сохранений. Прошли трудный уровень — сохранились. Пошли вперёд, провалились в ловушку — загрузили сохранёнку и попробовали по-другому. Никто не начинает игру заново только потому, что ошибся после трёх часов прохождения.

В проекте без сохранёнок всё иначе: сделали одно изменение, что-то сломалось, и непонятно, что именно и когда. Откатиться некуда. Прораб пытается угадать и исправить — иногда получается, иногда нет. git решает эту проблему [2].

Git — это программа, которая ведёт журнал всех изменений в вашем проекте. Каждая запись в журнале называется коммит. Коммит — это именованная точка: «добавил фото», «исправил цвет кнопки», «добавил третью ссылку». К любой из них можно вернуться [2].

Есть ещё одна вещь в git, которую стоит знать: ветка. Ветка — это параллельная версия проекта. Представьте: у прораба есть работающий дом — и рядом идёт стройка нового крыла. Крыло строят на «ветке», основной дом не трогают. Когда крыло готово — его «сливают» с основным домом. Если крыло не получилось — ветку просто удаляют, основной дом цел.

Для нашего уровня: ветки — это продвинутый инструмент. На этом курсе будем работать в одной ветке (её называют main). Коммиты на ней — это наши сохранёнки. Ветки появятся в жизни естественно, когда проект вырастет.
💾
Файл называется finansy_final_FINAL_v3_provereno_tochno.xlsx.
— А это точно финальная версия?
— Нет, подожди, есть ещё final_FINAL_copy2.
Git — это именно про то, чтобы больше никогда не называть файлы вот так. Каждое изменение — в журнал, с именем и датой.

Часть 4. Закрепляем понятия

Разберём четыре слова, которые только что появились в вашем словаре. Убедитесь, что они сидят правильно — потом будет проще говорить с прорабом и читать его ответы.

✎ Своими словами — без подглядывания
Представьте, что объясняете другу по телефону: «Что такое коммит в git — в двух предложениях, так чтобы было понятно человеку, который никогда не программировал?» Сформулируйте вслух или запишите. Потом сравните со своим пониманием из этого урока.
Хорошая формулировка не использует слово «коммит» в определении. Если вы написали «коммит — это коммит в git» — это не определение, это тавтология. Попробуйте через аналогию: сохранёнка, точка отката, запись в журнале.

Часть 5. Зачем это прорабу-нетеху

Честный вопрос: если Claude Code делает всё сам, зачем вам вообще знать, что такое файлы, фреймворк и git? Можно же просто говорить «сделай страницу» и не думать об остальном.

Можно. Но тогда вы попадаете в ситуацию хозяина, который не знает, где в его доме щиток. Он зависит от электрика при каждом вопросе: «а можно ли включить ещё один прибор?», «что значит этот мигающий индикатор?», «почему сработал автомат?». Пока электрик доступен — всё хорошо. Как только возникает мелкая проблема в воскресенье вечером — хозяин беспомощен.

Знание устройства проекта даёт три конкретные вещи:

1

Точнее ставить задачу

Когда вы знаете, что стиль лежит в globals.css, а страница — в page.tsx, вы говорите: «измени цвет только в globals.css, не трогай page.tsx». Это ограничение из урока 2, и теперь вы можете его произнести точно.

2

Замечать раньше, если что-то не туда

Если прораб говорит «удалил файл layout.tsx» — вы знаете, что это общая обёртка всех страниц, и задаёте вопрос: «зачем?» Без этого знания — просто соглашаетесь и потом удивляетесь, почему шапка пропала.

3

Не бояться смотреть на код

Код — это текст. Открыть файл и посмотреть глазами, что там написано, — это не программирование. Это просто чтение. Иногда достаточно увидеть своё имя внутри «текстового потока», чтобы понять: прораб написал верное имя или опечатался.

Часть 6. Первый коммит — делаем прямо сейчас

Теория позади. Делаем первую сохранёнку.

Откройте терминал с запущенным проектом из урока 4. Напишите Claude Code — одной задачей, по формуле из урока 2:

# Просим прораба сохранить точку:
Инициализируй git в папке проекта (если ещё не сделано)
и сделай первый коммит со всеми текущими файлами.
Назови коммит: "начальная версия страницы".
Объясни мне в двух предложениях, что именно ты сделал.

Claude Code инициализирует git в папке, добавит все файлы и создаст коммит. Он покажет вам, что сделал — и объяснит. После этого в вашем проекте есть первая именованная точка в журнале. Если завтра что-то сломается — всегда можно вернуться сюда [3].

Как часто делать коммиты? Правило одно: после каждого значимого шага, который «жалко потерять». Добавили блок — коммит. Поправили дизайн и понравилось — коммит. Не нужно ждать, пока проект «готов». Маленькие частые коммиты — это страховочная сетка. Один большой коммит в конце — это прыжок без сетки. Подробнее об этом в задании ниже.

💡 Объясните себе
После того как Claude Code сделает коммит — спросите его: «Покажи список всех коммитов в этом проекте». Он покажет журнал. Теперь ответьте: что в этом журнале соответствует «записи в журнале стройки» из нашей аналогии?
Посмотрите на дату, имя коммита («начальная версия страницы») и хэш (длинный код из цифр и букв). Это и есть ваша именованная точка. Хэш — уникальный номер каждой записи, по нему git отличает одну точку от другой.

Резюме

1

Код — это текст

Файлы проекта — обычные текстовые документы. Ничего магического. Открыть и посмотреть — не опасно.

2

Фреймворк — готовый каркас

Next.js сделан так, чтобы не строить стандартные вещи с нуля. Claude Code использует его как основу. Знать устройство изнутри не нужно — нужно знать, что он есть.

3

Git — журнал с точками отката

Коммит — именованная точка в истории проекта. Ветка — параллельная версия. Первый коммит сделан — сохранёнка есть.

4

Понимание = уверенность

Нетеху не нужно писать код. Но понимать, что файл существует, где он лежит и что коммит — точка отката — делает вас хозяином, а не гостем в своём проекте.

Код — не магия. Магия — это когда вы знаете, что искать, и не боитесь открыть папку.

Что дальше, в Уроке 6 — «Данные и база»: страница собрана, первая сохранёнка сделана. Пора добавить «живой» элемент: форму, которая запоминает сообщения. В аналогии с домом — это кладовка, которая помнит, кто приходил. Разберём, что такое база данных без единой SQL-команды, и добавим гостевой блок на страницу.

Источники / Sources

  1. docs Vercel / Next.js team. «Getting Started — Project Structure» — структура файлов и папок проекта Next.js: app/, public/, page.tsx, layout.tsx, globals.css, package.json. nextjs.org/docs/app/getting-started/project-structure · accessed 2026-06-02
  2. docs Chacon, S., Straub, B. «Pro Git, 2nd ed. — Getting Started: About Version Control» — определение системы контроля версий, коммит как именованная точка отката, история изменений. git-scm.com/book/en/v2/Getting-Started-About-Version-Control · accessed 2026-06-02
  3. docs Anthropic. «Claude Code — Git and GitHub workflow» — как Claude Code инициализирует git, создаёт коммиты и работает с историей проекта по запросу пользователя. docs.claude.com/en/docs/claude-code/github-actions · accessed 2026-06-02
Аналогия «машина сохранёнок» и «журнал стройки» — авторские иллюстрации в рамках метафоры курса. Технические факты о git (коммит, ветка, история) и Next.js (структура файлов) опираются на документацию выше.