farming-simulator/canon/_INDEX.md
Dmitrii Bykov d1c28d088b
All checks were successful
Godot CI / Import + smoke test (push) Successful in 32s
canon: _INDEX.md — навигатор для будущих сессий + обновлён project-memory
Цель: подготовить компактификацию контекста.
_INDEX.md содержит:
- Оглавление 24 канон-файлов с приоритетом чтения
- Минимум для старта Акта 1 (~17 мин чтения)
- 15 ключевых канон-локов (С.=СПБ, Шкалин, Осминог=я-из-будущего, FSM Panel real, etc)
- Порядок 13 актов пролога
- Инфраструктура: Godot 4.6.3 путь, Forgejo URL, proxy-fix, CI-runner setup

Любая будущая Claude-сессия может стартовать Акт 1 имея только:
1. project_farming_simulator.md из памяти
2. canon/_INDEX.md
3. Пролог_Первый_день.md
4. canon/CHARACTERS.md + canon/NAMING.md
2026-05-24 16:56:12 +03:00

153 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# canon/_INDEX.md — Навигатор канон-файлов
> Это **оглавление** всех ~24 канон-файлов проекта. Любая новая сессия Claude должна прочитать этот файл первым.
**Repo:** http://192.168.0.10:3000/bossiara13/farming-simulator
**Status (на момент создания файла):** канон полный, CI зелёный, готов к Акту 1 в коде.
---
## ОРИЕНТАЦИЯ ДЛЯ НОВОЙ СЕССИИ
### Минимум чтоб начать Акт 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 ветки, мосты разводят, двухтарифный счётчик Ленэнергосбыт | средний |
### Сюжетный каркас
| Файл | О чём |
|---|---|
| `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 подобрать.