Перейти к содержимому

Source of Truth

Актуально на: 2026-05-02 (v1.3) Owner: Jean (design lead) Co-maintainers: Темирхан Кенжебаев (генеральный продюсер), Ирлен Турлыханов (dev lead), Лолита Удар­цева (методолог-лид) Review cadence: после завершения каждой sub-сессии + квартально audit.

v1.3 KEY ADDITIONS (2026-05-02):

  • Geographic scope Y1 narrowed: KZ-national from Almaty + late-Y1 KG soft from Bishkek (ADR-0020). CIS broader + Türkic broader shifted to Y3+
  • Cartoon production cadence canon: 10 ep × 3 langs (KZ+RU+EN) × ₸750K/ep all-in × ~5 seasons/year, S1 paid + airs 11 May 2026, 3-person cartoon team (director + sound engineer + AI gen visuals/editor) (ADR-0021)
  • Tranched SAFE structure: T1 $200K + T2 $200K + T3 $150K = $550K total milestone-gated over 12 mo, $8M post-money cap (ADR-0022)
  • Local AI infrastructure canon: DeepSeek V4-Flash 284B + Kimi K2.6 1T on owned hardware, OIYNUP AI fine-tune on KZ corpus, no Anthropic baseline, no Soyle enterprise, no Firebase, no Adobe, no JetBrains (ADR-0023)
  • Danone Y1 ask = ₸35M canon multi-channel exclusive package with ₸350/kid lead pricing math (₸35M / 100K cumulative unique exposed) (ADR-0024)
  • KazTelecom Y1 dual-option pitch (cash sponsor OR cash + telecom services trade), both equal (ADR-0025)
  • Bottom-up funding ₸252M Y1 base / ₸308M buffered (~22% weighted) with 25% buffer methodology by bucket (canon-corrections C6)
  • Wage structure: 10 core humans + agents replacing junior dev/marketing/QA, founder fair comp Ivan + Irlen ₸2M/mo, Лолита Y1 paid ₸300K/mo, animator role added (canon-corrections C6)
  • Software stack stripped: -Anthropic -Firebase -Soyle -Adobe -JetBrains, +Claude Code Max +fal.ai = ₸22M Y1 (canon-corrections C10)
  • V3 contract sum ₸57,84M canon verified via docx body extraction (ADR-0008 amended)
  • 6 new ADRs (ADR-0020..0025) + 1 amended (ADR-0008)
  • Canon-corrections spec: docs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md

v1.2 (2026-05-01):

  • OIYNUP позиционируется как Mediafranchise для CIS+Türkic (~55M детей 2-10), Y3+ metaverse cross-IP platform (ADR-0013)
  • Wearable canon = AI-pin в MVP, голограммы и phygital bracelet отклонены (ADR-0014)
  • Self-production через китайский электронный core + 3D-печатные тела in-house для toys/AI-pin/smart devices, Qtoys 60/40 отклонён (ADR-0015)
  • Multi-source funding strategy (drop ₸103,77M Almaty Finance bank-anchor headline) (ADR-0016)
  • Best-in-class hardware (RTX PRO 6000 Blackwell, Mac M3 Ultra, Threadripper PRO) (ADR-0017)
  • Release dates corrected: 1 авг 2026 game release, 1 сент 2026 Season Pass patch (было «1 сент 2026 release») (ADR-0018)
  • Realistic financial baseline принят как канон (Y1 ₸86M revenue, Y4 ₸4B, breakeven Y2-end), aspirational модель архивирована (ADR-0019)
  • V3 contract сумма corrected: ₸57,84M (docx body wins over ADR-0008 ₸51,24M)
  • OКЭД set из реестра: 59200 main + 32400/58210/59110/62011/74100 secondary
  • Q1-Q10 decisions log: docs/superpowers/specs/2026-05-01-decisions-log.md

Единый индекс всех решений OIYNUP: где что живёт, что canonical, что draft, как разрешаются конфликты. Этот файл — карта, не источник. Каждая строка указывает на конкретный doc / ADR, который является реальным источником правды для своей области.

Зачем:

  • Sub-сессии (AI-агенты + люди) не переписывают canonical файлы по умолчанию.
  • Конфликты между sub-сессиями разрешаются через единый протокол.
  • Новый член команды за 15 минут понимает «где что искать».
  • Quarter-audit превращает его в живой документ, а не бумажку.
┌─────────────────────────────────────────────────────────────┐
│ Layer 1 — META (how we work) │
│ - projects/oinap/CLAUDE.md — как подходить к работе│
│ - projects/oinap/SOURCE_OF_TRUTH.md — этот файл │
│ - projects/oinap/docs/adr/ — записи решений │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Layer 2 — CANON (locked, source of truth) │
│ - docs/superpowers/specs/2026-04-19-oiynup-world-design.md │
│ - docs/Архитектура_для_разработчика.md │
│ - docs/Механики_MVP_актуальные.md │
│ - docs/01_GDD_Мир_Форм.md (base GDD v3) │
│ - contracts/ (V3 контракт) │
│ - ADR-0001..ADR-000X (immutable) │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Layer 3 — DRAFT (sessions in progress) │
│ - docs/superpowers/specs/2026-04-22-* │
│ - любые новые спеки из S1-a..g, S2-S7 │
│ - раз в sub-сессию может повыситься до CANON + новый ADR │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Layer 4 — OPTIONS / RAW (не truth, только идеи-пул) │
│ - docs/superpowers/specs/2026-04-22-raw-idea-inventory.md │
│ - docs/_gemini-brainstorm-imports/ │
│ - BACKLOG.md │
└─────────────────────────────────────────────────────────────┘
КонцернOwner fileLayerStatusLast reviewedRelated ADR
Narrative / World
World design (хаб, фазы, биомы, прогрессия, экономика верхнего уровня)docs/superpowers/specs/2026-04-19-oiynup-world-design.mdCanonLOCKED v1.02026-04-19ADR-0001
GDD база (персонажи, механики базовые, туториал)docs/01_GDD_Мир_Форм.mdCanonLOCKED v3.02026-04
Лор углублённый (пантеон, NPCs, биомные мифы)pending S1-a outputDraftPENDING
Game Mechanics
12 canonical mechanics (MVP scope)docs/Механики_MVP_актуальные.mdCanonLOCKED2026-04-19ADR-0002
6 mechanic proposals (backlog)docs/Механики_предложения_backlog.mdCanonBACKLOG2026-04-19
25-pool расширенный (outdated)docs/Игровые_механики.mdCanonSTALE — use 12-canon2026-04-19ADR-0002
Mechanics carts + decision on NPC-chase / Тенгриpending S1-b outputDraftPENDING
Matrix architecture (mech × biome × subject orthogonal)docs/Архитектура_для_разработчика.mdCanonLOCKED2026-04-19ADR-0003
Progression / Economy
Level = school quarter (формула)docs/superpowers/specs/2026-04-19-oiynup-world-design.md §ПрогрессияCanonLOCKED2026-04-19ADR-0004
Two currencies (Монеты + Кристаллы), no pay-to-windocs/superpowers/specs/2026-04-19-oiynup-world-design.md §ВалютыCanonLOCKED2026-04-19ADR-0007
Battle Pass / boosters / lootboxes designpending S1-f outputDraftPENDING
Tokenomics (deferred post-MVP Year 2+)project_oinap_v3_plan memory + raw-inventory §22CanonDEFERRED2026-04-22ADR-0012
AI Napar­nik
Napar­nik architecture (3 оси: skin × personality × voice)docs/superpowers/specs/2026-04-19-oiynup-world-design.md §НапарникCanonLOCKED2026-04-19ADR-0001
AI tutor stack LOCKED — DeepSeek V4-Flash 284B + Kimi K2.6 1T on owned hardware, OIYNUP AI fine-tune on KZ corpus, no Anthropic API baselinedocs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md §C7CanonLOCKED2026-05-02ADR-0023
KZ STT/TTS open-source stack — Whisper Large-v3 KZ + Coqui XTTS-v2 + F5-TTS + ISSAI Soyle base, custom voice training on owned hardwarebenchmark Y1H1 task for AI engineerDraftDRAFT (benchmark Y1H1)2026-05-02ADR-0023
Personality design + emotion triggers (3 character × 3 voice = 9 custom voices)pending Y1H1 implementationDraftPENDING (implementation)ADR-0001 + ADR-0023
15 Spark emotion assets~/.claude/projects/.../memory/project_oinap_uikit_v2_progress.md §SparkCanonLOCKED2026-04-19
Hub / UX
Ғарыш-база как orbital station (архитектура хаба)docs/superpowers/specs/2026-04-19-oiynup-world-design.md §ТопологияCanonLOCKED2026-04-19ADR-0005
Horizontal orientation (landscape)docs/superpowers/specs/2026-04-19-oiynup-world-design.md + memoryCanonLOCKED2026-04-07ADR-0006
Multiplayer / co-op / match format / singleplayer flowpending S1-g outputDraftPENDING
Player journey (end-to-end UX)pending S5 outputDraftPENDING
Physical products
Qtoys vs self-production decisionpending S1-e output (текущая позиция: 40/60 in Qtoys favor)DraftPENDING
Phygital bracelet tech stack + BOMpending S1-d outputDraftPENDING
Bracelet concept (руны, голограмма)docs/phygital-bracelet-concept.mdCanonLOCKED (v1 concept)2026-04
Content
Question bank (Rank 1–2 600 вопросов + 2000 validated)docs/book_validation/pipeline/output/ + Firebase exportCanonLOCKED (grades 1-2)2026-04
Question bank grades 3-4pending content sessionDraftPENDING
Анимационный сериал «Мир Форм»Производитель: Grinvich Technology. Премьера май 2026 на двух разных детских телеканалах: «Балапан» и TV+ (НЕ нести как один канал «TV+ Балапан»). Те же актёры озвучки в сериале и в игре.CanonLOCKED2026-04-27
Аудитория проекта (для всех публичных материалов)2–10 лет. Внутренние треки: дошкольники 2–6 (формы, цвета, счёт, буквы), младшеклассники 6–10 (1–4 классы по программам Атамура и Алматыкітап). НЕ писать «6–10 лет» в клиентских/партнёрских материалах. Источник: Hero на oiynup.kz.CanonLOCKED2026-04-27
ИИ-напарник — имяПо умолчанию имени НЕТ. Ребёнок придумывает имя сам в процессе настройки (имя + характер + один из трёх голосов). «Спарк» — рабочий технический ярлык в Figma/коде, НЕ канон, в копи не выводить.CanonLOCKED2026-04-27
Партнёрские форматы интеграции (B2B копирайт-канон)4 формата: (1) лицензированный герой партнёра как ИИ-напарник на сезон — пример «Щенячий патруль»; (2) продукт партнёра как поднимаемый бонус на уровне — пример Danonino даёт ×2 монеты/опыт; (3) совместная фигурка в коробке с QR-кодом, разблокирующим скин; (4) cameo бренда/героя в эпизоде сериала. НЕ использовать «Растишка-степь» и подобные старые наброски.CanonLOCKED2026-04-27
Design System / UI
Game UI Kit v2 (Figma + 13 screens + components)docs/superpowers/specs/2026-04-19-game-ui-kit-v2-design.md + Figma wJ0S3psoTB66ZxkfvVWLOqCanonLOCKED v2.02026-04-19
Brand identity (GG Zaglav + Nunito, palette)context/brand-identity.md (studio) + FigmaCanonLOCKED2026-04
Landing oiynup.kzdeployed v2 Cloudflare PagesCanonLIVE2026-04
Tech / Infrastructure
Unity stack (6.3 URP NGO Addressables)memory project_oinap_codebase_map.md + codebaseCanonLOCKED2026-04-19
3D asset pipeline (fal.ai + Meshy + gltf-transform)CLAUDE.md §3D + memory project_oinap_3d_asset_pipeline.mdCanonLOCKED2026-04-19
Server architecture (Linux + Mac Studio M3 Ultra + RTX 5060 Ti)Astana Hub presentation §TechnicalCanonLOCKED2026-04-19
Netcode stack (Mirror vs NGO vs Fusion)pending network session — not yet assignedDraftOPEN QUESTION
Save system / account / parental dashboardnot yet designed — gapGAP
Geographic scope
Y1 = KZ national from Almaty + Y1H2/Y2H1 = KG soft from Bishkek + Y3+ broader CIS (Russia conditional) + Türkic broaderdocs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md §C1CanonLOCKED2026-05-02ADR-0020
Cartoon production cadence — 10 ep × 3 langs (KZ+RU+EN) × ₸750K/ep all-in × ~5 seasons/yrdocs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md §C9CanonLOCKED2026-05-02ADR-0021
Business / Finance / Legal
V3 dev contract (Темирхан × Ivan/Жан × Ирлен) = ₸57,84M (verified docx body 2026-05-02)contracts/Договор_OIYNUP_v3.docxCanonLOCKED2026-05-02ADR-0008 amended
Tranched SAFE structure T1 $200K + T2 $200K + T3 $150K = $550K total milestone-gated, $8M post-money capdocs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md §C8CanonLOCKED2026-05-02ADR-0022
Bottom-up funding need Y1 ₸252M base / ₸308M buffered (~22% weighted)docs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md §C6CanonLOCKED2026-05-02canon-corrections C6
Astana Hub presentation (103,7 M ₸ headline)updated_plan/astana_hub_presentation.mdCanonSTALE — update after S42026-04
Scope filter MVP vs post-MVPpending S2 outputDraftPENDING
Financial model (4-year cost + revenue)pending S3 output + xlsxDraftPENDING
Business plan (для Astana Hub подачи)pending S4 outputDraftPENDING
ТОО Grinvich Technology (BIN 181240026177, director Шарипов)contracts/ + Astana Hub docsCanonLOCKED2026
IP защита (Казпатент + авторские)in progress (backlog)DraftIN PROGRESS2026-04
Налоговый режим — общеустановленныйmemory feedback_tax_regime.mdCanonLOCKED2026
Partnerships
Qtoys partnership termspending S1-e outputDraftPENDING (40/60 draft position)
Danone Y1 ₸35M canon multi-channel exclusive package, ₸350/kid lead pricingpartnerships/danone/ (CP v3 to be written Block C) + canon-corrections §C2CanonLOCKED2026-05-02ADR-0024
Kazakhtelecom Y1 dual-option pitch (cash sponsor OR cash + telecom services trade, both equal)partnerships/kazakhtelecom/ (CP v1 to be written Block C) + canon-corrections §C3CanonLOCKED2026-05-02ADR-0025
FMCG outreach list (9 P1 контактов)partnerships/CanonLOCKED (list)2026-04
Operations / Meta
Session decomposition methodology (S1-a..g + S2..S7)docs/superpowers/specs/2026-04-22-session-decomposition-and-prompts.mdCanonLOCKED v1.02026-04-22ADR-0011
Raw idea inventory (options, not truth)docs/superpowers/specs/2026-04-22-raw-idea-inventory.mdOptions2026-04-22
Project backlogBACKLOG.mdCanonLIVE2026-04-22
Cancelled / deferred
GITEX 4-5 May 2026dropped from roadmapCANCELLED2026-04-22ADR-0009
Astana Hub-first priority (до VC / Danone)this SOT + ADR-0010CanonLOCKED2026-04-22ADR-0010
  • LOCKED — канон, менять только через новый ADR + approval Jean.
  • DRAFT — активная работа, finalized через Jean approval.
  • PENDING — ждёт запуска соответствующей sub-сессии.
  • STALE — устарел, требует обновления (обычно после завершения цепочки sessions).
  • DEFERRED — решено отложить, не менять без ADR.
  • CANCELLED — отменён, не возвращаться без ADR.
  • GAP — дыра, не покрыто ни одним документом — требует новой сессии.
  • OPEN QUESTION — есть противоречия / нет консенсуса.
  • LIVE — непрерывно обновляемый не-ADR артефакт (backlog, landing).

Любая sub-сессия (человек или AI-агент) ОБЯЗАНА прочитать до каких-либо write-операций:

  1. projects/oinap/CLAUDE.md
  2. projects/oinap/SOURCE_OF_TRUTH.md (этот файл)
  3. projects/oinap/docs/adr/README.md
  4. Все ADR относящиеся к своей области (см. «Related ADR» колонку выше)
  5. Owner-файлы своей области из матрицы выше
  • Не переписывать LOCKED файлы напрямую.
  • Если новое решение противоречит LOCKED — создать новый ADR со статусом Proposed, пометить Supersedes: ADR-XXXX, флагом DISCUSS с Jean, и только после Jean approval повышать ADR до Accepted + обновлять SOT.
  • Новое решение/факт, не покрытое ни одним LOCKED файлом — в DRAFT-спеку своей сессии.
  • После Jean approval — DRAFT повышается до LOCKED: добавляется ADR, обновляется SOT.
  • Флаг CONFLICT, wait Jean.
  • Jean принимает решение, создаётся ADR Resolves: ADR-A vs ADR-B.

Автор sub-сессии обновляет:

  1. Этот файл (SOURCE_OF_TRUTH.md) — меняет статус из PENDING → DRAFT или LOCKED.
  2. docs/adr/ — добавляет 1+ ADR для новых решений.
  3. Делает commit с сообщением oinap: <session-id> complete — <summary>.

Вставить в начало любой sub-сессии (S1-a..g, S2..S7, и прочих будущих):

ПЕРЕД ЛЮБОЙ ЗАПИСЬЮ В ФАЙЛ:
1. Прочитай `projects/oinap/CLAUDE.md`.
2. Прочитай `projects/oinap/SOURCE_OF_TRUTH.md` (полностью).
3. Прочитай `projects/oinap/docs/adr/README.md` и все ADR'ы
относящиеся к твоей области (см. Owner Matrix в SOT).
4. Любое утверждение, противоречащее LOCKED owner-файлу,
оформляй как **новый ADR** со статусом `Proposed`
(template: `projects/oinap/docs/adr/ADR-template.md`),
пометкой `Supersedes: ADR-XXXX`, флагом `DISCUSS с Jean`.
НЕ переписывай canonical файл самостоятельно.
5. Новые решения твоей сессии — финализируй как **новые ADR'ы**
(даже если впоследствии статус будет `Proposed` до Jean approval).
6. После завершения: обнови `SOURCE_OF_TRUTH.md` —
поставь статус своей области на DRAFT или LOCKED и добавь ссылки
на свой output-файл + на созданные ADR.
  • 2026-04-22 v1.0 — создан после S1 (raw idea inventory). Зафиксированы 12 initial ADR для уже ratified решений. Матрица concern → owner построена.
  • 2026-04-27 v1.1 — внесены канонические факты для B2B/партнёрских материалов после сессии по B2B-видео: исправлен производитель сериала (Grinvich Technology, не ALACAST), разделены телеканалы «Балапан» и TV+, зафиксирована публичная аудитория 2–10 лет, политика именования ИИ-напарника, четыре формата партнёрских интеграций.
  • 2026-05-02 v1.3 — Canon corrections per Jean direction during continuation session. 10 corrections (C1-C10) locked: Y1 narrowed to KZ-national-from-Almaty + late-Y1 KG-soft-from-Bishkek; Danone Y1 ask restored to ₸35M as exclusive multi-channel package with ₸350/kid-cumulative-unique-exposed math; KazTelecom Y1 dual-option pitch (cash sponsor OR cash+telecom-services trade, equal); V3 contract sum ₸57,84M canon verified via docx body extraction (ADR-0008 amended); Block A verification file deliverable specified; bottom-up funding need ₸252M Y1 / ₸308M buffered with 25% weighted buffer methodology; OIYNUP AI fine-tune strategy on local DeepSeek V4-Flash + Kimi K2.6 (no Anthropic API baseline, no Soyle enterprise, no Firebase, no Adobe, no JetBrains; +Claude Code Max +fal.ai); tranched SAFE T1 $200K + T2 $200K + T3 $150K milestone-gated; cartoon production cadence 10ep × 3langs × ₸750K all-in × ~5 seasons/year (3-person FT cartoon team inside per-ep allocation); software stack stripped to local-first ₸22M Y1; wage structure 10 core humans + agents replacing junior dev/marketing/QA, founder fair comp Ivan + Irlen ₸2M/mo + Лолита Y1 paid + animator role added. 6 new ADRs (ADR-0020 geography, ADR-0021 cartoon cadence, ADR-0022 tranched SAFE, ADR-0023 local AI infra, ADR-0024 Danone canon, ADR-0025 KazTelecom dual-option) + 1 amended (ADR-0008). Spec: docs/superpowers/specs/2026-05-02-canon-corrections-jean-direction.md.
  • 2026-05-01 v1.2 — major session по Mediafranchise positioning + financial recalibration. Создано:
    • 8 новых specs: 2026-05-01-mediafranchise-business-plan-design.md, 2026-05-01-realistic-financial-recalibration.md, 2026-05-01-decisions-log.md, 2026-05-01-best-practices-audit.md, и 2026-05-01-mediafranchise-research/{00-synthesis, 01-hardware-quotes-2026, 02-unit-economics-benchmarks, 03-market-sizing-kz-turkic-cis, 04-funding-comparables}.md
    • 7 новых ADRs: ADR-0013 (Mediafranchise vision), ADR-0014 (AI-pin canon + self-production), ADR-0015 (vertical self-production drop Qtoys), ADR-0016 (multi-source money strategy), ADR-0017 (equipment best-in-class), ADR-0018 (release dates 1 авг + 1 сент), ADR-0019 (realistic financial baseline)
    • 2 canon docs обновлены: partnerships/EDITORIAL_POLICY.md (v2.0), partnerships/email_template.md (v2.0)
    • Stale pending sessions: S1-c (AI tutor speech stack), S1-d (phygital bracelet — DROPPED ADR-0014), S1-e (Qtoys vs self-prod — RESOLVED ADR-0015), S1-f (battle pass design), S1-g (multiplayer flow), S2 (reality check — DONE через recalibration), S3 (financial model — DONE), S4 (business plan — IN PROGRESS, next session deliverables: Investor BP / Danone CP v3 / KazTelecom CP v1)
    • Aspirational финмодель архивирована в main spec §4-5 superseded markings; recalibration принят как primary baseline (ADR-0019)
    • Главные числа canon (для всех новых документов): Y1 revenue ₸86M, Y4 ₸4B, breakeven Y2-end, Pre-Seed SAFE $200-300K @ $8-10M post-money cap, Danone Y1 pilot ₸15-20M (не 35M Take), KazTelecom Y1 ₸20-35M (не 50-70M)