Pre-pilot gate¶

Назначение¶

Этот документ содержит решения, которые намеренно отложены до подготовки внешнего пилота. Они не блокируют проектирование БД, разработку или внутреннее тестирование на синтетических/разрешённых данных. Они блокируют подключение реальных внешних пользователей и production-платежей.

Каждый пункт закрывается не устным «готово», а четырьмя полями в рабочем трекере: owner, decision, evidence link, approvedAt. Если решение меняет методику, создаётся новая версия engine/resource/policy; существующие результаты не переписываются.

PP-01 — лицензия Swiss Ephemeris¶

Связанный blocker: BLK-04.

До gate используем Swiss Ephemeris только для разработки и внутреннего тестирования. Перед внешним пилотом:

выбрать и документально подтвердить применимый вариант AGPL или Swiss Ephemeris Professional License;
проверить, совместима ли выбранная лицензия со способом развёртывания, распространения и лицензией всего продукта;
зафиксировать разрешённый источник и версию ephemeris files, обязательные notices и правила обновления;
добавить dependency/license report и manifest фактически используемых файлов в release evidence.

Owner: product/legal + tech lead. Evidence: лицензия/заключение, dataset manifest, release notices.

PP-02 — нумерология¶

Связанный blocker: BLK-06. До gate работает numerology-pythagorean-v0 из первичной методики.

Перед внешним пилотом:

эксперт выбирает школу, правила редукции 11/22/33, трактовку даты и обязательность имени;
отдельно утверждаются таблицы для кириллицы, латиницы, Ё, двойных имён и смешанного алфавита;
сравниваются минимум 10 fixtures, включая пограничные случаи;
принимается одно из решений: оставить v0, выпустить v1 либо не показывать систему в пилоте;
утверждаются versioned evidence mappings и пользовательские подписи.

Owner: эксперт по методике + product owner. Evidence: methodology card, fixtures, approval решения.

PP-03 — Human Design¶

Связанный blocker: BLK-07. До gate работает заменяемый human-design-standard-v0: design date определяется как момент, когда геоцентрическая тропическая долгота Солнца отстоит от natal Sun на 88° назад; gates/channels/centers читаются из versioned resource package.

Перед внешним пилотом:

эксперт подтверждает 88° rule, ephemeris flags, body set, gate boundaries и boundary tolerance;
утверждаются таблицы gates, channels, centers, types, authority, definition и profile;
проверяются права на методику, словарь, таблицы и пользовательские тексты;
минимум 10 fixtures сравниваются с выбранным эталоном;
принимается решение оставить v0, выпустить v1 или исключить HD из пилота.

Owner: HD-эксперт + legal/product. Evidence: resource manifest/hash, fixtures, rights review, approval.

PP-04 — Матрица судьбы¶

Связанный blocker: BLK-08. До gate работает собственная детерминированная destiny-matrix-22-v0 из первичной методики, без заявления о принадлежности к конкретной авторской школе.

Перед внешним пилотом:

выбрать школу/правообладателя либо письменно утвердить самостоятельную методику продукта;
подтвердить reduce22, набор и смысл позиций, нумерацию арканов и трактовки;
проверить права на названия, таблицы и тексты;
сравнить минимум 10 fixtures и пограничные даты;
принять решение оставить v0, выпустить v1 или исключить Матрицу из пилота.

Owner: эксперт по методике + legal/product. Evidence: methodology card, fixtures, rights review, approval.

PP-05 — приёмка натальной карты¶

Стартовая версия natal-v1 уже принята и не блокирует разработку. Перед внешним пилотом:

эксперт подтверждает house system, body set, aspect set, стартовые orbs 8°/6° и правила cusp/boundary;
выбран geocoding/timezone provider, проверены его terms/cost, а snapshot содержит coordinates, IANA zone, provider/version и закреплённую tzdata;
минимум три карты сравниваются с Astro-Seek при идентичных timezone, coordinates, zodiac и house settings;
расхождение долгот планет должно быть меньше 0,5°, а ASC/MC/house cusps — в согласованном tolerance;
проверяются DST ambiguity, отрицательная UTC date, высокие широты и запрет silent fallback с Swiss.

Если критерий не пройден, выпускается новая версия алгоритма либо функция не допускается во внешний пилот.

Owner: астролог-эксперт + tech lead. Evidence: подписанные fixtures и comparison report.

PP-06 — AI provider, model и data policy¶

Связанный blocker: BLK-10. Архитектура остаётся provider-agnostic независимо от выбора. До gate pipeline работает через FixtureAiProvider.

Перед внешним пилотом:

выбрать первый provider и конкретный model deployment по eval, стоимости, latency и availability;
проверить регион обработки/хранения, использование данных для обучения, retention, DPA/договор и процедуру удаления;
реализовать отдельный adapter и contract tests, не импортируя SDK в domain/application modules;
установить token/cost budgets, timeout/retry, concurrency limits, circuit breaker и kill switch;
прогнать одинаковый eval set для provider/model snapshot и пройти hard safety/evidence gates;
утвердить disclosure автоматизированной интерпретации и режим ручного review первой внешней выборки.

Смена provider/model после пилота создаёт новый snapshot и generation artifact, но не требует изменения доменных таблиц или API.

Owner: product + AI/tech lead + legal. Evidence: provider decision record, DPA/data review, eval report.

PP-07 — тариф и production-платежи¶

Связанные blockers: BLK-11, BLK-12. Схема поддерживает несколько тарифов, но для MVP публикуется один месячный RUB-тариф. Перед внешним пилотом:

утвердить сумму, состав entitlement, налоги/receipt lines, правила изменения цены и отсутствие/наличие trial;
создать production shop YooKassa, включить автоплатежи, HTTPS webhook и проверить сохранение payment method;
утвердить retry schedule, grace period, cancel-at-period-end, refund/no-show policies и тексты согласия;
определить юридическую схему консультаций: split, безопасная сделка или платформа-продавец с settlement;
проверить 54-ФЗ, оферту, регулярные списания, договоры с практиками и процесс финансовой сверки;
провести sandbox/rehearsal всех acceptance cases из платёжного документа.

Owner: business/finance/legal + backend lead. Evidence: catalog decision, contracts/policies, YooKassa test report.

PP-08 — Resend и e-mail OTP¶

Связанный blocker: BLK-13. В MVP единственный канал аутентификации и транзакционных уведомлений — e-mail через Resend; Telegram не рассматривается.

Перед внешним пилотом:

подтвердить sender domain и настроить SPF, DKIM и DMARC;
утвердить OTP и transactional templates без передачи кода в логи/analytics;
проверить TTL 10 минут, cooldown 60 секунд, пять попыток, лимиты по e-mail/IP/device и защиту от enumeration;
проверить bounce/complaint/suppression handling, доставляемость и fallback runbook;
проверить договорные условия, data processing и хранение provider message IDs.

Owner: backend/operations + product/legal. Evidence: DNS verification, abuse tests, deliverability report.

PP-09 — privacy, безопасность и пользовательские тексты¶

Связанный blocker: BLK-14. Для внутреннего тестирования достаточно принятого технического default: минимизация данных, object-level authorization, redacted logs, versioned consent/disclaimer и тестовые retention значения.

Перед внешним пилотом:

ответственные специалисты утверждают оферту, согласие на ПДн по 152-ФЗ, privacy notice и entertainment disclaimer;
утверждаются retention/deletion/anonymization matrix и основания хранения финансовых данных;
фиксируются controller/processor roles всех внешних providers и трансграничная передача;
проходят abuse/security checks, secret scan, dependency review, backup/restore и incident runbook rehearsal;
запрещённые медицинские, психологические, юридические и инвестиционные утверждения входят в AI safety tests.

Owner: legal/security + product/tech. Evidence: versioned policies, security report, restore/incident reports.

PP-10 — эксплуатация без админ-панели¶

Связанный blocker: BLK-15. Админ-панель не является частью MVP и не требуется для закрытия этого gate. До внешнего пилота вместо неё должны быть готовы:

structured logs, metrics и alerts для API, workers, queues, providers, payment mismatches и OTP abuse;
read-only telemetry/export для funnel и продуктовых метрик без произвольного доступа к ПДн;
идемпотентные allowlisted operational scripts для retry/reconciliation с dry-run и audit event;
runbooks для failed job, webhook mismatch, refund request, provider outage, data export/deletion и backup restore;
понятная on-call/owner matrix и журнал выполненных операционных действий.

Любая потребность в широком ручном CRUD или /admin endpoint оформляется как отдельный post-MVP scope, а не как скрытое расширение текущего backend.

Owner: tech/operations lead. Evidence: dashboards/alerts, runbooks, rehearsal report, audit samples.

Решение о запуске¶

Внешний пилот разрешён, когда PP-01…PP-10 имеют owner, решение, evidence и approval, а все критические замечания закрыты или явно приняты ответственным владельцем риска. Наличие будущего плана без evidence не закрывает gate.

Если отдельная методика не готова, допустимо выключить её feature flag и запустить пилот без неё, если продуктовый scope и пользовательские обещания обновлены. Нельзя таким способом обойти лицензию Swiss, безопасность, privacy, платёжные обязательства или эксплуатационную готовность.