Помощь

Краткая инструкция снабженца. Полная версия — в документации проекта (docs/ИНСТРУКЦИЯ_СНАБЖЕНЦА.md).

🚀 Первые шаги (10 минут)

  • 1. Зарегистрируйте фирму (название + email + пароль от 12 символов). Вы автоматически становитесь администратором.
  • 2. Добавьте сотрудников: Рабочий стол → профиль admin → API /auth/users или попросите администратора (роль «buyer» — снабженец).
  • 3. Загрузите свою базу: раздел «Импорт» → выберите «Прайс-лист» или «Поставщики» → файл Excel/CSV. Шапки типа «Наименование», «ИНН», «Цена, руб (с НДС)» распознаются автоматически.
  • 4. Проверьте раздел «Каталог» — карточки создались, у каждой видна полнота заполнения.
  • 5. Загрузите первую заявку в «Документы» (PDF или скан) — система извлечёт позиции и сопоставит с каталогом.

📥 Импорт: как готовить файлы

  • Форматы: .xlsx, .xlsm, .csv (UTF-8 или Windows-1251, разделитель «;» или «,»).
  • Прайс: колонки «Артикул», «Наименование», «Цена», опционально «ИНН поставщика», «Кол-во», «Регион». Цены вида «1 234,50 ₽» понимаются.
  • Поставщики: «Наименование/Контрагент», «ИНН», «Город», «Email», «Телефон», «Специализация» (через ;), «Контактное лицо».
  • Повторная загрузка того же файла безопасна: система узнаёт файл по содержимому и не создаёт дубли.
  • Битые строки не ломают импорт: они попадают в отчёт с номером строки, остальное импортируется.

🏭 Поставщики и дубли

  • Карточка ищется по ИНН — один контрагент не заведётся дважды.
  • Если система заподозрила дубль (совпал ИНН, телефон или корпоративная почта) — она НЕ сливает карточки сама: на рабочем столе появится подсказка, решение за вами.
  • Чёрный список: поставщик со статусом «black» исключается из всех выборок и поиска.

📄 Документы: заявки и КП

  • PDF с текстом разбирается напрямую (без распознавания) — быстро и точно.
  • Сканы и фото идут через распознавание (русский+английский).
  • Каждый файл сначала проверяется антивирусом. Если антивирус недоступен — документ ЖДЁТ, а не проскакивает.
  • Извлечённые позиции сопоставляются с каталогом: сначала точно по артикулу, затем — AI по кандидатам поиска.
  • Всё, в чём система не уверена, попадает в «Проверку» — подтверждаете вы. Система никогда не принимает решения за снабженца.

🔍 Поиск

  • Ищет одновременно: по точному артикулу («SKF 6205» = «skf-6205»), по словам (русская морфология), по похожему написанию (опечатки: «SFK6205») и по смыслу.
  • Часть номера тоже работает: «6205» найдёт SKF6205 и NSK6205.
  • У каждой цены в карточке виден её возраст — цены меняются каждую минуту, доверяйте только свежим.

🔐 Безопасность и данные

  • Все данные — в вашей базе (локально или на вашем VPS). Никуда не передаются.
  • Пароли хранятся только в виде хэшей; вход по токенам с автоматическим продлением; выход отзывает сессию.
  • Каждое действие записывается в журнал событий — историю любой карточки можно восстановить.
  • AI-вызовы учитываются поштучно с дневным лимитом расходов.

🧭 Что дальше (в разработке)

  • Автоматические запросы поставщикам по email и мессенджерам, сбор КП, торг и ранжирование предложений — следующий этап (M3).
  • Проверка контрагентов по ЕГРЮЛ и риск-скор — после подключения ключа DaData.
  • Вопросы и идеи — администратору системы.