# restoplace.cc на Laravel + Filament

Сайт restoplace.cc, перенесённый с Tilda (проект 540442) на собственную платформу — ту же, что у korzilla.ru:

- **Дизайн, тексты, SEO и адреса — как на Tilda.** HTML страниц совпадает с оригиналом байт в байт, кроме намеренных отличий (ссылки на CDN Tilda ведут на свой сервер и др., см. «Сверка с Tilda») и 8 canonical, исправленных `php artisan site:fix-seo`. Проверяется командой `php artisan tilda:verify`: совпадают все 541 адрес — 412 страниц и 129 новостей.
- **Всё хранится у нас:** около 3,7 тыс. картинок и файлов (320 МБ), шрифты, библиотеки Tilda и наборы стилей блоков лежат в `public/`. Сайт не обращается к CDN и API Tilda: формы, лента новостей и поиск Tilda отвечают сами.
- **Админка на Filament:** страницы, блоки, новости, SEO, общие блоки, шапка и подвал, редиректы, заявки, код сайта, CSS.

Стек: PHP 8.3+, Laravel 13, Filament 5, MySQL 8 (или MariaDB 10.6+), Node не нужен.

---

## Быстрый старт (локально, Laragon)

```bash
composer install
cp .env.example .env         # заполнить DB_*, ADMIN_*; локально ещё APP_ENV=local, APP_DEBUG=true, APP_URL=http://restoplace-site.test
php artisan key:generate
php artisan migrate
php artisan tilda:import     # страницы, блоки и ленты из зеркала (файлы уже в public/, CDN Tilda не нужен)
php artisan site:fix-seo     # исправления SEO, без которых перенос дал бы ошибки (docs/audit.md)
php artisan db:seed          # первый администратор из ADMIN_EMAIL / ADMIN_PASSWORD
```

В Laragon нажмите Menu → Reload: появится хост `restoplace-site.test` с корнем в `public/`, админка — `/admin`. Без Laragon: `php artisan serve` (на Windows без OPcache — около секунды на запрос).

Всё нужное для импорта уже в репозитории: зеркало сайта `storage/app/tilda-mirror` (страницы, посты ленты с AMP-версиями, ответы API лент, `sitemap*.xml`, `robots.txt`, `custom.css`), картинки `public/uploads/tild…` и библиотеки Tilda `public/tilda`. Если нужен свежий снимок, см. «Повторный перенос».

## Как устроено

```
Tilda-страница  →  Page (pages)            адрес, SEO, шапка/подвал, подключения CSS/JS Tilda
Tilda-блок rec… →  Block (blocks)          исходный HTML блока — единственный источник правды
T121 «ссылка»   →  Block.ref_block_id      общий блок: контент берётся из исходного блока
Шапка/подвал    →  Page kind=header/footer как в Tilda: отдельные страницы, на которые ссылаются остальные
Лента (Feeds)   →  Feed + FeedPost         новости /news: список — API в формате Tilda, пост — /news/tpost/…
```

**Почему HTML, а не конструктор.** На сайте почти 90 типов блоков Tilda. Если переписывать их шаблонами, дизайн неизбежно поплывёт. Вместо этого админка находит в HTML блока редактируемые места: тексты (`field="…"`), картинки, ссылки, кнопки, подписи форм. Правка меняет **только** эти фрагменты (`app/Support/Html/HtmlPatch.php`), остальной код блока остаётся байт в байт.

Ключевые места кода:

| Что | Где |
|---|---|
| Парсер HTML с точными смещениями | `app/Support/Html/HtmlDocument.php`, `HtmlPatch.php` |
| Поля блока: извлечение и применение правок | `app/Support/Tilda/BlockContentEditor.php` |
| Сборка страницы в формате Tilda | `app/Support/Site/PageRenderer.php` |
| Ленты: API вместо feeds.tildaapi.com, страница поста, правка поста | `app/Http/Controllers/FeedApiController.php`, `app/Support/Feeds/PostPage.php`, `PostPageEditor.php`, `NewPost.php` |
| Поиск по сайту вместо search.tildacdn.com | `app/Http/Controllers/SearchController.php`, `app/Support/Site/SearchIndex.php` |
| Ссылка на неопубликованную страницу без входа (подпись, 30 дней) | `app/Support/Site/PagePreview.php`, `php artisan site:preview-links` |
| Маршрутизация, редиректы, 404, посты лент | `app/Http/Controllers/PageController.php` |
| Приём заявок с форм Tilda | `app/Http/Controllers/TildaFormController.php`, `app/Support/Forms/LeadDelivery.php` |
| Миниатюры вместо thb.tildacdn.com | `app/Http/Controllers/ThumbnailController.php` |
| favicon.ico (иконка из «Настройки сайта → Иконки сайта»; файла в `public/` нет), sitemap.xml, robots.txt, rss.xml, карты сайта и RSS лент | `app/Http/Controllers/SeoController.php` |
| Импорт из Tilda | `tools/crawl.py`, `app/Support/Tilda/SiteImporter.php`, `app/Support/Feeds/FeedImporter.php`, `AssetDownloader.php`, `TildaUrl.php`, `TildaPatches.php` |
| Сверка с Tilda | `app/Console/Commands/TildaVerify.php` |
| Админка | `app/Filament/**` |

### Файлы

| Путь | Что там |
|---|---|
| `public/uploads/tild…/…` | картинки и файлы из Tilda |
| `public/uploads/images/ГГГГ-ММ/…` | картинки, загруженные в админке |
| `public/tilda/…` | библиотеки Tilda (JS/CSS/шрифты/иконки) и наборы стилей блоков `ws/project540442/tilda-blocks-page*.min.css/js` |
| `public/thb/…` | миниатюры (создаются автоматически при первом запросе, папку можно чистить) |
| `public/custom.css` | общий CSS проекта (редактируется в админке, копии — в `storage/app/backups/custom-css`) |

### Что Tilda делала на своих серверах и что теперь делает сайт

| На Tilda | У нас |
|---|---|
| Формы → `forms.tildaapi.com` | `/tilda-forms/procces` (адрес подставлен в `tilda-forms-1.0.min.js`), ответ в формате Tilda |
| Лента новостей → `feeds.tildaapi.com/api/getfeed`, `getpost`, `getrelevantposts`, `setpostviewed` | `/tilda-feeds/…` (адрес подставлен в `tilda-feed-1.1.min.js`), данные — таблицы `feeds`, `feed_posts` |
| Страницы постов `/news/tpost/…` и их AMP-версии `?amp=true` | HTML постов из снимка; общие части (код сайта, иконки, Метрика) берутся из настроек |
| `sitemap-feeds.xml`, `sitemap-feed-531501322995.xml`, `rss-feed-531501322995.xml` | собираются из постов (посты с noindex не попадают, как у Tilda) |
| Поиск Tilda → `search.tildacdn.com` (его подключает боковое меню статей блога T830; поле поиска в блоке сейчас выключено) | `/tilda-search` (адрес подставлен в `tilda-search-1.2.min.js`), индекс — тексты страниц и постов |
| Миниатюры `thb.tildacdn.com` | `/thb/…`, создаются при первом запросе |
| Статистика Tilda (`tilda-stat`) | отключена |

Сторонние сервисы остались как были: Яндекс.Метрика 53775328, Google Analytics, чат Jivo, виджет Leaderator, поиск Google (CSE) в базе знаний, карты Яндекса.

### Формы и заявки

- Формы Tilda отправляют данные на `/tilda-forms/procces`. Ответ совместим с сервисом Tilda, поэтому сообщения об успехе и колбэки блоков работают без изменений.
- Заявки сохраняются в «Заявки» и уходят по каналам из «Настройки → Настройки сайта → Заявки»: e-mail, Telegram, Битрикс24 (`crm.lead.add`).
  Письма отправляются через SMTP почтового ящика со вкладки «Почта (SMTP)» (пароль хранится зашифрованным `APP_KEY`; пока сервер не указан — `MAIL_*` из `.env`).
  Telegram — через зеркало Bot API (`TELEGRAM_API_URL` в `.env`, поле «Telegram: адрес Bot API» в админке важнее): с российских серверов `api.telegram.org` не открывается.
- На Tilda каждая форма отправлялась в 3 подключённых сервиса (какие именно, видно только в кабинете Tilda) — их нужно повторить в настройках заявок.
- Галочек согласия на обработку персональных данных нет в 11 формах из 13 (так было на Tilda). Команда `php artisan site:form-consents` добавляет их во все формы (сделана для korzilla.ru, ссылки — `/politika` и `/soglasie`: перед запуском поправьте их в `SiteFormConsents::CONSENTS`).

### Тестовый стенд и продакшен

`SITE_TRACKING` в `.env` управляет счётчиками и виджетами (Метрика, Google Analytics, Jivo, Leaderator — `config/site.php`):

- `false` — они вырезаются из HTML. Тестовые визиты не попадают в статистику, тестовые обращения — к операторам чата.
- `true` (по умолчанию при `APP_ENV=production`) — выводятся как на Tilda.

## Сверка с Tilda

```bash
php artisan tilda:verify            # все страницы и посты; tilda:verify /pricing /help — выборочно
```

Каждая страница собирается так же, как для посетителя, и сравнивается со снимком байт в байт. Заранее учитываются намеренные отличия:

- ссылки на CDN Tilda → свои файлы (`/uploads/…`, `/tilda/…`, `/thb/…`, `/custom.css`), без резервной загрузки с `neo.tildacdn.com`, `dns-prefetch` к CDN и статистики Tilda;
- версия `custom.css?t=…` — от времени изменения файла (сбрасывает кэш браузера после правки стилей в админке);
- `og:image` и `twitter:image` — абсолютным адресом от адреса сайта;
- служебный параметр Метрики `cmsCatalog` у 5 страниц с корзиной Tilda: код Метрики один на весь сайт.

Шапку, подвал и копии общих блоков (T121) Tilda вставляет в страницу в момент её публикации, поэтому на давно не публиковавшихся страницах они старые (шапка — на ~300 страницах, подвал — на ~400). У нас они одни на весь сайт, в последней версии — сверка считает их отдельно.

## Деплой на сервер

Сайт разворачивается из git на любом сервере с PHP 8.3+ и MySQL/MariaDB — пошагово в **[DEPLOY.md](DEPLOY.md)**: требования, первая установка (`composer install`, `.env`, миграции, `tilda:import` из снимка в репозитории, `site:fix-seo`, администратор), настройка nginx/Apache, обновление кода (`bin/deploy-server.sh`, необязательная автовыкатка `bin/auto-deploy.sh`) и переключение домена.

## Чек-лист перед переключением домена

- [ ] Заполнить получателей заявок: «Настройки сайта → Заявки» (e-mail / Telegram / вебхук Битрикс24) и нажать «Отправить тестовую заявку». Проверьте в кабинете Tilda, в какие 3 сервиса уходили заявки, и повторите их здесь.
- [ ] Настроить SMTP: «Настройки сайта → Почта (SMTP)», кнопка «Отправить тестовое письмо».
- [ ] `SITE_TRACKING=true`, проверить Метрику 53775328, чат Jivo, виджет Leaderator.
- [ ] Пройтись по ключевым страницам на тестовом домене: главная, тарифы, база знаний, блог, новости (список, попап поста, колокольчик в шапке), формы в попапах.
- [x] SEO-ошибки, которые дал бы перенос, исправлены командой `php artisan site:fix-seo` (список — в `docs/audit.md`).
- [ ] Переключить DNS / DDoS-Guard на новый сервер, проверить `https://restoplace.cc/sitemap.xml`, `sitemap-feeds.xml`, `robots.txt`, 301 с `/pageNNN.html`.
- [ ] В Яндекс.Вебмастере и Search Console запросить переобход sitemap.

## Повторный перенос

Если до запуска контент на Tilda ещё меняется:

```bash
python tools/crawl.py --fresh         # свежий снимок сайта → storage/app/tilda-mirror
php artisan tilda:import              # УДАЛИТ страницы/блоки/посты в базе и создаст заново (спросит подтверждение)
php artisan site:fix-seo              # снова применить SEO-исправления (команда идемпотентна)
php artisan tilda:verify              # сверить с Tilda
```

После начала работы в админке повторный импорт не делаем: он перезапишет правки.

### Доперенос отдельных страниц

Если на Tilda сделали новую страницу или поправили старую, переносится только она — `tilda:import-page` ничего не удаляет:

```bash
# локально: скачать страницы и sitemap.xml в зеркало, перенести в базу, скачать картинки
MSYS_NO_PATHCONV=1 php artisan tilda:import-page /blog/novaya-statya /blog --fetch=https://restoplace.cc
git add -A && git commit -m "Доперенос с Tilda: …" && bash bin/deploy.sh
```

Новая страница добавляется целиком. У перенесённой обновляются только блоки, которые не правили в админке (прежняя версия остаётся в истории блока); блоки, добавленные или удалённые на Tilda, команда только называет. Что менялось на Tilda после снимка, видно по датам в её `sitemap.xml`. После переключения домена Tilda доступна по адресу проекта `https://<проект>.tilda.ws` — его и указывайте в `--fetch`.

Новости переносить не нужно: их добавляют в админке («Сайт → Новости»).

## Тесты

```bash
php artisan test
```

Покрыто: парсер HTML и точечные правки, редактор полей и элементов списков, админка (сохранение блоков, общие блоки), маршруты сайта (301, 404, регистр адресов), sitemap/robots, приём заявок и антиспам, отключение счётчиков на тестовом стенде, SEO-исправления, галочки согласий в формах, отправка заявок по SMTP и в Telegram, ленты (API в формате Tilda, страницы постов, правка и создание постов, карты сайта и RSS), доперенос страниц.
