# Настройка

Параметры фирмы, префиксы штрихкодов, журнал изменений, SMTP, API и служебные экраны администратора. Ниже — инвентарь элементов хаба раздела и оверлеев, открываемых с хаба. Подробные формы — на отдельных страницах.

## Формы и функции раздела

- Общие настройки (в т.ч. префиксы штрихкодов)
- Журнал изменений
- Мастер: интернет-магазин
- Состояние скриптов базы (platform admin)
- SQL-консоль (platform admin)
- HTTP-клиент (platform admin)
- Импорт марок ЕГАИС
- API сервер
- Загрузка весов (открывается из Розницы / справочника весов)

Кнопка «?» на экране формы открывает соответствующую страницу из этого списка.

## Устройство хаба

- **Шапка секции** — иконка, заголовок «Настройка», кнопка «?» → эта страница.
- **Панель кнопок** (панель «Настройки») — открывает вкладки или оверлеи.
- Часть кнопок с меткой admin-only видна только platform admin (скрыты для обычных пользователей).

## Кнопки панели

- **Общие настройки** — вкладка префиксов ШК и параметров базы. Подсказка: «Префиксы штрихкодов и другие параметры базы».
- **Журнал изменений** — склейки, удаления и переименования товаров/контрагентов; правки старых накладных.
- **Мастер: интернет-магазин** — пошаговый запуск бота, витрины, KDS и оплаты.
- **Состояние скриптов БД** (admin) — миграции схемы фирмы.
- **SQL-консоль** (admin) — произвольный SQL по текущей базе.
- **HTTP-клиент** (admin) — мини-Postman: коллекции HTTP-запросов. В разметке кнопка продублирована — обе открывают ту же вкладку.
- **Импорт ассортимента из меркурия** (admin) — оверлей CSV из десктопного Меркурия (товары, цены, ТТК).
- **Импорт марок ЕГАИС** (admin) — оверлей CSV из IBExpert.
- **Исходящая почта (SMTP)** — оверлей настройки SMTP для заказов поставщикам.
- **API сервер** — персональный API к базе.

## Строки-сводки под кнопками

- **firm-mail-summary** — краткий статус исходящей почты (заполняется программой).
- **firm-public-api-summary** — краткий статус API сервера (заполняется программой).

## Оверлей «Исходящая почта (SMTP)»

Заголовок: **E-mail для отправки заказа**. Подсказка: порт **465**, шифрование SSL; пароль хранится в базе фирмы.

### Поля

- **E-mail** — адрес отправителя.
- **Пользователь** — логин SMTP.
- **Пароль** — пароль SMTP; пустое значение = не менять сохранённый.
- **SMTP** — хост сервера.

### Служебные строки и кнопки

- Строка статуса настроек.
- Строка ошибки.
- **Сохранить** — записать настройки в базу.
- **Тестовое письмо** — открыть оверлей теста.
- **Закрыть** — закрыть оверлей.

## Оверлей «Тестовое письмо»

- Подсказка: письмо уходит с текущих настроек SMTP (пароль можно взять из формы, даже если ещё не сохраняли).
- **Email получателя** — куда отправить тест.
- Строка ошибки теста.
- **Отправить** / **Отмена**.

## Оверлей «Импорт ассортимента из меркурия»

Только platform admin. CSV (Windows-1251 или UTF-8): товары, цены, штрихкоды и опционально ТТК. Формат строк: `NAME;FIELD_KEY;SCANCOD;CENA;ED_IZM_NAME;GRP_NAME`.

- **Товары, цены и штрихкоды (.csv)** — выбор файла.
- **ТТК (.csv), необязательно** — выбор файла.
- **Склад для расходных цен** — выбор склада.
- **База не пуста — по имени…** — галочка (показывается, когда база уже не пустая): новые товары + недостающие штрихкоды и цены без смены групп.
- Строки превью / ошибки / результата.
- **Проверить файлы** — валидация без импорта.
- **Импортировать** — запуск (активна после проверки).
- **Закрыть**.

## Оверлей «Импорт марок ЕГАИС»

Только platform admin. На оверлее:

- **Файл выгрузки (.csv или .json)** — выбор файла.
- Превью / ошибка / результат.
- **Проверить файл**, **Проверить таблицу этой базы** (скрыта по умолчанию), **Импортировать**, **Закрыть**.