Scopewell: путь сделки — от создания клиента до подписания

• Продавец заводит проект: адрес объекта (автоподстановка Google Maps), имя, телефон и email клиента.
• Адрес определяет ценовую зону — районный множитель, который потом умножит всю смету.
• У проекта есть владелец («Rep») — его имя попадёт в документы. Рядовой продавец видит только свои проекты, менеджер и выше — все.
• Опционально проект связывается с CompanyCam — оттуда позже подтянутся фото с объекта.

• Внутри проекта создаётся Proposal — будущий документ для клиента. Тип: контракт или Change Order (допсоглашение к уже подписанному контракту).
• Система сразу создаёт Вариант 1 и стандартный набор секций документа — продавец начинает не с пустого листа.
• Пока статус Draft — всё редактируется свободно.

• До четырёх вариантов («Хорошо / Лучше / Лучший»…) — каждый со своим составом работ и своими наценками.
• Позиции добавляются из прайс-листа компании: материал + работа × количество × (1 + отходы). Итог варианта умножается на районный множитель и наценки (накладные, прибыль).
• К каждому варианту — скидки из библиотеки (фикс или процент, с потолками).
• Планы финансирования дадут клиенту расчёт ежемесячного платежа в портале.

• Документ собирается из секций: обложка, объём работ, фотоотчёт, график платежей, условия, гарантия, страница подписи, произвольные страницы. Секции можно переименовывать, скрывать, переставлять.
• Фотоотчёт: фото объекта из CompanyCam, кадрирование, разметка стрелками и подписями.
• Продавец смотрит PDF-превью (внутренний режим — со всеми вариантами) перед отправкой.

• Диалог отправки: имя и email клиента (подставляются из проекта), опционально — второй подписант (co-signer).
• Клиенту уходит письмо с PDF-вложением и кнопкой в портал. Второй подписант получает отдельное письмо со своей ссылкой, которая позволяет только его собственную подпись.
• Продавец автоматически получает скрытую копию письма (BCC).
• У ссылки есть срок действия — после истечения клиент видит экран «истекло».
• До нажатия «Отправить» проверить Post-секции: график платежей (дефолт 50/50 почти всегда надо менять) и текст гарантии (особенно при кастомных условиях) — подробный чек-лист на вкладке «Фазы секций».

• Клиент открывает портал — визард из 4 шагов: Обзор → Варианты → Детали → Подпись. Шаги «Детали» и «Подпись» закрыты, пока вариант не выбран.
• Шаг «Обзор»: фото дома, объём работ. Шаг «Варианты»: карточки цен с ежемесячным платежом по финансированию. Если вариант один — шаг превращается в «Принятие» с кнопкой «Принять и продолжить» (осознанный клик, без авто-пропуска).
• Выбор варианта переводит сделку в Accepted — и клиенту сразу автоматически высылается письмо «контракт готов к подписанию» с финальным PDF только по выбранному варианту; продавец получает скрытую копию (BCC).
• Каждое действие пишется в журнал: открыл, выбрал, подписал, скачал PDF. Продавец видит эту ленту и стадию сделки прямо в редакторе.

• Клиент рисует подпись прямо в портале (сенсорная панель подписи, удобно с телефона).
• Если есть второй подписант — он подписывает по своей ссылке; чужую роль подписать нельзя.
• Когда собраны все нужные подписи — статус Signed, обеим сторонам уходит письмо с подписанным контрактом.

• Отзыв (Revoke): ссылки клиента мгновенно гаснут, предложение возвращается в редактируемое состояние. Используется, чтобы поправить смету и отправить заново.
• Повторная отправка (Resend): старые ссылки заменяются новыми, письмо уходит снова. До выбора варианта — письмо-предложение, после — письмо «контракт готов».
• Change Order: если объём работ изменился после подписания — создаётся дочернее предложение к контракту, и весь цикл (блоки 2–7) повторяется для него.

Ловушка фазовой модели: Post-секции клиент увидит только после выбора варианта, но заполнить их нужно до отправки — после Send предложение блокируется для редактирования целиком (чтобы править — придётся отзывать ссылку через Revoke). Значит, ещё в Draft, до нажатия «Отправить»:

• График платежей — по умолчанию система ставит «50% при подписании / 50% по завершении». Для реальной сделки этапы почти всегда другие — настроить под проект сразу, а не «потом».
• Гарантия — автоподставляется стандартный текст (2 года на работы + гарантия производителя на материалы). Обязательно перечитать, особенно если по сделке обещаны кастомные гарантийные условия — дефолтный текст о них ничего не знает.
• Условия (Terms) и Право на отказ — тоже готовые шаблоны; проверить, что они подходят конкретному контракту.
• Произвольные Post-страницы — если нужны особые приложения к контракту, добавить их до отправки.

• Sent (вариант не выбран) — видна только Pre-фаза: обложка, объём работ, фото, смета. Шаги «Детали» и «Подпись» заперты. Юридика скрыта — клиенту сначала продают.
• Accepted / частично подписано / Signed — открываются обе фазы: добавляются платежи, условия, гарантия, отказ, подпись. Клиент при заходе попадает сразу на шаг «Подпись».
• Revoked / Rejected — не видно ничего, терминальный экран.

• preview — вложение в первое письмо (Sent): только Pre-секции, все варианты цен.
• contract — письмо «контракт готов» и финальный контракт: Post-секции + Объём работ и Смета (их «двойная жизнь»), сужено до выбранного варианта.
• full — внутренний режим продавца: обе фазы целиком.

• Проблема: всё крутится вокруг «проекта»: при создании — поле Project Title, кнопка «+ New Project», в главном списке проект первым. А философия продукта строится вокруг клиента.
• Что меняем: проект создаётся от клиента; поле Project Title при создании убираем, кнопку «+ New Project» убираем; в главном виде местами меняются имя клиента (первым) и название проекта. Proposal остаётся главной рабочей единицей дальше.
• Из ревью: F-02 (дубли клиентов — нужна модель client → projects и проверка уникальности), F-03 (нейминг проект/proposal), Q-02.

• Проблема: текст гарантии — общий шаблон; реп должен вручную вспоминать про него и править до отправки, особенно при кастомных гарантийных условиях.
• Что меняем: документы о гарантии прикрепляются к материалам (позициям прайс-листа); когда материал попадает в смету, его гарантия автоматически включается в Post-accept пакет. Для начала — просто текстом.
• Из ревью: развитие пункта «просмотреть warranty до Send» — вместо ручной проверки гарантия собирается сама из состава сметы.

• Проблема: клиент не может просто посмотреть и одобрить квоту — выбор опции сразу тянет его к подписи. Если что-то не понравилось, он свяжется с репом, захочет поменять — а квота уже заблокирована; правки только через аварийный Revoke.
• Что меняем: разводим состояния «view» и «sign-интент»; новое состояние Approved: клиент смотрит → апрувит ИЛИ запрашивает изменения → реп правит квоту и отправляет заново — штатный цикл правок (пунктирная петля на схеме).
• Из ревью: F-22b (P0), часть F-19.

• Проблема: письмо «Your contract ready to sign» уходит сразу после того, как клиент выбрал опцию для просмотра. Клиент ещё ничего не решил, а система уже давит подписью — и другого способа посмотреть опцию у него нет.
• Что меняем: триггер письма — явный accept/аппрув квоты, а не просмотр опции.
• Из ревью: F-19 (P0), связано с F-22b.

• Проблема: до Send реп обязан сделать график платежей, вычитать гарантию и т.д. — большая работа до того, как клиент вообще что-то одобрил. (Заменяет прежний черновик «чек-лист перед Send»: вместо предупреждений убираем саму обязанность.)
• Что меняем: до Send реп собирает только варианты сметы; после аппрува клиента дособирает пакет (график платежей) — и клиенту уходит дополнение + чистый контракт на подпись.
• Из ревью: F-07 — обязательные страницы (terms, 3-day right, authorization) включены всегда и невыключаемы, опциональные (брошюры и т.п.) — выключены по дефолту.

• Проблема: если реп не включил Post-acceptance страницы, клиент может подписать контракт без обязательных доков (terms, warranty, 3-day right, authorization) — юридический риск.
• Что меняем: признак «обязательная страница»; подпись недоступна, пока обязательные страницы не включены; валидация на Preview & Send.
• Из ревью: F-22 (P0).

• Проблема: после подписи quote не переходит в Signed — сейлзы и менеджмент не видят реальное состояние сделки.
• Что меняем: статусная машина проекта Sent → Selected → Signed; проверить триггер на событии подписи.
• Из ревью: F-21 (P0).

• Проблема: на клиентской странице Details → «Show what's included» видна чистая цена без маржи; breakdown Overhead 15% / Profit 20% рендерится прямо в превью опции.
• Что меняем: аудит всех клиентских вьюшек (портал, PDF, email) на утечку internal-полей (line items cost, overhead, profit, margin). Клиент видит только финальную цену опции.
• Из ревью: F-17 (P0).