refactor: Smart Asset Organization - 916 files reorganized
EXECUTED SMART ORGANIZATION: ✅ 916 assets moved to categorized folders ✅ Smart naming applied: {category}_{subcategory}_{description}_style32.png ✅ Slovenian folder structure implemented ✅ Manifest generated: ASSET_ORGANIZATION_MANIFEST.json FOLDER STRUCTURE: - liki/ (gronk, kai, ana, zombiji, npcs) - biomi/ (desert, gore, džungla, močvirje, arktika) - zgradbe/ (hiše, javne, kmetijske, delavnice) - objekti/ (pohištvo, shranjevanje, razsvetljava, dekoracije) - narava/ (rastline, pridelki, živali) - oprema/ (orožje, orodja, zaščita) - vmesnik/ (gumbi, ikone, vrstice, okna) - teren/, notranjost/, učinki/, kreature_mutanti/ SCAN IMPROVEMENTS: - Naming issues: 2,322 → 870 (-1,452 / -62% 🎉) - Broken refs: 200 → 199 (-1) - Still TODO: Fix remaining 199 broken references Next: Fix broken path references in code
This commit is contained in:
6420
docs/ASSET_ORGANIZATION_MANIFEST.json
Normal file
6420
docs/ASSET_ORGANIZATION_MANIFEST.json
Normal file
File diff suppressed because it is too large
Load Diff
@@ -5,41 +5,41 @@
|
||||
"errors": [
|
||||
{
|
||||
"type": "BROKEN_REFERENCES",
|
||||
"count": 200,
|
||||
"count": 199,
|
||||
"items": [
|
||||
"fish_trout.png",
|
||||
"slike/dinozavri",
|
||||
"audio/voiceover/ana_msg_06.mp3",
|
||||
"npc_scout.png",
|
||||
" - assetname_styleA_1024x1024.png",
|
||||
"../narezano_in_majhno/krvava_zetev_sprites/grass_soil_tileset_1766171156780_obdelan.png",
|
||||
"npc_child.png",
|
||||
" 🎨 Generating: {item}_stylea.png",
|
||||
"slike/cutscene",
|
||||
" 🎨 Generating: {item}_styleb.png",
|
||||
"tree_oak.png",
|
||||
"{asset_name.lower()}.png",
|
||||
" - assetname_styleA_sprite_32x32.png",
|
||||
"{name}_{direction}_{frame}.png"
|
||||
"axe_*.png",
|
||||
"susi_dachshund.png",
|
||||
"seed_{crop}.png",
|
||||
"{asset_path.stem}_preview_256x256.png",
|
||||
"cow_spotted.png"
|
||||
]
|
||||
}
|
||||
],
|
||||
"warnings": [
|
||||
{
|
||||
"type": "NAMING_ISSUES",
|
||||
"count": 2322,
|
||||
"count": 870,
|
||||
"items": [
|
||||
"Timestamp in name: dagger_weapon_v2_1767520538278.png",
|
||||
"Missing style32 suffix: dagger_weapon_v2_1767520538278.png",
|
||||
"No category prefix: dagger_weapon_v2_1767520538278.png",
|
||||
"Timestamp in name: zombie_soldier_walk_down_03_1767463447111.png",
|
||||
"No category prefix: zombie_soldier_walk_down_03_1767463447111.png",
|
||||
"No category prefix: objekti_pohištvo_carrot_vegetable_s30.png",
|
||||
"Timestamp in name: uploaded_image_1767410453204.jpg",
|
||||
"Timestamp in name: gronk_vape_04_1767408599735.png",
|
||||
"No category prefix: gronk_vape_04_1767408599735.png",
|
||||
"Timestamp in name: susi_idle_side_1767408905850.png",
|
||||
"No category prefix: susi_idle_side_1767408905850.png",
|
||||
"Timestamp in name: base_level3_house_1767411296399.png",
|
||||
"No category prefix: base_level3_house_1767411296399.png",
|
||||
"No category prefix: barn.png",
|
||||
"Timestamp in name: terrain_water_shallow_1767521374725.png",
|
||||
"Missing style32 suffix: terrain_water_shallow_1767521374725.png",
|
||||
"Timestamp in name: zombie_miner_carry_03_1767409693609.png",
|
||||
"No category prefix: zombie_miner_carry_03_1767409693609.png",
|
||||
"Timestamp in name: watchtower_building_1767496692109.png"
|
||||
"No category prefix: campfire_basic_style32.png",
|
||||
"No category prefix: machete.png",
|
||||
"No category prefix: golf_club.png",
|
||||
"Timestamp in name: zombie_gardener_harvest_03_1767409561494.png",
|
||||
"No category prefix: zombie_gardener_harvest_03_1767409561494.png",
|
||||
"Timestamp in name: zombie_basic_walk_up_01_1767463160319.png",
|
||||
"No category prefix: zombie_basic_walk_up_01_1767463160319.png",
|
||||
"No category prefix: tailoring_shop_style32.png",
|
||||
"No category prefix: objekti_shranjevanje_chest_v2_style32.png"
|
||||
]
|
||||
}
|
||||
],
|
||||
|
||||
382
docs/VISUAL_MANAGER_QUICKSTART.md
Normal file
382
docs/VISUAL_MANAGER_QUICKSTART.md
Normal file
@@ -0,0 +1,382 @@
|
||||
# 🎨 Visual Asset Manager - Quick Start Guide
|
||||
|
||||
**Status**: ✅ LIVE
|
||||
**URL**: `tools/visual_asset_manager.html`
|
||||
**Assets**: 1,166 slik
|
||||
|
||||
---
|
||||
|
||||
## 🚀 HITRI START
|
||||
|
||||
### 1. Odpri Visual Asset Manager
|
||||
```bash
|
||||
open tools/visual_asset_manager.html
|
||||
```
|
||||
|
||||
**ALI** preko serverja:
|
||||
```bash
|
||||
cd tools
|
||||
python3 -m http.server 8080
|
||||
# Odpri: http://localhost:8080/visual_asset_manager.html
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 KAJ LAHKO NARDI
|
||||
|
||||
### 📁 Sidebar (Leva Stran)
|
||||
|
||||
**Statistika:**
|
||||
- Skupaj assetov: 1,166
|
||||
- Prikazanih: Live count
|
||||
- Velikost: 576 MB
|
||||
|
||||
**Kategorije z Filtri:**
|
||||
- 👤 Liki (31)
|
||||
- 🏠 Zgradbe (54)
|
||||
- ⚔️ Oprema (48)
|
||||
- 🌿 Narava (289)
|
||||
- 🛋️ Notranjost (57)
|
||||
- 🗺️ Teren (30)
|
||||
- 🎨 UI (34)
|
||||
|
||||
**Akcijski Gumbi:**
|
||||
- 🔍 **Code Deep Scan** - preveri kodo za napake
|
||||
- ✅ **Validate Paths** - preveri če vse poti obstajajo
|
||||
- 📂 **Organize Assets** - organiziraj v folderje
|
||||
- 🗑️ **Delete Selected** - izbriši označene
|
||||
|
||||
---
|
||||
|
||||
### 🖼️ Asset Cards (Vsaka Slika)
|
||||
|
||||
**3 Gumbi pri vsaki sliki:**
|
||||
|
||||
1. **🗑️ Delete** (rdeč)
|
||||
- Izbriše asset (z potrditev)
|
||||
- Uporabno za cleanup Duplicates
|
||||
|
||||
2. **🔄 Re-roll** (zelen)
|
||||
- Regenerira asset z novim promptom
|
||||
- Če ti verzija ni všeč
|
||||
|
||||
3. **👁️ View Full** (moder)
|
||||
- Odpre modal s celotnim pregledom
|
||||
- Pokaže full resolution sliko
|
||||
- Prikaže path in velikost
|
||||
|
||||
---
|
||||
|
||||
### 🔍 Toolbar (Zgoraj)
|
||||
|
||||
**Search Box:**
|
||||
- Išči po imenu datoteke
|
||||
- Live filtering
|
||||
- Primer: "kai", "zombie", "terrain"
|
||||
|
||||
**View Toggle:**
|
||||
- ⊞ **Grid View** - card layout (default)
|
||||
- ☰ **List View** - seznam format
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ FUNKCIJE
|
||||
|
||||
### 1️⃣ Delete Asset
|
||||
|
||||
```
|
||||
1. Klikni 🗑️ Delete na asset cardu
|
||||
2. Confirm dialog
|
||||
3. Asset se remove iz galleryja in filesystem
|
||||
```
|
||||
|
||||
**Uporaba:**
|
||||
- Cleanup duplicates
|
||||
- Remove bad generations
|
||||
- Cleanup old test assets
|
||||
|
||||
---
|
||||
|
||||
### 2️⃣ Re-roll Asset
|
||||
|
||||
```
|
||||
1. Klikni 🔄 Re-roll
|
||||
2. Confirm dialog
|
||||
3. System regenerira asset z novim random seed
|
||||
4. Stara verzija se nadomesti
|
||||
```
|
||||
|
||||
**Kdaj uporabiti:**
|
||||
- Asset ni v pravem stilu
|
||||
- Zahteva drugačne detajle
|
||||
- Potrebuješ varianti
|
||||
|
||||
---
|
||||
|
||||
### 3️⃣ Code Deep Scan
|
||||
|
||||
```bash
|
||||
# ALI direktno iz terminala:
|
||||
python3 scripts/deep_code_scanner.py
|
||||
```
|
||||
|
||||
**Kaj scan naredi:**
|
||||
- ✅ Preveri vse asset reference v kodi
|
||||
- ✅ Najde broken paths
|
||||
- ✅ Preveri naming conventions
|
||||
- ✅ Otkrije duplicate file sizes
|
||||
- ✅ Najde large files (>1MB)
|
||||
- ✅ Generira JSON report
|
||||
|
||||
**Report lokacija:**
|
||||
`docs/CODE_SCAN_REPORT.json`
|
||||
|
||||
**Primer Output:**
|
||||
```
|
||||
📊 SCAN SUMMARY
|
||||
Total Assets: 1,166
|
||||
Code References: 210
|
||||
Errors: 1 (200 broken references)
|
||||
Warnings: 1 (2,322 naming issues)
|
||||
Suggestions: 1 (168 possible duplicates)
|
||||
Status: ❌ FAIL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4️⃣ Validate Paths
|
||||
|
||||
**Funkcija:**
|
||||
- Preveri če vsi referenced assets obstajajo
|
||||
- Cross-reference koda ↔ filesystem
|
||||
- Poročilo manjkajočih datotek
|
||||
|
||||
**Upoabra:**
|
||||
```
|
||||
Klikni "✅ Validate Paths" v sidebaru
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 5️⃣ Organize Assets
|
||||
|
||||
**Izvede:**
|
||||
- Runs `smart_asset_organizer.py`
|
||||
- Premakne files v kategorije
|
||||
- Rename z smart naming
|
||||
- Ustvari manifest
|
||||
|
||||
**Uporaba:**
|
||||
```
|
||||
Klikni "📂 Organize Assets" v sidebaru
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 DEEP CODE SCAN - Razlaga Rezultatov
|
||||
|
||||
### ❌ ERRORS
|
||||
|
||||
**BROKEN_REFERENCES**
|
||||
```
|
||||
Found: 200 broken references
|
||||
```
|
||||
|
||||
**Kaj to pomeni:**
|
||||
- Koda reference asset, ki NE obstaja
|
||||
- Napačna pot
|
||||
- Datoteka izbrisana
|
||||
|
||||
**Kako popraviti:**
|
||||
1. Poglej `CODE_SCAN_REPORT.json`
|
||||
2. Poišči section "errors"
|
||||
3. Vsaka broken ref je listed
|
||||
4. Update kodo ALI re-generate asset
|
||||
|
||||
**Primer broken ref:**
|
||||
```javascript
|
||||
// Koda:
|
||||
sprite: 'assets/npc_child.png' // ❌ Ta file ne obstaja
|
||||
|
||||
// Fix:
|
||||
sprite: 'assets/slike 🟢/liki/npcs/npc_child_style32.png' // ✅
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ⚠️ WARNINGS
|
||||
|
||||
**NAMING_ISSUES**
|
||||
```
|
||||
Found: 2,322 naming issues
|
||||
```
|
||||
|
||||
**Kaj to pomeni:**
|
||||
- Assets ne sledijo naming convention
|
||||
- Timestamps v imenih
|
||||
- Manjka category prefix
|
||||
- Manjka `_style32` suffix
|
||||
|
||||
**Kako popraviti:**
|
||||
```bash
|
||||
# Avtomatska popravka:
|
||||
python3 scripts/smart_asset_organizer.py --execute
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 💡 SUGGESTIONS
|
||||
|
||||
**POSSIBLE DUPLICATES**
|
||||
```
|
||||
Found: 168 groups of same-size files
|
||||
```
|
||||
|
||||
**Kaj to pomeni:**
|
||||
- Datoteke z exactly isto velikostjo
|
||||
- Mogoče duplicates (lahko so legit različne)
|
||||
|
||||
**Kako preveriti:**
|
||||
1. Poglej `CODE_SCAN_REPORT.json`
|
||||
2. Section "suggestions"
|
||||
3. Manually preglej suspected duplicates
|
||||
4. Uporabi Visual Asset Manager za delete
|
||||
|
||||
---
|
||||
|
||||
## 🔧 TROUBLESHOOTING
|
||||
|
||||
### Manager se ne odpre?
|
||||
```bash
|
||||
# Uporabi local server:
|
||||
cd tools
|
||||
python3 -m http.server 8080
|
||||
open http://localhost:8080/visual_asset_manager.html
|
||||
```
|
||||
|
||||
### Slike se ne prikazujejo?
|
||||
- Preveri da so paths relativni od project root
|
||||
- Browser console (F12) za napake
|
||||
- Preveri CORS permissions (use local server)
|
||||
|
||||
### Deep Scan crashne?
|
||||
```bash
|
||||
# Debug mode:
|
||||
python3 -v scripts/deep_code_scanner.py
|
||||
```
|
||||
|
||||
### Delete ne dela?
|
||||
- Manager je trenutno frontend-only
|
||||
- Za actual deletion uporabi terminal:
|
||||
```bash
|
||||
rm "path/to/asset.png"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 WORKFLOW PRIMER
|
||||
|
||||
### Scenario: Cleanup Duplicates
|
||||
|
||||
```
|
||||
1. Odpri Visual Asset Manager
|
||||
2. Klikni "🔍 Code Deep Scan"
|
||||
3. Počakaj scan complete (3s toast notification)
|
||||
4. Odpri docs/CODE_SCAN_REPORT.json
|
||||
5. Poglej "suggestions" → duplicates
|
||||
6. Nazaj v Manager, search za duplicate names
|
||||
7. Uporabi 🗑️ Delete za removes
|
||||
8. Run "✅ Validate Paths" da confirm
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Scenario: Fix Broken References
|
||||
|
||||
```
|
||||
1. Run Deep Code Scan
|
||||
2. Odpri CODE_SCAN_REPORT.json
|
||||
3. Poglej "errors" → "BROKEN_REFERENCES"
|
||||
4. Za vsako broken ref:
|
||||
a. Najdi kodo kjer je referenced
|
||||
b. Update path
|
||||
c. ALI re-generate missing asset
|
||||
5. Re-run scan da confirm fixed
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Scenario: Standardize Names
|
||||
|
||||
```
|
||||
1. Run: python3 scripts/smart_asset_organizer.py
|
||||
2. Review what would change (dry run)
|
||||
3. Run: python3 scripts/smart_asset_organizer.py --execute
|
||||
4. Run Deep Code Scan ponovno
|
||||
5. Naming issues bi morale bit 0
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 BEST PRACTICES
|
||||
|
||||
### Pred Veliko Asset Generation:
|
||||
```bash
|
||||
# 1. Backup
|
||||
cp -r assets/ assets_backup_$(date +%Y%m%d)/
|
||||
|
||||
# 2. Run scan
|
||||
python3 scripts/deep_code_scanner.py
|
||||
|
||||
# 3. Fix existing issues
|
||||
# 4. Commit clean state
|
||||
git add . && git commit -m "cleanup: before asset generation"
|
||||
```
|
||||
|
||||
### Po Asset Generation:
|
||||
```bash
|
||||
# 1. Organize
|
||||
python3 scripts/smart_asset_organizer.py --execute
|
||||
|
||||
# 2. Scan
|
||||
python3 scripts/deep_code_scanner.py
|
||||
|
||||
# 3. Review in Visual Manager
|
||||
open tools/visual_asset_manager.html
|
||||
|
||||
# 4. Commit
|
||||
git add . && git commit -m "assets: new batch organized"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📈 TRENUTNO STANJE
|
||||
|
||||
**Scan Results (2026-01-04):**
|
||||
- ✅ Assets: 1,166 datotek
|
||||
- ❌ Broken refs: 200
|
||||
- ⚠️ Naming issues: 2,322
|
||||
- 💡 Duplicates: 168 groups
|
||||
|
||||
**Priority Actions:**
|
||||
1. Fix broken references (200)
|
||||
2. Run smart organizer (fix 2,322 names)
|
||||
3. Review duplicates manually
|
||||
4. Re-scan to verify
|
||||
|
||||
---
|
||||
|
||||
## 🔗 RELATED FILES
|
||||
|
||||
- `tools/visual_asset_manager.html` - Main UI
|
||||
- `tools/asset_gallery.html` - Simple gallery (read-only)
|
||||
- `scripts/deep_code_scanner.py` - Code analysis
|
||||
- `scripts/smart_asset_organizer.py` - Auto organization
|
||||
- `docs/CODE_SCAN_REPORT.json` - Latest scan results
|
||||
- `docs/VISUAL_ASSET_SYSTEM.md` - Full documentation
|
||||
|
||||
---
|
||||
|
||||
**Version**: 1.0
|
||||
**Last Updated**: 2026-01-04
|
||||
**Maintainer**: Antigravity Agent
|
||||
Reference in New Issue
Block a user