diff --git a/frontend-chart-rendering.md b/frontend-chart-rendering.md index 11c4f73..8893ed2 100644 --- a/frontend-chart-rendering.md +++ b/frontend-chart-rendering.md @@ -1,42 +1,124 @@ -## Frontend notes: rendering chart JSON blocks +## Документация для фронтенда: как отображать графики из маркетингового анализа -- Markdown now emits chart data as fenced code blocks with language tags like `json:seasonality`, `json:competitors`, `json:audienceSegmentation`, `json:channelsPotential`, and `json:funnel`. -- Each block is pretty-printed JSON; parse the string inside the fence to feed the relevant chart component. -- Headings stay the same; only tables were replaced by these code fences. +Сервис возвращает данные для графиков в двух местах: -### Expected shapes +- **`report.chartsData`** (объект-словарь ключ → данные графика/таблицы) +- **`report.fullAnalysis`** (markdown-текст), где данные вставлены **инлайн** как fenced-блоки: + - формат: ```json: … ``` -- `seasonality` – object map: `{ "Январь": 70, "Февраль": 60, ... }`. -- `competitors` – array of objects: `{ name, reach, activity, reviews, strengths, weaknesses }`. -- `audienceSegmentation` – object with optional arrays: `ageGroups[]`, `genders[]`, `segments[]`, each item `{ label, value }`. -- `channelsPotential` – array of objects: `{ name, potential, justification }`. -- `funnel` – array of objects: `{ stage, value, conversion }`. +Фронтенд может рендерить графики либо **по `chartsData` (проще)**, либо **инлайн** — парся `fullAnalysis` и заменяя ` ```json:` на React-компоненты. -### Rendering hook (React + react-markdown) +--- -```javascript -components={{ - code({ node, inline, className, children, ...props }) { - const match = /language-(\w+):([\w-]+)/.exec(className || ""); - if (!inline && match && match[1] === "json") { - const chartType = match[2]; - const data = JSON.parse(String(children).replace(/\n$/, "")); - switch (chartType) { - case "seasonality": return ; - case "competitors": return ; - case "audienceSegmentation": return ; - case "channelsPotential": return ; - case "funnel": return ; - default: return
{children}
; - } +### Ключи `json:`, которые нужно поддержать + +#### Chart.js config (рендерить через Chart.js / react-chartjs-2) +- **`seasonality`**: сезонность (Chart.js config) +- **`audienceAge`**: возрастное распределение (Chart.js config) +- **`audienceGender`**: гендерное распределение (Chart.js config) +- **`marketShareChart`**: доли рынка (Chart.js config) +- **`channelsPotential`**: потенциал каналов (Chart.js config) +- **`funnel`**: воронка (Chart.js config) + Примечание: в `chartsData` ключ может быть `conversionFunnel`, но в тексте `fullAnalysis` блок идёт как `json:funnel`. + +#### Таблица (рендерить табличным компонентом) +- **`comparisonTable`**: сравнительная таблица конкурентов (обычно `Array`) + +--- + +### Формат данных для графиков (Chart.js config) + +Ваш пример — это **валидный Chart.js config** (минимально нужные поля: `labels`, `datasets[]`): + +```json +{ + "datasets": [ + { + "data": [25, 30, 20, 25], + "label": "Возрастные группы" } - return {children}; - } -}} + ], + "labels": ["18-24", "25-34", "35-44", "45+"] +} ``` -### Tips +Рендеринг (пример для Bar): +```ts + +``` -- Trim trailing newline before `JSON.parse` to avoid parse errors. -- Keep a safe fallback (`
`) for unknown chart types.
-- If using another markdown renderer, ensure it preserves the code fence language string in a similar `json:` format.
+---
+
+### Инлайн-рендеринг из `fullAnalysis` (React + react-markdown)
+
+Идея: перехватить `code`-блоки, найти `json:`, распарсить JSON и заменить на компонент.
+
+```tsx
+import React from "react";
+import ReactMarkdown from "react-markdown";
+
+function parseInfoString(className?: string) {
+  // react-markdown обычно кладёт info string как className вида:
+  // "language-json:audienceAge" или "language-json:marketShareChart"
+  const m = /language-([^ ]+)/.exec(className || "");
+  if (!m) return null;
+  const raw = m[1]; // "json:audienceAge"
+  const idx = raw.indexOf(":");
+  if (idx === -1) return { lang: raw, key: null };
+  return { lang: raw.slice(0, idx), key: raw.slice(idx + 1) };
+}
+
+export function ReportMarkdown({ markdown }: { markdown: string }) {
+  return (
+    {children};
+
+          const info = parseInfoString(className);
+          if (!info || info.lang !== "json" || !info.key) {
+            return 
{children}
; + } + + const raw = String(children).replace(/\n$/, ""); + let data: any; + try { + data = JSON.parse(raw); + } catch { + return
{children}
; + } + + switch (info.key) { + case "seasonality": + return ; + case "audienceAge": + return ; + case "audienceGender": + return ; + case "marketShareChart": + return ; + case "channelsPotential": + return ; + case "funnel": + return ; + case "comparisonTable": + return ; + default: + return
{children}
; + } + }, + }} + > + {markdown} +
+ ); +} +``` + +--- + +### Рекомендации по устойчивости + +- **JSON.parse**: всегда `trim`/убирайте trailing newline (`replace(/\n$/, "")`). +- **Fallback**: для неизвестных ключей оставляйте `
` (чтобы ничего не “ломалось”).
+- **Таблицы**: `comparisonTable` лучше рендерить как таблицу, а не Chart.js.
diff --git a/src/main/java/kz/konturai/parser/service/MarketingAnalysisService.java b/src/main/java/kz/konturai/parser/service/MarketingAnalysisService.java
index 7aeb083..987ec81 100644
--- a/src/main/java/kz/konturai/parser/service/MarketingAnalysisService.java
+++ b/src/main/java/kz/konturai/parser/service/MarketingAnalysisService.java
@@ -35,7 +35,9 @@ public class MarketingAnalysisService {
     private static final String AI_PREMIUM_CONSULTING_STYLE_GUIDE = ""
             + "СТИЛЬ (ОБЯЗАТЕЛЬНО): пиши как консалтинг «Большой четверки»: структурно, уверенно, с причинно-следственной логикой.\n"
             + "Используй профессиональную лексику и леммы: «аналитическая экстраполяция», «дифференциация предложения», «конверсионный слой», «кастомизация оффера».\n"
-            + "Текст должен звучать дорого: меньше общих слов, больше управленческих выводов, четких аргументов и практических шагов.\n\n";
+            + "Текст должен звучать дорого: меньше общих слов, больше управленческих выводов, четких аргументов и практических шагов.\n"
+            + "ФОРМАТ (ОБЯЗАТЕЛЬНО): пиши аналитический текст короткими емкими абзацами (2–4 предложения), без «воды».\n"
+            + "ГРАФИКИ (ОБЯЗАТЕЛЬНО): располагай теги графиков (например, [[CHART_...]]) непосредственно внутри или сразу после описания конкретных данных/цифр, к которым относится график.\n\n";
 
     private void appendMandatoryJsonUsageWarning(StringBuilder promptBuilder) {
         if (promptBuilder != null) {
@@ -82,6 +84,58 @@ public class MarketingAnalysisService {
         return text.replaceAll(placeholderWithNewlines, "\n");
     }
 
+    private String buildChartJsonBlock(String chartKey, String jsonStr) {
+        // Keep block compact: do not add extra blank lines here (front-end correlates
+        // adjacent text with the chart).
+        return "```json:" + chartKey + "\n" + jsonStr + "\n```";
+    }
+
+    /**
+     * Replace a specific placeholder variant with a JSON fenced block while keeping
+     * spacing compact (avoid accidental \\n\\n\\n around inserted blocks).
+     */
+    private String replacePlaceholderVariantWithJsonBlock(String text, String placeholderVariant, String jsonBlock) {
+        if (text == null || text.isBlank() || placeholderVariant == null || placeholderVariant.isBlank()
+                || jsonBlock == null || jsonBlock.isBlank()) {
+            return text;
+        }
+
+        String result = text;
+
+        // 1) Standalone line occurrences (allow indentation). Replace the whole line
+        // to keep fences at the start of a line (no leading spaces before ```).
+        java.util.regex.Pattern standaloneLine = java.util.regex.Pattern.compile(
+                "(?m)^[ \\t]*" + java.util.regex.Pattern.quote(placeholderVariant) + "[ \\t]*$");
+        result = standaloneLine.matcher(result)
+                .replaceAll(java.util.regex.Matcher.quoteReplacement(jsonBlock));
+
+        // 2) Inline occurrences: force the block onto its own line with minimal
+        // spacing.
+        java.util.regex.Pattern inline = java.util.regex.Pattern
+                .compile(java.util.regex.Pattern.quote(placeholderVariant));
+        java.util.regex.Matcher m = inline.matcher(result);
+        StringBuilder sb = new StringBuilder(result.length() + jsonBlock.length());
+        int last = 0;
+        while (m.find()) {
+            int start = m.start();
+            int end = m.end();
+            sb.append(result, last, start);
+
+            boolean hasNewlineBefore = start > 0
+                    && (result.charAt(start - 1) == '\n' || result.charAt(start - 1) == '\r');
+            boolean hasNewlineAfter = end < result.length()
+                    && (result.charAt(end) == '\n' || result.charAt(end) == '\r');
+
+            String prefix = hasNewlineBefore ? "" : "\n";
+            String suffix = hasNewlineAfter ? "" : "\n";
+
+            sb.append(prefix).append(jsonBlock).append(suffix);
+            last = end;
+        }
+        sb.append(result, last, result.length());
+        return sb.toString();
+    }
+
     private static final String[] SECTION_ROMANS = new String[] { "I", "II", "III", "IV", "V", "VI", "VII", "VIII",
             "IX", "X", "XI" };
     private static final Map ROMAN_TO_ANCHOR_ID = Map.ofEntries(
@@ -1723,7 +1777,8 @@ public class MarketingAnalysisService {
             promptBuilder.append("3. Глубина: аналитические инсайты с практическими выводами\n");
             promptBuilder.append("4. Данные: используй ТОЛЬКО данные из JSON, не выдумывай цифры\n\n");
             promptBuilder.append("ОБЯЗАТЕЛЬНАЯ СТРОКА:\n");
-            promptBuilder.append("- Обязательно напиши строку [[CHART_SEASONALITY]] (на отдельной строке).\n\n");
+            promptBuilder.append(
+                    "- Обязательно вставь тег [[CHART_SEASONALITY]] непосредственно рядом с описанием сезонности (внутри абзаца или сразу после него).\n\n");
             promptBuilder.append("СТРУКТУРА РАЗДЕЛА:\n");
             promptBuilder.append("III. Анализ рынка и сезонности\n\n");
             promptBuilder.append("Детально проанализируй:\n");
@@ -1742,13 +1797,13 @@ public class MarketingAnalysisService {
 
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКА:\n");
             promptBuilder.append(
-                    "1. В логичном месте раздела (после описания сезонности) вставь плейсхолдер [[CHART_SEASONALITY]] на отдельной строке\n");
+                    "1. В логичном месте раздела (сразу после конкретного описания сезонных колебаний/пиковых месяцев) вставь тег [[CHART_SEASONALITY]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "2. ПЕРЕД плейсхолдером напиши вводный абзац (2-3 предложения), но ТОЛЬКО если следующей строкой действительно идет [[CHART_SEASONALITY]].\n");
+                    "2. ПЕРЕД тегом напиши вводный абзац (2-3 предложения), но ТОЛЬКО если ты действительно вставляешь тег [[CHART_SEASONALITY]].\n");
             promptBuilder.append(
                     "3. ПОСЛЕ плейсхолдера напиши интерпретацию данных (2-3 предложения), но ТОЛЬКО если в тексте присутствует [[CHART_SEASONALITY]].\n\n");
             promptBuilder.append(
-                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике ниже показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил строку [[CHART_SEASONALITY]].\n\n");
+                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил тег [[CHART_SEASONALITY]].\n\n");
             promptBuilder.append("ВАЖНО:\n");
             promptBuilder.append("- Начинай сразу с заголовка \"III. Анализ рынка и сезонности\"\n");
             promptBuilder.append("- Не добавляй вступления или заключения\n");
@@ -1801,7 +1856,7 @@ public class MarketingAnalysisService {
                     "5. ЦИФРЫ ОБЯЗАТЕЛЬНЫ: в каждом подпункте делай выводы на основе процентов/чисел из audienceAnalysis.ageGroups и audienceAnalysis.genderDistribution.\n\n");
             promptBuilder.append("ОБЯЗАТЕЛЬНЫЕ СТРОКИ:\n");
             promptBuilder.append(
-                    "- Обязательно напиши строки [[CHART_AGE_DISTRIBUTION]] и [[CHART_GENDER_DISTRIBUTION]] (каждая на отдельной строке).\n\n");
+                    "- Обязательно вставь теги [[CHART_AGE_DISTRIBUTION]] и [[CHART_GENDER_DISTRIBUTION]] рядом с описанием конкретных процентов/выводов (внутри абзаца или сразу после него).\n\n");
 
             promptBuilder.append("ЕСЛИ В JSON НЕТ ТОЧНЫХ ЦИФР (РАЗРЕШЕННАЯ АППРОКСИМАЦИЯ):\n");
             promptBuilder.append(
@@ -1832,19 +1887,19 @@ public class MarketingAnalysisService {
             promptBuilder.append("- Рекомендации по коммуникации с каждым сегментом\n\n");
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКОВ (2 шт):\n");
             promptBuilder.append(
-                    "1. После разбора возрастных групп вставь плейсхолдер [[CHART_AGE_DISTRIBUTION]] на отдельной строке\n");
+                    "1. Сразу после конкретного описания возрастных долей (проценты по возрастным группам) вставь тег [[CHART_AGE_DISTRIBUTION]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "   - ПЕРЕД плейсхолдером: вводный абзац (2-3 предложения), но ТОЛЬКО если следующей строкой идет [[CHART_AGE_DISTRIBUTION]].\n");
+                    "   - ПЕРЕД тегом: вводный абзац (2-3 предложения), но ТОЛЬКО если ты действительно вставляешь тег [[CHART_AGE_DISTRIBUTION]].\n");
             promptBuilder.append(
                     "   - ПОСЛЕ плейсхолдера: интерпретация (2-3 предложения), но ТОЛЬКО если в тексте присутствует [[CHART_AGE_DISTRIBUTION]].\n");
             promptBuilder.append(
-                    "2. После разбора гендерного распределения вставь плейсхолдер [[CHART_GENDER_DISTRIBUTION]] на отдельной строке\n");
+                    "2. Сразу после конкретного описания гендерных долей (проценты) вставь тег [[CHART_GENDER_DISTRIBUTION]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "   - ПЕРЕД плейсхолдером: вводный абзац (2-3 предложения), но ТОЛЬКО если следующей строкой идет [[CHART_GENDER_DISTRIBUTION]].\n");
+                    "   - ПЕРЕД тегом: вводный абзац (2-3 предложения), но ТОЛЬКО если ты действительно вставляешь тег [[CHART_GENDER_DISTRIBUTION]].\n");
             promptBuilder.append(
                     "   - ПОСЛЕ плейсхолдера: интерпретация (2-3 предложения), но ТОЛЬКО если в тексте присутствует [[CHART_GENDER_DISTRIBUTION]].\n\n");
             promptBuilder.append(
-                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике ниже показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил соответствующий плейсхолдер графика.\n\n");
+                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил соответствующий тег графика.\n\n");
             promptBuilder.append(
                     "ОБЯЗАТЕЛЬНО ПРО ГЕНДЕР:\n- Явно укажи долю женщин по данным genderDistribution (в типовом кейсе около 60%) и объясни, почему аудитория смещена в сторону женщин.\n");
             promptBuilder.append(
@@ -1903,7 +1958,7 @@ public class MarketingAnalysisService {
                     "5. Это должен быть самый мощный раздел отчёта: каждое утверждение подтверждай цифрами из competitorAnalysis.marketShareChart / competitorAnalysis.comparisonTable.\n\n");
             promptBuilder.append("ОБЯЗАТЕЛЬНЫЕ СТРОКИ:\n");
             promptBuilder.append(
-                    "- Обязательно напиши строки [[CHART_MARKET_SHARE]] и [[TABLE_COMPARISON]] (каждая на отдельной строке).\n\n");
+                    "- Обязательно вставь теги [[CHART_MARKET_SHARE]] и [[TABLE_COMPARISON]] рядом с теми утверждениями, где ты обсуждаешь конкретные цифры/сравнения (внутри абзаца или сразу после него).\n\n");
             promptBuilder.append(
                     "КРИТИЧНО (ОБЯЗАТЕЛЬНЫЕ ТЕГИ): Ты ОБЯЗАН вставить тег [[CHART_MARKET_SHARE]] в начале раздела и [[TABLE_COMPARISON]] в середине. Без этих тегов отчет будет неполным.\n");
             promptBuilder.append(
@@ -1928,19 +1983,19 @@ public class MarketingAnalysisService {
             promptBuilder.append("- Рекомендации по дифференциации и конкурентным преимуществам\n\n");
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКА И ТАБЛИЦЫ:\n");
             promptBuilder.append(
-                    "1. В НАЧАЛЕ раздела (сразу после заголовка V. Анализ конкурентов) вставь плейсхолдер [[CHART_MARKET_SHARE]] на отдельной строке\n");
+                    "1. В НАЧАЛЕ раздела (сразу после первого абзаца с выводом по долям рынка) вставь тег [[CHART_MARKET_SHARE]] рядом с этим выводом (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "   - ПЕРЕД плейсхолдером: вводный абзац (2-3 предложения), но ТОЛЬКО если следующей строкой идет [[CHART_MARKET_SHARE]].\n");
+                    "   - ПЕРЕД тегом: вводный абзац (2-3 предложения), но ТОЛЬКО если ты действительно вставляешь тег [[CHART_MARKET_SHARE]].\n");
             promptBuilder.append(
                     "   - ПОСЛЕ плейсхолдера: интерпретация (2-3 предложения), но ТОЛЬКО если в тексте присутствует [[CHART_MARKET_SHARE]].\n");
             promptBuilder.append(
-                    "2. В СЕРЕДИНЕ раздела вставь плейсхолдер [[TABLE_COMPARISON]] на отдельной строке (это сравнительная таблица)\n");
+                    "2. В СЕРЕДИНЕ раздела, сразу после абзаца где ты перечисляешь ключевые различия/feature-ы, вставь тег [[TABLE_COMPARISON]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
                     "   - ПЕРЕД таблицей: короткий ввод (1-2 предложения), что именно сравниваем\n");
             promptBuilder.append(
                     "   - ПОСЛЕ таблицы: интерпретация (3-5 предложений) с выводом по позиционированию\n\n");
             promptBuilder.append(
-                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике ниже показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил строку [[CHART_MARKET_SHARE]].\n\n");
+                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил тег [[CHART_MARKET_SHARE]].\n\n");
             promptBuilder.append(
                     "ОБЯЗАТЕЛЬНОЕ СРАВНЕНИЕ С 'КОНКУРЕНТОМ A' И 'КОНКУРЕНТОМ B':\n");
             promptBuilder.append(
@@ -2012,9 +2067,9 @@ public class MarketingAnalysisService {
             promptBuilder.append("- Практические рекомендации на основе SWOT-матрицы\n\n");
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКА:\n");
             promptBuilder.append(
-                    "1. В логичном месте раздела (после SWOT-анализа) вставь плейсхолдер [[CHART_SWOT]] на отдельной строке\n");
+                    "1. Сразу после конкретного описания пунктов SWOT (S/W/O/T) вставь тег [[CHART_SWOT]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "2. ПЕРЕД графиком напиши вводный абзац (2-3 предложения), начинающийся с: \"Анализ данных на графике ниже показывает...\"\n");
+                    "2. ПЕРЕД графиком напиши вводный абзац (2-3 предложения), начинающийся с: \"Анализ данных на графике показывает...\"\n");
             promptBuilder.append(
                     "3. ПОСЛЕ графика напиши интерпретацию данных (2-3 предложения), начинающуюся с: \"Из этих показателей следует, что...\"\n\n");
             promptBuilder.append("ВАЖНО:\n");
@@ -2077,9 +2132,9 @@ public class MarketingAnalysisService {
             promptBuilder.append("- Интеграция каналов в единую маркетинговую стратегию\n\n");
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКА:\n");
             promptBuilder.append(
-                    "1. В логичном месте раздела (после анализа каналов) вставь плейсхолдер [[CHART_CHANNELS]] на отдельной строке\n");
+                    "1. Сразу после абзаца, где ты сравниваешь/ранжируешь каналы с конкретными аргументами, вставь тег [[CHART_CHANNELS]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "2. ПЕРЕД графиком напиши вводный абзац (2-3 предложения), начинающийся с: \"Анализ данных на графике ниже показывает...\"\n");
+                    "2. ПЕРЕД графиком напиши вводный абзац (2-3 предложения), начинающийся с: \"Анализ данных на графике показывает...\"\n");
             promptBuilder.append(
                     "3. ПОСЛЕ графика напиши интерпретацию данных (2-3 предложения), начинающуюся с: \"Из этих показателей следует, что...\"\n\n");
             promptBuilder.append("ВАЖНО:\n");
@@ -2124,7 +2179,8 @@ public class MarketingAnalysisService {
             promptBuilder.append("3. Глубина: аналитические инсайты с практическими выводами\n");
             promptBuilder.append("4. Данные: используй ТОЛЬКО данные из JSON, не выдумывай цифры\n");
             promptBuilder.append("ОБЯЗАТЕЛЬНАЯ СТРОКА:\n");
-            promptBuilder.append("- Обязательно напиши строку [[CHART_FUNNEL]] (на отдельной строке).\n\n");
+            promptBuilder.append(
+                    "- Обязательно вставь тег [[CHART_FUNNEL]] непосредственно рядом с описанием этапов/конверсий (внутри абзаца или сразу после него).\n\n");
             promptBuilder.append(
                     "ВНИМАНИЕ: Проверяй математическую логику. Количество покупок НЕ МОЖЕТ быть больше количества заявок. "
                             + "Конверсия не может превышать 100%. Если данные в JSON противоречивы, используй логические значения "
@@ -2148,13 +2204,13 @@ public class MarketingAnalysisService {
             promptBuilder.append("- Интеграция воронки с каналами продвижения\n\n");
             promptBuilder.append("КРИТИЧНО - ВСТАВКА ГРАФИКА:\n");
             promptBuilder.append(
-                    "1. В логичном месте раздела (после описания этапов) вставь плейсхолдер [[CHART_FUNNEL]] на отдельной строке\n");
+                    "1. Сразу после описания этапов и ключевых выводов по узким местам вставь тег [[CHART_FUNNEL]] рядом с этим описанием (внутри абзаца или сразу после него)\n");
             promptBuilder.append(
-                    "2. ПЕРЕД плейсхолдером напиши вводный абзац (2-3 предложения), но ТОЛЬКО если следующей строкой идет [[CHART_FUNNEL]].\n");
+                    "2. ПЕРЕД тегом напиши вводный абзац (2-3 предложения), но ТОЛЬКО если ты действительно вставляешь тег [[CHART_FUNNEL]].\n");
             promptBuilder.append(
                     "3. ПОСЛЕ плейсхолдера напиши интерпретацию данных (2-3 предложения), но ТОЛЬКО если в тексте присутствует [[CHART_FUNNEL]].\n\n");
             promptBuilder.append(
-                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике ниже показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил строку [[CHART_FUNNEL]].\n\n");
+                    "ЗАПРЕТ НА ЗАГЛУШКИ:\n- Запрещено писать фразы типа \"Анализ данных на графике показывает...\" и \"Из этих показателей следует, что...\", если ты НЕ вставил тег [[CHART_FUNNEL]].\n\n");
             promptBuilder.append("ВАЖНО:\n");
             promptBuilder.append("- Начинай сразу с заголовка \"VIII. Воронка спроса\"\n");
             promptBuilder.append("- Не добавляй вступления или заключения\n");
@@ -3660,10 +3716,8 @@ public class MarketingAnalysisService {
             if (!isEmptyChartData(chartData)) {
                 try {
                     String jsonStr = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(chartData);
-                    String jsonBlock = "\n```json:" + mapping.chartKey + "\n" + jsonStr + "\n```\n";
-                    // Replace all occurrences of this exact variant
-                    result = result.replaceAll(java.util.regex.Pattern.quote(placeholderVariant),
-                            java.util.regex.Matcher.quoteReplacement(jsonBlock));
+                    String jsonBlock = buildChartJsonBlock(mapping.chartKey, jsonStr);
+                    result = replacePlaceholderVariantWithJsonBlock(result, placeholderVariant, jsonBlock);
                     processedPlaceholders.add(normalized);
                     logger.info("Successfully replaced placeholder: {} (normalized {}) with dataKey: {}",
                             placeholderVariant, normalized, mapping.dataKey);
@@ -3698,9 +3752,8 @@ public class MarketingAnalysisService {
                 try {
                     String jsonStr = objectMapper.writerWithDefaultPrettyPrinter()
                             .writeValueAsString(chartsData.get(mapping.dataKey));
-                    String jsonBlock = "\n```json:" + mapping.chartKey + "\n" + jsonStr + "\n```\n";
-                    result = result.replaceAll(java.util.regex.Pattern.quote(placeholderVariant),
-                            java.util.regex.Matcher.quoteReplacement(jsonBlock));
+                    String jsonBlock = buildChartJsonBlock(mapping.chartKey, jsonStr);
+                    result = replacePlaceholderVariantWithJsonBlock(result, placeholderVariant, jsonBlock);
                     processedPlaceholders.add(normalized);
                     continue;
                 } catch (Exception e) {