================================================================================
                    INTEC PATCHER — ИНСТРУКЦИЯ ДЛЯ ПОЛЬЗОВАТЕЛЕЙ
================================================================================

Intec Patcher — ручной инструмент для точечного обновления отдельных файлов
модулей и готовых решений Intec (Kosmos, Universe, Food и др.) на сайте
1С-Битрикс.

Патчер сравнивает файлы из папки патча с файлами на вашем сайте и позволяет
заменить только те, которые отличаются.


================================================================================
  ВАЖНО: СНАЧАЛА ПРОЧИТАЙТЕ
================================================================================

1. Предпочтительный способ обновления — штатное обновление через Маркетплейс
   1С-Битрикс: https://marketplace.1c-bitrix.ru/

   Для готовых сайтов после обновления модулей часто требуется переустановка
   решения в режиме «обновление» через мастер установки.

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

2. Перед использованием сделайте резервную копию сайта (файлы + база данных).

3. Патчер доступен только администратору сайта (нужна авторизация в Bitrix).

4. После завершения работы рекомендуется удалить папку intec_patcher
   с сервера — инструмент не предназначен для постоянного хранения на сайте.

5. В intec_patcher кладите только те файлы модулей (intec.*), которые
   относятся к вашему сайту. Лишние модули создают дубли строк в таблице
   и путаницу (см. раздел «Несколько модулей — один файл на сайте»).


================================================================================
  ЧТО НУЖНО ЗАГРУЗИТЬ НА САЙТ
================================================================================

На сервер, в корень сайта (туда же, где лежат папки bitrix, upload и т.д.),
загрузите папку intec_patcher


================================================================================
  КАК ОТКРЫТЬ ПАТЧЕР
================================================================================

1. Войдите на сайт под учётной записью администратора Bitrix.

2. Откройте в браузере адрес:

      https://ВАШ-САЙТ.ru/intec_patcher/

   или

      https://ВАШ-САЙТ.ru/intec_patcher/index.php

   (замените ВАШ-САЙТ.ru на домен вашего сайта)

3. Если видите «Access denied» — вы не авторизованы как администратор.


================================================================================
  КАК ПОЛЬЗОВАТЬСЯ ИНТЕРФЕЙСОМ
================================================================================

После открытия патчер автоматически сканирует сайт и показывает таблицу
найденных файлов, сгруппированных по разделам:

   - Модуль          → /bitrix/modules/ и /local/modules/
   - Компоненты      → /bitrix/components/ и /local/components/
   - Wizards         → /bitrix/wizards/ и /local/wizards/
   - Tools           → /bitrix/tools/ и /local/tools/
   - Шаблоны         → /bitrix/templates/ и /local/templates/

Вверху отображаются счётчики:
   - «Найдено»    — сколько пар «патч ↔ файл на сайте» найдено
   - «Совпадает»  — сколько файлов на сайте уже идентичны патчу

Статусы в таблице:

   совпадает    — файл на сайте уже такой же, как в патче. Ничего делать не нужно.
   отличается   — файл на сайте отличается от патча. Можно обновить.
   нет записи   — у веб-сервера нет прав записи в этот файл. Обновление невозможно.

Метка «разные патчи» (синий бейдж, красная полоска слева):
   несколько папок intec.* в патче ведут на один и тот же файл на сайте,
   но содержимое патчей разное. Обновляйте осознанно нужную строку (нужное
   решение), а не все подряд.

Для обновления одного файла:
   1. Найдите строку со статусом «отличается» (жёлтая подсветка).
   2. Убедитесь, что в колонке «Решение» указан нужный вам продукт.
   3. Нажмите кнопку «Обновить».
   4. Дождитесь сообщения об успехе — страница не перезагружается.
   5. Строка станет зелёной, статус сменится на «совпадает».

Кнопка «Пересканировать» — обновляет список файлов (перезагружает страницу).
Используйте её, если вы вручную меняли файлы на сервере.


================================================================================
  БЭКАП ПРИ ОБНОВЛЕНИИ
================================================================================

Перед заменой каждого файла патчер автоматически создаёт его копию рядом
с оригиналом. Имя бэкапа содержит суффикс вида:

   .php_patcher_backup_ДД_ММ_ГГ

Если файл с таким именем уже существует, добавляется время (His).

Пример:
   class.php.php_patcher_backup_01_06_26


Чтобы откатить изменение вручную:
   1. Найдите файл бэкапа рядом с обновлённым файлом (через FTP или файловый
      менеджер хостинга).
   2. Переименуйте бэкап обратно в имя оригинального файла (без суффикса бэкапа).


================================================================================
  КУДА ПОПАДАЮТ ФАЙЛЫ ИЗ ПАТЧА
================================================================================

Путь файла внутри папки intec.* определяет цель на сайте:

   install/components/…     → bitrix/components/… и local/components/…
   install/wizards/…        → bitrix/wizards/… и local/wizards/…
   install/tools/…          → bitrix/tools/… и local/tools/…
   admin/, classes/, …      → bitrix/modules/intec.*/… (и local/modules/…)
   install/wizards/intec/<имя>/site/templates/<шаблон>/…
                            → bitrix/templates/<шаблон>/… (см. ниже)


================================================================================
  ФАЙЛЫ ШАБЛОНОВ
================================================================================

Для файлов из install/wizards/intec/<имя>/site/templates/<шаблон>/…
патчер ищет шаблоны с именами:

   <имя_шаблона>              — как в патче (например kosmos, food)
   <имя_шаблона>_<ID сайта>   — для каждого сайта (например kosmos_s1, food_s2)

Пример для решения Kosmos (модуль intec.kosmos, шаблон kosmos):
   kosmos
   kosmos_s1
   kosmos_s2
   … — по списку сайтов в Bitrix

Если вы переименовывали шаблон на сайте (например, назвали его «my_shop»),
патчер такие файлы не увидит. Их нужно обновить вручную через FTP или
файловый менеджер, сверяясь с содержимым папки патча.

================================================================================
  НЕСКОЛЬКО МОДУЛЕЙ — ОДИН ФАЙЛ НА САЙТЕ
================================================================================

Типичная ситуация: в intec_patcher лежат intec.kosmos, intec.kosmoslite,
intec.kosmoscorp — у всех один и тот же компонент intec.kosmos/banners/
ведёт в один файл:

   /bitrix/components/intec.kosmos/banners/class.php

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

Рекомендация: оставьте в intec_patcher только папку модуля вашего сайта
(например, только intec.kosmos), либо обновляйте только строку нужного решения.


================================================================================
  ЧАСТЫЕ ПРОБЛЕМЫ
================================================================================

Патчер показывает «Найдено: 0»
   → Проверьте, что папки intec.* лежат ВНУТРИ intec_patcher, рядом с index.php.
   → Убедитесь, что на сайте установлен соответствующий модуль и файлы
     по целевым путям уже существуют (патчер не создаёт новые файлы).
   → Проверьте, что в патче не только каталоги версий вида 1.0.0/…
     (такие пути игнорируются).

Статус «нет записи» (красная подсветка)
   → У веб-сервера нет прав на запись в файл или папку.
   → Исправьте права через FTP/SSH или обратитесь в поддержку хостинга.
   → Либо обновите файл вручную.

«Неверный sessid»
   → Сессия истекла. Обновите страницу и войдите в Bitrix заново.

После патча одна строка «совпадает», другая для того же файла — «отличается»
   → См. раздел «Несколько модулей — один файл на сайте».

«Файл уже совпадает с патчем» при нажатии «Обновить»
   → Файл на сайте уже идентичен выбранному патчу. Пересканируйте страницу.

После патча сайт работает некорректно
   → Восстановите файл из бэкапа (см. раздел «Бэкап при обновлении»).
   → Либо восстановите сайт из полной резервной копии.
   → Очистите кэш Bitrix (патчер делает это автоматически при успешном
     обновлении, при необходимости повторите вручную).

Патчер не видит часть файлов шаблона
   → Скорее всего, шаблон переименован. Обновите такие файлы вручную.


================================================================================
  ПОРЯДОК ДЕЙСТВИЙ (КРАТКО)
================================================================================

   1. Сделать бэкап сайта (файлы + БД).
   2. Загрузить папку intec_patcher на сервер.
   3. Оставить в ней только нужные папки intec.* для вашего сайта.
   4. Войти в Bitrix как администратор.
   5. Открыть /intec_patcher/ или /intec_patcher/index.php
   6. Обновить файлы со статусом «отличается» (нужное «Решение» в таблице).
   7. Проверить работу сайта (каталог, корзина, формы, админка модулей).
   8. Удалить папку intec_patcher с сервера.

================================================================================
