# 🍋 Lemontropia Suite — User Test Guide

**Version:** 0.1.0-alpha  
**Status:** Core Data Capture Engine — Mock Mode  
**Date:** 2026-02-08

---

## 🚀 Quick Start

### 1. Prerequisites
```bash
# Ensure Python 3.11+ is installed
python3 --version

# Run from project directory
cd /home/impulsivefps/.openclaw/workspace/projects/Lemontropia-Suite
```

### 2. Launch Application
```bash
python3 main.py
```

---

## 📋 User Test Checklist

### ✅ Test 1: Create a Project
1. Select option **1** (Create New Project)
2. Enter name: `My First Hunt`
3. Select type: **1** (Hunting)
4. Verify project appears in list (Option 2)

**Expected:** Project created with ID, visible in project list

---

### ✅ Test 2: Live Session (Mock Mode)
1. Select option **3** (Start Live Session)
2. Select your project
3. Watch mock log data being processed
4. Observe loot/globals/skills being captured
5. Press **Ctrl+C** to stop
6. View session summary

**Expected:** 
- Session starts
- Mock events appear (loot, skills, globals)
- Events recorded to database
- Summary shows total PED, event counts

---

### ✅ Test 3: View Statistics
1. Select option **4** (View Project Stats)
2. Select your project
3. Review totals and ROI

**Expected:**
- Session count displayed
- Total PED calculated
- ROI percentage shown

---

### ✅ Test 4: Data Persistence
1. Exit application (Option 0)
2. Restart: `python3 main.py`
3. Select option **2** (List Projects)
4. Select option **4** (View Stats)

**Expected:** Data persists between runs

---

## 🎯 What You're Testing

### Core Features
- ✅ **Project Management** — Create, list, archive projects
- ✅ **Session Tracking** — Start/end sessions with auto-capture
- ✅ **Log Parsing** — Real-time regex pattern matching
- ✅ **Data Storage** — SQLite with Data Principle schema
- ✅ **Statistics** — ROI calculations, event summaries

### Never-Break Rules Validated
- ✅ **Data Principle** — Every session saved as Project
- ✅ **Log Polling** — 2-second interval (performance)
- ✅ **Decimal Precision** — PED/PEC exact calculations
- ✅ **Mock Mode** — No game client required

---

## 📊 Expected Output Example

```
🍋 ==========================================
   LEMONTROPIA SUITE — User Test Build
   Data Capture Engine v0.1.0
==========================================

🍋 Initializing Lemontropia Suite...
✅ Database ready

📋 MAIN MENU
----------------------------------------
  1. 🎯 Create New Project
  2. 📂 List All Projects
  3. ▶️  Start Live Session (Mock Mode)
  4. 📊 View Project Stats
  5. 🗄️  Archive Project
  6. 🧹 Reset Database (WARNING)
  0. 🚪 Exit
----------------------------------------
Select option: 1

🎯 CREATE NEW PROJECT
----------------------------------------
Project name: My First Hunt

Project types:
  1. hunt (Hunting)
  2. mine (Mining)
  3. craft (Crafting)
  4. inventory (Inventory)
Select type (1-4): 1

✅ Created project: My First Hunt (ID: 1, Type: hunt)

📂 PROJECTS
------------------------------------------------------------
  ID    Name                 Type       Status     Created
  ----------------------------------------------------------
  1     My First Hunt        hunt       active     2026-02-08

  Total: 1 project(s)

📋 MAIN MENU
...
```

---

## 🔧 Troubleshooting

### Issue: `ModuleNotFoundError`
**Solution:** Python standard library only — no external deps for core

### Issue: Permission denied on database
**Solution:** Check `data/` directory permissions

### Issue: Mock log not found
**Solution:** App auto-generates `test-data/mock-chat.log` on first run

---

## 📝 Feedback

After testing, report:
1. Did all menu options work?
2. Were loot events captured correctly?
3. Did statistics calculate properly?
4. Any errors or unexpected behavior?
5. Performance observations?

---

## 🍋 Next Steps

After successful user test:
- Sprint 2: GUI Foundation (PyQt6)
- HUD Overlay system
- Real-time stats display
- Module toggles

---

**Lead Engineer:** LemonNexus  
**Repository:** https://git.lemonlink.eu/impulsivefps/Lemontropia-Suite

*Happy Testing! 🍋*