Перейти к содержанию

KarmaCode: функциональная карта MVP backend

Статус: актуализация от 09.09.2026. Полный список модулей и сопоставление с исходными milestone — текущая точка входа в продуктовую декомпозицию.

Что именно строим

KarmaCode принимает данные рождения через общий онбординг, строит натальную карту по Swiss Ephemeris и формирует нумерологию и Human Design по промптам через LLM. Для точной арифметики и астрономии используются вспомогательные функции из методики. Общий отчёт объединяет результаты систем.

OpenRouter выбран шлюзом для смены LLM-моделей; токен получен. Бесплатный тариф ограничен функционально, платный даёт расширенный доступ и скидку 40% на первый месяц. Цена и квоты ещё не утверждены. Консультации оплачиваются отдельно. Оферта и политика конфиденциальности пока представлены заглушками.

Основная воронка:

ввод данных → точные расчёты и LLM-сценарии → регистрация e-mail → бесплатная выжимка → paywall → оплата → расширенный разбор

Матрица судьбы и админ-панель остаются pending. Дизайн-система и клиентский UI относятся к проекту в целом, но не к реализации этого backend-репозитория. Расписание, бронирование, видео и escrow сохранены в сравнении с исходной дорожной картой как вопросы scope.

Модули backend

Авторизация и роли; профили и онбординг; география и время; натальная карта; OpenRouter и LLM-оркестрация; нумерология; Human Design; единый разбор и история; прогнозы, цели и трекер; практики и каталог; консультации; тарифы и подписка; платежи, комиссия и выплаты; уведомления; юридические документы; аналитика и аудит; инфраструктура.

Обязанности и статус каждого модуля описаны в актуальном перечне.

Границы функциональных блоков

Расчёт и трактовка разделены принципиально:

  • точные вспомогательные функции возвращают детерминированный JSON; LLM-сценарии формируют нумерологический и HD-результат с проверкой точных полей;
  • слой интерпретаций получает только сохранённые результаты и формирует платный текст;
  • проверенные точные поля не заменяются модельными значениями; LLM-артефакты хранятся отдельно от точных расчётов;
  • одинаковые inputHash + algorithmVersion возвращают один расчёт, а одинаковые calculationHash + promptVersion + provider/model snapshot — сохранённую интерпретацию.

Оплата отделена от выдачи доступа: YooKassa сообщает состояние операции, billing фиксирует подтверждённый факт, а entitlements внутри модуля подписки решает, к каким материалам пользователь имеет доступ. Redirect из платёжной формы не является подтверждением оплаты.

Возможный admin module подключается к публичным use cases/отдельным безопасным операциям. До подтверждения нового scope в MVP нет admin role, admin endpoints и административного CRUD.

Рекомендуемый порядок реализации

  1. Foundation: схема данных, e-mail OTP/sessions, профиль и согласия, места/таймзоны, аналитические события.
  2. Бесплатная ценность: natal-v1 и утверждённый для релиза набор дополнительных движков, сохранение JSON и бесплатные фактические подписи.
  3. Деньги: тариф, первичная оплата подписки, webhook, entitlement, отмена и повторное списание.
  4. Платная ценность: оси интерпретации, асинхронная AI-генерация, кэш, маршрут и прогноз.
  5. Retention: цели, e-mail-напоминания, продления и платёжный recovery.
  6. Supply: практики, заявки, ручное согласование и оплата консультаций.
  7. Pilot readiness: финансовая сверка, эксплуатационные метрики и выполнение pre-pilot checklist.

Документы

Блокеры

План разрешения зафиксирован в реестре. Текущую БД можно проектировать без ожидания; pending scope не расширяет реализацию до письменного решения заказчика. Provisional-методики и вопросы публичного запуска не останавливают internal-разработку, но обязательны к проверке по pre-pilot checklist.