Django admin

Основная админка управляет городами, точками, пользователями, каталогом, оплатой и интеграциями. Клиентский dashboard покрывает только часть настроек; остальные меняет техподдержка.

City

Источник: backend/dostavixbe/locations/city/models.py.

Главные блоки:

• основные поля: город, страна, часовой пояс, длительности этапов заказа;
• флаги активности и приема заказов;
• настройки оплаты;
• бонусы и баллы;
• описания доставки;
• социальные сети;
• legal info;
• телефоны и часы работы.

Когда менять:

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

Department

Источник: backend/dostavixbe/locations/department/models.py и locations/department/admin.py.

Главные блоки:

• адрес и координаты;
• активность точки;
• dashboard-модули;
• единицы измерения ингредиентов и блюд;
• складские ограничения;
• график и смены;
• зоны доставки;
• настройки KKM;
• Yandex credentials;
• показатели успеха.

Поля, которые чаще всего влияют на инциденты:

• modules - какие разделы видит персонал;
• is_active - доступность точки;
• can_full_edit_confirmed_orders - редактирование подтвержденных заказов;
• show_order_to_cooker_and_packer_synchronously - видимость заказа упаковщику;
• enable_write_off_goods - списание товаров со склада;
• enable_display_of_stock_balances - показ остатков;
• is_the_sound_signal_looped и sound_interval_in_seconds - звуковой сигнал;
• kitchen_success_rate_target, delivery_success_rate_target - цели метрик.

Настройки ККМ в Department

Эти настройки критичны для печати:

• kkm_cashier_name - имя кассира в чеке;
• kkm_cashier_tax_number - ИНН кассира;
• kkm_tax_tag - НДС в процентах или тег НДС, -1 используется как НДС не облагается;
• kkm_receipt_copies - количество копий;
• kkm_pay_by_processing - проводить оплату через эквайринговый терминал;
• check_printing_of_receipts - проверка печати;
• print_a_slip_check_anyway - печатать пречек в отдельных сценариях;
• cook_printer_device_numbers - номера устройств кухонных принтеров;
• auto_print_cook_receipt_on_confirm - автопечать на кухню;
• allow_close_order_with_printed_slip_check - разрешить закрытие заказа по пречеку без фискального чека;
• fiscal_receipt_is_enabled_by_default - фискальный чек выбран по умолчанию;
• split_delivery_price_by_item_in_receipt - распределять доставку по позициям или печатать отдельной строкой;
• enable_cooking_duration_in_receipt - печатать время приготовления;
• enable_big_order_number_in_receipt - печатать крупный номер заказа;
• fee_receipt_label - подпись сервисного сбора;
• slip_receipt_limit - лимит печати пречеков.

Ошибка

Налоговые параметры должны соответствовать регистрации ККТ и требованиям фискализации. Поддержка настраивает систему, но не заменяет налогового консультанта клиента.

CloudPayments

Модель: CloudPaymentsCredential.

Поля:

• public_id;
• secret_key;
• привязка к city или department;
• retailer.

Правила:

• secret_key не отправлять в чатах и не добавлять в документацию;
• после изменения webhook или ключей сделать тестовую онлайн-оплату;
• если есть привязка и к городу, и к точке, уточнить фактический приоритет в коде перед изменением.

Users и Groups

Модель пользователя содержит клиентские и сотруднические поля. Для сотрудников важны:

• department;
• responsible_for_categories;
• is_receive_bot_alerts;
• is_active;
• is_staff;
• is_for_test_login;
• groups;
• retailer.

Для клиентов не меняйте вручную баллы и комментарии без согласованного основания.

Каталог

Основные модели:

• Category;
• MenuItem;
• MenuItemCityAttr;
• Modifier;
• ModifierGroup;
• Ingredient;
• Label.

Проверяйте связки город/точка/ритейлер. Частая причина “блюдо не видно” - позиция есть в каталоге, но не активна или не привязана к нужному городу/точке.

Export templates

ExportTemplate и ExportJob используются для клиентских выгрузок. Перед изменением шаблона проверьте, какие роли и страницы используют эту выгрузку.