Party-Wall Cockpit — Экран кейса (справочник)¶
Это основной справочник по экрану кейса — странице, которая открывается по клику на кейс (сверху его адрес, рядом ссылка-референс вроде PW-EZNMGSDP). Здесь живёт всё, что можно сделать с живым кейсом: прочитать его состояние, запустить стадию, ответить на approval, зафиксировать факт. Держите страницу открытой во время работы — тут перечислена каждая кнопка: что она делает, требует ли подтверждения, можно ли отменить. Если вам нужен пошаговый первый проход — начните с Быстрого старта.
Главная мысль, которая проходит через каждую кнопку на этой странице: Record ≠ serve (записать ≠ отправить/вручить). Почти любое действие здесь записывает факт, сохраняет черновик или ставит намерение в очередь — оно не отправляет ничего соседу, клиенту или в банк и — за единственным исключением (Record service, см. §6) — не запускает статутный час само по себе. Единственные действия, которые вызывают реальные внешние эффекты, — это запускалки Run stage, и они всегда сначала останавливаются на approval-гейте.
1. Что такое экран кейса¶
У экрана две колонки.
- Левая рабочая колонка (шире) — где вы делаете работу: чтение анализа чертежей, чек-лист текущей стадии и документы кейса.
- Правый рельс (уже) — где вы читаете состояние: Operator context, External interactions, Current limits, Automation, Statutory clocks, Parties & contacts, Fees & invoicing.
В самом верху — заголовок кейса (адрес, референс, building owner, чипы работ и статей, уровень сервиса, дата мандата) с SLA-бейджем и пилюлей статуса. Прямо под заголовком — stage track (метро-линия стадий) и панель Quick actions.
Экран живого кейса: сверху заголовок и stage track, ниже Quick actions, слева рабочая колонка, справа рельс только для чтения. (Интерфейс англоязычный.)
2. Роли и доступ¶
Ваша роль — Surveyor (Operator); в сайдбаре под вашим именем показана роль Surveyor. (Имя над ней — например Administrator на демо-аккаунте или Andy на вашем — это отображаемое имя аккаунта, а не роль. На этой консоли есть только одна операторская роль.)
| Что вы видите | Когда |
|---|---|
| Полную панель Quick actions и все диалоги | Вы вошли с правом записи (обычное состояние оператора) |
| Нет Quick actions и баннер "Read-only mode — write commands are disabled." | Сессия в режиме только для чтения |
| "No access to the Party-Wall project. Contact an administrator." | Ваш аккаунт не привязан к проекту Party-Wall |
Note
Режим только для чтения не прячет кейс — вы по-прежнему видите все панели, бейджи и документы. Он лишь убирает кнопки, которые что-то меняют. Если панели действий нет, а вы её ожидали, — сначала проверьте баннер read-only, затем перезайдите.
Каждая отдельная кнопка также сереет, пока выполняется команда (предыдущий клик ещё обрабатывается). Это нормально — подождите секунду, и она снова станет активной. Если остаётся серой — см. Траблшутинг.
3. Где это в Cockpit¶
Каждая панель экрана, что она показывает и какие значения бывают:
| Панель | Показывает | Возможные значения |
|---|---|---|
| Case header | Адрес, референс / case id, building owner, чип работ, чип статей, planning ref, уровень сервиса, дата мандата, плюс SLA-бейдж и пилюля статуса | SLA: SLA healthy / SLA at risk / SLA breach. Статус: Prospect / Live / Closed / On-Hold / Abandoned / Referred. Уровень сервиса: Notices only / BO surveyor / Agreed surveyor / Hourly rate |
| Stage track | Метро-линию стадий плюс боковую полосу на каждого adjoining owner (его состояние, маршрут, чейзеры, вручено ли) | Стадии Lead … Referred; состояния AO; Route A–D |
| Quick actions | Контекстные кнопки (только с правом записи) | Зависят от стадии, статуса, сторон и наличия анализа чертежей |
| Requires your approval | Approval-гейты, ждущие вашего решения (см. §6, группа F) | Pending / Awaiting context / Approved / Rejected; типы: Qualification, Route confirmation, Serve, Notice section, BO approval, Quote send, Award service, Client-invoice send, Closing communication |
| Drawing analysis | Чтение системой чертежей: рекомендация, уверенность %, порог %, обоснование, доказательства, правила | Уверенность 0–100; порог по умолчанию 70% |
| Stage checklist | Чек-лист текущей стадии; блокеры красным "— blocks progression" | Сделано ✓ / открыто ◻; пусто = "Nothing blocking…" |
| Documents | Документы кейса (тип · версия), у каждого Open / Download, плюс статус approval и issue | Типы: Notice s1/s2/s3, s6, Award, Invoice…; approval Draft / Pending review / Approved / Rejected / Superseded; issue Not issued / Issued / Withdrawn |
| Operator context | Панель «объясни текущее состояние», восемь подгрупп (ниже) | Workflows & waits / AI decisions / Prompts / Approval decisions / Delivery / Escalations / Payment / Change assessments |
| External interactions | Всё, что касается внешнего мира, сгруппировано по стадии | Prepared / Awaiting authorisation / Authorised / Executed or recorded (до четырёх в каждой) |
| Current limits | Пять честных утверждений о том, чего система пока не делает | См. §9 |
| Automation | Живые воркфлоу этого кейса с контролами | Бейдж Failed / Paused / running; Pause против Retry / Investigate / Skip / Continue manually |
| Statutory clocks | Статутные сроки, идущие по кейсу | Типы: AO response / Appointment on behalf / Section works / s8 access / Award appeal или validity / Quote validity; Running / Met / Expired / Superseded; ≤7 дней красным |
| Parties & contacts | Building owner и adjoining owners: имя, email (клик — письмо), телефон, адрес | Две группы |
| Fees & invoicing | Гонорар (без НДС) плюс инвойсы (тип, срок, сумма, статус) | Client / Self-bill; Draft / Payable / Paid |
| Correspondence / Timeline / Notes вкладки | Лента событий, журнал переписки и Notes | Notes — заглушка, "available after INC-5" |
| Run stage (кнопка в заголовке) | Открывает выбор воркфлоу для этого кейса (различие — в §6) | Только с правом записи |
Parties & contacts: building owner и каждый adjoining owner. Адреса email — это ссылки для письма; Cockpit отсюда ничего не отправляет.
Fees & invoicing: согласованный гонорар и инвойсы с их статусом. Запись инвойса здесь — только запись, реальный инвойс в Xero не выставляется.
External interactions: честное состояние всего, что касается внешнего мира, от Prepared до Executed or recorded.
Operator context — что говорит каждая подгруппа¶
Панель Operator context существует, чтобы система объясняла себя (инвариант 9 Vision — прозрачность). Две подгруппы, которые вы читаете чаще всего:
- Escalations. Когда система помечает что-то для человека, она называет причину. Возможны: Document opened but not signed · Planning objection raised · Adjoining owner's surveyor involved · Defective notice received · WeTransfer link received · Scope change · Missing required merge fields · Bundled works. Предлагаемое действие — либо Review escalation, либо No action.
- Delivery. Когда стадийный воркфлоу действительно сделал внешнее действие, оно логируется здесь с меткой и статусом: Email sent · Drive file copied · Drive file uploaded · BoldSign signing link created …, каждое completed (зелёный) или failed (красный). failed-доставка — сигнал открыть Траблшутинг.
4. Ментальная модель — как связаны стадия, статус, маршрут и часы¶
На этом экране движутся четыре разные вещи, и полезно держать их раздельно:
STAGE (где весь кейс в процессе)
Lead → Quote → Case live → Determination → Service → Routing → SoC → Award → Works → Invoice → Closed → Referred
│
└── ROUTE (на каждого adjoining owner, в его боковой полосе)
A = согласие
B = несогласие, один agreed surveyor
C = несогласие, у каждого свой surveyor
D = deemed dissent / appoint on behalf
STATUS (состояние жизненного цикла кейса в целом) ── P / L / C / X / H / R (таблица ниже)
CLOCKS (статутные сроки, которые запускает реальное вручение) ── ответ AO, работы по статье, окна апелляции …
- Стадия (Stage) — как далеко кейс продвинулся по процессу — метро-линия.
- Маршрут (Route A–D) — на каждого adjoining owner: один сосед может согласиться (Route A), а другой — не согласиться (Route C). Маршруты живут в боковых полосах AO на stage track.
- Статус (Status) — состояние жизненного цикла кейса в целом.
- Статутные часы (Statutory clocks) — юридические дедлайны. Они запускаются от реального вручения — либо когда вы одобряете стадию serve, либо в момент, когда вы используете Record service, чтобы зафиксировать вручение, состоявшееся вне системы.
Статусы кейса:
| Значение | Метка | Смысл |
|---|---|---|
| P | Prospect | Заявка, ещё не живой кейс |
| L | Live | Активный (учитывается в active cases) |
| C | Closed | Терминальный, закрыт — нельзя отменить отсюда |
| X | Abandoned | Терминальный, брошен |
| H | On-Hold | Пауза |
| R | Referred | Выведен, лежит в реестре Referred |
SLA-бейджи (из статутных часов): SLA healthy (зелёный), SLA at risk (амбер, ≤7 дней), SLA breach (красный, истёк или просрочен). Приоритет: breach > at-risk > healthy.
Бейджи боковой полосы AO: Route {A|B|C|D} (основной), Predicted {route} (приглушённый — догадка системы до подтверждения), {N} chasers (амбер), Not served (пока ничего не вручено) и метка состояния AO, например Awaiting service / Served / Awaiting response / Consented / Agreed surveyor appointed / Deemed dissent / SoC visit scheduled / Award served / Complete.
Метки обратимости появляются у каждой записи ленты, чтобы вы всегда знали, насколько необратимым было действие: reversible (нейтрально), compensable (амбер — можно исправить, возможно с издержками), irreversible (красный, жирный) и reversibility unconfirmed (амбер — fail-safe формулировка, когда система не уверена; трактуется как необратимое).
5. Флоу — как читать экран и выбирать действие¶
Кнопки не нужно запоминать. Читайте экран сверху вниз — и нужное действие становится очевидным:
- Пилюля статуса (заголовок). On-Hold, Abandoned, Closed или Referred? Набор кнопок меняется со статусом (см. §7). Live-кейс показывает полный набор.
- Stage track. Какая стадия текущая? Соответствующая запускалка Run stage (Qualify, Set up, Determine notices, …) — ваш обычный способ двигаться вперёд.
- Requires your approval. Если гейт открыт, разберитесь с ним первым — открытый гейт блокирует продвижение стадии.
- Боковые полосы AO. Сосед ответил или замолчал? Там применяются действия adjoining-owner (Record AO response, Appoint on behalf, …).
- Stage checklist. Красный пункт "— blocks progression" точно скажет, чего не хватает.
Полные разобранные примеры — кейс с согласием, кейс с несогласием, отказ по лиду, обработка эскалации — см. в Сценариях.
6. Справочник опций¶
Это сердце страницы: каждый контрол, сгруппированный ровно так, как он выглядит.
Две разные вещи называются «Run stage» — это разные механизмы.
- Чипы-запускалки стадий (Qualify case, Set up case, Determine notices, …) в верхнем ряду Quick actions — это обычный, требующий подтверждения способ продвинуть кейс на одну стадию вперёд. Каждый запускает соответствующую стадию под системным аккаунтом.
- Кнопка «Run stage» в заголовке — это отдельный, универсальный operator-start: она открывает выбор воркфлоу (с уже выбранным этим кейсом), чтобы вы могли запустить любой promoted, operator-ready воркфлоу. Для повседневного потока используйте чипы; кнопку в заголовке — только когда осознанно хотите выбрать конкретный воркфлоу.
Run-stage launchers (запускалки стадий)¶
Верхний ряд. С подтверждением. Система сама заполняет все входы из фактов кейса плюс дефолтов фирмы и запускает стадию под системным аккаунтом. Это единственные действия, вызывающие реальные внешние эффекты, и каждое сначала останавливается на approval-гейте перед чем-либо необратимым.
| Кнопка | Что делает | С подтверждением? | Разрушительно? |
|---|---|---|---|
| Qualify case | Проверяет, что заявка — настоящая рабочая party-wall задача | ✅ | Нет |
| Set up case | Создаёт папку кейса, привязывает коннекторы, запускает setup | ✅ | Нет |
| Determine notices | Определяет, какие статутные уведомления нужны | ✅ | Нет |
| Serve notices | Готовит уведомления и открывает нужные approval-гейты. Ничего не отправляется автоматически — отправку вы авторизуете на гейте | ✅ | Нет |
| Start works engine | Запускает мониторинг работ | ✅ | Нет |
| Start invoicing engine | Запускает инвойсинг | ✅ | Нет |
| Re-create case folder | Только восстановление: пересобирает Drive-папку, если авто-создание упало | ✅ | Нет |
Serve notices не вручает
Несмотря на название, Serve notices только готовит уведомления и поднимает approval-гейты. Реальное вручение происходит позже, после того как вы авторизуете его на гейте, внутри стадийного воркфлоу — и только оно запускает статутный час.
For your technician
Все запускалки выполняют pw_cockpit_run_stage с соответствующим stage. Эта команда — единственная реальная поверхность сайд-эффектов: она стартует стадийный воркфлоу (провижининг Drive, генерация уведомлений, вручение + статутный час через pw_serve_and_track_v1, работы, Xero email-invoice через pw_invoicing_v1) за approval-гейтами, под системным аккаунтом, со свежим idempotency basis (безопасно retriable). Старая pw_cockpit_start_intake нефункциональна (self-reject в validate) — заменена на pw_cockpit_run_stage.
Adjoining-owner actions (действия по соседу)¶
Видны только когда у кейса есть adjoining owner с AO-группой (реальный сосед в деле). Каждое открывает небольшую форму.
| Кнопка | Что делает | Диалог | Record ≠ serve |
|---|---|---|---|
| Record AO response | Логирует ответ соседа (consent / dissent) и двигает его маршрут; вы выбираете AO и вводите текст | QuickActionDialog (форма) | Только запись ответа |
| Appoint on behalf | Когда сосед замолчал (deemed dissent), просит владельца одобрить назначение сюрвейера за него; вы выбираете AO и указываете причину. Создаёт owner-approval — сам никого не назначает | QuickActionDialog (форма) | Только создание approval |
| Confirm re-service | Записывает дату повторного вручения уведомления и сбрасывает статутный час этого соседа. Только дату — само уведомление нужно авторизовать и вручить отдельно | QuickActionDialog (форма) | Только запись даты |
| Record third surveyor | Записывает согласованного третьего сюрвейера (s.10) и готовит черновик письма. Черновик не отправляется | QuickActionDialog (форма) | Запись + черновик, без отправки |
Milestones (в один клик, с подтверждением)¶
| Кнопка | Что делает | С подтверждением? | Разрушительно? |
|---|---|---|---|
| Record SoC | Отмечает Schedule of Condition завершённым | ✅ | Нет |
| Record Award | Логирует, что Party Wall Award вынесен | ✅ | Нет |
| Mark works done | Отмечает работы завершёнными | ✅ | Нет |
| Record payment | Вручную помечает клиентский инвойс оплаченным (override — обычно приходит автоматически) | ✅ | Да |
| Close case | Закрывает кейс, терминально | ✅ | Да |
| Set chaser priority | Поднимает приоритет чейзеров до elevated | ✅ | Нет |
Record payment нельзя отменить отсюда
Record payment вручную помечает клиентский инвойс оплаченным. Это override для обычного автоматического пути. Его нельзя отменить отсюда — используйте только когда подтвердили, что деньги действительно пришли (реальные банковские переводы остаются вне системы, см. §9).
Close case нельзя отменить отсюда
Close case закрывает кейс терминально. Его нельзя отменить отсюда. Все открытые approval-гейты кейса отзываются в рамках закрытия. Сначала убедитесь, что кейс действительно завершён.
Case lifecycle (жизненный цикл кейса)¶
Кнопки, видимость которых зависит от статуса кейса (полная таблица — §7). Большинство открывают форму.
| Кнопка | Что делает | Диалог | Видна когда |
|---|---|---|---|
| Resume case | Снимает кейс с холда и перезапускает прогресс и чейзеры | Confirm | Статус = On-Hold |
| Mark method statement ready | Помечает method statement готовым и разблокирует работы | Confirm | Известна версия кейса |
| Put case on hold | Ставит кейс на паузу с причиной и интервалом ревью (1–365 дней, по умолчанию 30) | QuickActionDialog (форма) | Скрыта при On-Hold / Closed / Abandoned / Referred |
| Abandon case | Терминально забрасывает кейс; указываете код причины и текст. Показана красным danger-чипом | QuickActionDialog (форма) | Скрыта при Closed / Abandoned / Referred |
| Refer enquiry | Выводит заявку из party-wall процесса к специалисту. Записывает только referral | QuickActionDialog (форма) | Скрыта при Closed / Abandoned / On-Hold / Referred |
| Record invoice | Записывает выставленный клиентский инвойс (entity, bill-to, гонорар без НДС) | QuickActionDialog (форма) | Всегда (с правом записи) |
| Record external authority | Записывает out-of-band принятие назначения и активирует мандат. Ничего не отправляется | QuickActionDialog (форма) | Всегда (с правом записи) |
| Record signing authority | Записывает право одного владельца подписывать за остальных. Только запись | QuickActionDialog (форма) | Всегда (с правом записи) |
| Capture decision | Записывает решение сюрвейера, коррекцию подсказки системы и обоснование (для аудита) | QuickActionDialog (форма) | Всегда (с правом записи) |
| Request withdrawal | Запрашивает одобрение на отправку черновика отзыва вручённых уведомлений. Создаёт гейт — не отправляет | QuickActionDialog (форма) | Статус = Abandoned |
Abandon case нельзя отменить отсюда
Abandon case терминально забрасывает кейс. Его нельзя отменить отсюда. Если нужна только пауза — используйте Put case on hold: это обратимо через Resume case.
Everyday operational actions (повседневные действия)¶
Ежедневная фиксация фактов. Каждое открывает форму. Обратите внимание на цвета кнопок: primary (синий) и danger (красный) всё равно только записывают — цвет это акцент, а не обещание что-то отправить.
| Кнопка | Что делает | Стиль | Record ≠ serve |
|---|---|---|---|
| Record drawing analysis | Записывает ваше чтение чертежей (предзаполнено подсказкой системы). Видна только когда анализ чертежей существует | обычный | Только запись |
| Record service | Записывает уже состоявшееся вручение (метод + дата) и сразу запускает статутный час этого соседа от указанной даты — без approval-гейта | обычный | Не отправляет; но сразу запускает статутный час |
| Log call/note | Записывает звонок или заметку (входящий / исходящий) | обычный | Только запись; не отправляет |
| Upload document | Прикрепляет Drive-файл как source или draft | обычный | Только прикрепление |
| Email party | Записывает исходящее сообщение стороне | primary (синий) | Записано, НЕ отправлено — delivery worker'а нет; ничего не уходит автоматически |
| Schedule SoC visit | Записывает предложенную дату визита Schedule of Condition | обычный | Записывает дату; календарь не бронируется |
| Escalate | Поднимает эскалацию (причина / серьёзность / доказательства) на разбор человеком. Ничего автономного не запускает | danger (красный) | Только запись флага |
| Assess change | Записывает оценку влияния изменения на Award (no action / addendum / refer) | обычный | Только запись |
| Refer to specialist | Записывает referral-сообщение специалисту | primary (синий) | Записано, не отправлено |
Record service подписан неверно — гейта нет
Диалог подтверждения Record service подписан неверно: его кнопка гласит "Request approval", а текст упоминает approval-гейт перед запуском часов. Игнорируйте эту формулировку — гейта нет. Статутный час запускается в момент сохранения, отсчёт идёт от указанной вами даты вручения, поэтому указывайте правильную дату вручения.
Email party и Refer to specialist не отправляют
Обе выглядят как кнопки «отправить», и обе — заметные синие primary-кнопки — но обе только записывают исходящее сообщение. К ним не подключён delivery worker, поэтому ничего не отправляется и ничего не ставится в очередь на доставку. Если реальное письмо должно уйти — оно уходит через вручённый стадийный воркфлоу за approval-гейтом, либо вы отправляете его сами из своего почтового клиента.
Approval-gate controls (GateCard)¶
Появляются в секции «Requires your approval (N)», и только когда есть открытые гейты. Каждый открытый гейт — карточка; контролы на ней зависят от состояния гейта.
| Кнопка | Что делает | Видна когда |
|---|---|---|
| Approve | Авторизует действие за гейтом | Гейт pending |
| Reject | Раскрывает поле причины (обязательно) → затем Confirm reject | Гейт pending |
| Confirm reject | Финализирует отказ с причиной | После Reject; недоступна, пока не введена причина |
| Reclassify | Оспаривает классификацию ответа AO (consent ↔ dissent) → затем Confirm reclassify | На гейте подтверждения маршрута AO |
| Confirm reclassify | Финализирует реклассификацию | После Reclassify; недоступна, пока не введена причина |
| Request more context | Задаёт уточняющий вопрос → затем Send question | Гейт pending |
| Send question | Отправляет вопрос | Недоступна, пока не введён текст |
| Edit before approve | Редактирует поля гейта → затем Apply edit | Гейт pending; когда у гейта нет редактируемых полей, показывает "No editable fields for this gate" |
| Apply edit | Отправляет отредактированные поля | Недоступна, пока ничего не изменено |
| Provide context | Даёт запрошенный контекст → затем Submit context | Гейт awaiting context |
| Submit context | Отправляет контекст | Недоступна, пока не введён текст |
Необратимый гейт нарисован на красной карточке. Если у него есть ожидаемая стоимость, он говорит "Anticipated cost £X — authorise to incur charge" — одобрение потратит деньги. Читайте такие перед кликом.
«Approve all (N)» — не используйте, когда любой гейт показывает стоимость
На странице Approvals (/approvals, не на этом экране кейса) кнопка «Approve all (N)» появляется только когда в секции кейса есть группа из двух или более ожидающих гейтов одного side-effect-класса (класса обратимости) — она одобряет каждую такую группу в этом кейсе одним кликом (N — их суммарное число), включая любые необратимые или платные гейты в ней. Если хоть один гейт в группе показывает anticipated cost или бейдж irreversible — не используйте bulk-approve: проверяйте и одобряйте такие гейты по одному. Страница Approvals описана в Разделах.
Automation panel controls (панель автоматизации)¶
В правом рельсе, по одному набору на живой воркфлоу. Бейдж говорит о состоянии; контролы появляются, когда воркфлоу упал.
| Кнопка | Что делает | Видна когда |
|---|---|---|
| Pause | Ставит воркфлоу на паузу | Running (не failed / paused) |
| Retry | Перезапускает упавший воркфлоу | Failed |
| Investigate | Прокручивает к секции эскалаций (только чтение) | Failed |
| Skip | Отменяет упавший воркфлоу — тот же эффект, что и Continue manually; шаг не пропускается и кейс сам дальше не идёт. Дальше вы ведёте кейс вручную | Failed |
| Continue manually | Отменяет автоматику, шаг вы делаете вручную | Failed |
Панель Automation: живые воркфлоу с бейджами состояния. Retry / Investigate / Skip / Continue manually появляются, когда воркфлоу упал.
Свежий approval после retry
Панель предупреждает: "Fresh approval is required before money or statutory side effects repeat." Если вы Retry или Skip воркфлоу, который уже дошёл до денежного или статутного шага, система снова запросит approval перед повтором — она не станет молча повторно списывать деньги или повторно вручать.
Document links (ссылки документов)¶
В секции Documents, по каждому документу.
| Кнопка | Что делает | Видна когда |
|---|---|---|
| Open document | Открывает Drive-файл в новой вкладке | У документа есть Drive-файл |
| Download document | Скачивает Drive-файл | У документа есть Drive-файл |
Диалоги экрана кейса¶
За кнопками выше стоят три типа диалогов:
| Диалог | Назначение | Кнопки |
|---|---|---|
| ConfirmActionDialog | Универсальный гейт «вы уверены?» для действий в один клик. Полей нет — заголовок это метка действия, сообщение это последствие | Decline / Accept (Accept красный для разрушительных; недоступен, пока идёт команда) |
| QuickActionDialog | Универсальная форма для действий с вводом. Поля (text / textarea / date / select / radio) валидируются до отправки | Cancel / Submit (метка своя у действия, либо "Confirm"; недоступна, пока не валидно). Амбер-строка disclosure объясняет оговорку |
| StartWorkflowDialog | Выбор воркфлоу, открываемый кнопкой заголовка «Run stage» (с уже выбранным кейсом). Выберите promoted-воркфлоу, заполните поля, проверьте bindings | Cancel / Start (→ "Starting…") / Done |
Три других диалога — Reject lead, Set qualification outcome и мастер нового кейса (New-case wizard) — на экране кейса не живут. Они относятся к поверхности лидов / списка кейсов (
/cases,/cases/new) и описаны в Разделах и Сценариях.
Уведомления (тосты только об ошибках)¶
Cockpit показывает тост только когда что-то упало — успех показывается инлайн, никогда тостом. Поэтому тост всегда значит «прочитай меня». Полные способы устранения — в Траблшутинге; сами сообщения:
| Тост | Что значит |
|---|---|
| Session expired — Please sign in again. | Сессия закончилась — войдите заново |
| Not permitted — … | У вас нет прав на это действие |
| Item changed — …refresh and try again. | Кто-то изменил кейс после загрузки — обновите |
| Conflict — … | Конфликтующее состояние — обновите и повторите |
| Could not save — … | Часть данных невалидна |
| Action failed — … | Действие упало по иной причине |
7. Жизненный цикл — какая кнопка при каком статусе¶
Панель Quick actions меняется со статусом кейса. Правила зависимости от статуса:
| Кнопка | Появляется когда |
|---|---|
| Resume case | Только при On-Hold |
| Request withdrawal | Только при Abandoned |
| Put case on hold | Скрыта при On-Hold / Closed / Abandoned / Referred |
| Abandon case | Скрыта при Closed / Abandoned / Referred |
| Refer enquiry | Скрыта при Closed / Abandoned / On-Hold / Referred |
| Adjoining-owner actions + Record AO response | Только когда у кейса есть adjoining owner с AO-группой |
| Record drawing analysis | Только когда существует анализ чертежей |
| Mark method statement ready | Только когда известна версия кейса |
| Вся панель Quick actions | Только с правом записи; каждый чип сереет, пока идёт команда |
Так Closed или Referred кейс почти не показывает lifecycle-кнопок — это ожидаемо, он терминален. On-Hold кейс показывает Resume case и прячет Put case on hold и Refer enquiry; Abandon case остаётся доступной.
8. Траблшутинг¶
Две особенности экрана кейса, которые стоит знать, прежде чем идти в Траблшутинг:
- Кнопка серая. Либо команда ещё обрабатывается (подождите секунду), либо вы в режиме только для чтения (ищите баннер). Это не баг.
- Кейс не движется, но ничего не упало. Проверьте по порядку: Operator context › Workflows & waits (воркфлоу может ждать), секцию Requires your approval (открытый гейт блокирует стадию), Statutory clocks (юридический дедлайн может просто идти — это норма) и Stage checklist (красный пункт "— blocks progression"). Зовите технаря, только если ни одно из четырёх не объясняет остановку.
Всё остальное — полный список тостов и ошибок, повторная авторизация коннекторов и когда и как звать технаря — в Траблшутинге.
9. Ограничения и инварианты¶
Current limits (показаны дословно в панели правого рельса — честное раскрытие того, чего система пока не делает):
- Land Registry is manual attach and verify.
- Finance uses email requests only; Xero automation is off.
- Referral records the hand-off only.
- Real payments and bank transfers stay outside Axon.
- Multi-signer and drawing vision are later-stage capabilities.
Метки обратимости на записях ленты говорят, насколько необратимым было каждое прошлое действие: reversible (нейтрально), compensable (амбер — можно исправить, возможно с издержками), irreversible (красный, жирный), reversibility unconfirmed (амбер — fail-safe формулировка, трактуется как необратимое до подтверждения).
Record ≠ serve — инвариант за всем экраном. Каждое record-действие на этой странице сохраняет факт, черновик или намерение и ничего необратимого во внешнем мире само по себе не делает. Реальное вручение, e-sign, инвойсинг и статутные часы происходят только внутри стадийных воркфлоу, запускаемых запускалками Run stage, и только после того, как вы авторизуете их на approval-гейте. Единственное намеренное исключение — Record service: он используется, чтобы зафиксировать вручение, уже состоявшееся вне Axon, и сразу запускает статутный час этого соседа при сохранении (без гейта), поэтому указывайте правильную дату вручения. Это заложенное свойство безопасности, а не временный пробел — именно поэтому вы можете свободно кликать на этом экране и никогда случайно не вручить уведомление соседу и не списать деньги клиенту.
For your technician
Каждый record-фасад pw_cockpit_* — это sync_apply с side_effect_class='internal'; синхронно он не делает необратимого внешнего акта. _IRREVERSIBLE_ACTIONS = frozenset() (пуст). Обратимость классифицируется в core/api/queries/pwms_labels.py::action_reversibility, не в execution_paths.py (тот маппит command → ExecutionPath + RBAC Permission + internal-only gating). Единственная реальная поверхность сайд-эффектов — pw_cockpit_run_stage. Хендлеры: core/api/commands/handlers/pwms_cockpit.py. См. маппинг ниже.
For your technician
Backend-маппинг кнопок этого экрана (команда → что записывает):
New case wizard → pw_cockpit_create_lead (draft case, статус P). Run stage → pw_cockpit_run_stage (единственная поверхность сайд-эффектов; pw_serve_and_track_v1, pw_invoicing_v1). Reject lead → pw_cockpit_reject_lead (decline-письмо как outbox-событие, provider_send=False). Refer/Close/Abandon/Hold → pw_cockpit_refer/close/abandon/hold_case. Resume → pw_cockpit_resume_case. Request withdrawal → pw_cockpit_request_withdrawal (send-intent row; PW outbound worker'а нет, синхронной отправки нет). Log call/note → pw_cockpit_log_communication. Attach document → pw_cockpit_attach_document (только source/draft). Email party / Refer to specialist → pw_cockpit_request_outbound (outbound_request; не шлёт и не планирует доставку). Schedule SoC visit → pw_cockpit_schedule_soc_visit (без брони календаря). Raise escalation → pw_cockpit_raise_escalation. Set chaser priority → pw_cockpit_set_chaser_priority. Capture decision → pw_cockpit_capture_surveyor_decision. Record SoC/Award/works done → pw_cockpit_record_soc/record_award/mark_works_done. Record service → pw_cockpit_record_service (non-email метод требует evidence_document_id). Confirm re-service → pw_cockpit_confirm_reserve. Assess change / Record drawing analysis → pw_cockpit_assess_change / record_drawing_analysis. Record invoice → pw_cockpit_record_invoice_issued (Xero payload — только метадата; Xero не вызывается). Record payment → pw_cockpit_record_invoice_paid (ручной override; без движения денег). Record external/signing authority → pw_cockpit_record_external_authority / record_signing_authority. Record third surveyor → pw_cockpit_record_third_surveyor.
10. Связанное¶
- Обзор Cockpit — ментальная модель и оболочка приложения.
- Быстрый старт — один сквозной кейс, шаг за шагом.
- Сценарии — маршруты A–D, отказ по лиду, эскалации, on-hold чейзеры.
- Разделы — Home, список кейсов, Approvals, Statutory clocks, Connectors, Settings.
- Траблшутинг — тосты, ошибки и когда звать технаря.
- Памятка — одностраничная печатная сводка.
- Глоссарий — термины party-wall и системы.