7.8 KiB
Разбор архитектурного ревью v2
Дата: 31 октября 2026 · Статус: позиция по ревью. Вопрос про политику резерва решён (ADR-0001), вопрос про данные завершённых проектов открыт Относится к: estimator-architecture-review-v2.md
Ниже текст разбора записан как есть, без правок.
Что думаю про ревью
В целом оно полезное и в основном справедливое. Что-то из этого уже было у меня в списке ограничений, но три замечания я бы признал настоящими дефектами.
Принимаю безоговорочно:
- Наценка и маржа. В калькуляторе
margin_pctэто множитель×1.20, то есть наценка 20%, а фактическая маржа около 16,7%. Название вводит в заблуждение. Исправление небольшое: переименовать вmarkup_pct, при желании добавить режим целевой маржи. Числа в эталонном примере при этом не меняются. - Двойной резерв.
cost_confidentя считаю как цену, уже включающую 10% риска, умноженную на отношение часов P85 к ожидаемым. Резерв выходит дважды. Плюс подпись «≈P85» обещает вероятность, которую никто не калибровал. Подпись надо смягчить, а политику резерва выбрать одну. - Снимок вводных. В версии я храню только имя версии справочника (
2026Q4), а ставки лежат в файле, который можно отредактировать задним числом. Тогда старая оценка перестанет воспроизводиться, а ручная правка пересчитается по изменённым ставкам. Нужно класть в версию снимок ставок и параметров расчёта. - Устаревшие шапки документов. Исправил: в них стояло «реализация не начата».
Согласен, но с поправкой:
- 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 в БД: при общем пространстве сейчас не видно, кто создал оценку.
Что предлагаю дальше
- Небольшой пакет исправлений без споров: наценка вместо «маржи», один механизм резерва и честные подписи, снимок вводных и
created_byв версии. - Поле
work_item_codeи ввод плана и факта по задачам в интерфейсе. - Потом RAG и калибровка.
- Лёгкая версия пакета домена для ботов.
Нужно ваше решение по двум вопросам:
- Резерв. Какую политику берём: ожидаемая цена плюс плоские 10%, или диапазон от ожидаемой до P85 без плоской надбавки? От выбора зависят итоговые цены, у примера из документа 370 000 ₽ сдвинется.
- Данные. Есть ли у вас уже завершённые проекты с фактическими часами, пусть даже по этапам? Это определяет, будет ли калибровка работать со старта или начнётся с нуля.