182 lines
4.1 KiB
Markdown
182 lines
4.1 KiB
Markdown
# 🍋 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! 🍋*
|