Документация проекта

Этот раздел хранит рабочие технические документы по сайту ипотечного брокера Татьяны Стерликовой.

Основные документы

• site-audit-and-autonomous-plan.md — полный аудит сайта и план автономного развития.
• live-domain-acceptance.md — приемка боевого домена, HTTPS, robots, sitemap и поисковых кабинетов.
• deploy-checklist.md — проверка GitHub Actions и результата публикации.
• tatyana-photo-brief.md — техническое задание по подготовке фотографии Татьяны для сайта.
• photo-implementation-checklist.md — чек-лист внедрения обработанных фото на сайт.
• beget-domain-setup.md — инструкция по подключению домена через Beget и GitHub Pages.
• broker-leads-supabase.md — инструкция по будущему подключению заявок сайта к Supabase.

Что важно соблюдать при развитии сайта

1. Не использовать обещания гарантированного одобрения ипотеки.
2. Не писать, что банк «точно одобрит» заявку.
3. Не обещать конкретную ставку без актуальной проверки условий банка.
4. Уточнять, что финальное решение по заявке, сумме, ставке и объекту принимает банк.
5. Не публиковать отзывы, кейсы и персональные данные клиентов без отдельного согласования.
6. Для клиентов компании «ЭТАЖИ» писать аккуратно: ипотечное сопровождение включено в комиссию компании и отдельно клиентом не оплачивается.

Автоматические проверки

После сборки workflow запускает:

scripts/post-build-check.sh

Скрипт проверяет:

• наличие главной, robots, sitemap, CSS, JS и основных изображений;
• корректный urlset и достаточное количество URL в sitemap;
• отсутствие 404 в sitemap;
• основной sitemap в robots;
• canonical главной на sterlikova-ipoteka.ru;
• отсутствие неподтвержденного обещания 15 мин;
• отсутствие запрещенных обещаний гарантированного одобрения;
• наличие старого технического домена в собранных HTML-файлах.

Текущая задача по фотографии

Сейчас на сайте используется assets/img/tatyana-hero.svg со встроенным base64-изображением. По ТЗ рекомендуется перейти на отдельные оптимизированные файлы:

• assets/img/tatyana-hero.webp;
• assets/img/tatyana-hero-mobile.webp;
• assets/img/tatyana-social.jpg;
• assets/img/tatyana-avatar.webp.

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

Следующие рекомендуемые задачи

1. Проверить успешное выполнение обновленного workflow.
2. Провести приемку домена по live-domain-acceptance.md.
3. Подготовить и загрузить оптимизированные версии фотографии.
4. Проверить главный экран на мобильном экране.
5. Проверить Open Graph-превью в соцсетях и мессенджерах.
6. Подключить Яндекс Метрику и проверить цели.
7. Подготовить форму заявки через Supabase только после полной технической и юридической приемки.
8. Отправить sitemap в Яндекс Вебмастер и Google Search Console.

Технические файлы, которые важно проверять после крупных правок

• _config.yml;
• _layouts/default.html;
• .github/workflows/pages.yml;
• scripts/post-build-check.sh;
• robots.txt;
• sitemap.xml;
• site.webmanifest;
• llms.txt;
• humans.txt;
• assets/css/styles.css;
• assets/css/seo.css;
• assets/css/accessibility.css;
• assets/css/print.css;
• assets/js/main.js.