Швидкий старт брокера

Покроково: реєстрація, тріал, тенант, імпорт клієнтів, розширення, маржа на лоті, угода з лота, Track для клієнта, підписка.

Цей сценарій проходить брокер від першого знайомства до першої угоди. Кожен крок має фактичний стан у поточній збірці: де функція ще в роботі, сказано прямо і наведено, що робити зараз.

Огляд кроків і їхній стан

#	Крок	Стан
1	Реєстрація на сайті ImportOS і тріал 14 днів	У розробці форма на сайті лише збирає заявку
2	Створення тенанта (вашої компанії)	У розробці сервіс готовий, екрана реєстрації ще немає
3	Вхід у Desk за посиланням з листа	Працює
4	Імпорт клієнтів із CSV	У розробці сервіс готовий, екрана «Контакти» ще немає
5	Встановлення розширення Margin	Працює з теки збірки; магазин: Чекає на власника
6	Маржа на лоті Copart/IAAI	Працює
7	Угода з лота	У розробці кнопка «Додати в Desk» ще неактивна
8	Клієнт відкриває Track	Працює
9	Підписка після тріалу (Stripe)	У розробці

Сайт ImportOS має сторінку /signup. Зараз це форма «повідомити мене»: вона нічого не зберігає і чесно про це каже. Самообслуговна реєстрація (Google або пошта, назва компанії, країна, скільки авто на місяць) і тріал 14 днів без картки ще в розробці.

У розробці: самообслуговна реєстрація і білінг

Що буде: реєстрація через Google або пошту, анкета (назва компанії, країна, авто на місяць), створення тенанта з демо-даними, чекліст перших кроків, листи на 1-й, 3-й, 7-й і 12-й день тріалу, оплата через Stripe Checkout і Customer Portal для зміни плану. Тріал — 14 днів, ліміти м'які (попередження, без блокування даних).

Що робити зараз: попросіть оператора платформи створити тенант. Нижче крок 2.

Створення тенанта

Тенант — це ваша компанія в ImportOS: свої клієнти, угоди, бренд і ключі. Дані різних тенантів ізольовані на рівні бази.

Сервіс створення тенанта вже є (createTenantWithOwner): назва, країна, мова, валюта, демо-дані з позначкою «Демо» (їх можна видалити одним викликом), чекліст першого запуску з шести кроків: логотип, імпорт клієнтів, розширення, Telegram, перша угода, запрошення команди. Екрана реєстрації над ним поки немає, тому тенант створюється з боку платформи.

Вхід у Desk

Паролів у Desk немає, лише одноразові посилання.

Відкрийте адресу Desk і введіть робочу пошту, на яку створено обліковий запис власника.
Натисніть «Надіслати посилання». Лист із посиланням приходить на пошту, посилання діє 15 хвилин.
Перейдіть за посиланням. Якщо ваша пошта належить кільком компаніям, Desk покаже екран вибору компанії, потім перемикач у боковому меню.

Вхід через Google і Telegram з'являється лише тоді, коли на сервері налаштовано ключі. Інакше кнопки сховані з поясненням. Реєстрації нових користувачів у самому Desk немає: заходять лише наявні. Клієнти брокера в Desk не потрапляють, їм потрібен особистий кабінет.

Екран «Сьогодні» в Desk · Скріншот-заглушка: замінюється реальним знімком

Докладно про розділи: Desk.

Імпорт клієнтів із CSV

Працює Маршрут у Desk: /contacts

Сервіс імпорту готовий. Він приймає до 5000 рядків за раз і працює у три етапи:

Мапінг колонок. Для кожної колонки вашого файлу ви обираєте поле контакту або ignore.
Перегляд до запису. Для кожного рядка видно, що станеться: створити, оновити, пропустити або помилка, плюс підсумок і список колонок без мапінгу.
Запис. Помилка в одному рядку не скасовує інші.

Поля, які можна зіставити: fullName, firstName, lastName, phone, phone2, email, email2, telegram, viber, tags, notes, type, source, locale, consentMarketing, ownerEmail, utm_source, utm_medium, utm_campaign.

Дублі шукаються за телефоном, поштою, Telegram і Viber, тож повторний імпорт не плодить клієнтів. Режим дубля: update (оновити наявний контакт) або skip. На всі імпортовані контакти можна додати теги, наприклад імпорт-2026-10. Значення згоди на маркетинг розуміють такі слова: 1, true, yes, так, y, +.

Приклад файлу:

ПІБ,Телефон,Пошта,Тип,Теги
Іваненко Петро,+380671234567,petro@example.com,client,vip
Коваль Ірина,0501234567,,client,

Мапінг для цього файлу: ПІБ → fullName, Телефон → phone, Пошта → email, Тип → type, Теги → tags.

Встановлення розширення Margin

Розширення працює в Chrome і Edge. Магазинного лістингу поки немає (потрібен акаунт розробника), тому зараз його ставлять із теки збірки як розпаковане.

У Chrome відкрийте chrome://extensions, увімкніть «Режим розробника», натисніть «Завантажити розпаковане» й оберіть теку importos/apps/margin-extension/.output/chrome-mv3. В Edge: edge://extensions і тека .output/edge-mv3.
Після встановлення відкриється сторінка налаштувань. Без курсів валют панель нічого не рахує: задайте курси за 1 USD (EUR і UAH для України) з датою, свою комісію та місто доставки.

Повна інструкція: розширення Margin.

Маржа на лоті

Увійдіть на Copart або IAAI під своїм акаунтом і відкрийте сторінку лота.
Праворуч з'явиться панель Margin: собівартість «під ключ» для обраної країни та міста, розбивка статей з поясненням і формулою кожної.
Якщо розширення не знайшло на сторінці двигун, паливо чи ставку, введіть їх вручну. Без них розрахунку немає: розширення не рахує навмання.
Введіть очікувану ціну продажу. Панель покаже маржу, вердикт («добра», «прийнятна», «ризиковано», «збиток») і максимальну ставку для вашої цільової маржі.
У списках результатів на кожному лоті стоїть кольоровий бейдж маржі.

Панель Margin поруч із лотом · Скріншот-заглушка: замінюється реальним знімком

Селектори ще не звірені з живими сторінками

Розбір сторінок Copart і IAAI написано за пам'яттю про розмітку, живі сайти його ще не перевіряли. Якщо панель показує «сторінка змінилась», це очікувана реакція на розбіжність, а не збій. Як це виправляється, описано в розділі про звірку селекторів.

Угода з лота

У розробці: «Додати в Desk» і екран «Угоди»

Кнопки «Додати в Desk» і «Надіслати клієнту» в панелі розширення поки неактивні, а екран «Угоди» в Desk показує порожній стан. Сервіс угод готовий: створення, переходи стадій з перевіркою обов'язкових полів, автозадачі, сповіщення. Що буде: лот з розширення одним кліком стає автомобілем і пропозицією для запиту клієнта, а угода відкривається з канбана за стадіями.

Що робити зараз: завершіть розрахунок у розширенні й збережіть дані лота. Угоду створює оператор платформи через сервіс, поки екрани Desk доробляються.

Клієнт відкриває Track

Клієнт отримує посилання вигляду https://track.<ваш домен>/<токен> або заходить на https://track.<ваш домен>/ і вводить номер угоди та VIN. На сторінці він бачить поточну стадію, таймлайн із датами, маршрут, публічні фото, документи (якщо ви їх дозволили), наступну оплату й контакт менеджера. Усе це під вашим логотипом і кольорами. Сторінка оновлюється сама без перезавантаження.

Сторінка Track для клієнта брокера · Скріншот-заглушка: замінюється реальним знімком

Налаштування бренду й домену: Track.

Підписка після тріалу

У розробці: Stripe-підписка

Оплата підписки, Customer Portal і облік авто за місяць у білінгу ще не підключені. Тарифи й ліміти вже задано в конфігурації (див. таблицю в розділі Для брокерів), але остаточні ціни затверджує власник.

Що далі

Кожен екран Desk і його стан.
Стадії угоди: що відбувається автоматично на кожній.
Шаблони документів: як змінити договір чи інвойс у Word.

Швидкий старт брокера

Огляд кроків і їхній стан