chore: add .env.example template and project resume

- Add comprehensive .env.example with all configuration options documented
- Update .gitignore to track .env.example while keeping .env secure
- Add PROJECT_RESUME.md for development state tracking
- Create project directory structure (data, screenshots, logs, etc.)

The .env.example serves as documentation and setup reference for
new deployments while actual credentials remain gitignored.
This commit is contained in:
LemonNexus 2026-02-08 16:26:19 +00:00
parent 2f29640ed3
commit ccee4841a6
3 changed files with 235 additions and 0 deletions

176
.env.example Normal file
View File

@ -0,0 +1,176 @@
# Lemontropia-Suite Environment Configuration
# Copy this file to .env and fill in your values
# NEVER commit .env to git - it contains sensitive data
# =============================================================================
# APPLICATION MODE
# =============================================================================
APP_ENV=development
APP_DEBUG=true
APP_VERSION=0.1.0-alpha
# =============================================================================
# LICENSE & AUTHENTICATION
# =============================================================================
# Your registered email address for license verification
LICENSE_EMAIL=
# Your Invoice ID from purchase (used for license activation)
LICENSE_INVOICE_ID=
# License verification API endpoint
LICENSE_API_URL=https://api.lemontropia.eu/v1/license/verify
# Auto-check for updates on startup (true/false)
AUTO_UPDATE_CHECK=true
# =============================================================================
# DATABASE CONFIGURATION
# =============================================================================
# SQLite database file path
DB_PATH=./data/lemontropia.db
# Backup database path (auto-created)
DB_BACKUP_PATH=./data/backups/
# Maximum backup files to keep (rotating)
DB_MAX_BACKUPS=10
# =============================================================================
# ENTROPIA UNIVERSE CLIENT
# =============================================================================
# Path to Entropia Universe chat.log file
# Windows default: C:\Users\<Username>\Documents\Entropia Universe\chat.log
# Linux/Wine: ~/.wine/drive_c/users/<Username>/Documents/Entropia Universe/chat.log
EU_CHAT_LOG_PATH=./test-data/chat.log
# Log polling interval (milliseconds)
LOG_POLL_INTERVAL=1000
# Maximum log file size before rotation warning (MB)
MAX_LOG_SIZE_MB=100
# =============================================================================
# OCR & SCREEN CAPTURE
# =============================================================================
# OCR engine: tesseract or paddle
OCR_ENGINE=tesseract
# Path to Tesseract executable (if not in PATH)
# Windows: C:\Program Files\Tesseract-OCR\tesseract.exe
TESSERACT_PATH=tesseract
# OCR confidence threshold (0-100)
OCR_CONFIDENCE_THRESHOLD=70
# Screenshot capture on high-value loot
AUTO_SCREENSHOT_ENABLED=true
# PED threshold for auto-sccreenshot
SCREENSHOT_PED_THRESHOLD=50
# Screenshot output directory
SCREENSHOT_PATH=./screenshots/
# Screenshot format: png, jpg
SCREENSHOT_FORMAT=png
# =============================================================================
# HUD / OVERLAY SYSTEM
# =============================================================================
# Enable transparent overlay HUD
HUD_ENABLED=true
# Default HUD opacity (0.0 - 1.0)
HUD_OPACITY=0.85
# HUD window position (x, y)
HUD_POSITION_X=100
HUD_POSITION_Y=100
# HUD window size (width, height)
HUD_WIDTH=400
HUD_HEIGHT=300
# Always on top (true/false)
HUD_ALWAYS_ON_TOP=true
# Click-through mode (true/false)
HUD_CLICK_THROUGH=true
# =============================================================================
# MODULE TOGGLES
# =============================================================================
MODULE_HUNTER_TRACKER=true
MODULE_MINING_TRACKER=true
MODULE_CRAFTING_TOOL=true
MODULE_INVENTORY_MANAGER=true
# =============================================================================
# HUNTER TRACKER SETTINGS
# =============================================================================
# Auto-track on global/hof events
HUNTER_AUTO_TRACK=true
# Damage parser mode: log or ocr
HUNTER_DAMAGE_MODE=log
# Weapon decay calculation method
HUNTER_DECAY_METHOD=manual
# =============================================================================
# MINING TRACKER SETTINGS
# =============================================================================
# Map file path (if using custom maps)
MINING_MAP_PATH=./maps/
# Auto-mark claim locations
MINING_AUTO_MARK=true
# Probe depth tracking enabled
MINING_DEPTH_TRACKING=true
# =============================================================================
# CRAFTING TOOL SETTINGS
# =============================================================================
# Blueprint database update URL
CRAFTING_BP_DB_URL=https://api.lemontropia.eu/v1/blueprints
# Market data refresh interval (minutes)
CRAFTING_MARKET_REFRESH=60
# =============================================================================
# INVENTORY MANAGER SETTINGS
# =============================================================================
# Market API endpoint for price checks
INVENTORY_MARKET_API=https://api.lemontropia.eu/v1/market
# Auto-sync inventory on game launch
INVENTORY_AUTO_SYNC=false
# =============================================================================
# LOGGING
# =============================================================================
# Application log level: debug, info, warning, error
LOG_LEVEL=debug
# Log file path
LOG_PATH=./logs/lemontropia.log
# Max log file size before rotation (MB)
LOG_MAX_SIZE=10
# Number of log backups to keep
LOG_BACKUP_COUNT=5
# =============================================================================
# DEVELOPMENT / TESTING
# =============================================================================
# Use mock data instead of real game client
USE_MOCK_DATA=false
# Mock data file path (for testing)
MOCK_DATA_PATH=./test-data/mock-chat.log
# Enable verbose debug output
VERBOSE_DEBUG=false

1
.gitignore vendored
View File

@ -1,6 +1,7 @@
# --- Lemontropia-Suite Secrets & Config --- # --- Lemontropia-Suite Secrets & Config ---
.env .env
.env.* .env.*
!.env.example
mcp_servers.json mcp_servers.json
# Ignore your Gitea token if it's in a separate file # Ignore your Gitea token if it's in a separate file
gitea_token.txt gitea_token.txt

58
PROJECT_RESUME.md Normal file
View File

@ -0,0 +1,58 @@
# PROJECT_RESUME: Lemontropia-Suite
## Project Metadata
- **Repository:** https://git.lemonlink.eu/impulsivefps/Lemontropia-Suite
- **Local Path:** `/home/impulsivefps/.openclaw/workspace/projects/Lemontropia-Suite`
- **Clone Date:** 2026-02-08 16:20 UTC
- **Last Commit:** 2f29640 - docs: add AI knowledge base with project configuration and MCP server details
- **Status:** Active
## Project Overview
**Entropia-Tools Suite Replication** - Professional analytics platform for Entropia Universe MMORPG.
### Core Modules
1. **Hunter Tracker** - Combat performance & ROI analytics
2. **Mining Tracker** - Geospatial resource mapping & probe efficiency
3. **Crafting Tool** - Manufacturing cost/benefit simulation
4. **Inventory Manager** - Asset valuation & market markup tracking
### Technical Stack (Recommended)
- **Language:** Python (rapid dev) or C#/.NET (Windows native)
- **Database:** SQLite / structured JSON
- **UI:** Modern Dark Mode (PyQt6 or Electron)
- **Data Capture:** Hybrid (Log polling + OCR)
- **Overlay:** Transparent click-through HUD (Always on Top)
### Key Features
- **Data Principle:** All sessions stored as "Projects" (archivable, comparable)
- **Real-time Log Polling:** `Documents/Entropia Universe/chat.log`
- **OCR:** Tesseract/PaddleOCR for UI element capture
- **Auto-Screenshot:** Trigger on loot > 50 PED
- **License Auth:** Email + Invoice ID verification
## Development Status
- [x] Repository initialized
- [x] Documentation structure created
- [ ] Core data capture engine
- [ ] HUD overlay system
- [ ] Hunter Tracker module
- [ ] Mining Tracker module
- [ ] Crafting Tool module
- [ ] Inventory Manager module
- [ ] License/auth system
- [ ] Auto-updater
## Key Files
- `README.md` - Project overview
- `TECHNICAL_SPECS.md` - Implementation details
- `GAME_MECHANICS.md` - Entropia Universe domain knowledge
- `AI_KNOWLEDGE_BASE.md` - MCP server configuration
- `AGENTS.md` - Development agent guidelines
## Environment Setup
- [x] `.env.example` — Template with all configuration options documented
- [x] `.env` — Development configuration (gitignored)
- [x] Directory structure: `data/`, `screenshots/`, `logs/`, `test-data/`, `maps/`
## Next Actions
TBD by Lead Architect