novafarma/PROJECT_CLEANUP_PLAN.md

🗂️ 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