Files
estimator/docs/estimator-architecture-review-v2-response.md
T

7.8 KiB
Raw Blame History

Разбор архитектурного ревью v2

Дата: 31 октября 2026 · Статус: позиция по ревью. Вопрос про политику резерва решён (ADR-0001), вопрос про данные завершённых проектов открыт Относится к: estimator-architecture-review-v2.md

Ниже текст разбора записан как есть, без правок.


Что думаю про ревью

В целом оно полезное и в основном справедливое. Что-то из этого уже было у меня в списке ограничений, но три замечания я бы признал настоящими дефектами.

Принимаю безоговорочно:

  1. Наценка и маржа. В калькуляторе margin_pct это множитель ×1.20, то есть наценка 20%, а фактическая маржа около 16,7%. Название вводит в заблуждение. Исправление небольшое: переименовать в markup_pct, при желании добавить режим целевой маржи. Числа в эталонном примере при этом не меняются.
  2. Двойной резерв. cost_confident я считаю как цену, уже включающую 10% риска, умноженную на отношение часов P85 к ожидаемым. Резерв выходит дважды. Плюс подпись «≈P85» обещает вероятность, которую никто не калибровал. Подпись надо смягчить, а политику резерва выбрать одну.
  3. Снимок вводных. В версии я храню только имя версии справочника (2026Q4), а ставки лежат в файле, который можно отредактировать задним числом. Тогда старая оценка перестанет воспроизводиться, а ручная правка пересчитается по изменённым ставкам. Нужно класть в версию снимок ставок и параметров расчёта.
  4. Устаревшие шапки документов. Исправил: в них стояло «реализация не начата».

Согласен, но с поправкой:

  • Domain Packs и каталог работ. Направление верное, но делать реестр плагинов и композицию возможностей при одном домене и нуле завершённых проектов рано, можно угадать неверную абстракцию. Я бы взял дешёвую часть: вынести то, что сейчас зашито под ботов (тексты промптов, список сегментов, ключи ориентиров), в папку пакета с манифестом, один пакет bots_ai, без реестра. Второй домен покажет, чего не хватает.
  • Коды работ. Самый сильный довод ревью, что RAG и калибровку надо делать после унификации работ. В моём конвейере у задач только свободные названия от модели, поэтому «коэффициент по типу задачи», как я планировал, считать не по чему. Нужно необязательное поле work_item_code и факты на уровне задач. Это меняет мой план: до RAG нужен этот шаг.
  • Режимы экспресс и подробная оценка. Идея хорошая, сейчас её грубо заменяет флаг «продолжить с допущениями». Достаточно пометить результат «предварительная оценка», когда остались допущения.
  • Метрики. Согласен, что «попадание в рынок» нельзя выдавать за точность, это подталкивает подгонять смету под чужие прайсы. Оставлю как предупреждение, а метрикой сделаю ошибку по часам и смещение. Это моя запись в разделе 8.2 документа с рыночными данными.

Отложил бы:

  • Очередь на Postgres. Нужна только при нескольких репликах, в документах это уже записано как ограничение.
  • Роли viewer/estimator/approver, tenant_id, Monte Carlo, сценарии «эконом/база/консервативный», экспорт КП. Всё разумно, но без данных о ваших проектах это проектирование вслепую. Монте-Карло без калибровки только добавит ложной точности, ревью само это признаёт.
  • Девять ADR. Для вашего масштаба это много. Оформил бы короткие записи только для трёх решений, меняющих модель данных: экономика, снимки, коды работ.

Чего в ревью не хватает: нигде не сказано, что без фактических часов все предложенные улучшения (калибровка, рынок по контексту, Monte Carlo) работают на пустых данных. Главный рычаг точности это ввод плана и факта по задачам, и его я бы поставил раньше RAG.

Ещё одна ремарка: в ревью про пользователей UI сказано, что общего ключа мало. Для отдельных пользователей это уже не так (логины, раздельные рабочие пространства). Не хватает только created_by в БД: при общем пространстве сейчас не видно, кто создал оценку.

Что предлагаю дальше

  1. Небольшой пакет исправлений без споров: наценка вместо «маржи», один механизм резерва и честные подписи, снимок вводных и created_by в версии.
  2. Поле work_item_code и ввод плана и факта по задачам в интерфейсе.
  3. Потом RAG и калибровка.
  4. Лёгкая версия пакета домена для ботов.

Нужно ваше решение по двум вопросам:

  • Резерв. Какую политику берём: ожидаемая цена плюс плоские 10%, или диапазон от ожидаемой до P85 без плоской надбавки? От выбора зависят итоговые цены, у примера из документа 370 000 ₽ сдвинется.
  • Данные. Есть ли у вас уже завершённые проекты с фактическими часами, пусть даже по этапам? Это определяет, будет ли калибровка работать со старта или начнётся с нуля.