@ai.all/ds7 1.0.0 → 2.0.0

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

@@ -1,70 +1,53 @@
-# 04-SEO · AEO & GEO: Optimization for AI Search Engines
+# 04 · AEO and GEO: writing for AI search engines
 
-> Answer Engine Optimization (AEO) и Generative Engine Optimization (GEO): как сделать сайт источником цитирования для Perplexity, SearchGPT, Claude и Google Gemini Overviews.
+Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO) make a site easy to quote in AI answers: ChatGPT search, Perplexity, Gemini overviews and similar systems.
 
 ---
 
-## 1. Смена парадигмы: от «Ключевых слов» к «Фактической плотности»
+## 1. What changed
 
-Классические поисковики считали вхождения слов в текст. 
-Современные нейросети (SearchGPT, Gemini, Perplexity) считывают **семантические утверждения и факты**. Они ищут лаконичные, точные, проверяемые ответы на вопросы пользователя.
+Classic search matched words. AI search extracts **claims and facts** that answer a question, then cites the source. Pages that state a question, answer it in a few precise sentences, and back it with structured data are quoted more often.
 
 ---
 
-## 2. Структура Direct Answer Block (Блок прямого ответа)
+## 2. Direct answer block
 
-Каждый раздел сайта, отвечающий на информационный вопрос, должен начинаться с **блока прямого ответа**:
+Each informational section begins with its question as an `h2` and a short factual answer of 40–50 words:
 
 ```html
-<!-- 1. Заголовок — конкретный вопрос пользователя -->
-<h2 id="faq-cost">¿Cuánto cuesta instalar placas solares en una casa en Sevilla?</h2>
+<h2 id="cost-4kw">How much does a 4 kW home solar system cost?</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.
+  A standard 4 kW system costs <strong>[range from your price list]</strong> before grants.
+  Replace the placeholder with a figure you can source, and state the date and the region.
 </p>
 ```
 
-### Почему это работает:
-Нейросеть вырезает этот абзац целиком и вставляет в карточку быстрого ответа (AI Summary), прикрепляя ссылку на наш сайт как на **авторитетный первоисточник**.
+Rules for the answer:
+- No introduction ("Great question…"). The first words answer the question.
+- Numbers come with units, a date and a region.
+- Every figure has a source in the page or in linked official documents.
 
 ---
 
-## 3. Таблицы характеристик и списки (AI-Ready Data)
+## 3. Tables for comparisons
 
-ИИ парсит таблицы данных в десятки раз быстрее, чем сплошной текст:
+Assistants parse tables faster than prose. Use real `<table>` markup with `<thead>`:
 
-```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>
-```
+| Model | Power | Efficiency | Warranty |
+|---|---|---|---|
+| [example] | [value] | [value] | [value] |
+
+Fill in values from your product data, not from this example.
+
+---
+
+## 4. Sources
+
+Name primary sources: the law, the official gazette, the grant programme page. Link them. A claim with a link to the regulation is quoted more often than one without.
 
 ---
 
-## 4. Ссылки на законы и государственные бюллетени Испании
+## 5. Measurement
 
-Для закрепления статуса доверия в контенте всегда указываются ссылки на первоисточники:
-* **RD 244/2019** — закон Испании о компенсации излишков и коллективном потреблении;
-* **BOE (Boletín Oficial del Estado)** — регламент налоговых вычетов IRPF;
-* **Plan MOVES III** — государственная субсидия на зарядные станции для электрокаров.
+Track which pages appear in AI answers with a manual check each month, and record it in the project's `docs/METRICS.md`. Do not record a figure you did not observe.

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

@@ -1,41 +1,36 @@
-# 04-SEO · Google Local Pack, E-E-A-T & Behavioral Signals
+# 04 · Local search, E-E-A-T and behavioural signals
 
-> Главные драйверы бесплатного органического трафика без закупки рекламных ссылок.
+For businesses that serve a region, most new customers find them through a map listing. This document lists what the site controls.
 
 ---
 
-## 1. Google Local Pack (Карты как генератор 50% заявок в Испании)
+## 1. Local pack
 
-В сфере монтажа и инжиниринга в Испании половина клиентов выбирает компанию на **Google Maps**:
+Google's local results use the business profile and the website together.
 
-### Факторы ранжирования в Local 3-Pack:
-1. **Синхронизация NAP (Name, Address, Phone):**
-   Название, физический адрес в Севилье/Камасе и номер телефона на сайте в `Schema.org/LocalBusiness` должны совпадать **символ-в-символ** с профилем компании в **Google Business Profile**.
-2. **Живые отзывы:**
-   Регулярное пополнение отзывов от реальных клиентов с прикрепленными фотографиями установленных панелей на крышах.
-3. **Гео-привязка сервисных зон:**
-   В коде страницы и в микроразметке четко указываются города обслуживания: `Sevilla`, `Málaga`, `Marbella`, `Cádiz`, `Estepona`.
+1. **NAP consistency.** Name, address and phone are identical on the website, in `LocalBusiness` structured data and in the business profile. Same spelling, same format.
+2. **Reviews.** Real customer reviews, requested after each job. Do not write reviews for customers and do not ask for reviews only from happy customers.
+3. **Service areas.** The towns or regions served are listed in the page content and in the structured data (`areaServed`).
 
 ---
 
-## 2. Стандарты E-E-A-T (Опыт, Экспертность, Авторитет, Доверие)
+## 2. E-E-A-T
 
-Поскольку покупка солнечной электростанции стоит 4 000 – 15 000 €, Google применяет жесткие алгоритмы оценки надежности (YMYL):
+Google rates the trustworthiness of pages that affect money or safety more strictly.
 
-* **Юридические реквизиты:** Размещение CIF компании (`HELIONIX ENERGY SLU`), номера в торговом реестре Испании, юридического и фактического адреса.
-* **Сертификации монтажников:** Упоминание допусков электромонтажников категории especialista в Андалусии.
-* **Официальные партнерства:** Логотипы и упоминание статуса установщика брендов: V2C, Livoltek, Huawei, GoodWe, Canadian Solar.
+- **Legal identity:** full legal name, company registration number, registered address. Shown in the footer and on a legal page.
+- **Qualifications:** the licences and certifications the staff hold, with the issuing body named.
+- **Partnerships:** only partner logos the business is authorised to use, with a link to the partner's confirmation where one exists.
+- **Named authors** for guides, with their role.
+
+Placeholders in this standard (`[Legal name]`, `[Registration number]`) must be replaced with real data by the business.
 
 ---
 
-## 3. Поведенческие сигналы (Dwell Time и закрытие интента)
+## 3. Behavioural signals
 
-Алгоритм Google RankBrain оценивает реакцию пользователей:
+Google observes what visitors do after a result.
 
-1. **Мгновенный отклик (FCP < 0.4s):**
-   Человек кликает по ссылке и сразу видит контент. Нет белого экрана — отказ минимальный.
-2. **Вовлечение через интерактив (High Dwell Time):**
-   Интерактивный калькулятор заставляет пользователя провести на странице **3–5 минут** (двигает ползунок, выбирает аккумулятор, смотрит график окупаемости).
-3. **Отсутствие возврата в поиск (Zero Pogo-Sticking):**
-   Клиент нажимает кнопку перехода в WhatsApp или скачивает PDF-смету. Его потребность полностью закрыта. Он **не возвращается в поиск Google** продолжать поиски.
-   Для поисковика это доказательство высшего качества страницы: сайт автоматически поднимается на первые позиции.
+- **Fast first content.** A visitor who sees content at once stays. See `03-performance-web-vitals/`.
+- **Useful interaction.** A calculator or configurator keeps a visitor on the page to finish a task.
+- **Completed intent.** A visitor who reaches the contact action or downloads what they came for does not need to search again. Design the contact action to be the obvious next step.

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

@@ -1,12 +1,12 @@
-# 04-SEO · Structured Data & Schema.org Graph
+# 04 · Structured data (Schema.org JSON-LD)
 
-> Машиночитаемая микроразметка JSON-LD: как превратить сайт в структурированную базу данных для поисковых систем.
+Structured data is a machine-readable description of the business, its products and its pages. Search engines and AI assistants use it to identify entities and to show rich results.
 
 ---
 
-## 1. Единый граф сущностей (`@graph`)
+## 1. One graph per site
 
-Вместо разрозненных кусочков разметки на странице генерируется единый связанный граф через `@graph`:
+Describe all entities in a single `@graph` that links them by `@id`, instead of scattered fragments:
 
 ```json
 {
@@ -14,64 +14,61 @@
   "@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",
+      "@id": "https://example.com/#organization",
+      "name": "[Brand name]",
+      "legalName": "[Legal name]",
+      "url": "https://example.com",
+      "logo": "https://example.com/brand/logo.svg",
+      "email": "[contact email]",
       "address": {
         "@type": "PostalAddress",
-        "addressLocality": "Camas",
-        "addressRegion": "Sevilla",
-        "addressCountry": "ES"
+        "addressLocality": "[City]",
+        "addressRegion": "[Region]",
+        "addressCountry": "[ISO country code]"
       },
-      "areaServed": ["Sevilla", "Málaga", "Cádiz", "Andalucía"]
+      "areaServed": ["[Region 1]", "[Region 2]"]
     },
     {
       "@type": "WebSite",
-      "@id": "https://miluzsolar.es/#website",
-      "url": "https://miluzsolar.es",
-      "name": "Mi Luz Solar",
-      "publisher": { "@id": "https://miluzsolar.es/#organization" },
+      "@id": "https://example.com/#website",
+      "url": "https://example.com",
+      "name": "[Brand name]",
+      "publisher": { "@id": "https://example.com/#organization" },
       "inLanguage": ["es", "en", "uk"]
     }
   ]
-]
+}
 ```
 
----
+Name, address and phone must match the business profile exactly (see `GOOGLE-LOCAL-EEAT.md`).
 
-## 2. Разметка товаров для каталога (`Product` + `Offer`)
+---
 
-Позволяет Google выводить цены, плашку «В наличии» и рейтинг прямо в поисковой выдаче:
+## 2. Products and offers
 
 ```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"
-  },
+  "name": "[Product name]",
+  "image": "https://example.com/images/p/product.webp",
+  "description": "[One factual sentence]",
+  "brand": { "@type": "Brand", "name": "[Brand]" },
   "offers": {
     "@type": "Offer",
-    "price": "782.40",
+    "price": "[price]",
     "priceCurrency": "EUR",
-    "priceValidUntil": "2026-12-31",
+    "priceValidUntil": "[date the price is valid until]",
     "availability": "https://schema.org/InStock",
-    "seller": { "@id": "https://miluzsolar.es/#organization" }
+    "seller": { "@id": "https://example.com/#organization" }
   }
 }
 ```
 
----
+Only publish a price that is current on the page. Update `priceValidUntil` when you update the price.
 
-## 3. Разметка FAQ (`FAQPage`)
+---
 
-Гарантирует появление выпадающих вопросов и ответов прямо в результатах поиска Google:
+## 3. FAQ
 
 ```json
 {
@@ -79,12 +76,20 @@
   "mainEntity": [
     {
       "@type": "Question",
-      "name": "¿Cuánto se tarda en instalar las placas solares?",
+      "name": "[Question as the visitor asks it]",
       "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."
+        "text": "[The same answer as on the page]"
       }
     }
   ]
 }
 ```
+
+The FAQ text in structured data must match the visible text on the page.
+
+---
+
+## 4. Validation
+
+Check every page with a structured-data validator before release. A validator error counts as a failed gate.

package/05-internationalization/I18N-ARCHITECTURE.md

@@ -1,34 +1,31 @@
-# 05-Internationalization · Single Hub & Instant Language Scaling
+# 05 · Internationalisation: one hub
 
-> Единая архитектура локализации: как добавлять новые языки (es, en, uk, de, fr, it) за 2 минуты без раскидывания переводов по проекту.
+All interface text lives in one place. Adding a language is one file and one configuration entry.
 
 ---
 
-## 1. Архитектурный принцип: Single Hub (Единый хаб)
+## 1. Principle
 
-❌ **Как делать НЕЛЬЗЯ:**
-Хранить тексты в разных местах: часть в `i18n/`, часть в объектах `L(es, en, uk)` внутри компонентов, часть жестко зашитой в шаблонах.
+Do not keep text in several places: partly in `i18n/`, partly in inline `{ es, en }` objects inside components, partly typed into templates.
+
+Structure:
 
-✅ **Как устроено в DS7:**
-Все системные строки интерфейса хранятся **строго в одном месте**:
 ```
 i18n/
 └── locales/
-    ├── es.ts    # Испанский (базовый)
-    ├── en.ts    # Английский
-    ├── uk.ts    # Украинский
-    ├── de.ts    # Немецкий (новый)
-    └── fr.ts    # Французский (новый)
+    ├── es.ts      # base language
+    ├── en.ts
+    ├── uk.ts
+    └── [code].ts  # any new language
 ```
 
 ---
 
-## 2. Как добавить новый язык за 2 минуты:
+## 2. Adding a language
 
-### Шаг 1: Добавить файл перевода
-Скопируйте `es.ts` в `de.ts` и переведите значения ключей.
+1. Copy the base locale file to `[code].ts` and translate every value. Keys stay the same.
+2. Register the language:
 
-### Шаг 2: Зарегистрировать язык в `nuxt.config.ts`:
 ```ts
 // nuxt.config.ts
 i18n: {
@@ -38,20 +35,25 @@ i18n: {
     { 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' } // <-- Добавлена одна строчка!
+    { code: '[code]', language: '[bcp47]', name: '[name]', file: '[code].ts' },
   ],
-  langDir: '../i18n/locales'
+  langDir: '../i18n/locales',
 }
 ```
 
-Все маршруты (`/de`, `/de/hogares`, `/de/tienda`), переключатели в шапке, hreflang теги и sitemap для нового языка сгенерируются автоматически!
+Routes, language switcher, `hreflang` and sitemap entries for the new language are generated from this list.
+
+---
+
+## 3. Keys
+
+- Grouped by component or section: `businessScreens.night.title`.
+- Named by meaning, never by appearance (`hero.title`, not `big.red.title`).
+- The same key set in every locale. The parity check fails the build when a key is missing.
 
 ---
 
-## 3. Четкое разделение: UI-строки vs Бизнес-данные
+## 4. UI strings versus business data
 
-* **`i18n/locales/*.ts`** — отвечает **только за интерфейсные строки**:
-  Названия кнопок («Contactar», «Calcular mi ahorro»), подписи форм, элементы навигации, системные сообщения об ошибках.
-* **`app/data/*.ts`** — отвечает **за бизнес-данные и каталог**:
-  Список товаров, технические характеристики, список городов, база статей блога.
-* **Типизация:** Данные из `app/data/` проверяются TypeScript-интерфейсами. Если пропущен перевод на один из языков, компилятор не пропустит билд в продакшн.
+- `i18n/locales/*.ts`: interface text only. Button labels, form labels, navigation, error messages.
+- `app/data/*.ts`: business data. Products, specifications, service areas, articles. Typed. Text fields that differ by language use an object keyed by locale, validated by the schema, so a missing translation breaks the build.

package/05-internationalization/LOCALE-TEMPLATE.json

@@ -1,32 +1,33 @@
 {
+  "_comment": "Locale template. Copy to i18n/locales/<code>.ts in your project and translate every value. Keys must match the base locale exactly.",
   "nav": {
-    "home": "Inicio",
-    "residential": "Hogares",
-    "business": "Empresas",
-    "mobility": "Movilidad",
-    "equipment": "Equipamiento",
-    "service": "Mantenimiento",
-    "contact": "Contactar"
+    "home": "Home",
+    "residential": "Residential",
+    "business": "Business",
+    "mobility": "Mobility",
+    "equipment": "Equipment",
+    "service": "Service",
+    "contact": "Contact"
   },
   "common": {
-    "viewProduct": "Ver producto",
-    "requestQuote": "Pedir presupuesto",
-    "calculate": "Calcular ahorro",
-    "fromPrice": "desde",
-    "close": "Cerrar",
-    "send": "Enviar",
-    "success": "Solicitud enviada correctamente"
+    "viewProduct": "View product",
+    "requestQuote": "Request a quote",
+    "calculate": "Calculate savings",
+    "fromPrice": "from",
+    "close": "Close",
+    "send": "Send",
+    "success": "Your request was sent"
   },
   "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"
+    "title": "Calculate your solar savings",
+    "billLabel": "How much do you pay for electricity per month?",
+    "yearlySavings": "Estimated yearly savings",
+    "recommendedPower": "Recommended capacity",
+    "paybackTime": "Estimated payback period"
   },
   "badges": {
-    "top": "TOP Ventas",
-    "new": "Novedad",
-    "sale": "Oferta"
+    "top": "Best seller",
+    "new": "New",
+    "sale": "Offer"
   }
 }

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

@@ -1,36 +1,37 @@
-# 06-Business · B2C, B2B & B2A Business Models
+# 06 · Commercial models for energy projects (example)
 
-> Современные финансовые и коммерческие модели в солнечной энергетике Испании (2025–2026).
+> Example document from a Spanish solar company, 2025–2026. Market rules, subsidies and prices change. Verify every figure against current official sources before use.
 
 ---
 
-## 1. B2C (Hogares / Частные дома)
+## 1. Residential (B2C)
 
-### «Batería Virtual» (Виртуальный аккумулятор) и Factura 0,00 €
-* В солнечные месяцы (май–сентябрь) в Андалусии панели производят больше, чем потребляет дом.
-* Излишки отправляются в сеть, а энергокомпания (Octopus, Repsol, Próxima) начисляет евро на виртуальный счет;
-* Зимой эти накопленные евро списываются в счет оплаты ночного электричества.
-* **Результат для клиента:** Круглогодичный счет **0,00 € в фактуре**.
+**Virtual battery.** In sunny months a home system produces more than the household uses. The surplus goes to the grid and is credited on the customer's account. In winter the credit offsets night-time consumption.
 
-### Comunidades Energéticas (RD 244/2019)
-* По закону Испании панели на одной крыше могут распределять электричество между соседними домами в радиусе до 2 км;
-* Предложение для урбанизаций и таунхаусов (adosados): совместная установка одной мощной станции со скидкой до 35% для каждого соседа.
+**Result for the customer:** a bill close to zero over the year, when credits match consumption.
+
+**Energy communities.** Spanish rules (RD 244/2019) allow shared self-consumption between nearby homes. Offer it to terraced houses and communities as a shared installation with a per-home discount.
 
 ---
 
-## 2. B2B (Empresas / Предприятия и фабрики)
+## 2. Business (B2B)
+
+**Power purchase agreement (PPA).** A company that does not want to spend its own capital can have a third party install the system on its roof. The company buys the energy at a fixed rate, below the grid tariff.
+
+Explain the contract length, the rate, the escalation clause and who owns the system at the end. Do not present the rate as a saving without the tariff it is compared to.
+
+**Solar carports.** Panels over car parks for hotels, warehouses and shops. Shade for customers and staff, plus charging points for fleet vehicles.
+
+---
 
-### Модель PPA (Power Purchase Agreement / 0€ Inversión)
-* Главная проблема директоров компаний: нежелание тратить 50 000 – 100 000 € оборотных средств;
-* **Решение PPA:** Инвестор или Mi Luz Solar устанавливает электростанцию на крыше предприятия **за 0 € капиталовложений**.
-* Предприятие просто покупает чистую энергию со своей же крыши по фиксированной низкой ставке (например, 0.08 €/кВт·ч вместо 0.19 €/кВт·ч из сети), экономя сотни тысяч евро.
+## 3. Community and public buildings (B2A)
 
-### Solar Carports (Солнечные навесы для парковок)
-* Навесы из панелей над открытыми парковками отелей, складов, гипермаркетов и спорткомплексов;
-* Тень для автомобилей клиентов от андалузского солнца + встроенные зарядные станции V2C для сотрудников и автопарка.
+Public programmes can fund a large share of installations for shared buildings (lifts, garages, stairwell lighting). The share and the eligibility change by programme and year. State the programme name, the year and the source.
 
 ---
 
-## 3. B2A (Comunidades de Propietarios и Госсектор)
+## 4. Rules for any offer
 
-* Программы энергоэффективности Next Generation EU субсидируют до **60%** затрат на установку солнечных панелей на крышах многоквартирных домов для питания лифтов, гаражей и освещения подъездов.
+- Name the programme, the year and the official source.
+- Show the price before and after any grant as two separate figures.
+- Do not make a promise about a grant that is not yet approved.

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

@@ -1,50 +1,45 @@
-# 06-Business · Contextual Leads, WhatsApp Deep-Link & PDF Proposals
+# 06 · Contextual leads
 
-> Как конвертировать посетителей в квалифицированные заявки с максимальным закрытием в продажу.
+A visitor who has already used a calculator knows what they want. Contact actions should carry that context, so the first message is useful to both sides.
 
 ---
 
-## 1. Персонализированный WhatsApp Deep-Link
+## 1. Contact link with context
 
-Обычная ссылка `wa.me/34613050156` заставляет пользователя самостоятельно придумывать текст. В 40% случаев он закрывает вкладку.
-
-### Стандарт DS7:
-При клике на любую кнопку связи («Consultar en WhatsApp», «Pedir estudio») скрипт формирует динамическую ссылку с **полным контекстом расчета**:
+A plain `wa.me/<number>` link leaves the visitor to write the first message, and many leave. Build the message from the visitor's last action:
 
 ```ts
-const generateWhatsAppLink = (context: {
+const contactLink = (context: {
   page: string
   monthlyBill?: number
   powerKw?: number
   productId?: string
 }) => {
-  const phone = '34613050156'
-  let text = '¡Hola Mi Luz Solar! '
+  const phone = '[international number, digits only]'
+  let text = 'Hello, I would like information. '
   if (context.monthlyBill) {
-    text += `He calculado una instalación para mi factura de ${context.monthlyBill} €/mes (aprox. ${context.powerKw} kW). `
+    text += `My monthly bill is about ${context.monthlyBill} €; the estimate was ${context.powerKw} kW. `
   }
   if (context.productId) {
-    text += `Me interesa el equipo: ${context.productId}. `
+    text += `I am interested in: ${context.productId}. `
   }
-  text += '¿Podríais confirmarme la disponibilidad y subvenciones aplicables?'
-
+  text += 'Could you confirm availability and the grants that apply?'
   return `https://wa.me/${phone}?text=${encodeURIComponent(text)}`
 }
 ```
 
-Клиент открывает WhatsApp — сообщение уже написано за него. Ему остается нажать кнопку «Отправить». Менеджер сразу видит параметры и моментально закрывает сделку.
+The visitor only has to press send. The message is in the visitor's language (from the i18n layer, not hard-coded).
 
 ---
 
-## 2. Мгновенная генерация PDF-сметы в браузере
+## 2. Summary document
 
-* После работы с калькулятором пользователю предлагается: **«Descargar propuesta técnica preliminar (PDF)»**;
-* Прямо в браузере за 1 секунду формируется брендированный PDF с графиком окупаемости, перечнем оборудования и контактами;
-* Условие получения — ввод телефона или email;
-* Конверсия возрастает в 2–3 раза по сравнению с обычной формой обратного звонка.
+After a calculation, offer a summary the visitor can keep: the inputs, the result, the equipment and the contact. Generate it in the browser. Ask for a phone number or email before the download, and say why.
 
 ---
 
-## 3. Оффлайн-очередь заявок (Offline Lead Queue)
+## 3. Offline queue
+
+If the connection drops during a form submission, keep the data in `IndexedDB` (or `localStorage` for very small forms), show a neutral "saved, will be sent" message, and send it when the connection returns. A lead must not be lost because of a dropped connection.
 
-При кратковременном обрыве мобильного интернета форма не выдает красную ошибку. Данные сохраняются в `IndexedDB / localStorage` и автоматически отправляются на сервер сразу при восстановлении сетевого соединения. Ни один лид не теряется.
+Remove stored leads after the server confirms receipt.