Вектор — AI-ассистент для маркетологов

Рабочее место маркетолога: AI-чат по 16 направлениям маркетинга, to do list и калькулятор маркетинговых метрик.

Сайт: https://vektor-ai-marketing.vercel.app (проект Vercel vektor; старый адрес marketing-pilot-five.vercel.app переадресует сюда) Код: https://github.com/alexlojkov-code/vektor

• PRD.md — продуктовые требования: проблема, аудитория, направления, функции, метрики успеха.
• SPEC.md — техническая спецификация: архитектура, API, формулы, экраны, дизайн-система, критерии приёмки.

Запуск

npm install
npm run dev

Откройте http://localhost:3000: лендинг — /, приложение — /app.html.

AI-ключ

Как в Eatlas: общий ключ сервиса лежит только в переменной окружения на Vercel и никогда не попадает в браузер. Браузер обращается к /api/chat, сервер добавляет ключ и пересылает запрос в Gemini (через его OpenAI-совместимый адрес generativelanguage.googleapis.com/v1beta/openai).

Подключить ключ Gemini (aistudio.google.com → Get API key):

vercel env add GEMINI_API_KEY production --sensitive
vercel deploy --prod

Провайдер выбирается по заданному ключу: GEMINI_API_KEY → Gemini, OPENAI_API_KEY → OpenAI, ANTHROPIC_API_KEY → Claude; можно указать явно в AI_PROVIDER.

Модели на выбор — список под заголовком чата, выбор запоминается и синхронизируется:

Модель	В списке
gemini-3.8-flash (по умолчанию)	Gemini 3.8 Flash — точнее
gemini-3.6-flash	Gemini 3.6 Flash — баланс
gemini-3.5-flash-lite	Gemini 3.5 Flash-Lite — быстрее

Если выбранная модель перегружена (429/5xx), недоступна ключу или тарифу (404, «limit: 0»), или молчит в потоке, сервер сразу пробует остальные из списка. Список меняется переменными AI_MODEL и AI_FALLBACK_MODELS.

Дневные лимиты (сутки по UTC): вошедший пользователь — AI_DAILY_LIMIT_USER (50), гость по хэшу IP — AI_DAILY_LIMIT_GUEST (15), весь сервис — AI_DAILY_LIMIT_TOTAL (1500). Неудачные запросы лимит не расходуют. Счётчики — в Upstash Redis (без него — в памяти экземпляра функции, это слабее).

Локально (.env, пример — .env.example):

Настройка	Что происходит
GEMINI_API_KEY (или OPENAI_API_KEY)	Настоящие ответы потоком
Ключа нет или AI_PROVIDER=none	AI выключен, задачи и калькулятор работают
AI_PROVIDER=mock	Демо-режим: шаблонные ответы без сети и без лимитов

Аккаунты и синхронизация

Без настроек приложение работает как раньше: данные только в браузере, кнопки входа нет. Чтобы включить аккаунты на Vercel:

1. Проект vektor → Storage → Upstash for Redis (бесплатный тариф) → Connect к проекту.
2. Переменные KV_REST_API_URL и KV_REST_API_TOKEN появятся сами — пересоберите проект (Deployments → Redeploy).

Вход — по почте и паролю. Писем сервис не отправляет: при регистрации показывается код восстановления, по нему можно задать новый пароль. Локально аккаунты включаются DB_PROVIDER=memory (данные живут до перезапуска сервера).

Валюта

Калькулятор считает в сумах или долларах — переключатель в шапке калькулятора. Курс не пересчитывается: вводятся свои числа.

Установка на телефон (PWA)

«Вектор» можно установить как приложение: в Chrome и на Android — кнопкой «Установить приложение» в меню или с плашки на экране «Сегодня», на iPhone — «Поделиться → На экран „Домой“» (в приложении есть подсказка). Без интернета работают задачи, калькулятор, профиль бренда и прошлые чаты.

Файлы: public/manifest.webmanifest, public/sw.js (кэш «сначала сеть»), public/js/pwa.js. Если меняете список файлов оболочки в sw.js, поднимите версию CACHE.

Превью ссылки

public/og.png (1200×630), public/apple-touch-icon.png и иконки приложения public/icons/ собираются из scripts/og-image.mjs:

npm run build:og

3D-объекты лендинга

Исходник — src/scene3d.js (Three.js). После правок пересоберите бандл:

npm run build:3d

Готовый файл public/js/scene3d.min.js хранится в репозитории, на Vercel сборка не нужна.

Liquid Glass

Эффект стекла — отдельный слой: public/css/liquid-glass.css и public/js/liquid-glass.js, включается атрибутом data-glass на <html> в index.html и app.html. Чтобы убрать эффект, удалите атрибут data-glass (или подключения этих двух файлов) в обоих HTML-файлах.

Тесты

npm test

Проверяют все формулы калькулятора, воронку, валюту, разбор чисел, поиск метрик и слияние данных двух устройств.

Структура

api/            функции Vercel: /api/chat (поток NDJSON), /api/ai/status, /api/account, /api/sync
api/_lib/       конфигурация, промпты, AI-провайдеры (Gemini и OpenAI, Anthropic, демо), дневные лимиты, хранилище (Redis), аккаунты
public/         лендинг и приложение (чистые HTML/CSS/JS, без сборки)
src/            исходник 3D-сцены (собирается в public/js/scene3d.min.js)
scripts/        локальный сервер, генерация картинки превью
tests/          тесты формул, валюты, синхронизации, провайдера Gemini/OpenAI и лимитов

Деплой

vercel из папки проекта; в настройках проекта задайте переменные из .env.example.