# Развёртывание restoplace.cc

Код — в GitVerse: [gitverse.ru/restoplace/restoplace-site](https://gitverse.ru/restoplace/restoplace-site), ветка `main` (`git@gitverse.ru:restoplace/restoplace-site.git`).
В репозитории есть всё для запуска без Tilda: код, снимок сайта (`storage/app/tilda-mirror`), картинки (`public/uploads/tild…`) и библиотеки Tilda (`public/tilda`). После `git clone` проект занимает около 1 ГБ (история git — 270 МБ), плюс `vendor/` после `composer install`.

Как устроен сайт — `README.md`, раздел «Как устроено».

## Требования

- PHP 8.3+ с расширениями `pdo_mysql`, `mbstring`, `gd` (миниатюры картинок), `intl`, `zip`, `fileinfo`, `curl`, `dom`, `xml`; OPcache — желательно.
- MySQL 8 или MariaDB 10.6+, база в utf8mb4.
- Nginx или Apache. Корень сайта — `public/`.
- Composer 2. Node.js не нужен.
- Cron и обработчик очередей не нужны: уведомления о заявках отправляются сразу после ответа посетителю.

## Первая установка

```bash
git clone git@gitverse.ru:restoplace/restoplace-site.git restoplace && cd restoplace
composer install --no-dev --optimize-autoloader
cp .env.example .env          # заполнить DB_*, ADMIN_EMAIL, ADMIN_PASSWORD (остальное — см. комментарии в файле)
php artisan key:generate
php artisan migrate --force

# Наполнить базу из снимка Tilda: страницы, блоки, новости, SEO, настройки.
# Картинки и библиотеки уже в репозитории, поэтому --no-download: импорт не обращается к Tilda.
php -d memory_limit=1G artisan tilda:import --force --no-download    # 5–10 минут
php artisan site:fix-seo      # исправления SEO, без которых перенос дал бы ошибки (docs/audit.md)
php artisan db:seed --force   # первый администратор из ADMIN_EMAIL / ADMIN_PASSWORD

php artisan optimize
php artisan filament:optimize
```

Проверка, что сайт собирается так же, как на Tilda (не обязательно): `php -d memory_limit=1G artisan tilda:verify` — должно быть «Совпадают байт в байт: 541» (около минуты).

Права на запись для пользователя PHP: `storage/`, `bootstrap/cache/`, `public/thb/` (миниатюры создаются при первом запросе), `public/uploads/` (картинки из админки — `public/uploads/images`, `public/uploads/og`), `public/custom.css` (общий CSS правится в админке).

Если в `php.ini` отключена `proc_open`, Composer не выполнит свои скрипты — тогда после `composer install` запустить вручную `php artisan package:discover && php artisan filament:upgrade` (или Composer с `php -d disable_functions= composer.phar install …`).

## Веб-сервер

Корень — `public/`, всё, чего нет на диске, — в `public/index.php`. Важно: многие адреса, которые выглядят как файлы, отдаёт Laravel — `/favicon.ico`, `/robots.txt`, `/sitemap.xml`, `/sitemap-feeds.xml`, `/sitemap-feed-531501322995.xml`, `/rss-feed-531501322995.xml`, `/rss.xml`, миниатюры `/thb/…`. Не добавляйте для них отдельных `location` без перехода в `index.php` (в стандартном примере Laravel для nginx есть `location = /favicon.ico` и `location = /robots.txt` — их нужно убрать).

Nginx:

```nginx
server {
    server_name restoplace.cc www.restoplace.cc;
    root /var/www/restoplace/public;
    index index.php;
    client_max_body_size 32m;

    location / { try_files $uri $uri/ /index.php?$query_string; }
    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    }
    # Картинки, библиотеки Tilda и миниатюры: файл с диска, а миниатюры, которых ещё нет, создаёт Laravel
    location ~* ^/(uploads|tilda|thb)/ { expires 30d; access_log off; try_files $uri /index.php?$query_string; }
    location = /custom.css { expires 1h; }
}
```

Apache: `public/.htaccess` уже есть (стандартный Laravel), нужен `AllowOverride All` и `mod_rewrite`.

`www.restoplace.cc` приложение само отправляет 301 на `restoplace.cc` (основной адрес — `SITE_URL` в `.env`, после импорта — «Настройки сайта → Адрес сайта»). Любой другой адрес (тестовый домен, IP сервера) отдаётся с `X-Robots-Tag: noindex`, а `robots.txt` на нём — `Disallow: /`, так что тестовый стенд не попадёт в поиск.

## Что в git, а что нет

| | Где источник правды | В git |
|---|---|---|
| Код: `app/`, `config/`, `resources/`, `routes/`, `database/migrations`, `bin/`, `public/index.php`, `public/assets/` | GitVerse | да |
| Снимок Tilda: `storage/app/tilda-mirror`, картинки `public/uploads/tild…`, библиотеки `public/tilda` | GitVerse | да |
| `.env` — ключ приложения, доступы к базе, почта, `SITE_TRACKING` | свой на каждом сервере | **нет** |
| База: страницы, блоки, новости, SEO, заявки, настройки, пользователи | **админка на сервере** | **нет** |
| `public/custom.css` — общий CSS (создаётся импортом, дальше правится в админке) | **админка на сервере** | **нет** |
| Картинки из админки: `public/uploads/images`, `public/uploads/og` | **админка на сервере** | **нет** |
| `public/thb` (миниатюры), `storage/logs`, кэши | создаются сами | нет |

База и картинки из админки живут только на сервере — их нужно включить в резервное копирование.

**`php artisan tilda:import` запускается один раз, при установке.** Повторный импорт пересоздаёт страницы, блоки и новости и стирает правки из админки. Новые и изменённые на Tilda страницы переносит `tilda:import-page` (README, «Доперенос отдельных страниц») — он ничего не удаляет.

## Обновление кода

```bash
git pull --ff-only
composer install --no-dev --optimize-autoloader    # если менялся composer.lock
php artisan migrate --force
php artisan optimize:clear && php artisan cache:clear
php artisan optimize && php artisan filament:optimize
```

То же делает `bash bin/deploy-server.sh` (из рабочей копии на сервере, от пользователя сайта): забирает `origin/main`, приводит к нему код (`git reset --hard` — правки кода прямо на сервере затираются), ставит зависимости, если менялся `composer.lock`, выполняет миграции и пересобирает кэши. Данные из `.gitignore` не трогает.

Необязательно — автовыкатка: `bin/auto-deploy.sh` в cron пользователя сайта раз в минуту сверяет `main` в GitVerse с выкаченной версией и запускает `bin/deploy-server.sh`, если появились новые коммиты (`* * * * * bash /путь/к/сайту/bin/auto-deploy.sh`; журнал — `storage/logs/deploy.log`). Серверу для этого нужен ключ с доступом на чтение к репозиторию (ключ развёртывания в настройках репозитория GitVerse). Так обновляется korzilla.ru.

Разработчики после этого отправляют правки командой `bash bin/deploy.sh` (тесты → push). С `DEPLOY_SERVER` и `DEPLOY_DIR` в окружении она ещё и дождётся выкатки на сервере (подробности — в шапке скрипта).

## После установки

1. **Почта и уведомления о заявках:** админка `/admin` → «Настройки сайта» → вкладки «Заявки» (e-mail, Telegram, Битрикс24) и «Почта (SMTP)», кнопки «Отправить тестовое письмо» и «Отправить тестовую заявку». На Tilda каждая форма уходила в 3 подключённых сервиса — какие, видно в кабинете Tilda.
2. **Telegram:** с российского сервера `api.telegram.org` часто не открывается — тогда в `.env` указать зеркало Bot API в `TELEGRAM_API_URL` (у korzilla.ru — `https://tapi.keeplo.ru`).
3. **Пароль администратора** — сменить после первого входа: «Настройки → Пользователи».
4. **Проверить на тестовом адресе:** главная, тарифы, база знаний, блог, новости (`/news`, попап поста, колокольчик в шапке), формы в попапах, `/sitemap.xml`, `/sitemap-feeds.xml`, `/robots.txt`.

## Переключение домена

1. `SITE_TRACKING=true` в `.env` (Метрика, Google Analytics, Jivo, Leaderator), затем `php artisan optimize:clear && php artisan optimize`.
2. DNS / DDoS-Guard: `restoplace.cc` и `www.restoplace.cc` → новый сервер. Если DDoS-Guard остаётся, соединение с сервером должно идти по HTTPS, иначе с редиректом на https будет петля.
3. SSL (Let's Encrypt) для `restoplace.cc` и `www.restoplace.cc`, редирект http → https.
4. Проверить `https://restoplace.cc/sitemap.xml`, `robots.txt`, 301 с `www` и с технических адресов `/pageNNN.html`.
5. Яндекс.Вебмастер и Search Console — переобход sitemap.

## Полезное

- Логи приложения — `storage/logs/laravel-ГГГГ-ММ-ДД.log`.
- Команды — `php artisan list`: `tilda:import-page` (доперенос страниц с Tilda), `tilda:verify` (сверка с Tilda), `site:fix-seo`, `site:preview-links` (ссылки на неопубликованные страницы без входа, 30 дней), `site:form-consents` (галочки согласий в формах — не запускалась, см. README).
