ok

docs/ASSET_CLEANUP_PLAN.md

@@ -0,0 +1,261 @@
+# 🗂️ ASSET CLEANUP & REORGANIZATION PLAN
+
+**Date:** 3. Januar 2026 @ 19:51  
+**Purpose:** Organize assets, remove duplicates, clean structure
+
+---
+
+## 📊 CURRENT SITUATION:
+
+**Total PNG:** 921 files  
+**Problem:** Scattered across multiple folders with duplicates!
+
+### Breakdown:
+```
+slike 🟢/          623 PNG  (main production folder)
+animations 🟢/     134 PNG  
+demo 🔴/            83 PNG  (some duplicates!)
+kreature 🟢/        71 PNG  (enemies - some in slike too?)
+MASTER_REFS 🟣/      6 PNG  
+vfx 🟣/              3 PNG  
+maps 🟣/             1 PNG  
+```
+
+### 🚨 PROBLEMS FOUND:
+
+1. **Wheat duplicates** - 3 different locations!
+   - `slike/rastline/wheat/` (old Style 32)
+   - `slike/rastline/zita/` (new Style 30)
+   - `demo/items/` (same as zita)
+
+2. **733 files with long numbers** like `_1767464954800.png`
+   - Makes files hard to identify
+   - Should have clean names
+
+3. **Kreature vs Slike confusion**
+   - Enemies scattered in both folders
+   - Need single source of truth
+
+4. **Demo duplicates**
+   - Some files in both `demo/` and `slike/`
+
+---
+
+## 🎯 CLEANUP PLAN:
+
+### **PHASE 1: CONSOLIDATE DEMO ASSETS**
+
+**Goal:** All demo assets in ONE place, clean names
+
+**Actions:**
+1. Keep ONLY `demo 🔴/` folder
+2. Remove duplicates from `slike 🟢/`
+3. Rename files to clean names (no timestamps)
+
+**Example:**
+```
+❌ wheat_s30_stage1_seed_1767464954800.png
+✅ wheat_stage1_seed.png
+```
+
+---
+
+### **PHASE 2: ORGANIZE MAIN PRODUCTION**
+
+**New structure for `slike 🟢/`:**
+
+```
+slike 🟢/
+├── characters/     (Kai, Ana, NPCs - Style 32)
+├── enemies/        (ALL zombies, mutants - Style 32)
+├── items/          (tools, weapons - Style 32)
+├── rastline/       (ALL plants - Style 30)
+├── buildings/      (structures - Style 32)
+├── ui/             (UI elements)
+└── vfx/            (effects)
+```
+
+---
+
+### **PHASE 3: REMOVE DUPLICATES**
+
+**Strategy:**
+1. Find duplicates (same content, different timestamp)
+2. Keep BEST version (latest/correct style)
+3. Delete older versions
+
+**Wheat cleanup example:**
+```
+KEEP:  slike/rastline/zita/wheat_stage1.png  (Style 30 ✅)
+DELETE: slike/rastline/wheat/wheat_stage1*.png  (Style 32 ❌)
+DELETE: demo/items/wheat_s30_stage1*.png  (duplicate)
+```
+
+---
+
+### **PHASE 4: CLEAN ENEMY ORGANIZATION**
+
+**Move all to `slike 🟢/enemies/`:**
+```
+enemies/
+├── zombies/
+│   ├── basic/
+│   ├── variants/
+│   └── special/
+├── mutants/
+│   ├── animals/
+│   └── creatures/
+├── bosses/
+└── hybrids/
+```
+
+**Then DELETE `kreature 🟢/`** (outdated folder)
+
+---
+
+### **PHASE 5: RENAME TIMESTAMPED FILES**
+
+**Pattern:**
+```
+OLD: item_locket_silver_1767464385940.png
+NEW: item_locket_silver.png
+
+OLD: kai_idle_down_1767465832047.png
+NEW: kai_idle_down.png
+```
+
+**Script to generate clean names:**
+```bash
+# For each file
+# Remove timestamp numbers
+# Keep descriptive name
+```
+
+---
+
+## 🤖 AUTOMATED CLEANUP SCRIPT:
+
+I can create script that:
+1. ✅ Identifies duplicates
+2. ✅ Suggests which to keep/delete
+3. ✅ Renames timestamped files
+4. ✅ Moves files to correct folders
+5. ✅ Creates clean manifest
+
+**You review and approve before deletion!**
+
+---
+
+## 📋 MANUAL CLEANUP TASKS (For you):
+
+**What YOU should do:**
+1. **Review generated images** - Delete bad quality ones
+2. **Choose best versions** - If multiple versions exist
+3. **Approve deletions** - Before I remove anything
+
+**What I do:**
+1. Scan & identify issues
+2. Suggest reorganization
+3. Create rename/move scripts
+4. Generate clean manifest
+5. Execute approved changes
+
+---
+
+## 📊 EXPECTED RESULTS:
+
+**Before:**
+```
+921 PNG scattered
+733 with timestamps
+Duplicates unknown
+Hard to find things
+```
+
+**After:**
+```
+~700-800 PNG organized
+Clean descriptive names
+No duplicates
+Clear folder structure
+Easy to find anything!
+```
+
+---
+
+## ⏰ TIME ESTIMATE:
+
+**Automated scan:** 5 min  
+**Generate cleanup script:** 10 min  
+**Your review:** 15-30 min  
+**Execute cleanup:** 5 min  
+**Verify & commit:** 5 min  
+
+**TOTAL:** ~40-60 minutes
+
+---
+
+## 🚀 RECOMMENDED ORDER:
+
+### **NOW (while waiting for quota):**
+
+1. **I create cleanup script** (10 min)
+2. **Script shows what to delete** (you review)
+3. **You approve** (or adjust)
+4. **Execute cleanup** (5 min)
+5. **Clean commit** ✅
+
+### **Benefits:**
+- Organized assets ✅
+- Easy to find files ✅
+- No duplicates ✅
+- Professional structure ✅
+- Ready for production ✅
+
+---
+
+## 💡 SHOULD WE DO THIS?
+
+**PROS:**
+- ✅ Clean organization
+- ✅ Easy to maintain
+- ✅ No wasted space
+- ✅ Professional project
+- ✅ Perfect task while waiting for API quota!
+
+**CONS:**
+- ⚠️ Takes 1 hour
+- ⚠️ Need to review carefully
+- ⚠️ One-time effort
+
+**MY RECOMMENDATION:** 
+**YES! ✅ Perfect timing!**
+- Quota resets in 2h anyway
+- Cleanup makes future work easier
+- Good use of waiting time
+- Professional organization matters!
+
+---
+
+## 🎯 NEXT STEP:
+
+**Want me to:**
+
+**Option A:** Create automated cleanup script NOW
+- Scans all assets
+- Identifies duplicates
+- Suggests renames
+- YOU review before any deletion
+
+**Option B:** Manual approach
+- I give you list of what to check
+- You organize manually
+- Less automated, more control
+
+**Option C:** Skip for now
+- Keep current messy structure
+- Deal with it later
+
+**KAJ HOČEŠ? 🤔**
+
+Priporočam **Option A** - automated script with YOUR approval! ✅