Мой сайт не работал пять лет. Пересобираю его в портал

1 Что делать

Отдаю Claude Code каркас портала: маршруты, чтение markdown, базовый шаблон. Сначала план, потом файлы.

2 Промпт

RU · Промпт

Собираем персональный портал на FastAPI. Ни генератора статики, ни SPA:
страницы рендерятся на сервере через Jinja2.

Структура проекта:
app/main.py — приложение FastAPI
app/content.py — чтение markdown из content/ и разбор фронтматтера
templates/ — Jinja2: base.html и по шаблону на раздел
static/css/site.css — собранный Tailwind (кладём в репозиторий собранным)
content/ru|uk|en/ — тексты разделов в markdown с YAML-фронтматтером
content/works/ — по одному файлу на работу

Что сделать сейчас:

1. app/main.py: приложение FastAPI, StaticFiles смонтирован на /static,
Jinja2Templates на templates/.

2. Маршруты. Язык — первый сегмент пути, русский без префикса:
/ /uk/ /en/
/how /uk/how /en/how
/works /uk/works /en/works
/works/{slug} и то же с префиксами
/materials /contact /archive — так же.
Один общий обработчик, а не двадцать одинаковых функций.

3. app/content.py: читает content/{lang}/{name}.md, разбирает YAML-фронтматтер
(title, description, updated), отдаёт HTML и метаданные.
Файла нет — отдаём 404, а не пустую страницу.

4. templates/base.html: атрибут lang подставляется, title и meta description
берутся из фронтматтера, один link на /static/css/site.css.

5. Никаких текстов в шаблонах. Любая строка, которую я захочу поправить,
живёт в content/. В шаблоне только разметка и подстановки.

Оформление сейчас не трогаем — только структура и правильные тексты
в правильных местах.

Сначала покажи план и список файлов, которые собираешься создать.
Файлы не пиши, пока я не подтвержу.

EN · Промпт с экрана

Собираем персональный портал на FastAPI. Ни генератора статики, ни SPA:
страницы рендерятся на сервере через Jinja2.

Структура проекта:
app/main.py — приложение FastAPI
app/content.py — чтение markdown из content/ и разбор фронтматтера
templates/ — Jinja2: base.html и по шаблону на раздел
static/css/site.css — собранный Tailwind (кладём в репозиторий собранным)
content/ru|uk|en/ — тексты разделов в markdown с YAML-фронтматтером
content/works/ — по одному файлу на работу

Что сделать сейчас:

1. app/main.py: приложение FastAPI, StaticFiles смонтирован на /static,
Jinja2Templates на templates/.

2. Маршруты. Язык — первый сегмент пути, русский без префикса:
/ /uk/ /en/
/how /uk/how /en/how
/works /uk/works /en/works
/works/{slug} и то же с префиксами
/materials /contact /archive — так же.
Один общий обработчик, а не двадцать одинаковых функций.

3. app/content.py: читает content/{lang}/{name}.md, разбирает YAML-фронтматтер
(title, description, updated), отдаёт HTML и метаданные.
Файла нет — отдаём 404, а не пустую страницу.

4. templates/base.html: атрибут lang подставляется, title и meta description
берутся из фронтматтера, один link на /static/css/site.css.

5. Никаких текстов в шаблонах. Любая строка, которую я захочу поправить,
живёт в content/. В шаблоне только разметка и подстановки.

Оформление сейчас не трогаем — только структура и правильные тексты
в правильных местах.

Сначала покажи план и список файлов, которые собираешься создать.
Файлы не пиши, пока я не подтвержу.

Спросить в Telegram

11 10:49 Разделы: работы по единой схеме

1 Что делать

Каждая работа описана по одной схеме из пяти частей, «что не получилось» обязательна.

2 Промпт

RU · Промпт

Раздел «Работы». Каждая работа лежит отдельным markdown-файлом
в content/works/ и описана по одной и той же схеме — пять частей,
всегда в этом порядке:

1. Задача — с чем пришли
2. Что было до — как это работало раньше
3. Как устроено — из чего собрано решение
4. Что получилось — измеримо, если есть чем мерить
5. Что не получилось — обязательная часть, пропускать нельзя

Сделай:

- фронтматтер работы: slug, title, client_type (без названия компании),
period, stack (список), summary — одна строка;
- шаблон списка /works: карточки в одну колонку, в карточке только
title, summary и period. Ничего больше;
- шаблон одной работы /works/{slug}: пять частей в фиксированном порядке
с подзаголовками, внизу — ссылка на /contact;
- если в файле работы нет части «что не получилось» — сборка страницы
должна упасть с понятной ошибкой, а не молча пропустить раздел.
Это правило, а не пожелание.

Названий компаний, доменов и имён клиентов в текстах нет и не появляется.
Клиента описываем типом: «финтех-продукт», «производственная компания».

EN · Промпт с экрана

Раздел «Работы». Каждая работа лежит отдельным markdown-файлом
в content/works/ и описана по одной и той же схеме — пять частей,
всегда в этом порядке:

1. Задача — с чем пришли
2. Что было до — как это работало раньше
3. Как устроено — из чего собрано решение
4. Что получилось — измеримо, если есть чем мерить
5. Что не получилось — обязательная часть, пропускать нельзя

Сделай:

- фронтматтер работы: slug, title, client_type (без названия компании),
period, stack (список), summary — одна строка;
- шаблон списка /works: карточки в одну колонку, в карточке только
title, summary и period. Ничего больше;
- шаблон одной работы /works/{slug}: пять частей в фиксированном порядке
с подзаголовками, внизу — ссылка на /contact;
- если в файле работы нет части «что не получилось» — сборка страницы
должна упасть с понятной ошибкой, а не молча пропустить раздел.
Это правило, а не пожелание.

Названий компаний, доменов и имён клиентов в текстах нет и не появляется.
Клиента описываем типом: «финтех-продукт», «производственная компания».

Спросить в Telegram

12 13:09 Где AI сделал не то: выдуманные факты

13 15:09 Тихая ошибка: hreflang «ua» вместо «uk»

14 15:38 Языки и структура адресов

1 Что делать

Три языка папками в адресе, hreflang плюс x-default, и что сознательно не переводим.

2 Промпт

RU · Промпт

Языковые версии. Три языка: русский, украинский, английский.
Адреса — папками: русский без префикса, /uk/, /en/. Ни поддоменов,
ни параметров в адресе.

Сделай:

1. В base.html — блок ссылок на языковые версии текущей страницы
(rel="alternate") плюс версия по умолчанию для случая, когда язык
посетителя не совпал ни с одним. По умолчанию — русская версия.
Коды языков подставь сам; я проверю их отдельно.

2. Переключатель языка в шапке: обычные ссылки, без JavaScript.
Ведёт на ту же страницу в другом языке, а не на главную.

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

4. Проверка: пройди по всем маршрутам и выведи таблицу
«адрес — язык — есть ли перевод — куда ведёт языковая ссылка».

EN · Промпт с экрана

Языковые версии. Три языка: русский, украинский, английский.
Адреса — папками: русский без префикса, /uk/, /en/. Ни поддоменов,
ни параметров в адресе.

Сделай:

1. В base.html — блок ссылок на языковые версии текущей страницы
(rel="alternate") плюс версия по умолчанию для случая, когда язык
посетителя не совпал ни с одним. По умолчанию — русская версия.
Коды языков подставь сам; я проверю их отдельно.

2. Переключатель языка в шапке: обычные ссылки, без JavaScript.
Ведёт на ту же страницу в другом языке, а не на главную.

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

4. Проверка: пройди по всем маршрутам и выведи таблицу
«адрес — язык — есть ли перевод — куда ведёт языковая ссылка».

Спросить в Telegram

15 16:42 Воронка: форма, почта, канал

1 Что делать

Форма из трёх полей, заявка в базу и в Telegram, почта на своём домене, ссылка в канал.

2 Промпт

RU · Промпт

Форма на /contact. Ровно три поля: задача (многострочное),
срок (одна строка), контакт (одна строка). Больше полей не добавлять —
каждое лишнее поле стоит ответов.

Сделай:

1. POST /contact — обычная отправка формы, без JavaScript.
После отправки — отдельная страница «спасибо», а не всплывающее
сообщение: на неё можно поставить цель в аналитике.

2. Заявка сохраняется в SQLite (файл data/site.db, таблица leads:
id, задача, срок, контакт, время, язык страницы, источник перехода)
и одновременно уходит сообщением в мой телеграм через бота.
Токен и chat_id — из переменных окружения, в коде их нет.
Читай их через os.environ, .env в репозиторий не попадает.

3. Если телеграм недоступен — заявка всё равно сохранена в базе,
а ошибка записана в лог. Потерять заявку из-за упавшего бота нельзя.

4. Простая защита от роботов без капчи: скрытое поле-приманка
и проверка, что форма отправлена не раньше чем через три секунды
после загрузки страницы.

5. Почта — на своём домене, ссылка mailto рядом с формой.
Ссылка на телеграм ведёт в канал, не в личку.

EN · Промпт с экрана

Форма на /contact. Ровно три поля: задача (многострочное),
срок (одна строка), контакт (одна строка). Больше полей не добавлять —
каждое лишнее поле стоит ответов.

Сделай:

1. POST /contact — обычная отправка формы, без JavaScript.
После отправки — отдельная страница «спасибо», а не всплывающее
сообщение: на неё можно поставить цель в аналитике.

2. Заявка сохраняется в SQLite (файл data/site.db, таблица leads:
id, задача, срок, контакт, время, язык страницы, источник перехода)
и одновременно уходит сообщением в мой телеграм через бота.
Токен и chat_id — из переменных окружения, в коде их нет.
Читай их через os.environ, .env в репозиторий не попадает.

3. Если телеграм недоступен — заявка всё равно сохранена в базе,
а ошибка записана в лог. Потерять заявку из-за упавшего бота нельзя.

4. Простая защита от роботов без капчи: скрытое поле-приманка
и проверка, что форма отправлена не раньше чем через три секунды
после загрузки страницы.

5. Почта — на своём домене, ссылка mailto рядом с формой.
Ссылка на телеграм ведёт в канал, не в личку.

Спросить в Telegram

16 17:21 Четыре события в аналитике