4.1 KiB

Raw Blame History

🍋 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

# Ensure Python 3.11+ is installed
python3 --version

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

2. Launch Application

python3 main.py

📋 User Test Checklist

✅ Test 1: Create a Project

Select option 1 (Create New Project)
Enter name: My First Hunt
Select type: 1 (Hunting)
Verify project appears in list (Option 2)

Expected: Project created with ID, visible in project list

✅ Test 2: Live Session (Mock Mode)

Select option 3 (Start Live Session)
Select your project
Watch mock log data being processed
Observe loot/globals/skills being captured
Press Ctrl+C to stop
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

Select option 4 (View Project Stats)
Select your project
Review totals and ROI

Expected:

Session count displayed
Total PED calculated
ROI percentage shown

✅ Test 4: Data Persistence

Exit application (Option 0)
Restart: python3 main.py
Select option 2 (List Projects)
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:

Did all menu options work?
Were loot events captured correctly?
Did statistics calculate properly?
Any errors or unexpected behavior?
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! 🍋

4.1 KiB Raw Blame History