Справка

Кто есть кто: роли в закупке

Платформа использует четыре роли. Роль выбирается при входе через Яндекс — каждая страница ниже автоматически запрашивает нужную роль. Одна закупка всегда объединяет организатора, участников и закупщика; продавец — отдельная роль для тех, кто публикует предложения на витрине.

🗂 Организатор — как провести закупку

Организатор запускает закупку и ведёт её от начала до конца. Самостоятельно покупать ничего не нужно — для этого есть закупщик.

1. Войдите как организатор — откройте панель организатора. При входе через Яндекс роль «Организатор» подставится автоматически.
2. Создайте закупку — введите название, описание, адрес раздачи и ориентировочную стоимость доставки. Нажмите «Создать». Закупка появится в таблице «Мои закупки».
3. Скопируйте ID закупки — кликните по строке в таблице. ID появится в поле «Id закупки» справа. Это короткий код вида 3fa85f64-….
   Передайте ID участникам и закупщику. Без ID присоединиться к закупке невозможно — платформа не показывает чужие закупки в открытом доступе. Отправьте ID в чат группы, где собираете заявки.
   
   Участникам (кто делает заказы) — они вводят его на странице участника в поле «Вступить по коду».
   Закупщику (кто едет на рынок) — он вводит его на странице закупщика.
4. Дождитесь заявок — участники вступают и добавляют позиции. Вы видите общий список в панели.
5. Переведите статус в «Заблокирована» — когда сбор заявок завершён. После этого состав не меняется.
6. Ведите статусы дальше — «В процессе» → «На рынке» → «В пути» → «Раздача» → «Завершена». Участники видят текущий статус в своей панели.
7. На этапе раздачи — отметьте кто забрал заказ. Закупщик к этому моменту уже внёс фактические цены.

🧺 Участник — как вступить и сделать заказ

Участник — это тот, кто хочет что-то купить в закупке. Просто так зайти на сайт и увидеть чужую закупку нельзя: нужен ID от организатора.

1. Получите ID закупки от организатора — обычно он присылает его в общий чат. Это строка вида 3fa85f64-5717-4562-b3fc-2c963f66afa6.
2. Откройте панель участника — перейдите по ссылке и войдите через Яндекс (роль «Участник» подставится автоматически).
3. Вступите в закупку — введите ID в поле «Вступить по коду» и нажмите кнопку. Закупка появится в вашем списке.
4. Добавьте позиции — укажите что хотите заказать: название товара и количество. Можно добавить несколько позиций.
5. Следите за статусом — когда организатор меняет статус закупки, вы увидите это в панели. На этапе «Раздача» приходите за своим заказом по адресу, который указал организатор.
6. Используйте чат — задавайте вопросы организатору прямо в панели.

Если закупка уже «Заблокирована» — новые заявки не принимаются. Уточните у организатора.

🛒 Закупщик — как работать на рынке

Закупщик — человек, который физически едет на рынок или к поставщику и покупает товары по общему списку. Это отдельная роль: закупщик не обязательно сам участвует в закупке как потребитель.

1. Получите ID закупки от организатора — без него войти в закупку невозможно.
2. Откройте панель закупщика — перейдите по ссылке и войдите через Яндекс (роль «Закупщик» подставится автоматически).
3. Загрузите закупку по ID — введите ID в поле и нажмите «Загрузить детали». Вы увидите общий список позиций всех участников.
4. Возьмите список с собой — распечатайте или держите телефон под рукой. В списке — все товары и суммарные количества.
5. После покупки внесите фактические цены — по каждой строке введите реальную цену за единицу. Система сама пересчитает итоги для каждого участника.
6. Отметьте купленные позиции — чтобы организатор и участники видели что уже есть.

Итоговые суммы к оплате каждым участником считаются автоматически после того, как вы внесли фактические цены.

🏪 Продавец — как опубликовать предложение

Продавец — поставщик или частное лицо, которое предлагает товары на витрине маркетплейса. Витрина открыта для всех без входа — посмотреть.

1. Откройте страницу продавца — перейдите по ссылке и войдите через Яндекс (роль «Продавец» подставится автоматически).
2. Заполните карточку товара — название, описание, цена, фото, минимальный заказ, срок хранения, категория, контакты.
3. Опубликуйте — карточка появится на витрине главной страницы. Организаторы могут перенести её в свою закупку одним кликом.

Модерация публикаций — на усмотрение администратора платформы.

Краткая шпаргалка

Самое важное на одной странице.

Для разработчиков и интеграции

• Документация API — JWT, примеры тел запросов, маркетплейс, закупки по ролям, OpenAPI JSON (/swagger/v1/swagger.json).
• Чат в реальном времени (SignalR), переменные окружения и запуск — в GroupBuying.Server/README.md.
• Назначение роли в базе для отладки, контракты API и бизнес-логика — в tz_zakupki.md.

Полезные ссылки

• Сценарии по ролям и панели — быстрый переход к разделу выше.
• Документация API — для HTTP-клиентов и мобильных приложений.
• Маркетплейс — стартовая страница, лента объявлений продавцов.