FAZA 0: Add documentation and checklist for testing

This commit is contained in:
2025-12-06 17:49:10 +01:00
parent cdcd7f8bc6
commit 26070dc22b
3 changed files with 245 additions and 7 deletions

145
FAZA_0_CHECKLIST.md Normal file
View File

@@ -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

93
README.md Normal file
View File

@@ -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

View File

@@ -23,15 +23,15 @@
--- ---
## FAZA 0: Projektni Setup ## FAZA 0: Projektni Setup
**Status:** ⏳ V teku **Status:** ✅ COMPLETE - Čaka na testiranje naročnika
### Opravila: ### Opravila:
- [ ] Inicializacija npm projekta - [x] Inicializacija npm projekta
- [ ] Setup Git repository - [x] Setup Git repository
- [ ] Kreiranje strukture map (src/, assets/, dist/) - [x] Kreiranje strukture map (src/, assets/, dist/)
- [ ] Instalacija odvisnosti (Phaser, Electron) - [x] Instalacija odvisnosti (Phaser, Electron)
- [ ] Osnovna konfiguracija Electron + Phaser - [x] Osnovna konfiguracija Electron + Phaser
- [ ] Test run: prazno črno okno - [x] Test run: prazno črno okno
### Testiranje (ročno): ### Testiranje (ročno):
**Naročnik potrdi:** Electron okno se odpre in prikaže prazno Phaser sceno **Naročnik potrdi:** Electron okno se odpre in prikaže prazno Phaser sceno