Введение
BuildCore - SaaS-платформа для строительной отрасли Узбекистана. Платформа объединяет заказчиков (B2B, B2C, B2G), подрядчиков, поставщиков, исполнителей услуг, рабочих и бригады, технадзор и модераторов в едином рабочем пространстве с AI-подбором, оплатой по этапам и сквозным документооборотом (договоры подряда, акты выполненных работ, справки о стоимости). Платформа не является стороной сделок, не хранит деньги и не удерживает процент с заказов: договоры и расчёты - напрямую между пользователями.
Это руководство описывает интерфейсы каждой роли, типовые сценарии и форматы интеграции через REST API. Скриншоты сняты с текущей сборки платформы.
Регистрация и вход
Регистрация занимает 1-2 минуты: указываете email, телефон, выбираете роль (Заказчик, Подрядчик, Поставщик, Исполнитель услуг). Для юридических лиц добавляется верификация ИНН и подтверждение документов модератором. После подтверждения email становится доступен личный кабинет.
- Откройте
/register, выберите роль, заполните email и пароль. - Подтвердите email по ссылке из письма.
- Юр.лица: загрузите выписку и устав - модерация занимает до 1 рабочего дня.
- После входа сессия сохраняется 30 дней; выход - через меню аватара.
Глобальная навигация
Внутри кабинета слева - sidebar с разделами роли, сверху - глобальный поиск, кнопка «+ Создать», уведомления и аватар пользователя. Бэйджи у пунктов меню показывают количество непрочитанных событий: новые заявки, отклики, сообщения чатов, неподписанные акты.
- Sidebar - раздел роли с пунктами и числовыми бэйджами.
- Topbar - глобальный поиск по проектам, заказам и контрагентам.
- Кнопка «+ Создать» - быстрое создание проекта, заявки, сметы, заказа.
- Колокольчик уведомлений с выпадающим списком последних 10 событий.
- Аватар - настройки, профиль организации, выход.
Уведомления
Все системные события (новый отклик, начало этапа, акт на подпись, спор, отметка оплаты этапа, комментарий в чате) приходят в виде уведомлений в колокольчик. Email-уведомления подключаются дополнительно.
- Оплата - изменение статуса оплаты этапа, счета за подписку.
- Документы - акты выполненных работ, договоры на подпись, счета-фактуры.
- Workflow - переходы этапов, готовность к приёмке, дедлайны.
- Социальные - отзывы, сообщения чатов, ответы технадзора.
- Системные - модерация, верификация, изменения тарифа.
Заказчик
Кабинет заказчика - центр управления проектом: создаёте объект, публикуете тендер, выбираете подрядчика, контролируете этапы и отмечаете оплату по актам. Поддерживается полный цикл от ТЗ до сдачи объекта и эксплуатации.
Дашборд
Стартовая страница заказчика: сводка по активным проектам, статус оплаты этапов, ближайшие этапы и акты на подпись. Все ключевые метрики (бюджет, ожидает оплаты, оплачено) видны в одном месте.
- Карточки активных проектов с прогресс-баром этапов.
- Сводка по оплате: «Ожидает оплаты», «Оплачено», «В споре».
- Список «требует действия»: акты на подпись, споры, новые отклики.
- График оплат по договорам на ближайшие 30 дней.
- Быстрые ссылки: создать проект, опубликовать заявку, открыть смету.
Проекты
Таблица всех проектов с фильтрами по статусу, типу (ИЖС, многоэтажка, ремонт, благоустройство) и бюджету. Каждая строка - карточка с прогрессом и текущим этапом.
- Колонки: название, тип, статус, бюджет, % готовности, дедлайн.
- Фильтры по статусу (DRAFT, ACTIVE, ON_HOLD, COMPLETED) и категории.
- Кнопка «Создать проект» с шаблонами (ИЖС, ремонт, нежилое).
- Поиск по адресу и названию.
- «+ Создать проект» → шаблон → ввод адреса, бюджета, описания.
- После сохранения - проект в статусе DRAFT, не виден исполнителям.
- Публикация заявки автоматически переводит проект в ACTIVE.
Карточка проекта
Полная карточка проекта со вкладками: общее описание, заявки, сметы, материалы, этапы, оплата, акты, технадзор, фотоотчёты, документы и чаты.
- Шапка: название, адрес, ответственный менеджер, статус.
- Горизонтальные вкладки разделов проекта.
- Сводка по бюджету vs факту и календарь этапов.
- Кнопки действий: опубликовать заявку, добавить смету, пригласить технадзор.
Заявки и тендеры
Заявка - это публичный тендер для подрядчиков и поставщиков. Заказчик описывает работы, прикладывает смету, указывает срок ответа и получает предложения.
- Список заявок с типом (Работы, Материалы, Комплект), бюджетом, числом откликов.
- Статусы: DRAFT, PUBLISHED, RECEIVING_PROPOSALS, AWARDED, CLOSED.
- Колонка «дедлайн ответа» с цветовой подсветкой просроченных.
- Бэйдж AI-подбора - рекомендованные исполнители платформы.
- Создайте заявку из проекта или отдельно - укажите тип и описание.
- Прикрепите смету или BOM (спецификация материалов).
- Опубликуйте - система запустит AI-подбор и разошлёт релевантным исполнителям.
- Через дедлайн заявка автоматически закрывается; можно продлить вручную.
Предложения
Все отклики подрядчиков и поставщиков с их ценой, сроком и AI-скорингом. Можно открыть карточку исполнителя, посмотреть портфолио и отзывы.
- Сортируемая таблица: исполнитель, цена, срок, AI-балл, рейтинг.
- Маркеры верификации (организация подтверждена) и страховки.
- Inline-чат с исполнителем без перехода на страницу заказа.
- Кнопки «Принять» и «Отклонить» - принятие создаёт
Order.
Сметы
Сметы поддерживают версионирование, импорт из Excel/CSV и AI-генерацию ресурсной сметы по нормативам на основе описания задачи. Позиции сметы привязываются к этапам проекта.
- Список смет с версиями (v1, v2…) и статусами (DRAFT, APPROVED, SIGNED).
- Сумма по версии и сравнение с предыдущей.
- Кнопка «AI-генерация» - описание работы → автогенерация позиций ресурсной сметы по нормативам.
- Экспорт в Excel/PDF и электронная подпись (ЭЦП).
Материалы
Спецификация материалов (BOM) проекта: позиции из каталога, фактический поставщик и статус поставки. Поддерживается экспорт в CSV для бухгалтерии.
- Таблица: артикул, наименование, количество, цена, поставщик, статус доставки.
- Сводка: заказано / в пути / получено / возвращено.
- Кнопки «Заказать на платформе» и «Добавить из каталога».
- Экспорт BOM в CSV -
GET /api/orders/{id}/bom.csv.
Этапы
Этапы - это вехи проекта с привязкой к смете, исполнителю и сумме оплаты. Поддерживается workflow: PLANNED → IN_PROGRESS → SUBMITTED → ACCEPTED либо REJECTED.
- Список этапов с прогрессом и текущим статусом.
- Привязка к исполнителю, сумме этапа и дате дедлайна.
- Inline-кнопки: «Принять», «Вернуть на доработку», «Открыть спор».
- История изменений статуса с timestamps.
- Подрядчик начинает этап - статус IN_PROGRESS.
- По готовности - «Сдать на приёмку» (SUBMITTED).
- Заказчик в течение N дней принимает или возвращает.
- После приёмки этап переходит в «Ожидает оплаты»; заказчик платит по договору и отмечает оплату.
Оплата по этапам
Заказчик и подрядчик рассчитываются напрямую по договору. Платформа не хранит деньги и не берёт процент с заказов: в системе фиксируется статус оплаты каждого этапа (ожидает оплаты / оплачен), прикладывается акт и хранится история отметок.
- Сводка по этапам: ожидает оплаты / оплачено / в споре.
- История отметок оплаты с датой, суммой и автором.
- Привязка каждой отметки к этапу и акту.
- Кнопка «Отметить оплату» - после перевода по договору заказчик подтверждает оплату, подрядчик видит статус.
Акты
Платформа автоматически формирует акт выполненных работ и справку о стоимости работ по приёмке этапа. Поддерживается электронная подпись (ЭЦП); юридическая сила подписи зависит от сертификата.
- Таблица актов с типом (акт выполненных работ, справка о стоимости), суммой, статусом подписи.
- Подсветка просроченных - больше 5 рабочих дней без подписи.
- Скачивание PDF:
GET /api/pdf/act-ks2/{stageId}. - Кнопка «Подписать» - вызов окна электронной подписи (ЭЦП).
Технадзор
Внешний инспектор технадзора подключается к проекту, аудирует этапы, ведёт замечания и подписывает скрытые работы. Опционально; для B2G-проектов рекомендуется.
- Назначенный инспектор с рейтингом и квалификацией.
- Журнал инспекций: дата, этап, вердикт, фото-доказательства.
- Замечания и срок устранения, повторная инспекция.
- Кнопка «Пригласить технадзор» - выбор из каталога инспекторов.
Споры
Если этап возвращается несколько раз или у сторон есть претензии по оплате, открывается спор. Модератор платформы изучает историю, документы и переписку и даёт заключение в 3 рабочих дня. Платформа деньги не удерживает: расчёты по итогам спора стороны проводят напрямую.
- Список споров с типом (брак, срыв срока, оплата), суммой и статусом.
- Доказательства: фото, переписка, акт инспекции технадзора.
- Чат с участниками и модератором.
- Заключение модератора: в пользу заказчика / в пользу подрядчика / частично.
Фотоотчёты
Все фото и видео объекта с геометкой, timestamp и привязкой к этапу. Хранятся на серверах платформы, доступны для скачивания и приложения к актам.
- Галерея с фильтрами по этапу и дате.
- EXIF: геометка, время, устройство - подтверждают аутентичность.
- Сравнение «было/стало» по соседним съёмкам.
- Загрузка с телефона через браузер; мобильные приложения в планах.
Подрядчик
Кабинет подрядчика - рабочая лента откликов на тендеры, управление бригадами, этапами и финансами. Подписка Lite или Pro открывает расширенные лимиты откликов и AI-рекомендации.
Дашборд
Сводка по активным заказам, выставленные ставки на тендеры, ожидание ответа заказчика и статус оплаты этапов по сделкам.
- Карточки активных заказов с текущим этапом и статусом оплаты.
- Лента новых тендеров, отфильтрованных AI под профиль подрядчика.
- Ставки в работе: отправлены, просмотрены, отклонены.
- Виджет рейтинга по 7 факторам: качество, сроки, цена, коммуникация, безопасность, документы, проактивность.
Проекты
Все выигранные тендеры, ставшие проектами. Каждый - со сметой, этапами и статусом оплаты.
- Список заказов с заказчиком, бюджетом и % выполнения.
- Ближайший дедлайн и ответственный прораб.
- Бэйдж «Технадзор активен» - если объект под аудитом.
Бригады
Список бригад с составом, квалификацией и доступностью. Можно назначать бригады на конкретные этапы и видеть их загрузку в календаре.
- Карточки бригад: бригадир, состав, специализация, рейтинг.
- Календарь загрузки - кто свободен на нужные даты.
- Документы рабочих: паспорт, ИНН, допуски и удостоверения.
- Кнопка «Назначить на этап» - привязка к конкретной вехе.
Этапы
Этапы по всем активным заказам. Здесь подрядчик переводит этап в работу, прикрепляет фотоотчёт, сдаёт на приёмку.
- Все этапы со статусами и привязкой к заказу.
- Кнопка «Начать» - статус IN_PROGRESS, старт таймлайна.
- Кнопка «Сдать на приёмку» - статус SUBMITTED, заказчику уходит уведомление.
- Прикрепление фото и комментариев перед сдачей.
Финансы
Финансовая лента подрядчика: этапы к оплате и оплаченные по договорам, бонусы 3% от поставщиков. Можно выгрузить отчёт в CSV для бухгалтерии.
- Сводка: ожидает оплаты / оплачено / в споре.
- История отметок оплаты и бонусов по этапам.
- Бонусный кошелёк - накопленные 3% от поставщиков-партнёров.
- Реквизиты организации - подставляются в договоры и акты.
Поставщик
Кабинет поставщика - управление каталогом, заказами и остатками. Платформа автоматически отдаёт ваш прайс в матчинг заявкам и формирует BOM для подрядчиков.
Дашборд
Сводка по продажам, активным заказам, новым заявкам в тендерах. Виджет популярности позиций и сравнение с прошлым месяцем.
- KPI: выручка за месяц, средний чек, конверсия из заявки в заказ.
- Топ-позиций по продажам и низкий остаток.
- Лента новых тендеров на материалы.
- Бонусная программа: 3% подрядчикам-партнёрам.
Товары
Каталог товаров поставщика с ценами, остатками и фотографиями. Поддерживается импорт прайса из CSV/XLSX и сопоставление с глобальным каталогом BuildCore.
- Таблица: артикул, наименование, категория, цена, остаток, статус.
- Кнопки «+ Добавить товар» и «Импорт прайса».
- Фильтры: категория, статус модерации, наличие.
- Массовое редактирование цен и наценки.
- Импорт прайса:
POST /api/catalog/products/import- CSV или XLSX. - Платформа сама сопоставляет позиции с эталонным каталогом.
- Несопоставленные позиции - на ручную модерацию.
Заказы
Все заказы, оформленные через платформу, со статусом доставки и привязкой к проекту заказчика.
- Список заказов с покупателем, суммой, датой доставки и статусом.
- Статусы: NEW, CONFIRMED, PACKING, SHIPPED, DELIVERED, RETURNED.
- Кнопка «Подтвердить» переводит в логистическую очередь.
- Трекинг доставки с геометкой и фото отгрузки.
Остатки
Учёт остатков по складам и регионам. Платформа учитывает остаток при матчинге заявкам - не показывает товар, которого нет в наличии.
- Таблица остатков по складам и SKU.
- Прогноз исчерпания при текущем темпе продаж.
- Подсветка позиций ниже неснижаемого остатка.
- Импорт остатков из 1С через webhook или CSV.
Исполнитель услуг
Отдельная роль для узких специалистов: электрики, сантехники, кровельщики, дизайнеры интерьеров, геодезисты. Расширенные возможности - по подписке Lite ($14.99/мес) или Pro ($29.99/мес) с AI-подбором заявок и расширенным портфолио.
Регистрация
Многошаговая регистрация с указанием специализации, географии работы, ставки и портфолио. Поддерживаются как физлица-самозанятые, так и юрлица.
- Тип организации: ИП / ООО / самозанятый.
- До 5 специализаций (электрика, сантехника, демонтаж и т. д.).
- География работы: регионы и максимальное расстояние выезда.
- Документы: ИНН, фото лицензий, фото-портфолио.
- Тариф подписки выбирается на последнем шаге.
Дашборд
Стартовая страница исполнителя услуг: новые заявки от AI-подбора, активные заказы, история откликов и баланс подписки.
- Лента рекомендованных заявок - точечный AI-подбор под специализацию.
- Карточки активных заказов и счётчик дней до окончания подписки.
- Статистика откликов: отправлено, просмотрено, принято.
- Кнопка «+ Откликнуться» - открывает модальное окно с активными тендерами.
Карточка
Публичная карточка исполнителя со всей информацией: специализации, рейтинг, портфолио, отзывы, цены, география работы. По этой карточке заказчик принимает решение.
- Шапка: название, фото, бэйджи (верифицирован, Pro, страховка).
- Метрики: средняя оценка, количество завершённых заказов, % приёмки с первого раза.
- Список специализаций с прайсом «от X».
- Портфолио с фото и видео завершённых работ.
- Отзывы заказчиков с разбивкой по 7 факторам.
Подписка
Подписка Lite ($14.99/мес или $89.99/год) и Pro ($29.99/мес или $179.99/год) включают: расширенные лимиты откликов на тендеры, AI-подбор заявок, расширенное портфолио, бэйдж в каталоге, приоритет в результатах поиска. Онлайн-оплата подписки подключается.
- Текущий статус подписки и дата окончания.
- Сравнение Lite и Pro: лимиты на отклики и доступ к функциям.
- История платежей и скачивание счетов.
- Кнопки «Продлить» и «Отменить автопродление».
Портфолио
Галерея завершённых работ с категориями и описанием. Каждый проект может содержать до 20 фото и 1 видео. Заполненное портфолио повышает AI-скор и конверсию из карточки в заказ.
- Сетка проектов с обложкой, заголовком и тегами.
- Карточка проекта: фото «до/после», описание, бюджет, отзыв.
- Кнопка «+ Добавить проект» с шаблонами категорий.
- Возможность скрыть проект (статус DRAFT) без удаления.
Технадзор
Технадзор - независимый инспектор, подключаемый к проекту для аудита этапов и сдаточных работ. Платформа предоставляет шаблоны актов, чек-листы и место для подписи скрытых работ.
Дашборд
Список активных назначений на проектах с ближайшими инспекциями и невыполненными замечаниями.
- Карточки активных проектов с краткой сводкой по этапам.
- Очередь предстоящих инспекций с датой и адресом.
- Незакрытые замечания со сроком устранения.
- Календарь выездов на 2 недели вперёд.
Этапы на аудите
Все этапы, попавшие на проверку технадзору. Для каждого - чек-лист, фото-доказательства и вердикт.
- Этапы с привязкой к проекту, подрядчику и сумме.
- Чек-лист проверки: соответствие нормативам, материалы, скрытые работы.
- Фото с геометкой и комментарии.
- Вердикт: «Одобрено», «На доработку», «Критические замечания».
- Подрядчик сдаёт этап → технадзор получает уведомление.
- Выезд на объект, фото с чек-листом, вердикт.
- При одобрении этап автоматически идёт на приёмку заказчику.
- При критических замечаниях возможен спор; этап не переходит к оплате до его решения.
Администратор
Админка платформы для модераторов, финансистов и супер-админов. Здесь верифицируют организации, разбирают споры, ведут подписки и проверяют документы SP.
Дашборд
Общая сводка по платформе: новые регистрации, активные споры, активные подписки, очередь модерации.
- KPI: DAU, MAU, активные проекты, подписки Lite и Pro.
- Очередь модерации с цветовой подсветкой просроченных.
- Лента критичных событий: крупные споры, fraud-сигналы.
- Быстрый доступ к разделам: пользователи, организации, финансы.
Модерация
Очередь модерации новых организаций, отзывов и сомнительного контента. Каждый объект - с историей действий и кнопкой «Одобрить / Отклонить / Запросить уточнение».
- Список объектов с типом (организация, отзыв, фото, документ).
- Фильтры по типу, дате, приоритету.
- Карточка объекта с историей и прикреплёнными файлами.
- Кнопки одобрения / отклонения с указанием причины.
Споры
Очередь активных споров со статусом «на рассмотрении». Модератор даёт заключение в течение 3 рабочих дней; деньги платформа не удерживает.
- Список споров с типом, суммой, сроками SLA.
- Карточка спора со всеми доказательствами и чатом.
- Кнопки заключения: в пользу заказчика / в пользу подрядчика / частично / эскалация.
- Журнал решений модератора для аудита.
Финансы
Финансовая консоль: подписки Lite и Pro, поступления по ним, отчёты для бухгалтерии. Расчёты по заказам через платформу не проходят, процент с заказов не удерживается.
- Выручка по подпискам с детализацией по тарифам и валютам.
- Лента платежей за подписку с фильтрами.
- Сверка с банком - выгрузка для бухгалтерии.
- Подписки Lite и Pro: активные, продлённые, отменённые.
Документы SP
Очередь документов исполнителей услуг: лицензии, выписки, страховки, аттестации. Без одобрения SP не может публиковать карточку.
- Список документов с типом, исполнителем, датой загрузки.
- Превью PDF/изображения в боковой панели.
- Фильтр по статусу: на проверке, одобрено, отклонено.
- Кнопки «Одобрить» и «Отклонить» с указанием причины.
Сценарии работы
Три типовых сквозных сценария показывают, как роли взаимодействуют между собой и где фиксируется оплата по этапам.
Сценарий 1. От проекта к выбору подрядчика
- Заказчик создаёт проект (адрес, бюджет, тип) - статус DRAFT.
- Загружает или AI-генерирует ресурсную смету по нормативам.
- Публикует заявку (тендер) с прикреплённой сметой - статус PUBLISHED → RECEIVING_PROPOSALS.
- Платформа запускает AI-подбор и шлёт уведомления релевантным подрядчикам.
- Подрядчики отправляют предложения: цена, срок, состав работ.
- Заказчик сравнивает по AI-скору, рейтингу, отзывам.
- «Принять» - создаётся
Order, генерируется договор подряда. - Подписание договора (ЭЦП или на бумаге) - заказ переходит в IN_PROGRESS.
Сценарий 2. Этап → акт → оплата
- Сумма этапа зафиксирована в договоре и смете.
- Подрядчик «Начать этап» → IN_PROGRESS, привязывает бригаду, фото-старт.
- В процессе - еженедельный фотоотчёт с геометкой, загрузка с телефона через браузер.
- По готовности - «Сдать на приёмку» → SUBMITTED, заказчику уведомление.
- Если технадзор активен - сначала аудит инспектора с чек-листом.
- Заказчик принимает → ACCEPTED, этап переходит в статус «Ожидает оплаты».
- Генерируется акт выполненных работ; подписывается обеими сторонами (ЭЦП).
- Заказчик оплачивает по договору и отмечает этап как оплаченный; по завершению заказа формируется справка о стоимости работ.
Сценарий 3. Спор → разбор → решение
- Заказчик возвращает этап на доработку второй раз подряд.
- Подрядчик не согласен - нажимает «Открыть спор», этап переходит в статус «В споре».
- Платформенный модератор получает уведомление с SLA 3 рабочих дня.
- Модератор изучает чат, фото, акт технадзора, переписку.
- Заключение: в пользу заказчика / в пользу подрядчика / частично (например, 70/30).
- Стороны получают электронное заключение и проводят расчёты по нему напрямую; платформа деньги не удерживает.
- Решение можно оспорить один раз - эскалация на супер-админа.
API и интеграции
BuildCore предоставляет REST API с OpenAPI 3.0 спецификацией для интеграции с ERP, 1С, CRM-системами и мобильными приложениями. Аутентификация - по сессионной cookie, для машин - ключи API на уровне организации.
OpenAPI / Swagger
- UI:
/api-docs- интерактивный Swagger с примерами запросов. - Schema:
/openapi.yaml- сырая спецификация для генератора клиентов. - Серверы: production, staging, local - переключаются в Swagger UI.
- Группы эндпоинтов: auth, users, catalog, projects, requests, proposals, orders, payments, stages, disputes, reviews, files, chat, ai, subscriptions, bonuses, technadzor, documents, webhooks.
SSE - чаты и события
Для real-time коммуникации используется Server-Sent Events. Один стрим на чат, переподключение автоматическое, поддержка last-event-id для гарантии доставки.
GET /api/sse/chat/{chatId}- стрим сообщений конкретного чата.GET /api/chats- список чатов пользователя.POST /api/chats/{id}/messages- отправка сообщения.- Headers:
Accept: text/event-stream,Last-Event-ID.
Webhook платежей и курсов
Платёжный провайдер подписки шлёт webhook на эндпоинт платформы с HMAC-подписью в заголовке X-Signature (онлайн-оплата подписки подключается). Аналогично - источник курсов валют.
POST /api/webhooks/payment- подтверждение платежа за подписку или возврата.POST /api/webhooks/exchange-rate- обновление курсов валют (UZS/USD/EUR).- Проверка: HMAC-SHA256 от тела запроса с секретом организации.
- Идемпотентность:
X-Idempotency-Key- защита от двойной обработки.
Загрузка файлов
Все файлы платформы (документы, фотоотчёты, портфолио, аватары) загружаются через единый эндпоинт. Файлы отдаются по подписанным ссылкам с ограниченным сроком действия.
POST /api/upload- multipart/form-data с полемfile.- Максимум 50 МБ на файл, 10 файлов за запрос.
- Поддерживаются: PDF, JPG, PNG, WEBP, MP4, MOV, XLSX, CSV.
- Ответ:
{ id, url, mimeType, size }- id используется в дальнейших ссылках. - Изображения автоматически проходят оптимизацию (resize, webp-конвертация).
Генерация PDF-документов
GET /api/pdf/act-ks2/{stageId}- акт выполненных работ.GET /api/pdf/act-ks3/{orderId}- справка о стоимости работ.GET /api/pdf/contract/{orderId}- договор подряда.GET /api/pdf/invoice/{paymentId}- счёт-фактура.POST /api/documents/sign- подпись документа (ЭЦП).