@ai.all/ds7 0.0.0-stage → 1.0.0

package/03-performance-web-vitals/HYDRATION-STRATEGY.md

@@ -0,0 +1,51 @@
+# 03-Performance · Hydration Strategy & TBT Minimization
+
+> Как избавиться от зависаний интерфейса (Total Blocking Time < 50ms) при первом входе на страницу.
+
+---
+
+## 1. В чём опасность полной гидратации
+
+Nuxt генерирует чистый статический HTML. Браузер быстро его отображает, но затем запускается процесс **гидратации (Hydration)**:
+* Vue начинает «оживлять» каждый компонент на странице, вешать слушатели событий и инициализировать реактивные объекты;
+* Если на странице 15 секций (калькулятор, карта проектов, чат, модалки, слайдеры), этот процесс может занять **250–500 мс** на среднем мобильном процессоре;
+* В это время страница «висит» — пользователь тыкает по меню или кнопке, а клик не срабатывает.
+
+---
+
+## 2. Стратегия отложенной гидратации в DS7
+
+### 1. Отложенные второстепенные виджеты (`requestIdleCallback`)
+Виджеты, которые не нужны в первую секунду (чат WhatsApp, куки-баннер, модалка звонка, звуковые эффекты), гидрируются только тогда, когда процессор свободен:
+
+```vue
+<script setup lang="ts">
+const shouldHydrateIdle = ref(false)
+
+onMounted(() => {
+  if ('requestIdleCallback' in window) {
+    window.requestIdleCallback(() => { shouldHydrateIdle.value = true })
+  } else {
+    setTimeout(() => { shouldHydrateIdle.value = true }, 1500)
+  }
+})
+</script>
+
+<template>
+  <ClientOnly>
+    <SiteChat v-if="shouldHydrateIdle" />
+    <SiteCookieBanner v-if="shouldHydrateIdle" />
+  </ClientOnly>
+</template>
+```
+
+### 2. Ленивая гидратация по скроллу (`when-visible`)
+Тяжелые интерактивные секции ниже первого экрана (интерактивная карта проектов `HomeProjectMap`, модель дня и ночи `HomeDayNight`) гидрируются только тогда, когда пользователь приближается к ним при прокрутке.
+
+### 3. Пассивные слушатели событий (`passive: true`)
+В компоненте `UiCardSlider` и любых событиях скролла/тача:
+```ts
+window.addEventListener('scroll', onScroll, { passive: true })
+track.addEventListener('touchstart', onTouchStart, { passive: true })
+```
+Браузер заранее знает, что скрипт не отменит стандартную прокрутку страницы (`preventDefault`), и скроллит страницу с максимальной частотой 120 FPS без микро-фризов.

package/04-seo-ai-optimization/AEO-GEO-AI-SEARCH.md

@@ -0,0 +1,70 @@
+# 04-SEO · AEO & GEO: Optimization for AI Search Engines
+
+> Answer Engine Optimization (AEO) и Generative Engine Optimization (GEO): как сделать сайт источником цитирования для Perplexity, SearchGPT, Claude и Google Gemini Overviews.
+
+---
+
+## 1. Смена парадигмы: от «Ключевых слов» к «Фактической плотности»
+
+Классические поисковики считали вхождения слов в текст. 
+Современные нейросети (SearchGPT, Gemini, Perplexity) считывают **семантические утверждения и факты**. Они ищут лаконичные, точные, проверяемые ответы на вопросы пользователя.
+
+---
+
+## 2. Структура Direct Answer Block (Блок прямого ответа)
+
+Каждый раздел сайта, отвечающий на информационный вопрос, должен начинаться с **блока прямого ответа**:
+
+```html
+<!-- 1. Заголовок — конкретный вопрос пользователя -->
+<h2 id="faq-cost">¿Cuánto cuesta instalar placas solares en una casa en Sevilla?</h2>
+
+<!-- 2. Блок прямого ответа: 40–50 слов, точные цифры, без вводных фраз -->
+<p class="direct-answer">
+  Una instalación estándar de 4 kW (8 paneles solares de alta eficiencia) en Sevilla tiene 
+  un coste medio de <strong>4.200 € a 5.600 €</strong> sin ayudas. Con la bonificación del 50% 
+  del IBI en Sevilla y la deducción de hasta el 40% en el IRPF, el coste neto final se sitúa 
+  entre <strong>2.600 € y 3.300 €</strong>, con un retorno de inversión en 3,8 años.
+</p>
+```
+
+### Почему это работает:
+Нейросеть вырезает этот абзац целиком и вставляет в карточку быстрого ответа (AI Summary), прикрепляя ссылку на наш сайт как на **авторитетный первоисточник**.
+
+---
+
+## 3. Таблицы характеристик и списки (AI-Ready Data)
+
+ИИ парсит таблицы данных в десятки раз быстрее, чем сплошной текст:
+
+```html
+<table class="ai-data-table">
+  <thead>
+    <tr>
+      <th>Modelo</th>
+      <th>Potencia</th>
+      <th>Eficiencia</th>
+      <th>Garantía</th>
+      <th>Precio estimado</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Panel Monocristalino N-Type</td>
+      <td>450 W</td>
+      <td>22,5 %</td>
+      <td>25 años</td>
+      <td>139 €</td>
+    </tr>
+  </tbody>
+</table>
+```
+
+---
+
+## 4. Ссылки на законы и государственные бюллетени Испании
+
+Для закрепления статуса доверия в контенте всегда указываются ссылки на первоисточники:
+* **RD 244/2019** — закон Испании о компенсации излишков и коллективном потреблении;
+* **BOE (Boletín Oficial del Estado)** — регламент налоговых вычетов IRPF;
+* **Plan MOVES III** — государственная субсидия на зарядные станции для электрокаров.

package/04-seo-ai-optimization/GOOGLE-LOCAL-EEAT.md

@@ -0,0 +1,41 @@
+# 04-SEO · Google Local Pack, E-E-A-T & Behavioral Signals
+
+> Главные драйверы бесплатного органического трафика без закупки рекламных ссылок.
+
+---
+
+## 1. Google Local Pack (Карты как генератор 50% заявок в Испании)
+
+В сфере монтажа и инжиниринга в Испании половина клиентов выбирает компанию на **Google Maps**:
+
+### Факторы ранжирования в Local 3-Pack:
+1. **Синхронизация NAP (Name, Address, Phone):**
+   Название, физический адрес в Севилье/Камасе и номер телефона на сайте в `Schema.org/LocalBusiness` должны совпадать **символ-в-символ** с профилем компании в **Google Business Profile**.
+2. **Живые отзывы:**
+   Регулярное пополнение отзывов от реальных клиентов с прикрепленными фотографиями установленных панелей на крышах.
+3. **Гео-привязка сервисных зон:**
+   В коде страницы и в микроразметке четко указываются города обслуживания: `Sevilla`, `Málaga`, `Marbella`, `Cádiz`, `Estepona`.
+
+---
+
+## 2. Стандарты E-E-A-T (Опыт, Экспертность, Авторитет, Доверие)
+
+Поскольку покупка солнечной электростанции стоит 4 000 – 15 000 €, Google применяет жесткие алгоритмы оценки надежности (YMYL):
+
+* **Юридические реквизиты:** Размещение CIF компании (`HELIONIX ENERGY SLU`), номера в торговом реестре Испании, юридического и фактического адреса.
+* **Сертификации монтажников:** Упоминание допусков электромонтажников категории especialista в Андалусии.
+* **Официальные партнерства:** Логотипы и упоминание статуса установщика брендов: V2C, Livoltek, Huawei, GoodWe, Canadian Solar.
+
+---
+
+## 3. Поведенческие сигналы (Dwell Time и закрытие интента)
+
+Алгоритм Google RankBrain оценивает реакцию пользователей:
+
+1. **Мгновенный отклик (FCP < 0.4s):**
+   Человек кликает по ссылке и сразу видит контент. Нет белого экрана — отказ минимальный.
+2. **Вовлечение через интерактив (High Dwell Time):**
+   Интерактивный калькулятор заставляет пользователя провести на странице **3–5 минут** (двигает ползунок, выбирает аккумулятор, смотрит график окупаемости).
+3. **Отсутствие возврата в поиск (Zero Pogo-Sticking):**
+   Клиент нажимает кнопку перехода в WhatsApp или скачивает PDF-смету. Его потребность полностью закрыта. Он **не возвращается в поиск Google** продолжать поиски.
+   Для поисковика это доказательство высшего качества страницы: сайт автоматически поднимается на первые позиции.

package/04-seo-ai-optimization/STRUCTURED-DATA.md

@@ -0,0 +1,90 @@
+# 04-SEO · Structured Data & Schema.org Graph
+
+> Машиночитаемая микроразметка JSON-LD: как превратить сайт в структурированную базу данных для поисковых систем.
+
+---
+
+## 1. Единый граф сущностей (`@graph`)
+
+Вместо разрозненных кусочков разметки на странице генерируется единый связанный граф через `@graph`:
+
+```json
+{
+  "@context": "https://schema.org",
+  "@graph": [
+    {
+      "@type": "Organization",
+      "@id": "https://miluzsolar.es/#organization",
+      "name": "Mi Luz Solar",
+      "legalName": "HELIONIX ENERGY SLU",
+      "url": "https://miluzsolar.es",
+      "logo": "https://miluzsolar.es/brand/mi-luz-solar.svg",
+      "email": "info@miluzsolar.es",
+      "address": {
+        "@type": "PostalAddress",
+        "addressLocality": "Camas",
+        "addressRegion": "Sevilla",
+        "addressCountry": "ES"
+      },
+      "areaServed": ["Sevilla", "Málaga", "Cádiz", "Andalucía"]
+    },
+    {
+      "@type": "WebSite",
+      "@id": "https://miluzsolar.es/#website",
+      "url": "https://miluzsolar.es",
+      "name": "Mi Luz Solar",
+      "publisher": { "@id": "https://miluzsolar.es/#organization" },
+      "inLanguage": ["es", "en", "uk"]
+    }
+  ]
+]
+```
+
+---
+
+## 2. Разметка товаров для каталога (`Product` + `Offer`)
+
+Позволяет Google выводить цены, плашку «В наличии» и рейтинг прямо в поисковой выдаче:
+
+```json
+{
+  "@type": "Product",
+  "name": "V2C Trydan e-Charger 7.4 kW",
+  "image": "https://miluzsolar.es/images/p/v2c-trydan.webp",
+  "description": "Cargador inteligente para coche eléctrico con integración fotovoltaica y carga por excedentes solares.",
+  "brand": {
+    "@type": "Brand",
+    "name": "V2C"
+  },
+  "offers": {
+    "@type": "Offer",
+    "price": "782.40",
+    "priceCurrency": "EUR",
+    "priceValidUntil": "2026-12-31",
+    "availability": "https://schema.org/InStock",
+    "seller": { "@id": "https://miluzsolar.es/#organization" }
+  }
+}
+```
+
+---
+
+## 3. Разметка FAQ (`FAQPage`)
+
+Гарантирует появление выпадающих вопросов и ответов прямо в результатах поиска Google:
+
+```json
+{
+  "@type": "FAQPage",
+  "mainEntity": [
+    {
+      "@type": "Question",
+      "name": "¿Cuánto se tarda en instalar las placas solares?",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "La instalación física en una vivienda unifamiliar se realiza habitualmente en 24 a 48 horas. La legalización completa y gestión de excedentes toma entre 2 y 4 semanas."
+      }
+    }
+  ]
+}
+```

package/05-internationalization/I18N-ARCHITECTURE.md

@@ -0,0 +1,57 @@
+# 05-Internationalization · Single Hub & Instant Language Scaling
+
+> Единая архитектура локализации: как добавлять новые языки (es, en, uk, de, fr, it) за 2 минуты без раскидывания переводов по проекту.
+
+---
+
+## 1. Архитектурный принцип: Single Hub (Единый хаб)
+
+❌ **Как делать НЕЛЬЗЯ:**
+Хранить тексты в разных местах: часть в `i18n/`, часть в объектах `L(es, en, uk)` внутри компонентов, часть жестко зашитой в шаблонах.
+
+✅ **Как устроено в DS7:**
+Все системные строки интерфейса хранятся **строго в одном месте**:
+```
+i18n/
+└── locales/
+    ├── es.ts    # Испанский (базовый)
+    ├── en.ts    # Английский
+    ├── uk.ts    # Украинский
+    ├── de.ts    # Немецкий (новый)
+    └── fr.ts    # Французский (новый)
+```
+
+---
+
+## 2. Как добавить новый язык за 2 минуты:
+
+### Шаг 1: Добавить файл перевода
+Скопируйте `es.ts` в `de.ts` и переведите значения ключей.
+
+### Шаг 2: Зарегистрировать язык в `nuxt.config.ts`:
+```ts
+// nuxt.config.ts
+i18n: {
+  strategy: 'prefix_except_default',
+  defaultLocale: 'es',
+  locales: [
+    { code: 'es', language: 'es-ES', name: 'Español', file: 'es.ts' },
+    { code: 'en', language: 'en-GB', name: 'English', file: 'en.ts' },
+    { code: 'uk', language: 'uk-UA', name: 'Українська', file: 'uk.ts' },
+    { code: 'de', language: 'de-DE', name: 'Deutsch', file: 'de.ts' } // <-- Добавлена одна строчка!
+  ],
+  langDir: '../i18n/locales'
+}
+```
+
+Все маршруты (`/de`, `/de/hogares`, `/de/tienda`), переключатели в шапке, hreflang теги и sitemap для нового языка сгенерируются автоматически!
+
+---
+
+## 3. Четкое разделение: UI-строки vs Бизнес-данные
+
+* **`i18n/locales/*.ts`** — отвечает **только за интерфейсные строки**:
+  Названия кнопок («Contactar», «Calcular mi ahorro»), подписи форм, элементы навигации, системные сообщения об ошибках.
+* **`app/data/*.ts`** — отвечает **за бизнес-данные и каталог**:
+  Список товаров, технические характеристики, список городов, база статей блога.
+* **Типизация:** Данные из `app/data/` проверяются TypeScript-интерфейсами. Если пропущен перевод на один из языков, компилятор не пропустит билд в продакшн.

package/05-internationalization/LOCALE-TEMPLATE.json

@@ -0,0 +1,32 @@
+{
+  "nav": {
+    "home": "Inicio",
+    "residential": "Hogares",
+    "business": "Empresas",
+    "mobility": "Movilidad",
+    "equipment": "Equipamiento",
+    "service": "Mantenimiento",
+    "contact": "Contactar"
+  },
+  "common": {
+    "viewProduct": "Ver producto",
+    "requestQuote": "Pedir presupuesto",
+    "calculate": "Calcular ahorro",
+    "fromPrice": "desde",
+    "close": "Cerrar",
+    "send": "Enviar",
+    "success": "Solicitud enviada correctamente"
+  },
+  "calc": {
+    "title": "Calcula tu ahorro solar",
+    "billLabel": "¿Cuánto pagas de luz al mes?",
+    "yearlySavings": "Ahorro anual estimado",
+    "recommendedPower": "Potencia recomendada",
+    "paybackTime": "Amortización estimada"
+  },
+  "badges": {
+    "top": "TOP Ventas",
+    "new": "Novedad",
+    "sale": "Oferta"
+  }
+}

package/06-business-conversion/B2C-B2B-MODELS.md

@@ -0,0 +1,36 @@
+# 06-Business · B2C, B2B & B2A Business Models
+
+> Современные финансовые и коммерческие модели в солнечной энергетике Испании (2025–2026).
+
+---
+
+## 1. B2C (Hogares / Частные дома)
+
+### «Batería Virtual» (Виртуальный аккумулятор) и Factura 0,00 €
+* В солнечные месяцы (май–сентябрь) в Андалусии панели производят больше, чем потребляет дом.
+* Излишки отправляются в сеть, а энергокомпания (Octopus, Repsol, Próxima) начисляет евро на виртуальный счет;
+* Зимой эти накопленные евро списываются в счет оплаты ночного электричества.
+* **Результат для клиента:** Круглогодичный счет **0,00 € в фактуре**.
+
+### Comunidades Energéticas (RD 244/2019)
+* По закону Испании панели на одной крыше могут распределять электричество между соседними домами в радиусе до 2 км;
+* Предложение для урбанизаций и таунхаусов (adosados): совместная установка одной мощной станции со скидкой до 35% для каждого соседа.
+
+---
+
+## 2. B2B (Empresas / Предприятия и фабрики)
+
+### Модель PPA (Power Purchase Agreement / 0€ Inversión)
+* Главная проблема директоров компаний: нежелание тратить 50 000 – 100 000 € оборотных средств;
+* **Решение PPA:** Инвестор или Mi Luz Solar устанавливает электростанцию на крыше предприятия **за 0 € капиталовложений**.
+* Предприятие просто покупает чистую энергию со своей же крыши по фиксированной низкой ставке (например, 0.08 €/кВт·ч вместо 0.19 €/кВт·ч из сети), экономя сотни тысяч евро.
+
+### Solar Carports (Солнечные навесы для парковок)
+* Навесы из панелей над открытыми парковками отелей, складов, гипермаркетов и спорткомплексов;
+* Тень для автомобилей клиентов от андалузского солнца + встроенные зарядные станции V2C для сотрудников и автопарка.
+
+---
+
+## 3. B2A (Comunidades de Propietarios и Госсектор)
+
+* Программы энергоэффективности Next Generation EU субсидируют до **60%** затрат на установку солнечных панелей на крышах многоквартирных домов для питания лифтов, гаражей и освещения подъездов.

package/06-business-conversion/CONTEXTUAL-LEADS.md

@@ -0,0 +1,50 @@
+# 06-Business · Contextual Leads, WhatsApp Deep-Link & PDF Proposals
+
+> Как конвертировать посетителей в квалифицированные заявки с максимальным закрытием в продажу.
+
+---
+
+## 1. Персонализированный WhatsApp Deep-Link
+
+Обычная ссылка `wa.me/34613050156` заставляет пользователя самостоятельно придумывать текст. В 40% случаев он закрывает вкладку.
+
+### Стандарт DS7:
+При клике на любую кнопку связи («Consultar en WhatsApp», «Pedir estudio») скрипт формирует динамическую ссылку с **полным контекстом расчета**:
+
+```ts
+const generateWhatsAppLink = (context: {
+  page: string
+  monthlyBill?: number
+  powerKw?: number
+  productId?: string
+}) => {
+  const phone = '34613050156'
+  let text = '¡Hola Mi Luz Solar! '
+  if (context.monthlyBill) {
+    text += `He calculado una instalación para mi factura de ${context.monthlyBill} €/mes (aprox. ${context.powerKw} kW). `
+  }
+  if (context.productId) {
+    text += `Me interesa el equipo: ${context.productId}. `
+  }
+  text += '¿Podríais confirmarme la disponibilidad y subvenciones aplicables?'
+
+  return `https://wa.me/${phone}?text=${encodeURIComponent(text)}`
+}
+```
+
+Клиент открывает WhatsApp — сообщение уже написано за него. Ему остается нажать кнопку «Отправить». Менеджер сразу видит параметры и моментально закрывает сделку.
+
+---
+
+## 2. Мгновенная генерация PDF-сметы в браузере
+
+* После работы с калькулятором пользователю предлагается: **«Descargar propuesta técnica preliminar (PDF)»**;
+* Прямо в браузере за 1 секунду формируется брендированный PDF с графиком окупаемости, перечнем оборудования и контактами;
+* Условие получения — ввод телефона или email;
+* Конверсия возрастает в 2–3 раза по сравнению с обычной формой обратного звонка.
+
+---
+
+## 3. Оффлайн-очередь заявок (Offline Lead Queue)
+
+При кратковременном обрыве мобильного интернета форма не выдает красную ошибку. Данные сохраняются в `IndexedDB / localStorage` и автоматически отправляются на сервер сразу при восстановлении сетевого соединения. Ни один лид не теряется.

package/06-business-conversion/EV-SOLAR-ECOSYSTEM.md

@@ -0,0 +1,38 @@
+# 06-Business · EV & Solar Ecosystem (V2C, V2H, Plan MOVES III)
+
+> Современная связка солнечной энергетики и электромобильности. Как продавать умные зарядные станции и станции самопотребления.
+
+---
+
+## 1. Зарядка от излишков солнца (100% Solar Surplus)
+
+Станции испанского производителя **V2C Trydan** — якорный продукт для направления `Movilidad`:
+* **Принцип:** Станция связывается по Wi-Fi с инвертором (Huawei, Livoltek, GoodWe). Если дом потребляет 1 кВт, а панели генерируют 5 кВт, оставшиеся 4 кВт излишка автоматически направляются в батарею автомобиля.
+* **Выгода:** Машина заряжается **чистой бесплатной энергией солнца (0 € расходов)**, не покупая ни одного кВт·ч из сети.
+
+---
+
+## 2. Метрика «Солнечный километр»
+
+Клиентам тяжело воспринимать абстрактные технические показатели (кВт, амперы, вольты).
+В интерфейсе все формулы переводятся в **километры бесплатной езды**:
+* *«6 солнечных панелей на крыше = 45 км бесплатного ежедневного пробега»*.
+* *«Экономия на заправке автомобиля: более 180 € в месяц по сравнению с бензином»*.
+
+---
+
+## 3. V2H (Vehicle-to-Home) — Электромобиль как аккумулятор дома
+
+* Обычная домашняя батарея (например, 5 кВт·ч) стоит около 3 000 €.
+* Батарея современного электромобиля — **60–80 кВт·ч** (в 12–15 раз больше!).
+* Технология V2H позволяет использовать емкость электромобиля для питания дома в вечерние часы пиковых тарифов или при аварийных отключениях электросети.
+
+---
+
+## 4. Субсидии Plan MOVES III (Возврат до 70–80%)
+
+Государственная программа Испании компенсирует большую часть стоимости зарядной станции и ее монтажа:
+* В карточках товаров V2C всегда выводятся две цены:
+  * Базовая цена оборудования;
+  * **Финальная цена после субсидии Plan MOVES III** (`782 € → 234 €`).
+* Это снимает ценовые возражения и стимулирует покупку комплекта «Панели + Зарядка».

package/07-testing/TESTING-STRATEGY.md

@@ -0,0 +1,133 @@
+# DS7 · 07 — Targeted Testing Strategy
+
+> **Принцип:** Запускай минимально достаточный тест — не весь suite.  
+> Полный прогон — только перед PR/деплоем. Ежедневная разработка — точечные проверки.
+
+---
+
+## Иерархия тестов (от быстрого к медленному)
+
+```
+1. Unit (domain logic)      ~10ms/test    → запускать всегда при изменении логики
+2. Composable (Vue reactive) ~50ms/test   → при изменении composable
+3. Component (Vue TU)        ~200ms/test  → при изменении компонента
+4. E2E / Playwright          ~5s/flow     → только критичные пути, перед релизом
+```
+
+---
+
+## Инструменты
+
+| Инструмент | Назначение |
+|---|---|
+| **Vitest** | Unit + composable + component тесты |
+| **@vue/test-utils** | Маунт Vue-компонентов без браузера |
+| **Playwright** | E2E (checkout, calculator flow, 404) |
+
+---
+
+## Команды — точечные запуски
+
+```bash
+# Один файл
+npx vitest run app/domain/calculators/residential.test.ts
+
+# Одна папка
+npx vitest run app/domain/calculators/
+
+# По имени теста
+npx vitest run -t "savings calculator"
+
+# Минимальный вывод (экономит токены в AI-диалоге)
+npx vitest run --reporter=dot
+
+# Полный suite — только перед коммитом
+npx vitest run
+
+# Watch (только при локальной разработке)
+npx vitest --reporter=dot
+```
+
+---
+
+## Правила именования тестов
+
+```typescript
+// ✅ Описательное: что тестируем + ожидаемый результат
+it('calculates savings with 30% self-consumption correctly', () => { ... })
+
+// ❌ Слабое: непонятно что ломается
+it('works', () => { ... })
+```
+
+---
+
+## Структура тест-файла
+
+```typescript
+// app/domain/calculators/residential.test.ts
+
+import { describe, it, expect } from 'vitest'
+import { calcSavings } from './residential'
+
+// Self-contained: тест запускается изолированно без глобального setup
+describe('calcSavings', () => {
+  it('returns zero savings for zero consumption', () => {
+    expect(calcSavings({ kwhMonth: 0, panelKw: 5, tariff: 0.18 })).toBe(0)
+  })
+
+  it('caps savings at 100% of bill', () => {
+    const r = calcSavings({ kwhMonth: 100, panelKw: 20, tariff: 0.18 })
+    expect(r.savingsPct).toBeLessThanOrEqual(100)
+  })
+})
+```
+
+---
+
+## Правила тестового покрытия
+
+| Слой | Покрытие | Инструмент |
+|---|---|---|
+| `domain/calculators/` | **≥ 90%** | Vitest unit |
+| `composables/` | **≥ 70%** | Vitest + @vue/test-utils |
+| `components/ui/` | **критичные пути** | @vue/test-utils |
+| `pages/` | **smoke только** | Playwright |
+
+> **Не тестировать:** статичные данные (`app/data/`), CSS, переводы (i18n) — их не нужно юнит-тестировать.
+
+---
+
+## Стратегия для AI-агентов (экономия токенов)
+
+1. **Перед правкой** — запусти только тест изменяемого файла
+2. **После правки** — снова только этот тест (`--reporter=dot`)
+3. **Расширяй scope** только если изменение затронуло shared logic
+4. **Полный suite** — один раз в конце задачи, не в каждой итерации
+
+```bash
+# Шаблон для AI-итерации (минимум токенов):
+npx vitest run path/to/changed.test.ts --reporter=dot
+```
+
+---
+
+## Vitest Config (рекомендуемый минимум)
+
+```typescript
+// vitest.config.ts
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    environment: 'jsdom',
+    include: ['**/*.test.ts'],
+    exclude: ['node_modules', 'ds7', 'dist'],
+    reporter: process.env.CI ? 'verbose' : 'dot',  // dot = меньше вывода
+    coverage: {
+      include: ['app/domain/**', 'app/composables/**'],
+      reporter: ['text-summary'],  // краткий отчёт, не таблицы
+    },
+  },
+})
+```