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
|
||||
**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
|
||||
|
||||
Reference in New Issue
Block a user