Initial commit

Магазин обуви (apelsincom)/Магазин обуви (apelsincom) — Обзор.md

@@ -0,0 +1,47 @@
+# Документация сайта (магазин обуви 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)]]
+
+## Самое важное, если коротко
+1. Сайт на Битриксе, главный модуль **25.100.500** (2025). Все доработки — в `/local/`, ядро `/bitrix/` не трогаем.
+2. Каталог товаров — **инфоблок ID 2** (тип `catalog`), с торговыми предложениями (размер, цвет). Номер зашит в коде во многих местах — см. [[Известные проблемы и рекомендации (apelsincom)]].
+3. Своих компонентов и `init.php` в `/local/` **нет**. Вся кастомизация — в переопределённых шаблонах штатных компонентов (`/local/templates/custom/components/`). См. [[Компоненты и шаблоны компонентов]].
+4. Наружу торчит **REST API** (`richcode.api 3.1.5`) по пути вида `/api/…` с токенной авторизацией. Это чувствительная точка входа — [[REST API (richcode.api)]] и [[Информационная безопасность (apelsincom)]].
+5. Внимание: в webroot лежит полный бэкап `shoes.zip` (~1.27 ГБ). Убрать в первую очередь — [[Известные проблемы и рекомендации (apelsincom)]].