48 lines
5.6 KiB
Markdown
48 lines
5.6 KiB
Markdown
# Документация сайта (магазин обуви 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)]].
|