Документация сайта (магазин обуви apelsincom) — для разработчика

Это техническая документация интернет-магазина обуви на 1С-Битрикс (хостинг-аккаунт apelsincom, стенд shoes1.orangedm.agency, агентство OrangeDM). Она написана для веб-разработчика, который будет сопровождать и дорабатывать сайт по FTP, без опоры на админку. Задача — чтобы новый человек разобрался сам, не обращаясь к прежней команде.

Я разбирался по коду и файлам через FTP (только чтение, на сервере ничего не менял). Всё, что хранится в базе (точные настройки модулей, значения токенов, включённость мер защиты), по файлам не видно — такие места помечены как «проверить». Как и что проверялось — в Источники и метод проверки (apelsincom).

[!info] Главная особенность этого сайта Кроме обычной витрины, сайт работает как API-бэкенд: сторонний модуль richcode.api отдаёт наружу REST-интерфейс к товарам, заказам, складам и пользователям. Скорее всего, именно поэтому «работа без админки» — данными управляют через API. Начните с REST API (richcode.api).

Впервые на проекте — идите в Быстрый старт для нового разработчика (apelsincom). Совсем коротко — #Самое важное, если коротко ниже.

С чего начать

Быстрый старт для нового разработчика (apelsincom) — что делать в первый день
Доступы и окружение (apelsincom) — сервер, FTP, домен, версии

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

Архитектура и структура каталогов (apelsincom) — общая картина и правило «всё в /local/»
Шаблон custom — шапка, подвал, подключение стилей, поведение на JS
Компоненты и шаблоны компонентов — где вёрстка и данные каждого блока
Инфоблоки и каталог (apelsincom) — модель товаров, размеры, цвета
Маршрутизация и ЧПУ (apelsincom) — как адрес превращается в страницу
Серверная логика и php_interface (apelsincom) — что выполняется на каждой странице

Технические подсистемы

REST API (richcode.api) — самое интересное: внешний API к сайту
REST API — методы и примеры (richcode.api) — справочник действий и примеры curl
Интеграции (apelsincom) — 1С, Яндекс.Маркет, Битрикс24, мобильное приложение
Кэширование и обслуживание (apelsincom) — кэш, обновления, cron

Работа с сайтом

Сценарии. Товары и разделы — как добавить/изменить элемент и раздел (через API и код)

Безопасность

Информационная безопасность (apelsincom) — модель угроз и меры
Известные проблемы и рекомендации (apelsincom) — грабли и что чинить в первую очередь

Справочники

Справочник — что где лежит (apelsincom)
Глоссарий (apelsincom) — термины Битрикса
Источники и метод проверки (apelsincom)

Самое важное, если коротко

Сайт на Битриксе, главный модуль 25.100.500 (2025). Все доработки — в /local/, ядро /bitrix/ не трогаем.
Каталог товаров — инфоблок ID 2 (тип catalog), с торговыми предложениями (размер, цвет). Номер зашит в коде во многих местах — см. Известные проблемы и рекомендации (apelsincom).
Своих компонентов и init.php в /local/ нет. Вся кастомизация — в переопределённых шаблонах штатных компонентов (/local/templates/custom/components/). См. Компоненты и шаблоны компонентов.
Наружу торчит REST API (richcode.api 3.1.5) по пути вида /api/… с токенной авторизацией. Это чувствительная точка входа — REST API (richcode.api) и Информационная безопасность (apelsincom).
Внимание: в webroot лежит полный бэкап shoes.zip (~1.27 ГБ). Убрать в первую очередь — Известные проблемы и рекомендации (apelsincom).

5.6 KiB Raw Permalink Blame History Unescape Escape