Первичная настройка

Первичная настройка выполняется в Django admin основного backend. Для тестового стенда админка доступна по адресу, переданному команде отдельно. В документацию не добавляйте реальные учетные данные.

Последовательность настройки

1. Создать или проверить Retailer.
2. Создать или проверить Country.
3. Создать City.
4. Создать Department.
5. Настроить часы работы, смены и зоны доставки.
6. Включить нужные dashboard-модули.
7. Настроить способы оплаты.
8. Создать сотрудников и назначить группы.
9. Настроить базовый каталог.
10. Проверить KKMServer и печать.
11. Проверить тестовый заказ от создания до закрытия.

Проверка

После настройки новой точки сделайте полный тестовый цикл: сайт или dashboard -> заказ -> кухня -> упаковка -> чек -> статус done -> отчет управляющего.

Retailer

Retailer задает верхний контур данных. Через него ограничиваются города, точки, пользователи, каталог и интеграции.

Проверьте:

• название;
• служебный ключ или slug, если используется;
• внешние ключи приложений и карт, если они есть;
• доступность ритейлера для нужных пользователей поддержки.

Country

Country нужен для валюты, телефонного кода и части платежных настроек.

Проверьте:

• название страны;
• код телефона;
• валюту;
• доступные банкноты для наличной оплаты;
• настройки платежных URL, если они используются.

City

City управляет поведением заказов в городе.

Критичные поля:

• timezone - часовой пояс заказов, смен и отчетов;
• is_active - город доступен;
• is_accepting_orders - город принимает заказы;
• is_callcenter_accepted и is_push_to_callcenter - call center;
• длительности cooking, packing, delivery, takeaway, stay;
• min_order_time_offset_minutes - минимальный отступ времени заказа;
• min_delivery_order_price - минимальная сумма доставки;
• флаги оплат: online, card, courier POS, cash, QR, bank transfer, SBP, Sber;
• бонусная система, проценты начисления и максимальная оплата баллами;
• телефоны, юридическая информация, описания доставки;
• business hours.

Department

Department - конкретная точка/ресторан.

Критичные поля:

• title, city, retailer;
• address, latitude, longitude;
• is_active;
• has_takeaway_service;
• modules;
• business hours и shift hours;
• delivery zones;
• складские флаги;
• настройки ККМ;
• настройки Yandex credentials для интеграции;
• цели успешности кухни и доставки.

Сотрудники

Сотрудник должен иметь:

• username;
• пароль;
• account_type = employee;
• привязку к department, если он работает на конкретной точке;
• retailer;
• группы доступа.

Типовые группы:

• operator;
• manager;
• director;
• cook;
• packer;
• callcenter;
• storekeeper;
• takeaway_info_screen.

Важно

Сотрудник с группой, но без корректной точки, может видеть не тот набор данных или не видеть нужный dashboard-раздел.

Базовый каталог

Минимальный набор для запуска:

• категории;
• блюда;
• цены и доступность по городу/точке;
• модификаторы и группы модификаторов;
• ингредиенты, если используется склад;
• labels;
• причины отмены.

Финальная проверка запуска

Перед передачей клиенту проверьте:

1. Вход под оператором.
2. Выбор города и точки.
3. Создание заказа каждого доступного типа: доставка, самовывоз, ресторан.
4. Переход заказа на кухню и упаковку.
5. Печать пречека и фискального чека.
6. Отмена заказа с чеком возврата, если сценарий применим.
7. Отчеты управляющего.
8. Складские документы, если склад включен.