# canon/_INDEX.md — Навигатор канон-файлов

> Это **оглавление** всех ~27 канон-файлов проекта. Любая новая сессия Claude должна прочитать этот файл первым.

**Repo:** http://192.168.0.10:3000/bossiara13/farming-simulator
**Status:** канон + Акт 1 в коде (FPV-комната с placeholder-кубами, отец, подарок, флешка). HUD с датой/квестом. Следующий шаг — Акт 2.

---

## ОРИЕНТАЦИЯ ДЛЯ НОВОЙ СЕССИИ

### Минимум чтоб начать Акт 1
1. `_INDEX.md` (этот файл) — 1 мин
2. `Пролог_Первый_день.md` (в корне проекта, не canon/) — финальный сценарий пролога — 8 мин
3. `canon/CHARACTERS.md` — кто все NPC — 5 мин
4. `canon/NAMING.md` — слэнг и имена-локи — 3 мин

**Итого ~17 минут чтения** и можно стартовать FPV-сцену комнаты с подарком пека.

### Когда нужна подробность
- Цены подработок / зп / валюта → `LORE.md` + `CURRENCIES.md` + `HISTORICAL_PRICES.md`
- Мини-игры → `MINIGAMES.md`
- Риски (кидалово/гопники/погода) → `RISKS.md` + `HISTORICAL_RISKS.md`
- СПб локалка (шаверма/метро/двухтарифный счётчик) → `SAINT_PETERSBURG.md` + `HISTORICAL_SPB.md`
- Дроп-система / панели / тиры фермеров → `FARMING_DOMAIN.md`
- Скины / кейсы / wear / цены → `STEAM_ITEMS.md` + `COLLECTIONS_TIMELINE.md` + `HISTORICAL_STEAM_ITEMS.md`
- CS:GO → CS2 переход → `CS2_TRANSITION.md`
- Tegelram-каналы / блогеры → `CHANNELS.md`
- TG-новости → `NEWS.md`
- Эпилог 2022-2026 → `EPILOG.md`
- Финальное письмо → `FINAL_LETTER.md`
- Засевы → оплаты → `FORESHADOWING.md`
- Полный таймлайн → `TIMELINE.md`
- Криптокошельки → `CURRENCIES.md` + `HISTORICAL_CRYPTO.md`
- Техническая модель каталога → `DATA_PIPELINE.md`

---

## ВСЕ ФАЙЛЫ (24)

### Канон-якоря (мирообразование)
| Файл | О чём | Размер |
|---|---|---|
| `NAMING.md` | Словарь слэнга + имена-локи (Сергей/Шкалин/Толик/Сергий/Эдуард) + политика ввода имени игрока | средний |
| `TIMELINE.md` | Все даты от 21.08.2020 до 31.12.2026 + волны банов + операции CS:GO | большой |
| `CHARACTERS.md` | Все NPC: герой, Сергей-отец, мать-Псков, Андрюха, Осминог=герой-из-будущего, тов. Майор Шкалин, Толик, Сергий, Эдуард, продавцы | большой |
| `LORE.md` | Страна Р = СПб = "С.", C-19/WAR нейтрально, цены игр (Prime 990₽ до 03.06.2021), подработки СПб 2020-2022 | большой |
| `SAINT_PETERSBURG.md` | Шаверма/парадная/поребрик, метро 4 ветки, мосты разводят, двухтарифный счётчик Ленэнергосбыт | средний |
| `APARTMENT.md` | Квартира + комната героя: брежневка Купчино, обои бежевые, линолеум, ковёр на стене, батарея чугунная, ИКЕА MICKE/BILLY, постеры CS:GO+Моргенштерн на изоленте, цвета по hex | средний |
| `STREET.md` | Парадная (Eltis домофон), фасад керамики, двор спальника (тополя, ракушки-гаражи, советская площадка), метро (жетон 55₽), шаверма СПб 120-180₽, цвета по hex | средний |
| `HUD.md` | UI-философия: Pathologic-2 стиль (статы только при пороге), pixel-font, жёлтый Steam-inventory #F0B419, диалог в стиле Шиндовс-окна | средний |

### Сюжетный каркас
| Файл | О чём |
|---|---|
| `FORESHADOWING.md` | 21 засев → 21 оплата с привязкой к актам пролога и эпилогу |
| `EPILOG.md` | Эпоха 6 (2022-2026) с 30+ реальными событиями: мобилизация 21.09.2022, FTX, Wagner, CS2, Крокус, halving, YouTube блок, Discord блок |
| `FINAL_LETTER.md` | Душевное письмо героя на финале 29.05.2022, заменяет сырой концепт-док. Шрифт typewriter, без TTS. |
| `NEWS.md` | 22 канонических TG-новостей в 2 каналах (Будни / Свои) |
| `MINIGAMES.md` | 14 мини-игр от установки Шиндовс до разработки своей панели |

### Механики
| Файл | О чём |
|---|---|
| `MECHANICS.md` | 5 механик: прокси-цепочка эпилога, курс валют, шкала паранойи, журналист с интервью, двухтарифный счётчик электричества |
| `CURRENCIES.md` | 7 валют: ₽/$/€/¥/BTC/ETH/USDT. Кошельки фермера по эпохам. USDT/RUB P2P спайк фев-мар 2022 до 200₽ |
| `RISKS.md` | Реальные шансы рисков по статистике МВД: промоутер 15-25% кидалово, гопники в Купчино 0.5-1% инцидент, погода 173 дождливых дня/год СПб |
| `ITEMS.md` | Australium Wrench 2500₽ дроп, FSM Panel $180 lifetime real, кейсы, аккаунты как предметы |

### Предметная область (мегасправочники)
| Файл | О чём |
|---|---|
| `FARMING_DOMAIN.md` | Мегасправочник: 5 каст фермеров (доходы 500₽-3млн), панели по режимам (FSM=Flying Scoutsman, DM=Deathmatch), 7 эпох дроп-системы 2013-2026 (Cases→Weekly→Hydra→F2P→Prime gap→Sunset→CS2 Care Package), 14 видов фарма |
| `STEAM_ITEMS.md` | Категории/rarity/wear/StatTrak/Souvenir + процедурная формула ценообразования |
| `COLLECTIONS_TIMELINE.md` | ~50 коллекций с датами и статусами Active/Legacy/Retired/Contraband/Event-only. Howl Contraband 23.06.2014. Hydra Case 6 мес дроп. |
| `CS2_TRANSITION.md` | 27.09.2023 переход CS:GO→CS2: Source 2, Premier mode, Care Package, рыночный шок ±30-50%, CapyFarm закрылась |
| `CHANNELS.md` | Экосистема каналов: 2 разных мира (мейнстрим-блогеры Прилив vs андеграунд @octofarm), 30+ reskinned реальных каналов с user-скринов |
| `DATA_PIPELINE.md` | Техническое решение каталога: 3-слойная архитектура (~150 якорей + процедурный генератор 25к записей + опц. скрейпинг Steam Market API) |

### Research-файлы (сырые данные с источниками)
| Файл | Источник |
|---|---|
| `HISTORICAL_PRICES.md` | research-агент: CS:GO/TF2/PUBG цены, RUB-курс, зарплаты РФ 2020-2022 с источниками |
| `HISTORICAL_CRYPTO.md` | research-агент: BTC/ETH/USDT недельно 2020-2026, USDT/RUB P2P премия, регулирование РФ |
| `HISTORICAL_RISKS.md` | research-агент: реальная статистика рисков подростка СПб 2020-2022 (МВД, Statista, форумы) |
| `HISTORICAL_SPB.md` | research-агент: метро, мосты, шаверма, школа, ВиТ, электричество тарифы СПб |
| `HISTORICAL_STEAM_ITEMS.md` | research-агент: цены 30 iconic скинов по wear/year, все 50 кейсов, Australium 2020-2024, PUBG sezony |

---

## КЛЮЧЕВЫЕ КАНОН-ЛОКИ (на которых строится вся игра)

1. **Локация:** "С." = абстрактный СПБ. Действие в спальнике (Купчино / Озеро / Гражданка)
2. **Страна Р** (вместо Россия) — нейтрально для платформ
3. **Период:** 21.08.2020 (пятница) → 29.05.2022 (воскресенье, **Большая Волна Банов**) + опц. эпилог до 31.12.2026
4. **Герой:** 15 лет, 9 класс на старте, имя вводит игрок при установке Шиндовс (фильтр мата + ban "повелитель/владыка/бог")
5. **Семья:** Сергей (отец, в речи "батя"), мать в Пскове (контакт только через TG)
6. **Друг:** Андрюха (полная фамилия раскрывается в военкомате эпилога)
7. **Антагонист:** **майор Шкалин** (полиция, *"любые совпадения случайны"*). СОВЕРШЕННО НЕ Осминог.
8. **Наставник:** Осминог `@osminog_2k20` — мета-твист = сам {playerName} из будущего, пишет себе через "канал в прошлое"
9. **Финал:** на столе **распечатка-письмо** героя (canon/FINAL_LETTER.md) — душевная переупаковка концепт-дока, не сырой текст
10. **Слэнг намеренно искажён** (Шиндовс/стеме/тефе2/Тегерлам/Гмыло/митуб/Пабаджи) — защита от АП
11. **Толик** (мужик с листовками) исчезает 21.09.2022 (мобилизация, в каноне "уехал в Тверь" с подтекстом)
12. **WAR** = "Большая Операция", БЕЗ упоминания сторон/территорий/причин
13. **FSM Panel** = РЕАЛЬНЫЙ продукт, $180 lifetime, оплата только в крипте. Название = режим Flying Scoutsman
14. **Все цены/зп/курсы/риски — реальные** для конкретных дат 2020-2026
15. **Австралиевый "контракер"** = школьный сленг героя для **Australium Wrench** (Андрюха поправит 1 сен 2020)

---

## ЧТО ОСТАЛОСЬ TBD (не блокирует Акт 1)
- Полная фамилия Андрюхи (раскроется в военкомате эпилога 2023)
- Имя/отчество Шкалина в документах
- Дизайн логотипов панелей (нарисуется при кодинге)
- Детали мини-игры Care Package для CS2-эпилога
- Конкретные тексты постов в TG-каналах по дням (можно процедурно)

---

## ПОРЯДОК АКТОВ ПРОЛОГА (что кодим)

**Акт 1 ← следующий**: Подарок пека. FPV-комната, коробка, флешка, отец. Wi-Fi qwerty + механика взлома.
**Акт 2**: Установка Шиндовс. 9 ШИЗО-пунктов лицензионки. Ввод имени игрока с фильтром.
**Акт 3**: Первый запуск стеме. Big Picture. Первый аккаунт (защищённый навсегда).
**Акт 4**: тефе2 → боты убивают (засев имён `_2020` для финала).
**Акт 5**: Подработка листовки у Толика. 3 варианта поведения (85% норм / 10% аванс / 5% кидалово).
**Акт 6**: Вечер. Кухня. Кровать = save.
**Акт 7**: День 2. Снова листовки.
**Акт 8**: ★ ВТОРОЙ ЗАХОД В ТЕФЕ2. Mann Up tour 95₽ → 3 миссии → Australium Wrench 2500₽.
**Акт 9**: Выбор покупки игры (3 пути: Prime через PR21 / Prime 990₽ / Пабаджи 700₽).
**Акт 10**: Первый кейс в купленной игре.
**Акт 11**: День 3. Митуб поиск.
**Акт 12**: Создание 3 Гмыло + 3 фарм-аккаунтов.
**Акт 13**: КОНЕЦ ПРОЛОГА. Календарь. Титр "Это было лето 2020".

---

## ИНФРАСТРУКТУРА (текущая)

- **Godot:** 4.6.3 stable в `C:\Godot\Godot_v4.6.3-stable_win64.exe`
- **Проект:** `C:\Users\Dimul\Desktop\GameDev\Farming simulator\`
- **Главная сцена:** `main.tscn` — placeholder с надписью FARMING SIMULATOR, viewport 640×360 пиксель-арт. Бутится без ошибок.
- **Git:** локальный `.git` в папке проекта (НЕ глобальный в C:\Users\Dimul!)
- **Forgejo remote:** `http://bossiara13:<token>@192.168.0.10:3000/bossiara13/farming-simulator.git`
- **Proxy fix:** `git config --local http.http://192.168.0.10:3000/.proxy ""` (Xray не лезет в LAN)
- **CI:** Forgejo Actions в `.forgejo/workflows/build.yml`. Runner на genmachine в docker container `forgejo-runner` (network `forgejo`, user GID 989, `network: 'forgejo'` в config.yaml). Image `data.forgejo.org/forgejo/runner:6`. CI passes на main.
- **Token:** `claude-farming-sim` ($) — Settings → Applications → Tokens в Forgejo.

---

## ЧТО НЕ В КАНОН-ФАЙЛАХ

- **Текущий код игры:** только `main.tscn` + `main.gd` (заглушка). Реальный код пролога — впереди.
- **Ассеты:** ещё не подключены. План — Kenney CC0 для UI/иконок.
- **Звуки:** ещё нет. SFXR пресеты + 1-2 CC0-трека для пролога.
- **Шрифты:** дефолтные Godot. Pixel-font подобрать.
