offer_boq_generator

Imported from bDikov/buildsmart (.agents/skills/offer_boq_generator/SKILL.md). Install upstream with npx skills add bDikov/buildsmart --skill offer_boq_generator. Copyright stays with the author.

BuildSmart Offer & BOQ (КСС) Generator Skill

Този скил ръководи изготвянето на официални оферти и Количествено-Стойностни Сметки (КСС) за клиенти на BuildSmart под формата на Markdown (.md) файлове, базирани на мултимодален анализ на видео огледи, снимки и чертежи, напълно съобразени с имплементацията на парсера в BuildSmart (AdminOffers.razor / MarkdownOfferParserService.cs / OffersController.cs).

1. СТРОГИ ПРАВИЛА ЗА ВАЛУТАТА И СЪВМЕСТИМОСТТА С BUILDSMART

[!IMPORTANT] ВАЛУТА: ЕДИНСТВЕНО И САМО В ЕВРО (€).
Всички оферти, бюджети, пера, единични цени и рекапитулации се остойностяват само и единствено в EUR (€). Забранено е споменаването на левове (BGN), валутни курсове или двойни колони.

1.1. Заглавни секции (Задължителни тригери за IsStructuredOffer)

Парсерът разпознава структурирана оферта по наличието на тези заглавия:

• ### 1. ОБЩИ ДАННИ ЗА ОБЕКТА И ПРОЕКТА
• ### 2. СТРУКТУРА НА ИНВЕСТИЦИЯТА (ТРИКОМПОНЕНТНА РАЗБИВКА)
• ### 3. ДЕТАЙЛНА КОЛИЧЕСТВЕНО-СТОЙНОСТНА СМЕТКА (КСС) ПО СМР РАЗДЕЛИ
• ### 4. ОБОБЩЕНА ТАБЛИЦА НА ОФЕРТАТА
• ### 5. ИНЖЕНЕРНИ ПРЕПОРЪКИ И СПЕЦИФИЧНИ КАЗУСИ

1.2. Метаданни в Секция 1 (Точни ключове за регулярните изрази)

Всеки ред започва с тире и удебелен ключ с двоеточие:

• - **Клиент:** [Име на клиента] (или Собственик:, Възложител:) -> записва се в result.ClientName.
• - **Местоположение:** [Адрес на обекта] (или Обект:, Адрес:) -> записва се в result.SiteAddress и Parameters.Location.
• - **Възраст на сградата и състояние:** [Текст] -> записва се в Parameters.PropertyCondition.
• - **Обща площ:** **[XX.XX] m²** -> записва се в Parameters.TotalArea.
• - **Срок за изпълнение:** **[XX] работни дни** -> записва се в Parameters.ExecutionTimeline.
• - **Ниво на изпълнение:** **[PREMIUM / STANDARD / LUXURY]** -> записва се в Parameters.QualityLevel.
• - **Гаранция:** **[X години...]** -> записва се в Parameters.Warranty.
• - **Начин на плащане:** **[...]** -> записва се в Parameters.PaymentTerms.

1.3. Секция 4: Обобщена таблица – КРИТИЧНО ПРАВИЛО ЗА КОЛОНИТЕ

В MarkdownOfferParserService.cs парсерът за Секция 4 прочита бюджета от колона с индекс 2 (cells[2]):

string firstCell = CleanMarkdown(cells[0]); // Индекс (№)
string secTitle = CleanMarkdown(cells[1]);  // Заглавие на раздела
string budgetCell = CleanMarkdown(cells[2]); // Бюджет в EUR (cells[2] ЗАДЪЛЖИТЕЛНО е сумата в EUR!)
var range = ParseNumberAndRange(budgetCell, false);

[!CAUTION] НЕ поставяйте процентите % в колона 2! Ако колона 2 е Дял (%), парсерът ще прочете числото на процента вместо сумата в евро! Задължителната подредба на колоните в Секция 4 е: | № | СМР Раздел | Общ Бюджет (€) | Труд (€) | Чернови М-ли (€) | Чистови / Оборудване (€) |

2. ЗАБРАНА ЗА ЗАБИТИ (СТАТИЧНИ) СТОЙНОСТИ – ДИНАМИЧНО ЦЕНООБРАЗУВАНЕ

[!IMPORTANT] Никога не копирайте статични числа от предходни оферти!
Всяка стойност се изчислява динамично за конкретния обект спрямо реалните размери от скиците/чертежите и видео огледа:

1. Квадратури ($S$):
   • $S_{чиста}$, $S_{обща}$ и развитите площи на стените се извличат от предоставените чертежи/записки от огледа.
2. Базова ставка за квадратен метър в EUR (€/m²):
   • Определя се спрямо състоянието на обекта от видеото:
     • STANDARD (ново строителство БДС / освежителен): € 420 – € 520 / m²
     • PREMIUM (старо строителство, цялостна подмяна на инсталации): € 540 – € 650 / m²
     • LUXURY (премиум финиши, акустика, сложни детайли): € 750 – € 950+ / m²
3. Общ прогнозен бюджет (€): $$\text{Бюджет}{min} = S \times P{min}, \quad \text{Бюджет}{max} = S \times P{max}$$
4. Срок за изпълнение: $$\text{Работни дни} \approx \text{round}(S \times 1.25)$$
5. Трикомпонентна разбивка (в EUR):
   • Труд (48%): $\text{Бюджет (€)} \times 0.48$
   • Чернови материали (27%): $\text{Бюджет (€)} \times 0.27$
   • Чистови материали & Оборудване (25%): $\text{Бюджет (€)} \times 0.25$
6. Тегла на 9-те СМР раздела:
   • Пресмятат се съобразно приоритетите от огледа (напр. ново Ел. и ново ВиК имат водещ приоритет, къртене на преградни стени, топлоизолационни пакети и т.н.).

3. СТАНДАРТЕН СТРУКТУРИРАН ШАБЛОН НА ОФЕРТАТА (EUR ONLY)

# ОФИЦИАЛНА ОФЕРТА И КОЛИЧЕСТВЕНО-СТОЙНОСТНА СМЕТКА (КСС)
## Цялостен Основен Капитален Ремонт на Апартамент – Ниво [PREMIUM / STANDARD] (без обзавеждане)

---

### 1. ОБЩИ ДАННИ ЗА ОБЕКТА И ПРОЕКТА
- **Клиент:** [Име на клиента или Възложител]
- **Местоположение:** [Точен адрес или гр. София, кв. ...]
- **Възраст на сградата и състояние:** [Констатации от огледа и записките]
- **Обща площ (застроена площ с тераси):** **[S] m²** (чиста светла площ: [S_чиста] m² + [S_тераси] m² тераси).
- **Срок за изпълнение:** **[ДНИ] работни дни** (около [МЕСЕЦИ] календарни месеца).
- **Ниво на изпълнение:** **[PREMIUM / STANDARD / LUXURY]**
- **Гаранция:** **5 години пълна писмена гаранция** по договор с двустранни приемо-предавателни протоколи за всеки етап.
- **Начин на плащане:** **0% авансово плащане** – поетапно разплащане единствено след двустранно приет СМР етап.

---

### 2. СТРУКТУРА НА ИНВЕСТИЦИЯТА (ТРИКОМПОНЕНТНА РАЗБИВКА)

Общата прогнозна стойност за цялостния ремонт (без мебели) по калкулатора на **BuildSmart** е:
\[
\mathbf{€\ [МИН]\ –\ €\ [МАКС]}
\]

| Компонент на инвестицията | Дял (%) | Стойност в EUR (€) | Какво включва |
| :--- | :---: | :---: | :--- |
| **1. Труд & Инженерен надзор** | **48%** | **€ [EUR_MIN] – € [EUR_MAX]** | Квалифицирани майстори за всички СМР етапи, технически ръководител, лазерно заснемане, координация и авторски надзор. |
| **2. Чернови строителни материали** | **27%** | **€ [EUR_MIN] – € [EUR_MAX]** | 100% включени: лепила C2TE S1, 2K хидроизолация с ленти, Knauf профили и картон, вата, PPR и PVC тръби, СВТ кабели, замазки, мрежи и Sheetrock. |
| **3. Чистови покрития & Оборудване** | **25%** | **€ [EUR_MIN] – € [EUR_MAX]** | Гранитогрес/фаянс, структура за вграждане, санитария, смесители, душ-зона, интериорни врати, ключове/контакти Schneider, подови настилки. |
| **ОБЩО ([S] кв.м [НИВО]):** | **100%** | **€ [МИН] – € [МАКС]** | **Средна цена: [ЦЕНА_МИН] – [ЦЕНА_МАКС] €/m²** |

---

### 3. ДЕТАЙЛНА КОЛИЧЕСТВЕНО-СТОЙНОСТНА СМЕТКА (КСС) ПО СМР РАЗДЕЛИ

Всички раздели са остойностени с точна трикомпонентна разбивка:
`[Общ дял на раздела] -> Труд (48%) | Чернови материали (27%) | Чистови материали & Оборудване (25%)`

#### РАЗДЕЛ 1: Баня и Санитарен възел
- **Общ бюджет на раздела ([P1]%):** **€ [EUR_MIN] – € [EUR_MAX]**
  - **Труд (48%):** € [EUR]
  - **Чернови материали (27%):** € [EUR]
  - **Чистови материали и оборудване (25%):** € [EUR]

**Подробни позиции:**
1. **2K Еластична хидроизолационна мембрана:** Двукратно полагане по подове и стени... – **€ [СУМА]**
2. **Полагане на едроформатен гранитогрес / фаянс:** Лепене на плочи с флексово лепило C2TE S1, герунг 45°... – **€ [СУМА]**
...

[Аналогично се остойностяват раздели от 2 до 9]

---

### 4. ОБОБЩЕНА ТАБЛИЦА НА ОФЕРТАТА

| № | СМР Раздел | Общ Бюджет (€) | Труд (€) | Чернови М-ли (€) | Чистови / Оборудване (€) |
| :---: | :--- | :---: | :---: | :---: | :---: |
| **1** | Баня и Санитарен възел | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **2** | Шпакловка, мрежа и ъгли | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **3** | Интериорно боядисване | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **4** | Сухо строителство & изолации | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **5** | Подови настилки & Паркет | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **6** | Електроинсталация & Осветление | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **7** | ВиК инсталация & Нова кухня | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **8** | Интериорни врати | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **9** | Къртене, логистика & депо | € [MIN] – [MAX] | € [T_MIN] – [T_MAX] | € [M_MIN] – [M_MAX] | € [O_MIN] – [O_MAX] |
| **ОБЩО** | **ЦЯЛОСТЕН РЕМОНТ (без мебели)** | **€ [ОБЩО_МИН] – [ОБЩО_МАКС]** | **€ [Т_ОБЩО]** | **€ [М_ОБЩО]** | **€ [О_ОБЩО]** |

---

### 5. ИНЖЕНЕРНИ ПРЕПОРЪКИ И СПЕЦИФИЧНИ КАЗУСИ
1. **Казус 1:** [Анализ и инженерни препоръки].
2. **Казус 2:** [Препоръки за материали и изпълнение].

4. ОПТИМИЗАЦИЯ ЗА ДЪЛГИ ВИДЕА: ДЕЛЕГИРАНЕ КЪМ ИЗОЛИРАН СЪБАГЕНТ

При наличие на дълги видеоклипове (няколко минути / стотици мегабайти) или множество клипове за един обект:

1. Никога не зареждайте суровите видеа директно в основния контекст на главния агент. Това разходва стотици хиляди токени и блокира агента.
2. Архитектура на изпълнение чрез събагент (invoke_subagent):
   • Главният агент стартира специализиран събагент self или research с роля Video Auditor.
   • Събагентът изглежда видеоклипа в своята собствена изолирана сесия, извлича:
     • Пълна аудио стенограма на казаното от техническото лице на обекта;
     • Секунда по секунда опис на помещенията, конструктивните забележки и дефектите;
     • Списък с критични изисквания (затапване на тръби, бутане на стени, топлоизолация, състояние на паркет).
   • Събагентът записва лек текстов структуриран файл в проектната папка: [video_name]_inspection.md (размер ~10-20 KB).
3. Главен агент:
   • След приключване на събагента, главният агент прочита само лекия текстов [video_name]_inspection.md и снимките от бележника/чертежите.
   • Резултат: Главното контекстно прозорче остава чисто (под 10 000 токена), светкавично бързо и 100% работоспособно.