FAZA 0: Add documentation and checklist for testing
This commit is contained in:
145
FAZA_0_CHECKLIST.md
Normal file
145
FAZA_0_CHECKLIST.md
Normal 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
93
README.md
Normal 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
|
||||||
14
dev_plan.md
14
dev_plan.md
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user