Initial commit

Магазин обуви (apelsincom)/Быстрый старт для нового разработчика (apelsincom).md

@@ -0,0 +1,42 @@
+# Быстрый старт для нового разработчика (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)]]