From 26070dc22b2f73cb6b4af2d82af3e3a4c1a7cbb0 Mon Sep 17 00:00:00 2001
From: NovaFarma Dev <hipodevil666@gmail.com>
Date: Sat, 6 Dec 2025 17:49:10 +0100
Subject: [PATCH] FAZA 0: Add documentation and checklist for testing

---
 FAZA_0_CHECKLIST.md | 145 ++++++++++++++++++++++++++++++++++++++++++++
 README.md           |  93 ++++++++++++++++++++++++++++
 dev_plan.md         |  14 ++---
 3 files changed, 245 insertions(+), 7 deletions(-)
 create mode 100644 FAZA_0_CHECKLIST.md
 create mode 100644 README.md

diff --git a/FAZA_0_CHECKLIST.md b/FAZA_0_CHECKLIST.md
new file mode 100644
index 0000000..45c336f
--- /dev/null
+++ b/FAZA_0_CHECKLIST.md
@@ -0,0 +1,145 @@
+# FAZA 0: Projektni Setup - Checklist
+
+**Status:** ✅ PRIPRAVLJEN ZA TESTIRANJE
+
+**Datum:** 2025-12-06
+
+---
+
+## ✅ Opravila (Developer)
+
+- [x] Inicializacija npm projekta
+- [x] Setup Git repository (local)
+- [x] Konfiguracija Git user (hipodevil666@gmail.com)
+- [x] Kreiranje strukture map (src/, assets/, dist/)
+- [x] Instalacija Phaser.js (v3.80.1)
+- [x] Instalacija Electron.js (v33.2.1)
+- [x] Kreacija main.js (Electron config)
+- [x] Kreacija index.html
+- [x] Kreacija game.js (Phaser config)
+- [x] Kreacija BootScene.js
+- [x] Kreacija PreloadScene.js
+- [x] Kreacija GameScene.js
+- [x] .gitignore setup
+- [x] Prvi Git commit
+- [x] README.md dokumentacija
+
+**VSE OPRAVILA ZAKLJUČENA** ✅
+
+---
+
+## 🧪 Ročno testiranje (Naročnik)
+
+### Test 1: Zagon aplikacije
+**Ukaz:** `npm start`
+
+**Pričakovani rezultat:**
+- [ ] Electron okno se odpre (velikost 1280x720)
+- [ ] DevTools so odprte (developer mode)
+- [ ] Naslov okna: "NovaFarma - 2.5D Survival Game"
+- [ ] Črno ozadje
+
+**Status:** ⏳ ČAKA NA TESTIRANJE
+
+---
+
+### Test 2: BootScene
+**Pričakovani rezultat:**
+- [ ] Loading bar se prikaže
+- [ ] "Loading..." besedilo vidno
+- [ ] Loading bar se napolni
+- [ ] Samodejni prehod v PreloadScene
+
+**Status:** ⏳ ČAKA NA TESTIRANJE
+
+---
+
+### Test 3: PreloadScene
+**Pričakovani rezultat:**
+- [ ] Naslov "NOVAFARMA" prikazan (zelena barva)
+- [ ] Podnaslov "2.5D Isometric Survival Game" viden
+- [ ] "Press SPACE to start" blinka (fade in/out)
+- [ ] Pritisk SPACE preide v GameScene
+
+**Status:** ⏳ ČAKA NA TESTIRANJE
+
+---
+
+### Test 4: GameScene
+**Pričakovani rezultat:**
+- [ ] Besedilo "FAZA 0: Setup Complete!" vidno
+- [ ] Debug info v zgornjem levem kotu
+- [ ] FPS counter v spodnjem levem kotu (približno 60 FPS)
+- [ ] Nobenih error-jev v konzoli
+
+**Status:** ⏳ ČAKA NA TESTIRANJE
+
+---
+
+### Test 5: Performance
+**Pričakovani rezultat:**
+- [ ] FPS: 55-60 (stabilen)
+- [ ] Brez lagganja
+- [ ] Brez memory leakov
+- [ ] Electron okno responsive
+
+**Status:** ⏳ ČAKA NA TESTIRANJE
+
+---
+
+## 📋 Potrditev Naročnika
+
+```
+FAZA 0: [STATUS]
+- Testirano: [DA/NE]
+- Datum testiranja: ___________
+- Opombe: 
+
+
+
+
+- Test 1: [✅/❌]
+- Test 2: [✅/❌]
+- Test 3: [✅/❌]
+- Test 4: [✅/❌]
+- Test 5: [✅/❌]
+
+ODOBRENO ZA FAZO 1: [DA/NE]
+
+Podpis naročnika: _____________
+```
+
+---
+
+## 🚨 V primeru težav
+
+### Težava: Electron se ne zažene
+**Rešitev:**
+```bash
+# Ponovno instaliraj odvisnosti
+rm -rf node_modules
+npm install
+npm start
+```
+
+### Težava: "Phaser is not defined"
+**Rešitev:**
+- Preveri da je `node_modules/phaser/dist/phaser.js` prisoten
+- Preveri da je `<script>` tag v `index.html` pravilen
+
+### Težava: Črn zaslon brez vsebine
+**Rešitev:**
+- Odpri DevTools (F12)
+- Preveri console za error-je
+- Preveri da so vse scene pravilno definirane
+
+---
+
+## ➡️ Naslednji koraki (po odobritvi)
+
+Ko naročnik potrdi FAZO 0, se začne:
+**FAZA 1: Generacija Terena**
+- Implementacija Perlin noise
+- 100x100 isometrični zemljevid
+- Tipi terena (grass, dirt, stone)
+- Kamera kontrola
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..88d456c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,93 @@
+# NovaFarma 🌾
+
+**2.5D Isometric Survival Game**
+
+Pixel art survival game z izometričnim pogledom, ustvarjen z Phaser.js in Electron.
+
+---
+
+## 🚀 Quick Start
+
+### Predpogoji
+- Node.js 18+
+- npm
+
+### Instalacija
+```bash
+# Kloniraj repository (local)
+cd c:\novafarma
+
+# Instaliraj odvisnosti
+npm install
+
+# Zaženi igro
+npm start
+```
+
+---
+
+## 🛠️ Tehnologije
+- **Node.js** v18+
+- **Phaser.js** v3.80.1 - Game engine
+- **Electron.js** v33.2.1 - Desktop wrapper
+
+---
+
+## 📁 Struktura projekta
+```
+novafarma/
+├── src/
+│   ├── scenes/          # Game scenes (Boot, Preload, Game)
+│   ├── entities/        # Game entities (Player, NPC, etc.)
+│   ├── systems/         # Game systems (terrain gen, AI, etc.)
+│   ├── utils/           # Utility functions
+│   └── game.js          # Main Phaser config
+├── assets/
+│   ├── images/          # Image assets
+│   ├── sprites/         # Sprite sheets
+│   └── audio/           # Sound effects & music
+├── dist/                # Build output
+├── index.html           # HTML entry point
+├── main.js              # Electron main process
+└── package.json
+```
+
+---
+
+## 🎮 Trenutni Status
+
+**FAZA 0: ✅ COMPLETE**
+- Setup projekta
+- Git inicializacija
+- Electron + Phaser integracija
+- Osnovne scene (Boot, Preload, Game)
+
+**Naslednja faza:** FAZA 1 - Generacija Terena
+
+---
+
+## 📝 Development Plan
+
+Glej `dev_plan.md` za celoten razvojni načrt.
+
+---
+
+## 🐛 Debug Mode
+
+Razvojni način je privzeto vključen:
+- Electron DevTools odprte ob zagonu
+- FPS counter v igri
+- Console logging
+
+---
+
+## 👨‍💻 Developer
+
+**Email:** hipodevil666@gmail.com  
+**Git:** Local repository
+
+---
+
+## 📄 License
+
+ISC
diff --git a/dev_plan.md b/dev_plan.md
index 412fe25..edff9d8 100644
--- a/dev_plan.md
+++ b/dev_plan.md
@@ -23,15 +23,15 @@
 ---
 
 ## FAZA 0: Projektni Setup
-**Status:** ⏳ V teku
+**Status:** ✅ COMPLETE - Čaka na testiranje naročnika
 
 ### Opravila:
-- [ ] Inicializacija npm projekta
-- [ ] Setup Git repository
-- [ ] Kreiranje strukture map (src/, assets/, dist/)
-- [ ] Instalacija odvisnosti (Phaser, Electron)
-- [ ] Osnovna konfiguracija Electron + Phaser
-- [ ] Test run: prazno črno okno
+- [x] Inicializacija npm projekta
+- [x] Setup Git repository
+- [x] Kreiranje strukture map (src/, assets/, dist/)
+- [x] Instalacija odvisnosti (Phaser, Electron)
+- [x] Osnovna konfiguracija Electron + Phaser
+- [x] Test run: prazno črno okno
 
 ### Testiranje (ročno):
 ✅ **Naročnik potrdi:** Electron okno se odpre in prikaže prazno Phaser sceno