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

49 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Разбор архитектурного ревью v2
**Дата:** 31 октября 2026 · **Статус:** позиция по ревью. Вопрос про политику резерва решён ([ADR-0001](adr/0001-reserve-policy-and-engagement.md)), вопрос про данные завершённых проектов открыт
**Относится к:** [estimator-architecture-review-v2.md](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 ₽ сдвинется.
- **Данные.** Есть ли у вас уже завершённые проекты с фактическими часами, пусть даже по этапам? Это определяет, будет ли калибровка работать со старта или начнётся с нуля.