# Naddie Jump — Agent Notes

## Описание проекта
Игра на Phaser 3 (Vite-сборка), жанр "прыгалка" (doodle-jump style). Текущее издание — Monad Edition.

## Технологический стек
- **Framework:** Vite 8.x
- **Game Engine:** Phaser 3.70.0
- **Language:** TypeScript / JavaScript (ES Modules)
- **Deploy target:** Vercel (Static + Vite preset)

## Структура `src/`
```
src/
├── main.js                      # Точка входа
├── config/game.config.js        # Глобальные настройки игры
├── entities/
│   ├── Player.js                # Игрок
│   ├── Enemy.js                 # Враги
│   ├── Platform.js              # Платформы
│   ├── PropellerHat.js          # Апгрейд: пропеллер
│   ├── Rocket.js                # Апгрейд: ракета
│   └── Spring.js                # Апгрейд: пружина
├── managers/
│   ├── BlockchainManager.js     # Web3/блокчейн интеграция
│   ├── PlatformManager.js       # Генерация и управление платформами
│   └── ScoreManager.js          # Учёт очков
└── scenes/
    ├── BootScene.js             # Загрузка ассетов
    ├── MenuScene.js             # Главное меню
    ├── GameScene.js             # Основной игровой процесс
    └── GameOverScene.js         # Экран поражения
```

## Команды разработки
```bash
npm install     # установка зависимостей
npm run dev     # локальный dev-сервер
npm run build   # production-сборка (output: dist/)
npm run preview # превью production-сборки локально
```

## Деплой на Vercel
- **Проект в Vercel:** `anrils-projects/naddie-jump`
- **Production URL:** https://naddie-jump.vercel.app
- **Конфигурация:** `vercel.json` (framework: vite, outputDirectory: dist)
- **Привязка CLI:** `.vercel/project.json` создан, `.vercel/` добавлен в `.gitignore`

### ⛔ ВАЖНОЕ ПРАВИЛО — ДЕПЛОЙ
- **Текущая версия на Vercel — это prod-альфа.** Она остаётся как есть.
- **Вся дальнейшая разработка ведётся ТОЛЬКО локально.**
- **Деплоить новую версию на Vercel можно ТОЛЬКО по явной команде пользователя.**
- Не деплоить самостоятельно, даже если есть токен/доступ.

## Git
- **Remote:** `https://гитея.рф/git/AnRil/naddie-jump.git` (Gitea, не GitHub)
- Ветка по умолчанию: `main`
- Репозиторий `.git/` находится в корне проекта `naddie-jump/`

## Зависимости
- `phaser` — игровой движок
- `vite` — сборщик (devDependency)
- `typescript` — типизация (devDependency)

## Ассеты
Статические ресурсы (спрайты, звуки) хранятся в `public/assets/` и копируются в `dist/` при сборке.