# План: локация «Волшебное болото» (id 4, 90 000 🪙)

Статус: **реализован (Этап 45)** — см. запись «Этап 45» в `docs/DEVLOG.md`; тело плана ниже оставлено как историческая фиксация.
Ориентир по коду: `index.html` ~3861 строка; ссылки на строки даны на момент составления плана
(перед реализацией сверять — номера могли сдвинуться).

## 1. Задача

Добавить пятую локацию — **«Волшебное болото»** за **90 000 🪙**:

- светящиеся рыбы, которые **ночью** светятся в темноте **разными цветами**;
- **прыгающие лягушки**;
- **кувшинки** и **лилии** (жёлтые, белые, розовые).

## 2. Зафиксированные решения (ответы пользователя)

| Развилка | Решение |
|---|---|
| Когда светятся рыбы | **Только ночью** — включать при `nightMix() > 0.35` (тот же порог, что у фонаря на лодке, `index.html:2584`). Днём болото — обычная мрачная вода. |
| Сколько новых видов | **5 видов** по одному на редкость r0–r4, у каждого своё поле `glow:'#hex'` (разные цвета). |
| Босс | **Да** — светящийся босс + персональная ачивка (паттерн остальных 4 локаций). |
| Доходность | «Не принципиально» → берём **между Озёрами и Морем** (уважает связку «дороже вода = дороже улов» при цене 90 000). Ориентир день ~240 / ночь ~330 🪙; точные цифры подбираются `balance.mjs --set` и фиксируются. |
| Свечение в карточке/дневнике | **Да** — CSS `drop-shadow` по полю `glow` вида. |

## 3. Предлагаемые виды (имена/цвета можно менять)

| id | RU | EN | r | weight | wMin–wMax | glow | цена |
|---|---|---|---|---|---|---|---|
| `glowfin` | Светлячок | Glowfin | 0 | 38 | 0.3–3 | `#5ff2ff` циан | 8 |
| `moonfish` | Лунная рыбка | Moonfish | 1 | 24 | 0.8–8 | `#b9c8ff` бледно-голубой | 13 |
| `emberfin` | Изумрудный светляк | Emerald Glowfish | 2 | 14 | 1.5–16 | `#57ffa8` зелёный | 20 |
| `violetlure` | Фиалковый огонёк | Violet Lure | 3 | 5 | 2–24 | `#d17bff` фиолетовый | 38 |
| `spiritfin` | Дух болота | Swamp Spirit | 4 | 2.5 | 0.5–6 | `#ffe07a` золотой | 70 |

- **Босс** — `spiritfin` (легендарный дух; вес по общему правилу 20–50 кг, награда ×5).
- Веса и цены — стартовая заготовка, финал через `node tools/balance.mjs --set ...`.
- «Здоровье» теста «каждый вид ≥1»: минимальный вес вида ≥ ~2.2 (иначе lc4 за 3000 роллов
  заплывёт). `moonfish`/`emberfin` в норме; при желании боссу можно добавить вес.
- **Дополнительные ачивки**: `swamp_first` (локация, `coinPct:0.02`, как `lake_first`) и
  `swamp_boss` (без `coinPct`, как `lake_boss`). Это поднимет `ACHIEVEMENTS.length` 34→36
  и пин `achBonus().coinPct` 0.16→0.18 — тесты и доки обновить явно.

## 4. Карта изменений по коду

### 4.1 Данные (`index.html`, секция «ДАННЫЕ»)

| Что | Где | Правка |
|---|---|---|
| Локация | `1143-1156` (`LOCATIONS`) | Запись `{id:4, name:'Волшебное болото', ... cost:90000}`; `water` — тёмно-моховой 6-hex (день/ночь); `waves` — слабая рябь (`amp~0.8`). Миграция сейва (`1382-1387`) уже завязана на `LOCATIONS.length`. |
| Новые виды | `1072-1118` (`SPECIES`) | Только **в КОНЕЦ** (после `whale`) — `SPECIES[0..7]` запинены тестами/квестами (§9j/M4/M6). Каждому поле `glow`. |
| Ночные веса | `1127` (`NIGHT_WEIGHTS`) | Ключ каждому новому id (иначе `weight=undefined`). |
| Таблицы болота | `1176-1196` | `SWAMP_IDS`, `SWAMP_DAY_WEIGHTS`, `SWAMP_NIGHT_WEIGHTS`, `SWAMP_SPECIES(_NIGHT)` — копия паттерна LAKE/SEA/OCEAN, без пересечений. |
| Босс | `1201` (`BOSS_BY_LOCATION`) | `4:'spiritfin'`. |
| Фоновые рыбы | `1809-1814` (`AMBIENT_FISH`) | 5-я запись + `palette` (циан/зелёный/фиолет/золото) для «разных цветов». |

### 4.2 Логика

- `pickSpecies()` (`1907-1925`): заменить вложенный тернарник на табличный доступ по
  `save.location` + guard на диапазон. Поведение локаций 0..3 идентично; болото больше
  не «проваливается» в реку.
- `startBite()` (`1950`): босс подхватится из `BOSS_BY_LOCATION[4]` автоматически;
  `save.bosses` уже миграционно готов (`1371-1372`).

### 4.3 Свечение (только ночь)

- `drawFishShape`/`drawAmbientFish` (`2517-2540`): аура радиальным градиентом +
  `globalCompositeOperation='lighter'`, цвет из `palette`/`glow`, только при
  `nightMix()>0.35` и `save.location===4`.
- `draw()` (`2934-2943`) и `drawHookedFish()` (`2731-2745`): аура для вида с `glow` ночью
  (паттерн боссовой ауры `2739-2743`). Обязательно `save/restore` либо сброс `shadowBlur`.
- Карточка (`showCard` `3645`, CSS `175-190`): класс `glow-card` для вида с `glow` **при
  normal-варианте** (чтобы не конфликтовать с фильтрами вариантов) → `drop-shadow` цвета `glow`.
- Дневник (`renderShop` journal `3501-3521`): маркер-класс на SVG для светящихся видов.

### 4.4 Декорации (лягушки, кувшинки, лилии)

- `initScenery()` (`1836-1853`): ветка `i===4` — фон (камыш/кривые деревья) + отдельные
  массивы `pads[]`/`frogs[]` (очищаются вместе с `scenery`).
- `updateDecor(dt)` (`2240-2266`): параболический прыжок лягушек; покачивание кувшинок.
- Новая `drawSwampDecor()`: кувшинки (эллипс с вырезом), лилии жёлтые/белые/розовые
  (лепестки), лягушки. Вызов в `draw()` (`2924`) **после** `drawWater`/`drawAmbientFish`
  и до `drawBoat` — лилии поверх воды.
- Вызовы `initScenery()` не трогаем (уже есть в `resize` и обеих ветках `shopClick`).

### 4.5 Магазин / i18n / ачивки

- `shopClick` тост (`3586`): ветка `id===4` → `welcome_swamp`.
- `T` ru/en (`3060+` / `3157+`): название и описание локации, `welcome_swamp`,
  `nameEn`/`descEn`/описания видов.
- `ACHIEVEMENTS` (`1618-1655`): `swamp_first` (+0.02), `swamp_boss` (без `coinPct`).

### 4.6 Портреты (основной объём)

- 5 файлов `assets/fish/fish-<id>.svg` (viewBox `0 0 160 100`, цвета через `var(--f1/--f3)`).
- Добавить id в `tools/embed-fish.mjs:24-29`, прогнать `node tools/embed-fish.mjs`.

### 4.7 Тесты (`tests/test.js`) — в том же коммите

- `lc1` (`1956-2010`): `SPECIES.length` 32→37, `LOCATIONS` 4→5, `costs` +`,90000`,
  `names`, `sprites` 32→37, `swampOrder`, поля новых видов.
- `lc2` (`2013-2045`): `SWAMP_*` длины/порядок/пересечения.
- Новый тест роллов болота (аналог `lc4c` `2112-2132`).
- `lc5` (`2135-2171`): кейс `location:4`.
- Покупка болота — аналог `lc8c` (`2247-2259`).
- `lc9` (`2261-2266`): дневник 32→37.
- `lc10` (`2268-2290`): дополнить `mid24` swamp-видами.
- `a22d` (`2309-2326`): `ACHIEVEMENTS.length` 34→36.
- Пин `0.16` (`1648-1666`): 0.16→0.18.
- Новый data-тест: у swamp-видов есть `glow`, цвета различны, `*_WEIGHTS` покрывают все id.

### 4.8 Инструменты / доки / визуал

- `tools/balance.mjs`: таблицы болота в `TABLES`, пины в шапке; сортировать сводку
  отношений по цене (т.к. 90000 < Моря/Океана, а порядок массива иной).
- `tests/gen-screenshots.js`: кадр `swamp` (день) и/или `swamp-night` со свечением.
- `AGENTS.md`, `README.md`, `docs/DEVLOG.md` («Этап 45»).
- Emoji-шрифт не трогаем (лягушки/лилии — фигуры canvas), пока не появятся новые emoji.

## 5. Порядок работ (фазы)

1. Данные: `LOCATIONS` + `SPECIES` + веса + `BOSS_BY_LOCATION` + табличный `pickSpecies`.
   → `node tools/check.mjs`.
2. Баланс: `node tools/balance.mjs` (+`--set`), зафиксировать числа.
3. Портреты: 5 SVG + `embed-fish.mjs`.
4. Свечение рыб (ambient/bite/reel, карточка/дневник).
5. Декорации: лягушки/кувшинки/лилии + фон болота.
6. Магазин/тосты/i18n/ачивки.
7. Тесты (все пины выше) → `cd tests && npm test`.
8. Доки + скриншоты + при желании `orca-playtest.js`.

## 6. Проверка (порядок команд)

1. `node tools/check.mjs`
2. `node tools/embed-fish.mjs` (сам прогонит check)
3. `node tools/balance.mjs` — пины Река/Озёра/Море/Океан не изменились, болото в цели
4. `cd tests && npm test` — все PASS, exit 0
5. Опционально: `node tests/orca-playtest.js`, `node tests/gen-screenshots.js`

## 7. Риски

1. `SPECIES` — только в конец (иначе river-пины/квесты ломаются молча).
2. `pickSpecies` табличный рефакторинг — нужен guard, чтобы не изменить роллы локаций 0..3.
3. Порядок отрисовки лилий/лягушек — строго после воды.
4. Порог свечения и производительность (`shadowBlur`/градиенты на мобиле).
5. Числовые пины тестов и `achBonus().coinPct` — обновить всё в одном коммите.