# Тест презентация — пособие «Автономный бизнес на базе AI»

**Формат деливерабла:** PDF-пособие (научно-презентационная работа) для доклада перед
инвесторами, руководителями холдингов и директорами по развитию. После готовности —
размещение в «Витрина результатов».

**Цель:** убедительно показать, что автономный бизнес на базе искусственного интеллекта —
перспективное направление, достойное внимания и инвестиций. Достоверная информация с
источниками + продуманные выводы/рекомендации от AI (как если бы готовила группа экспертов).

---

## Смысл проекта (что значит «сделано отлично»)

- **Пользователь:** инвестор / топ-менеджер. Читает PDF на экране и/или в распечатке,
  принимает решение «стоит ли вкладываться в направление».
- **Ценность:** за 20–40 слайдов даёт целостную, достоверную и убедительную картину рынка
  автономных AI-бизнесов: как устроены, на чём строятся, экономика, риски, вероятность успеха.
- **«Отлично» =** (1) каждый факт/цифра подкреплён реальным источником с датой; (2) выводы и
  рекомендации AI явно помечены и логически обоснованы; (3) вау-визуал (glassmorphism, светлые
  тона + графит/синий/фиолетовый градиент), сбалансированная типографика; (4) PDF с встроенными
  кириллическими шрифтами, текст копируется, пагинация стабильна.

## Главные риски / неизвестности

1. **Достоверность с источниками (главный риск).** Инвесторская научная работа не прощает
   выдуманных цифр. Каждый тезис — с проверяемым источником (URL + дата), AI-блоки помечены.
   → навыки `deep-research`, `ai-market-research`, `source-citation`.
2. **Качество визуала в PDF.** Glass-эффекты, градиенты и кириллица должны пережить печать в
   PDF; визуалы — реальные (genvisual), без заглушек. → `pdf-generation`, `visual-generation`.
3. **Баланс «продать идею» vs «остаться достоверным».** Нарратив должен убеждать, не скатываясь
   в маркетинговый хайп. → `presentation-deck`, `copywriting`, `self-critique`.
4. **Фиделити рендера и пагинация.** Blur/градиенты на стыках страниц, осиротевшие блоки.
   → проверка скриншотом через Playwright.

---

## Архитектура (решение)

**Движок:** HTML + CSS (print) → **Playwright / Chromium `page.pdf()`**.
Причина: только так получаем полный контроль над glassmorphism (backdrop-filter, градиенты,
прозрачность), точную типографику и встраивание кириллических шрифтов. pptx/Canva такого
визуального контроля не дают.

- **Формат страницы:** ландшафтные слайды 16:9 (1280×720 pt-эквивалент), каждый «слайд» =
  отдельная страница PDF через `@page`.
- **Шрифты:** локальные `@font-face` (PT Sans/PT Serif или Inter + Cyrillic), НЕ CDN. Headless
  Linux не имеет кириллицы — шрифты кладём в `fonts/`. Смоук-тест панграммой.
- **Визуалы:** реальные ассеты через `node /srv/factory/tools/genvisual.mjs` → `public/generated/`.
- **Проверка:** Playwright скриншот каждого слайда + копипаст кириллицы из готового PDF.

## Структура репозитория

```
content/
  outline.md         — слайд-аут (утв. 18 слайдов, takeaway-заголовки)
  deck.json          — ЕДИНЫЙ ИСТОЧНИК ПРАВДЫ: финальные тексты/структура слайдов
  research-dossier.md— проверенный контент по слайдам (тезисы [S#], 🟦 выводы AI)
  sources.md         — библиография (источник + URL + дата + доверие A/B/C)
src/
  build.mjs          — сборка: deck.json → единый PDF (Playwright page.pdf) + скриншоты
  render/
    template.mjs     — рендер deck.json → HTML (layout по типу слайда, @font-face inline)
  styles/
    tokens.css       — дизайн-система (палитра, glass, типографика, сетки)
public/generated/    — сгенерированные визуалы (genvisual)            [этап visuals]
fonts/               — локальные шрифты с кириллицей (Inter + Manrope) + fonts.css
build/               — выходной PDF, screens/*.png, build-report.json   [не в VCS]
ai-assets/           — провенанс визуалов (ledger.json от genvisual)
```

## Как собирать

```bash
npm install                       # playwright + (devDep) pdf-parse
node src/build.mjs                # → build/posobie-ai-business.pdf + build/screens/*.png
node src/build.mjs --no-shots     # только PDF
```

Chromium берётся из кэша Playwright; при отсутствии — `npx playwright install chromium`.
Сборка идемпотентна: один и тот же `deck.json` → один и тот же PDF.

**Самопроверка сборки** (`build/build-report.json`): число слайдов, смоук-тест кириллицы
(шрифт применён, ширина панграммы), список console-ошибок. Текущее состояние: 18 страниц
16:9, кириллица встроена и копируется из PDF (8955 символов в текстовом слое).

## Дорожная карта

См. этапы в `.factory/result.json` (`stages`). Самые рискованные — контент-исследование и
архитектура рендера — идут первыми.