Alterna · онлайн-платформа турецкого A1–C1 по подписке
План как в Duolingo, но материала больше, чем тестов. Каждый уровень — отдельный город. Каждая тема — гайд со своим дизайном. Дашборд показывает всё: от уровня ученика до секции, на которой он остановился. Только веб: телефон и компьютер в браузере.
У каждого гайда свой дизайн и свои анимации. Но любой гайд одинаково размечает секции и упражнения и подключает один трекер. Платформе неважно, как гайд выглядит.
Vercel, Supabase и Paddle закрывают хостинг, базу, вход, файлы и подписки. Ни одного сервера, который нужно администрировать. За 10 дней это решает.
Прогресс чтения ученик видит в дашборде, поэтому он хранится в своей базе. PostHog нужен команде для решений: воронки, удержание, конверсия из пробного в платный.
Города, юниты и порядок уроков строятся из карт грамматики и лексики скриптом. Поменял карту — план пересобрался, код трогать не нужно.
Что уже есть. Карты грамматики (158 тем) и лексики (152 темы) со стабильными id, часами, пререквизитами и привязкой к городам. Это готовый скелет базы данных. Гайды делаются с нуля под контракт платформы. Язык пока один — турецкий, но в схеме есть course_id, поэтому второй язык потом добавляется без переделки.
Экран «План» — это карта маршрута. Ученик проходит уровень в одном городе: модули привязаны к его фокусу, в конце — «Остановка» с темой о самом городе и тест уровня, который открывает следующий город.
// scripts/build-plan.ts — запускается в CI, // когда меняется любая из карт for (const city of route) { // A1 Стамбул … C1 Самсун plan.push(arrival(city)) // только A2 и B2 // грамматика — по order, граф пререквизитов const spine = topoSort(grammar[city.level]) // лексика встаёт после своей грамматики for (const v of vocab[city.level]) insertAfter(spine, v.recommended_after_grammar, v) // режем на юниты по 5–7 уроков plan.push(...chunk(spine, { min: 5, max: 7 }) .map(withPractice).map(withUnitTest)) plan.push(cityStop(city), tools(city), levelTest(city)) } // результат → таблицы units и lessons в Postgres; // админ может вручную подвинуть урок (override)
Тема открыта, когда пройдены её пререквизиты из карты. CI проверяет, что в графе нет циклов.
Рекомендована после своей грамматики (recommended_after_grammar), но не блокируется.
Открыты сразу. Прибытие даётся готовыми фразами, повторение слов доступно в любой момент.
Открывается тестом уровня. Тест при регистрации может сразу отправить ученика в нужный город.
Прогресс в часах, а не в процентах. У каждой темы в карте есть часы, у уровня — модель: уроки, повторение, тесты. Поэтому дашборд может сказать «до Измира ≈ 37 часов — около трёх месяцев при 25 минутах в день». Темы, у которых ещё нет гайда, показываются как «скоро» и не мешают проходить город.
Выбор под три условия: только веб, платная подписка, 10 дней на одного разработчика с Claude Code. Версии — текущие стабильные в npm на сегодня, тарифы и ограничения сверены с документацией сервисов (источники — внизу раздела).
| Слой | Выбор | Версия | Почему |
|---|---|---|---|
| Фреймворк | Next.js, App Router | 16.4 | Серверные компоненты, Server Actions, кэш через "use cache", proxy.ts для проверки входа. Лучшая поддержка на Vercel. |
| UI | React + TypeScript | 19.3 | Стандарт рынка. Claude Code пишет его лучше всего. |
| Стили и компоненты | Tailwind CSS + shadcn/ui | 4.3 CLI 4.21 | Макет собирается из готовых компонентов, а их код лежит в твоём репозитории — меняешь как хочешь. |
| Анимации интерфейса | Motion | 14 | XP, стрики, переходы, карта городов. |
| Графики | Recharts | 3.10 | Дашборд ученика и аналитика в админке. |
| Формы и схемы | zod + react-hook-form | 4.6 | Одна схема проверяет форму, API и контент гайдов. |
| База, вход, файлы | Supabase: Postgres, Auth, Storage, pg_cron | js 2.117 ssr 0.12 | Всё бэкенд-ядро в одном сервисе, RLS из коробки. Переносится на свой сервер без переписывания кода. |
| Гайды и игры | HTML + CSS + GSAP + kit | GSAP 3.15 | Полная свобода дизайна. GSAP со всеми плагинами бесплатен и в платных продуктах. |
| Повторение слов | ts-fsrs | 5.4 | Алгоритм FSRS, как в Anki. |
| Оплата | Paddle Billing | js 1.6 node 3.10 | Merchant of Record: подписки, повторные списания, налоги за тебя. Продавцы из Казахстана поддерживаются. |
| Письма | Resend + React Email | 6.32 | Письма с твоего домена, включая письма входа Supabase. |
| Озвучка | Azure Speech, голоса tr-TR Emel и Ahmet | — | Нейроголоса, SSML для медленной речи, около $15 за 1 млн символов. |
| Ошибки и аналитика | Sentry + PostHog | 11.6 | Ошибки, воронки, конверсия пробного в платный. |
| Тесты и линтер | Vitest, Playwright, Biome | 5.0 1.64 | Логика, сквозные сценарии на 375 px, один инструмент для линта и форматирования. |
| Хостинг | Vercel Pro (fra1) + Supabase Pro (Франкфурт) | — | Рядом друг с другом; бесплатный Hobby на Vercel запрещает коммерческое использование. |
proxy.tsmiddleware.ts переименован в proxy.ts и по умолчанию работает на Node.js. Кэш включается явно: cacheComponents: true и "use cache".
Ключи sb_publishable_… и sb_secret_… вместо anon и service_role — старые отключают в конце 2026. Подпись JWT асимметричная, проверка через getClaims().
С апреля 2025 все плагины бесплатны и для коммерческих проектов. Запрещено только делать на нём конструктор анимаций, конкурирующий с Webflow.
Эти детали прописаны в CLAUDE.md, чтобы Claude Code не писал код по устаревшим туториалам.
Нормальный фреймворк, но меньше готовых компонентов, а ИИ-ассистенты пишут его хуже, чем React.
NoSQL: связи «ученик — тема — секция» и аналитика в нём тяжелее. На свой сервер в РК не перенести.
Не работает с продавцами из Казахстана.
Администрирование съест несколько дней из десяти. Нужно только для плана Б.
Второй проект, второй деплой. Next.js и Postgres-функции закрывают всё, что нужно.
Freedom Pay или TipTop Pay дешевле по комиссии, но подписки придётся писать самому. Это после запуска.
npm view, 9 октября 2026Ученик работает в приложении. Гайд открывается внутри приложения во весь экран, как урок в Duolingo. Сервер отдаёт гайд только тем, у кого есть доступ. События чтения идут через приложение на сервер и в Postgres.
← Схему можно листать вбок →
Чтение. iframe запрашивает /g/a1.dative/v1 на том же домене. Сервер проверяет доступ и отдаёт HTML из приватного бакета. Без доступа — 403 и пейволл.
Трекинг. tracker.js сообщает приложению о секциях и ответах. Приложение добавляет пользователя и раз в 30 секунд отправляет пачку событий на /api/track.
Публикация. Новый гайд — мерж в репозиторий. CI проверяет, озвучивает, кладёт в Storage и синхронизирует каталог. Релиз приложения не нужен.
Платформа и гайды решают разные задачи, поэтому одна технология на всё — ошибка. Платформа — веб-приложение с входом, подпиской, состоянием и данными. Гайд — длинная страница-история с тяжёлой анимацией, которую читают сверху вниз.
proxy.ts для проверки входа.index.html. Claude Code генерирует такую страницу быстрее и надёжнее всего.kit.js, подключаются одной строкой.| Вариант | Для платформы | Для гайдов |
|---|---|---|
| React + Next.js | ✓Экосистема, скорость с ИИ, всё для SaaS. | ~Лишний рантайм, React и GSAP спорят за DOM. |
| HTML + GSAP + kit | ✕Вход, подписка, роутинг и состояние пришлось бы писать руками. | ✓Без сборки, полная свобода дизайна, общие части — из kit. |
| Vue + Nuxt | ~Хороший фреймворк, но меньше готовых компонентов и хуже результат у ИИ-ассистентов. | ~Те же минусы, что у React. |
| Astro | ✕Не для приложения с личными данными. | ~Хорош, но это ещё один шаг сборки. Можно перейти позже. |
| Чистый HTML без kit | ✕— | ✕Квиз, озвучка и трекер окажутся в 310 копиях. |
kit/kit.cssЦвета, шрифты, радиусы как CSS-переменные. Один источник для приложения, гайдов и игр.
kit/kit.jsWeb components: <a-say> озвучка, <a-word> карточка, <a-exercise> упражнения из карты.
kit/tracker.jsБез зависимостей: секции, активное время, ответы, озвучка → postMessage.
kit/game-sdk.jsСвязь игры с платформой: получить слова, отправить очки, завершить игру.
src/domainЧистая логика: правила открытия, доступ, XP, часы до города, FSRS. С тестами Vitest.
src/content/schemaZod-схемы карт, guide.json, упражнений и game.json. Проверка в CI и типы в коде.
| Экран | Как рендерится |
|---|---|
| Лендинг, тарифы | Статика — SEO и мгновенная загрузка |
| Маршрут и юниты | Server Components — данные сразу, без спиннеров |
| Плеер гайда, игры | Клиент + iframe, трекер через postMessage |
| Дашборд | Server Components из готовых агрегатов |
| Упражнения и тесты | Клиент: проверка мгновенно, XP начисляет сервер |
| Админка | Server Components + Server Actions, доступ по роли |
| Задача | Библиотека |
|---|---|
| Интерфейс | Tailwind CSS 4 + shadcn/ui |
| Данные с сервера | Server Components + Server Actions |
| Состояние плеера | Zustand |
| Формы | react-hook-form + zod |
| Карта городов | SVG + Motion |
| Графики дашборда | Recharts |
| Повторение слов | ts-fsrs |
Один код без отдельной мобильной версии. Верстаем сначала под самый узкий Android (360 px), потом добавляем место. Раскладку меняет ширина экрана, а не тип устройства: User-Agent не используем — iPad в Safari представляется как Mac.
Одна колонка, нижняя панель из 5 вкладок, гайд во весь экран. Учитываем вырез и полоску «домой».
Панель иконок слева, карточки в две колонки.
Полный сайдбар, план в две колонки — как на макете.
Справа появляется колонка: цель дня, слова на повторение, стрик.
Весь интерфейс по центру, не шире 2000 px. Текст не растягивается: строка до 75 знаков.
max-width и clamp(), фиксированных ширин блоков нет.@container в Tailwind 4): карточка одинаково хорошо выглядит в сайдбаре и в центре.dvh вместо vh: адресная строка Safari и Chrome не обрезает контент.@media (hover: hover).prefers-reduced-motion показывается итог без анимации.content:check снимает каждый гайд на 360, 768, 1280 и 1920 px.viewport-fit=cover и env(safe-area-inset-*) для выреза и полоски «домой». Звук — только по нажатию: автозапуск заблокирован.
Кнопка «назад» закрывает плеер через историю браузера. Проверка на слабом телефоне с замедлением процессора ×4.
Safari выдаёт себя за Mac, поэтому различаем по (pointer: coarse). С клавиатурой и трекпадом работают hover и горячие клавиши. Поворот меняет раскладку без перезагрузки.
Чёткие SVG и картинки 2x для Retina, hover-состояния, горячие клавиши в упражнениях: 1–4 — выбор, Enter — проверить.
Контент и графики не растягиваются на всю ширину. Таблицы админки получают больше колонок, а не шире ячейки.
| Профиль Playwright | Движок | Размер | Что это |
|---|---|---|---|
| android | Chromium, касания | 360×800 | Бюджетный Android |
| iphone-se | WebKit, касания | 375×667 | Маленький iPhone |
| iphone | WebKit, касания | 393×852 | iPhone 15–17 |
| iphone-max | WebKit, касания | 430×932 | Pro Max |
| ipad | WebKit, касания | 820×1180 и 1180×820 | iPad в двух ориентациях |
| macbook | Chromium, Retina ×2 | 1470×956 | MacBook Air 13 |
| fhd | Chromium | 1920×1080 | Обычный монитор |
| ultrawide | Chromium | 3440×1440 | Ультраширокий |
Поддерживаемые браузеры. Safari 16.4+ (iPhone 8 и новее), Chrome 111+, Firefox 128+, Samsung Internet, Edge — это требование Tailwind CSS 4. На iPhone 7 и старше (iOS 15) показываем плашку «Обновите браузер». Перед запуском главный сценарий проходится руками на дешёвом Android, iPhone, iPad и MacBook.
Гайды делаются с нуля под платформу, поэтому контракт закладывается с первого гайда: внутри — любой дизайн, снаружи — обязательные атрибуты. Id гайда = id темы из карты. Всё живёт в одном репозитории с платформой.
alterna/ src/ # платформа, Next.js 16 app/ domain/ content/schema/ public/ kit/v1/ # kit.css, kit.js, tracker.js, # game-sdk.js, GSAP games/match-pairs/ # index.html, game.json guides/ _template/ # шаблон для Claude a1-istanbul/ a1.dative/ # index.html, guide.json, # exercises.json, media/ v.a1.cafe/ a2-izmir/ … # 310 папок content/ maps/ # карты грамматики и лексики supabase/migrations/ scripts/ # build-plan, publish, sync CLAUDE.md
<!-- дизайн любой, атрибуты обязательны --> <section data-section="buffer-y" data-words="180"> …свои анимации и вёрстка… <a-say>Arabaya bin.</a-say> </section> <!-- упражнение из общего движка --> <a-exercise ref="a1.dative.ex2"></a-exercise> <link rel="stylesheet" href="/kit/v1/kit.css"> <script type="module" src="/kit/v1/kit.js"></script> <script src="/kit/v1/tracker.js" defer></script>
Озвучка генерируется при публикации: скрипт находит все <a-say>, создаёт аудио через Azure Speech и кладёт в публичный бакет.
{
"topic": "a1.dative", // id из карты
"code": "A1-20",
"city": "istanbul", "cefr": "A1",
"kind": "grammar", // или "lexicon"
"version": 1,
"title": "Дательный падеж -(y)A",
"sections": [
{ "key": "idea", "title": "Куда? Кому?", "words": 160 },
{ "key": "harmony", "title": "-a или -e", "words": 240 },
{ "key": "buffer-y", "title": "arabaya", "words": 180 },
{ "key": "pronouns", "title": "bana, sana", "words": 120 },
{ "key": "quiz", "title": "Тест", "type": "quiz" }
],
"exercises": ["a1.dative.ex1", "a1.dative.ex2"],
"vocab": ["gitmek", "vermek", "ev", "okul"]
}
topic не найден в карте или уровень гайда не совпадает с уровнем темы;guide.json или ключ повторяется;Ключи секций — навсегда. Прогресс хранится по ключу, а не по номеру. Если потом вставить секцию в середину, у тех, кто уже читал гайд, прогресс не съедет.
/g/a1.dative/v1Без доступа сервер отвечает 403, приложение показывает пейволл. Аудио и картинки лежат в публичном бакете с CDN: без HTML гайда они бесполезны, зато кэшируются. Когда трафик медиа превысит 250 ГБ в месяц, его можно перенести в Cloudflare R2 — меняется одна переменная.
Игра устроена как гайд: папка со статикой, свой game.json и общий SDK. Сама игра ничего не знает о турецком — слова и фразы ей передаёт платформа из тем, которые ученик уже прошёл. Одна механика сразу работает для всех пяти городов.
{
"id": "match-pairs",
"title": "Найди пару",
"skill": "lexicon",
"content": "words", // words | phrases | affixes
"minLevel": "A1",
"version": 1,
"xpPerGame": 10,
"dailyXpCap": 50
}
const game = await AlternaGame.init() // game.content.words → // [{ tr: "elma", ru: "яблоко", audio: "…" }, …] // … игра идёт … game.score(120) game.complete({ correct: 18, total: 20 }) // платформа сохраняет game_session, // сервер начисляет XP с дневным лимитом
Папка public/games/<id>/ + game.json → мерж → Vercel выкладывает, CI регистрирует игру в каталоге. Через пару минут она в разделе «Игры». Позже — загрузка zip в суперадминке.
Игра запускается в iframe с sandbox="allow-scripts": у неё «чужое» происхождение, поэтому даже сторонний код не прочитает cookie и не сходит в API от имени ученика. Очки проверяет сервер, XP ограничен в день.
Механики («найди пару», wordle, виселица) не защищены — их можно брать. Чужой код, графику и названия — нельзя. Open-source игры с лицензией MIT или Apache можно адаптировать, сохранив лицензию.
В 10 дней — SDK и одна игра («Найди пару»). Остальные добавляются папками после запуска.
Главное правило: Git — источник истины для контента, Postgres — для учеников. Каталог в базе — только копия, которую перезаписывает CI. Поэтому любую правку контента можно проверить, откатить и найти в истории.
| Что | Где | Почему |
|---|---|---|
| Карты, гайды, упражнения, игры | Git, один репозиторий | Ревью через PR, история, откат одной командой. |
| Опубликованные гайды | Supabase Storage, приватный бакет: guides/a1.dative/v1/ | Отдаются только через сервер после проверки доступа. Каждая версия — своя папка, откат = вернуть номер версии. |
| Аудио и картинки | Supabase Storage, публичный бакет + CDN | Имя файла = хеш содержимого: без дублей, кэш навсегда. При росте — Cloudflare R2 без платы за трафик. |
| Kit, GSAP, шрифты, игры | Vercel CDN, папка public/ | Деплоятся вместе с приложением, версия в пути: /kit/v1/. |
| Каталог: темы, план, секции, слова | Postgres (копия из Git) | Быстрые запросы и связи с прогрессом учеников. |
| Ученики, подписки, прогресс | Postgres | Транзакции, RLS, ежедневные бэкапы. |
planned → ветка guide/a1.dative.index.html, guide.json, упражнения.guides/a1.dative/v1/.published, сброс кэша. Гайд появился у учеников.| 1 · Статика | Kit, игры, аудио, картинки — большая часть трафика. CDN, сервер не участвует. |
| 2 · Гайды | HTML через сервер после проверки доступа, дальше — кэш в браузере. |
| 3 · Каталог | План и темы одинаковы для всех. Кэш Next.js, сброс при публикации. |
| 4 · Личное | Прогресс, дашборд, слова. Postgres по индексам, дашборд из агрегатов. |
| 5 · События | ~17 запросов/с в пик. Батчи, пакетная вставка, без дублей. |
| 6 · Транзакции и фон | Урок пройден, XP, вебхуки Paddle, агрегаты, письма. Решает сервер. |
Зарегистрировался, не платит. Доступ по правилам пробного периода.
Активная подписка: все города, гайды, упражнения, игры, дашборд.
Поддержка и контент: ученики, подписки, продление пробного, статусы тем, аналитика.
Ты, разработчик: всё, что может админ, плюс роли, цены, настройки, фича-флаги.
| Что можно | Пробный | Ученик | Админ | Суперадмин |
|---|---|---|---|---|
| Маршрут, первые уроки Стамбула, одна игра | ✓ | ✓ | ✓ | ✓ |
| Все города, упражнения, тесты, повторение, все игры | ~по настройке | ✓ | ✓ | ✓ |
| Свой дашборд и статистика | ✓ | ✓ | ✓ | ✓ |
| Ученики, подписки, продление пробного, поддержка | ✕ | ✕ | ✓ | ✓ |
| Статусы тем, аналитика гайдов и игр | ✕ | ✕ | ✓ | ✓ |
| Назначать админов, цены, пробный период, фича-флаги | ✕ | ✕ | ✕ | ✓ |
| «Войти как ученик» (только чтение, с журналом) | ✕ | ✕ | ✕ | ✓ |
| Удалять аккаунты и данные | ✕ | ✕ | ✕ | ✓ |
app_role в профиле: user, admin, superadmin. Попадает в JWT через Custom Access Token Hook, RLS читает её оттуда.trial, student, expired. Считается из trial_ends_at и подписки. Если бы это была роль, её пришлось бы переключать руками — и кто-то бы забыл./api/v1 и Postgres-функции. «Урок пройден → XP → стрик → следующий урок» — одна транзакция.audit_log.alter table user_guide_progress enable row level security; create policy "свой прогресс" on user_guide_progress for select using (user_id = (select auth.uid())); create policy "админы видят всех" on user_guide_progress for select using (((select auth.jwt()) ->> 'app_role') in ('admin', 'superadmin')); -- политик insert/update нет: -- писать может только сервер (секретный ключ) -- суперадмин — только миграцией: update profiles set app_role = 'superadmin' where id = '<твой user id>';
frame-ancestors 'self')/api/track и вход; подпись вебхуков Paddle проверяетсяДля подписочного продукта важны три вещи: тариф хостинга, который разрешает коммерческое использование, ежедневные бэкапы и платёжный провайдер, который работает с продавцами из твоей страны. Всё ниже — управляемые сервисы: серверы администрировать не нужно.
| Компонент | Где | Тариф | Почему |
|---|---|---|---|
| Платформа | Vercel, регион fra1 | Pro, $20 | Бесплатный Hobby запрещает коммерческое использование. В Pro есть $20 кредита на использование, превью на каждый PR. |
| База, вход, файлы | Supabase, Франкфурт | Pro, от $25 | Бесплатный тариф засыпает без активности и без бэкапов. В Pro — ежедневные бэкапы и 250 ГБ трафика. |
| Оплата | Paddle Billing | 5% + $0,50 с платежа | Подписки, повторные списания, налоги и счета. Выплаты раз в месяц в USD или EUR. |
| Почта | Resend | $0–20 | Письма с твоего домена: вход, пробный заканчивается, оплата. |
| Домен и DNS | Cloudflare | DNS бесплатно, домен ~$15–40 в год | Позже здесь же — R2 для медиа, если вырастет трафик. |
Vercel и Supabase — в одном регионе. Функции Vercel ставятся в fra1, рядом с базой во Франкфурте. Если оставить регион по умолчанию (США), каждый запрос к базе станет медленнее на 100+ мс.
main → прод. Настраивать нечего.main — миграции, публикация изменённых гайдов, content-sync.supabase start.on: [pull_request, push] jobs: check: # каждый PR - pnpm typecheck && pnpm lint - pnpm test # Vitest: domain, RLS - pnpm guide:check --changed - pnpm e2e --base-url=$PREVIEW_URL release: # только main - supabase db push # миграции - pnpm content:publish --changed # озвучка, гайды → Storage - pnpm content:sync # каталог → Postgres
/api/health — проверка раз в минуту/api/track и вебхуков PaddleГайд — отдельная страница в iframe, он не знает ни про ученика, ни про базу. Он только сообщает факты через postMessage, а приложение дописывает пользователя и отправляет данные на сервер. Поэтому 310 гайдов не зависят от кода платформы.
Если засчитывать секцию при простом показе, быстрый скролл до конца даст «100% прочитано». Поэтому учитываем время:
Гайд пройден, когда прочитано не меньше 80% секций и сдан тест в конце. Кнопка «Продолжить» на маршруте ведёт ровно в последнюю секцию.
| Событие | Куда пишем |
|---|---|
guide_open | events, прогресс: начат |
section_read | events, прогресс: секция и % |
heartbeat | только счётчик активного времени, не в events |
exercise_answer | exercise_attempts + events |
audio_play | events |
guide_complete | прогресс, XP, открытие следующего урока |
create table user_guide_progress ( user_id uuid references auth.users, topic_id text references topics, -- a1.dative guide_version int, last_section text, -- для «Продолжить» sections_read text[], -- ключи секций read_pct smallint, active_seconds int, quiz_best_pct smallint, started_at timestamptz, completed_at timestamptz, primary key (user_id, topic_id) );
Всё, что видит ученик: секции, время, ответы, стрики. Сырые события лежат в таблице с партициями по месяцам и живут 90 дней, агрегаты — всегда.
Только ключевые события: регистрация, первый гайд, пробный → оплата, город пройден, отмена подписки. Детальные события туда не шлём: при 5 000 учеников в день это десятки миллионов событий и сотни долларов в месяц.
Таблицы каталога заполняет CI из карт, гайдов и игр. Таблицы учеников пишет только сервер. Админка и суперадминка — свои экраны в приложении.
profilessubscriptions, paymentssettingscities → units → lessonsbuild-plan.tstopics, topic_prereqs, topic_linksguides, guide_sections, exercises, vocab_itemsuser_lesson_progressuser_guide_progressexercise_attemptsvocab_itemsuser_cardsgames, game_sessionsxp_events, streakseventsdaily_user_stats, guide_section_statsaudit_logКак определяется уровень. При регистрации — адаптивный тест на 12–15 вопросов, он выбирает стартовый город. Дальше уровень растёт по пройденным городам, а уровни навыков считаются по ответам: у каждого упражнения есть навык и тема.
Kit, игры и медиа раздаёт CDN, гайды кэшируются в браузере, каталог — в кэше Next.js. До базы доходит почти только личное: прогресс и события. Для Postgres это мало.
Доли — оценка по трафику. Пики: вечер 19:00–22:00, рассылки, начало учебного года. Соединения идут через пулер Supavisor, чтобы serverless-функции не исчерпали лимит базы.
Стек как есть: Supabase Pro с compute Small.
Compute Medium, реплика для чтения под дашборды, медиа — в Cloudflare R2.
Сырые события → ClickHouse, очередь для событий и писем. Остальное не меняется.
Серверы — самая маленькая статья. Главные расходы: комиссия за оплату и время на контент. Цифры ориентировочные, по публичным тарифам на октябрь 2026 — проверь перед покупкой.
| В месяц | Старт, до 1 000 | 5 000 в день | 50 000 в день |
|---|---|---|---|
| Vercel Pro | $20 | $20–40 | $60–150 |
| Supabase Pro + compute | $25 | $30–60 | $110–250 |
| Resend | $0–20 | $20 | $35–90 |
| Sentry, PostHog | $0 | $0–26 | $26–150 |
| Cloudflare: DNS, позже R2 | $0 | $0 | $5–20 |
| Домен | ~$2 | ~$2 | ~$2 |
| Итого инфраструктура | ≈ $50–70 | ≈ $75–150 | ≈ $240–660 |
Озвучка: около 1–1,5 млн символов. Azure или Google — $15–30 после бесплатного лимита, ElevenLabs — до $150.
Продвигай годовой тариф. Фиксированные $0,50 съедают дешёвые месячные подписки. При 1 000 подписчиков сервер обходится примерно в $0,07 на ученика в месяц, а комиссия — в $0,90 с месячного платежа.
10 дней — реально для рабочей платформы, если работать полный день и не расширять объём. Это не 310 гайдов: конвейер гайдов стартует на 3-й день и идёт параллельно. Подробные промпты на каждый день — в плане для Claude Code.
Сделай сегодня, до дня 1. Подай заявку в Paddle: проверка домена и личности занимает несколько дней. Для проверки нужен живой сайт на твоём домене с ценами, офертой, политикой конфиденциальности и правилами возврата — поэтому лендинг с этими страницами выходит в первый же день.
Честно про контент. 310 уникальных гайдов с проверкой — это 10–15 в день, то есть ещё 3–4 недели после старта конвейера. К запуску реально: первые юниты Стамбула. Остальные темы видны на маршруте как «скоро» и открываются по мере публикации.
/admin закрыт для обычного пользователя.build-plan.ts и content-sync.ts, тесты графаkit.js, kit.css, tracker.js, шаблон гайдаcontent:publish: проверка контракта, озвучка, загрузка в Storage/g/…: отдаёт гайд из приватного бакета только при доступе/api/track: батчи, без дублей, партиции<a-exercise>: 5 типов — пропуски, сопоставление, выбор, сборка фразы, верно/неверноgame-sdk.js, раздел «Игры», первая игра «Найди пару»/code-review и /security-review по всему проектуГород за городом, в порядке маршрута.
Всё это не мешает запуску и лучше делается на реальных данных.
Два файла делают Claude Code предсказуемым: CLAUDE.md — правила проекта, которые он читает в каждой сессии, и PLAN.md — промпты на каждый из 10 дней. Положи оба в корень нового репозитория.
Подготовка перед днём 1, промпт на каждый день, критерий «готово», промпт для конвейера гайдов.
Продукт, стек с версиями, структура, правила, контракты гайда и игры, трекинг, доступ, команды, чек-лист запуска.
| Задача | Модель | Effort | Почему |
|---|---|---|---|
| План дня (plan mode) | Opus 5.5 | high | Ошибка в плане стоит дня работы. Opus лучше видит связи между частями. |
| Схема БД, RLS, роли, оплата, доступ к гайдам | Opus 5.5 | high | Здесь деньги и безопасность — дешёвая модель тут обходится дороже. |
| Ревью безопасности (день 9), сложные баги | Opus 5.5 | xhigh или max | Редко, но глубоко. Долго и дорого — только по делу. |
| Экраны, компоненты, API по готовому плану | Sonnet 5.5 | medium | Основная масса кода. Быстро и экономно. |
| Трекер, построитель плана, движок упражнений | Sonnet 5.5 | high | Логика с краевыми случаями, но задача хорошо описана. |
| Гайды, упражнения, игры по шаблону | Sonnet 5.5 | medium | Много однотипной работы. Opus — только для эталонного первого гайда. |
| Тексты, мелкие правки стилей, переименования | Sonnet 5.5 | low | Думать не над чем. |
PLAN.md. Читаешь план, правишь, утверждаешь./model → Sonnet. Одна задача — одна сессия; /clear между задачами, чтобы контекст не засорялся./code-review по изменениям дня, правки, мерж в main.Их нужно закрыть до дня 1 или в первые дни: от ответов зависит, где хранить данные, как принимать оплату и что видит пробный пользователь.
Закон РК требует, чтобы база с персональными данными граждан находилась в Казахстане. Юристы спорят, допустима ли копия за рубежом, но основная база в РК устраивает оба толкования. С поправками 2026 года место хранения базы ещё и нужно указывать в уведомлении регулятору.
Решение для 10 дней: Supabase во Франкфурте, минимум личных данных (только email и имя) и консультация юриста сразу. Если нужна локализация — план Б: Docker Compose (Next.js + self-hosted Supabase) на сервере в РК, например Yandex Cloud kz1 или PS Cloud. Код не меняется, это +3–5 дней.
Stripe не работает с продавцами из Казахстана. Paddle работает: Казахстана нет в списке запрещённых стран, НДС РК он считает и платит сам, выплаты раз в месяц в USD или EUR.
Решение: Paddle на старте, Polar — если Paddle откажет (Казахстан есть в списке выплат Polar). Местный эквайринг (Freedom Pay, TipTop Pay) — после запуска, когда выручка оправдает работу над своими подписками.
Варианты: 7 дней полного доступа без карты или первые уроки Стамбула навсегда.
Рекомендация: 7 дней полного доступа без карты (считает платформа, а не Paddle), после — остаются первые уроки Стамбула и пейволл. Всё хранится в settings, суперадмин меняет без релиза.
Месяц и год, валюта, цена с НДС или без.
Из-за фиксированной комиссии $0,50 выгоднее продвигать годовой тариф. Цены живут в Paddle, в базе — только их id.
Email (код или ссылка) и Google — с первого дня.
Вход через Telegram популярен в СНГ, но в Supabase его нет из коробки. После запуска.
310 уникальных дизайнов без ограничений превратятся в 310 тяжёлых страниц на слабых телефонах.
Лимит 400 КБ JS + CSS без медиа и LCP меньше 2,5 с — проверка в CI с первого гайда.