From a3a0fbe2f53f776cef0ea8f2b9e23d97221c4ab3 Mon Sep 17 00:00:00 2001
From: LemonNexus <nexus@lemonlink.eu>
Date: Mon, 9 Feb 2026 00:01:34 +0000
Subject: [PATCH] docs: add comprehensive ROADMAP.md

- Project vision and completed features
- Current sprint: Advanced Loadout Manager
- Future sprints: Analytics, Export, Hunter/Miner/Crafter modules
- Attachment system planned
- Full cost tracking scope defined
---
 docs/ROADMAP.md | 116 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 116 insertions(+)
 create mode 100644 docs/ROADMAP.md

diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
new file mode 100644
index 0000000..76f38bf
--- /dev/null
+++ b/docs/ROADMAP.md
@@ -0,0 +1,116 @@
+# 🍋 LEMONTROPIA SUITE - Development Roadmap
+
+## **PROJECT VISION**
+**Lemontropia Suite** is a professional-grade analytics platform for Entropia Universe players. It provides real-time tracking, cost analysis, and ROI calculations for hunting, mining, and crafting activities.
+
+---
+
+## **✅ COMPLETED (Sprint 2 Phase 2)**
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Core Data Capture Engine | ✅ | SQLite DB, LogWatcher, ProjectManager |
+| Real-time Log Parsing | ✅ | English + Swedish support |
+| HUD Overlay | ✅ | Transparent, draggable, click-through |
+| Entropia Nexus API | ✅ | 3,099 weapons, 1,985 armors, 106 finders, 817 mobs |
+| Gear Selector | ✅ | Weapon/Armor/Finder selection with real stats |
+| Cost Tracking | ✅ | Decay-based cost per shot |
+| Profit/Loss | ✅ | Real-time P/L calculation |
+| Shots/Kills/Damage | ✅ | All tracking accurately |
+
+---
+
+## **🔨 CURRENT SPRINT - Advanced Loadout Manager**
+
+### **Loadout Manager v2.0**
+Full gear configuration with complete cost tracking.
+
+#### **Core Features:**
+- [ ] **Weapon Selection** - From Nexus API (3,099 weapons)
+- [ ] **Armor Selection** - From Nexus API (1,985 armors)
+- [ ] **Finder Selection** - From Nexus API (106 finders)
+- [ ] **Healing Tools** - Medical tools + healing chips with cost tracking
+- [ ] **Current DPP Display** - Real-time DPP in HUD overlay
+
+#### **Attachment System:**
+| Attachment | Compatible Gear | Status |
+|------------|-----------------|--------|
+| Amplifiers | Weapons | Planned |
+| Scopes | Weapons | Planned |
+| Absorbers | Weapons | Planned |
+| Finder Amplifiers | Finders | Planned |
+| Armor Platings | Armors | Planned |
+| Enhancers | Weapons/Armor/Tools | Planned |
+| Mindforce Implants | Mindforce chips | Planned |
+
+**Validation:** Only allow correct attachments for gear type.
+
+#### **Cost Tracking:**
+- [ ] **Weapon Decay** - Per shot fired
+- [ ] **Armor Decay** - Per hit taken (from chat.log damage)
+- [ ] **Healing Cost** - Per heal used
+- [ ] **Ammo Cost** - Per shot fired
+- [ ] **Attachment Decay** - If applicable
+
+---
+
+## **📊 SPRINT 3 - Analytics & Export**
+
+### **ROI Charts**
+- [ ] Profit/loss graphs over time
+- [ ] Cost breakdown pie charts
+- [ ] Efficiency trends
+
+### **Session Comparison**
+- [ ] Compare current vs historical sessions
+- [ ] Best/worst session identification
+- [ ] Improvement tracking
+
+### **Export System**
+- [ ] CSV export for spreadsheet analysis
+- [ ] JSON export for external tools
+- [ ] Session reports (PDF/HTML)
+
+---
+
+## **🎮 SPRINT 4 - Specialized Modules**
+
+### **Hunter Module**
+- [ ] Mob spawn tracking
+- [ ] Best loot per mob analysis
+- [ ] Optimal weapon recommendations per mob
+
+### **Miner Module**
+- [ ] Mining run tracking with depth/radius
+- [ ] Claim quality analysis
+- [ ] Resource value tracking
+
+### **Crafter Module**
+- [ ] Blueprint profit calculator
+- [ ] Success rate tracking
+- [ ] Material cost analysis
+
+---
+
+## **🚀 FUTURE IDEAS**
+
+- [ ] **Cloud Sync** - Data across devices
+- [ ] **Mobile Companion** - Check stats on phone
+- [ ] **Discord Integration** - Auto-share globals
+- [ ] **Twitch Overlay** - Streamer-friendly display
+- [ ] **Trading Integration** - Track markup, sales
+
+---
+
+## **TECHNICAL DEBT**
+
+- [ ] Comprehensive pytest suite
+- [ ] GUI integration tests
+- [ ] Performance optimization (60+ FPS guarantee)
+- [ ] Error handling improvements
+- [ ] Documentation updates
+
+---
+
+**Last Updated:** 2026-02-09  
+**Next Milestone:** Advanced Loadout Manager with full cost tracking
\ No newline at end of file