49 lines
7.8 KiB
Markdown
49 lines
7.8 KiB
Markdown
# Разбор архитектурного ревью 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 ₽ сдвинется.
|
||
- **Данные.** Есть ли у вас уже завершённые проекты с фактическими часами, пусть даже по этапам? Это определяет, будет ли калибровка работать со старта или начнётся с нуля.
|