карьерчик.ПРОЕКТНАЯ ДОКУМЕНТАЦИЯ / V1.0.0 / 16 ОКТЯБРЯ 2026
BUSINESS REQUIREMENTS / BRD

От потребности в материале
до понятной заявки.

1. Цели и границы

Проблема: покупателю приходится связывать характеристики материала, единицы измерения и доставку самостоятельно. Запрос без адреса, объёма и даты создаёт дополнительные уточнения.

Цель: собрать исходные параметры и предварительную стоимость в одном сценарии. Результат v1 — сохранённая заявка со снимком расчёта, а не подтверждённый заказ на поставку.

В v1За границами v1
Демонстрационный каталог из 8 позицийИнтеграция с прайсами карьеров и остатками
Предварительный расчёт по зонамМаршрутизация по координатам, пробки, пропуска
Поставка 3–500 м³ и самовывозИндивидуальная логистика нестандартных объёмов
Частный клиент / организацияВерификация юрлиц, отсрочки и кредитные лимиты
Сохранение и чтение статуса заявкиКабинет менеджера, CRM, диспетчеризация
Локальная работа и HTML-аналитикаПубличный запуск, платёжный эквайринг, электронный документооборот

2. Сегменты, задачи и роли

СегментЗадача клиентаКритерий успеха
Частный застройщикОтсыпать участок / подготовить основаниеПонять объём и ориентир полной цены
Прораб / подрядчикПодобрать фракцию под этап строительстваПередать материал, дату и условия подъезда
Снабженец организацииСобрать запрос на поставку для объектаЗаявка содержит компанию и параметры
Ландшафтный подрядчикЗаказать грунт, песок, дренажный материалВыбрать применение и рассчитать слой
Менеджер оператора (будущая роль)Проверить тариф и согласовать предложениеПолучить структурированный запрос без пропусков

В реализованной v1 только публичный пользователь. Раздел «Для бизнеса» не создаёт отдельную учётную запись. Роли менеджера, диспетчера, администратора и поставщика описывают целевой процесс и пока не доступны в интерфейсе.

Ответственность в целевой модели

ДействиеКлиентМенеджерЛогистВладелец каталога
Параметры потребностиВводитУточняетКонсультирует по подъезду—
Актуальность товара и цены—ПодтверждаетПодтверждает логистикуПоддерживает
Подтверждение датыСогласуетСообщаетПроверяет слот—
Качество партииПринимаетПередаёт документыКонтроль перевозкиСвязывает с поставщиком
Работа с даннымиДаёт согласиеДоступ по ролиМинимально необходимый доступУправляет правилами

3. Бизнес-процесс

AS-IS: гипотеза на основе публичных страниц

Каталог / прайс→Звонок или форма→Уточнение объёма и адреса→Ручное предложение

Это обобщение публичного пути, а не аудит внутренних процессов конкурентов.

TO-BE: реализованная v1

Поиск материала→Выбор количества и зоны→Предварительный расчёт→Контакты и согласие→Локальная заявка

Целевое продолжение после v1

Менеджер проверяет→Коммерческое предложение→Договор / оплата→Диспетчеризация→Приёмка и документы

В v1 нет автоматической передачи менеджеру и резервирования. Успешная отправка означает только устойчивое сохранение на локальном сервере. Статус всегда «Новая заявка».

UC-01. Рассчитать поставку

Предусловие: доступны API и каталог. Клиент выбирает материал, количество, единицу и зону. Система проверяет диапазон, переводит массу в объём, определяет число рейсов и создаёт расчёт. Клиент видит состав суммы. При ошибке введённые значения сохраняются; отображается причина. После смены любого параметра прежний расчёт скрывается.

UC-02. Сохранить заявку

Предусловие: есть действующий расчёт. Клиент вводит имя, телефон, адрес, дату, тип клиента, при необходимости компанию и комментарий, отмечает согласие. API сохраняет снимок расчёта и возвращает номер и секретный код. При сетевой ошибке клиент может повторить отправку; один расчёт создаёт максимум одну заявку.

UC-03. Проверить заявку

Клиент открывает «Моя заявка» и вводит номер с кодом или подставляет последнее подтверждение из браузера. При совпадении сервер возвращает ограниченную сводку без контактных данных. Для неверного номера и неверного кода используется одинаковая ошибка.

4. Бизнес-правила

IDПравилоРеализация
BR-01Основная расчётная единица — м³; денежная — RUBAPI, decimal
BR-02Допустимый объём 3–500 м³ включительноAPI; тонны преобразуются по плотности
BR-03Насыпная плотность зависит от материалаДемо-значения в каталоге, без претензии на измерение партии
BR-04Ограничения машины одновременно 12 м³ и 20 тРейсы = ceil(max(объём / 12, масса / 20))
BR-05Тариф доставки определяется зоной и числом рейсовСамовывоз = 0; иные зоны — тариф × рейсы
BR-06Цена расчёта не принимается от браузераСервер использует свой каталог; заявка ссылается на quoteId
BR-07Расчёт действует 24 часаExpiresAt; истёкший расчёт отклоняется
BR-08Один расчёт — одна заявкаПовтор с теми же именем и телефоном возвращает исходный результат
BR-09Дата от текущей до +90 дней по МосквеAPI, YYYY-MM-DD; желаемая дата, без обещания слота
BR-10Для организации обязательно название компанииAPI и форма
BR-11Согласие обязательно; версия и время фиксируютсяAPI, ConsentVersion=demo-v1
BR-12Налоговые условия не определеныИнтерфейс предупреждает; налог не вычисляется отдельно
BR-13Доступ к статусу по номеру и секретуСлучайный 256-битный код в заголовке, не в URL

5. Функциональные требования и приоритеты

IDТребованиеПриоритетКритерий приёмки
FR-01Поиск и категорииMustПоиск по названию/фракции/применению комбинируется с категорией
FR-02Сортировка по ценеMustВозрастание / убывание по цене за м³
FR-03Карточка материалаMustНазвание, фракция, плотность, применение и тестовая цена
FR-04Калькулятор материала и логистикиMustСуммы берутся только из ответа C# API
FR-05Площадь × толщина слояShouldОбъём = м² × см / 100; запас на уплотнение не включён
FR-06Заявка частного / корпоративного клиентаMustВалидация обязательных полей и согласия
FR-07Подтверждение и проверка заявкиMustНомер и секрет; без секрета сводка недоступна
FR-08Ошибки и повторMustНедоступность API не создаёт ложного успеха; каталог можно перезагрузить
FR-09Адаптивный интерфейсMustКаталог 4/2 колонки, форма 2/1 колонки
FR-10HTML-документацияMustАвтономные связанные файлы; копия доступна из портала
FR-11Администрирование и CRMLaterВ v1 не реализовано
FR-12Онлайн-оплата и документыLaterВ v1 не реализовано

6. Метрики и бизнес-экономика

Целевые показатели ниже — гипотезы пилота; данные ещё не собраны, аналитический SDK не подключён.

МетрикаФормула / источникПредлагаемая цель пилота
Завершение расчётаУспешные расчёты / начала формыОпределить baseline на 100 сессиях
Расчёт → заявкаСохранённые заявки / уникальные расчётыНе менее 15%, подтвердить экспериментом
Полнота заявкиЗаявки без уточнения исходных параметров / все заявкиНе менее 80%
Время до заявкиМедиана между выбором и сохранениемДо 3 минут для повторного клиента
Ошибка расчётаОшибочные / все запросы, отдельно 4xx и 5xx5xx менее 1% после пилота
Маржинальный доходВыручка − закупка − перевозка − переменные расходыОпределить после тарифов поставщиков

Монетизация предполагается через торговую наценку и/или логистическую услугу единого оператора. Комиссии маркетплейса, подписки поставщиков и платное продвижение не включены в v1. Для экономики нужны закупочные цены, расстояния от точек отгрузки, загрузка машин, простой и условия налогов.

7. Открытые бизнес-решения

  1. Юрлицо, бренд, реквизиты и реальные контакты.
  2. Регион, список карьеров и фактические тарифы, минимальные партии.
  3. Правила объёмных скидок, наценок, сезонности и налогов.
  4. Кто подтверждает заявку и в какой срок; канал уведомлений и CRM.
  5. Договор, оплата, отмена, возврат и порядок претензий по объёму/качеству.
  6. Требования к документам партии, учёт лабораторных показателей.