# 🗂️ PROJECT CLEANUP & ORGANIZATION PLAN
**Date:** 2025-12-12  
**Goal:** Organize NovaFarma project structure for better maintainability

---

## 📁 **Current Issues:**
- ❌ 92 files in root directory (too many!)
- ❌ Multiple `.md` documentation files scattered
- ❌ Test files (`.js`) mixed with main code
- ❌ Backup folders in root
- ❌ Python scripts in root

---

## ✅ **Proposed Structure:**

```
c:\novafarma\
├── 📁 docs/                    # All documentation
│   ├── planning/               # FAZA checklists, plans
│   ├── guides/                 # User guides, testing
│   ├── sessions/               # Session summaries
│   └── design/                 # Design docs, GDD
│
├── 📁 tools/                   # Development tools
│   ├── python/                 # Python scripts (sprites, bg removal)
│   └── build/                  # Build scripts
│
├── 📁 archive/                 # Old files, backups
│   ├── backups/                # Backup folders
│   ├── tests/                  # Old test files
│   └── deprecated/             # Deprecated code
│
├── 📁 src/                     # Source code (ALREADY ORGANIZED ✅)
│   ├── scenes/
│   ├── systems/
│   ├── entities/
│   ├── ui/
│   └── utils/
│
├── 📁 assets/                  # Game assets (ALREADY ORGANIZED ✅)
│   ├── sprites/
│   └── [other assets]
│
├── 📁 dist/                    # Distribution builds
├── 📁 build/                   # Build output
├── 📁 node_modules/            # Dependencies
│
└── 📄 [Root Files - KEEP ONLY ESSENTIAL]
    ├── package.json            ✅ KEEP
    ├── package-lock.json       ✅ KEEP
    ├── index.html              ✅ KEEP
    ├── main.js                 ✅ KEEP
    ├── server.js               ✅ KEEP
    ├── README.md               ✅ KEEP
    ├── CHANGELOG.md            ✅ KEEP
    ├── TASKS.md                ✅ KEEP
    ├── .gitignore              ✅ KEEP
    └── novafarma.code-workspace ✅ KEEP
```

---

## 🗑️ **Files to MOVE (not delete):**

### → `docs/planning/`
- FAZA_*_CHECKLIST.md (17 files)
- TASKS_*.md
- NEXT_STEPS.md
- FUTURE_TASKS.md
- dev_plan.md
- optimizations.md

### → `docs/guides/`
- ACCESSIBILITY.md
- ACCESSIBILITY_IMPLEMENTATION_PLAN.md
- ANDROID_GUIDE.md
- COLLISION_GUIDE.md
- DISTRIBUTION_GUIDE.md
- FARMING_GUIDE.md
- KAKO_OSVEZITI_IGRO.md
- TESTING_GUIDE.md
- TRANSLATION_TESTING.md
- MP4_VIDEO_GUIDE.md
- STEAM_INTEGRATION_PLAN.md
- SYSTEM_REQUIREMENTS.md

### → `docs/sessions/`
- SESSION_*.md (11 files)
- DNEVNIK.md
- FINAL_SESSION*.md

### → `docs/design/`
- DESIGN_DOC.md
- GDD.md
- ADVANCED_*.md
- ATMOSPHERIC_EFFECTS.md
- BUILDING_CONTROLS_PLAN.md
- DLC_ROADMAP.md
- FENCE_IMPLEMENTATION_SUMMARY.md
- KICKSTARTER_PLAN.md
- OPEN_WORLD_PLAN.md
- SEZNAM_STAVB_IN_DEKORACIJ.md
- UI_IMPROVEMENTS_*.md

### → `tools/python/`
- make_spritesheet.py
- process_sprites.py
- remove_backgrounds.py
- ultra_remove_bg.py

### → `archive/tests/`
- ADVANCED_BUILD_MODE_CODE.js
- GAMESCENE_KEYBOARD_BINDINGS.js
- QUICK_VIDEO_TEST.js
- STAMINA_SYSTEM_INTEGRATION.js
- TEST_FENCE_PLACEMENT.js
- VIDEO_CHARACTER_TEST.js
- clear_all_saves.js
- clear_save.js
- test_water_animation.js

### → `archive/backups/`
- backup_faza11_2025-12-11/
- backup_faza11_extracted/

### → `archive/deprecated/`
- NovaFarma-v2.5.0-Windows.zip (old build)
- BUILD_TEST_RESULTS.md
- COMMIT_PHASE23.md
- DISTRIBUTION_PACKAGE.md

---

## 🎯 **Action Plan:**

1. ✅ Create new directories
2. ✅ Move files to appropriate locations
3. ✅ Update README.md with new structure
4. ✅ Test that game still runs
5. ✅ Commit changes with clear message

---

## 📝 **Notes:**
- **DO NOT DELETE** any files - only move/organize
- Keep git history intact
- Update any hardcoded paths if needed
- Test game after reorganization