# Быстрый старт для нового разработчика (apelsincom)

Эта страница для того, кто впервые открыл проект. Идите по шагам сверху вниз. Непонятные слова — в [[Глоссарий (apelsincom)]].

## 1. Получите доступы
Сервер, FTP и домен — на странице [[Доступы и окружение (apelsincom)]]. Админка в этом проекте может быть недоступна — работаем по FTP и через API.

Скачайте к себе по FTP папку `/local/` — это все доработки сайта. Ядро `/bitrix/` целиком тянуть не нужно.

## 2. Разберитесь, как всё устроено
- Прочитайте [[Архитектура и структура каталогов (apelsincom)]] — общая картина и правило «всё в /local/».
- Прочитайте [[Компоненты и шаблоны компонентов]] — здесь ключевая особенность: своих компонентов нет, вся вёрстка и логика вывода — в переопределённых шаблонах штатных компонентов.
- Загляните в [[REST API (richcode.api)]] — сайт отдаёт наружу REST-интерфейс; для этого проекта это важнее, чем витрина.
- Бегло — [[Маршрутизация и ЧПУ (apelsincom)]] и [[Инфоблоки и каталог (apelsincom)]].

## 3. Сразу узнайте про «грабли»
Это лучше прочитать до того, как что-то менять — [[Известные проблемы и рекомендации (apelsincom)]]:
- Номер инфоблока каталога (**2**) зашит в коде во многих местах.
- В webroot лежит публичный бэкап `shoes.zip` (~1.27 ГБ) — риск утечки.
- В шаблоне умного фильтра валяется файл-дубль `template copy 1.php`.
- Рядом с активными шаблонами лежат исходные `bootstrap_v4` — не перепутайте, какой правите.

## 4. Проверьте, что всё работает
- Откройте витрину: главная, каталог `/catalog/`, карточка товара.
- Проверьте, отвечает ли API по настроенному пути (по умолчанию `/api/`). Точный путь и токены — в настройках модуля `richcode.api` (нужен админ) либо у прежней команды. См. [[REST API (richcode.api)]].
- Посмотрите свежий `error_log` в корне аккаунта на предмет ошибок.

## 5. Сделайте первое простое изменение
Тренируйтесь на чём-то безопасном:
1. Поправьте текстовую область в `/include/` (например, контакты в подвале — сейчас там демо-данные). Как — в [[Компоненты и шаблоны компонентов#Include-области]].
2. Сбросьте кэш и проверьте страницу ([[Кэширование и обслуживание (apelsincom)]]).

Чего лучше не делать на старте:
- Не трогать ядро `/bitrix/` — работайте только в `/local/`.
- Не менять номер инфоблока и коды свойств без полной проверки — они зашиты в шаблонах и в API.
- Не выкладывать и не генерировать бэкапы в webroot.
- Не делать массовых правок без резервной копии.

## См. также
- [[Магазин обуви (apelsincom) — Обзор]]
- [[Архитектура и структура каталогов (apelsincom)]]
- [[Известные проблемы и рекомендации (apelsincom)]]