impulsivefps
/
Lemontropia-Suite
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Lemontropia-Suite/PROJECT_INDEX.md

7.5 KiB
Raw Blame History

Lemontropia-Suite Project Index

Project Metadata

  • Name: Lemontropia Suite
  • Repository: https://git.lemonlink.eu/impulsivefps/Lemontropia-Suite
  • Local Path: /home/impulsivefps/.openclaw/workspace/projects/Lemontropia-Suite
  • Branch: main
  • Status: 🟢 Active Development
  • Lead Engineer: LemonNexus
  • Last Updated: 2026-02-08 16:37 UTC

Directory Structure

Current Structure (Documentation Phase)

Lemontropia-Suite/
├── 📁 data/                    # SQLite database storage
│   └── 📁 backups/             # Rotating database backups
├── 📁 logs/                    # Application logs
├── 📁 maps/                    # Mining map overlays
├── 📁 screenshots/             # Auto-capture on 50+ PED loot
├── 📁 test-data/               # Mock data for development
│
├── 📄 .env                     # Environment configuration (gitignored)
├── 📄 .env.example             # Configuration template
├── 📄 .gitignore               # Git exclusions
│
├── 📄 AGENTS.md                # Agent operating manual (THIS IS LAW)
├── 📄 AI_KNOWLEDGE_BASE.md     # MCP server configuration
├── 📄 GAME_MECHANICS.md        # Entropia Universe domain knowledge
├── 📄 INSPIRATION.md           # Design inspiration & references
├── 📄 MODULE_REQUIREMENTS.md   # Module specifications
├── 📄 OBSIDIAN_WORKFLOW.md     # Documentation protocol
├── 📄 PROJECT_RESUME.md        # Development state tracking
├── 📄 README.md                # Project overview
├── 📄 RESOURCES.md             # External resources & APIs
├── 📄 TECHNICAL_SPECS.md       # Implementation details
├── 📄 TESTING_AND_DEBUGGING.md # QA procedures
├── 📄 VERIFICATION_CHECKLIST.md # Release checklist
├── 📄 environment-test.md      # Environment validation
└── 📄 run_tests.bat            # Windows test runner

Target Structure (Implementation Phase)

Per AGENTS.md architecture:

Lemontropia-Suite/
├── 📁 /core                    # Engine logic
│   ├── __init__.py
│   ├── log_watcher.py          # Observer Pattern implementation
│   ├── project_manager.py      # Data Principle enforcement
│   ├── auth_manager.py         # License verification
│   └── database.py             # SQLite abstraction
│
├── 📁 /modules                 # Feature modules
│   ├── 📁 hunter/              # Combat analytics
│   ├── 📁 miner/               # Mining tracker
│   ├── 📁 crafter/             # Crafting tool
│   └── 📁 inventory/           # Inventory manager
│
├── 📁 /ui                      # PyQt6 interface
│   ├── 📁 components/          # Shared UI widgets
│   ├── 📁 hud/                 # Overlay system
│   └── 📁 themes/              # Dark mode & styling
│
├── 📁 /data                    # Runtime data
│   ├── 📁 projects/            # Session archives
│   └── lemontropia.db          # SQLite database
│
├── 📁 /assets                  # Static resources
│   └── 📁 icons/               # UI icons & images
│
├── 📁 /tests                   # pytest suite
│   ├── test_log_watcher.py
│   ├── test_project_manager.py
│   └── conftest.py
│
├── 📄 main.py                  # Application entry point
├── 📄 requirements.txt         # Python dependencies
└── 📄 setup.py                 # Package installer

Core Modules

Module Status Purpose Key Features
Core Engine ⏳ Planned Log polling, database, auth Observer Pattern, asyncIO, SQLite
Hunter Tracker ⏳ Planned Combat analytics Damage parsing, ROI calculation, global detection
Mining Tracker ⏳ Planned Resource mapping Geospatial claims, probe efficiency, depth tracking
Crafting Tool ⏳ Planned Manufacturing simulation Blueprint DB, cost/benefit, market prices
Inventory Manager ⏳ Planned Asset valuation Markup tracking, market integration
HUD Overlay ⏳ Planned Transparent overlay Always-on-top, click-through, editable

Technology Stack

Layer Technology Version Purpose
Language Python 3.11+ Core implementation
GUI Framework PyQt6 Latest Windows native UI
Database SQLite 3.39+ Project storage
OCR Engine PaddleOCR / Tesseract Configurable UI element capture
Async Framework asyncio Built-in Non-blocking operations
Testing pytest 7.x+ Quality assurance
Packaging setuptools Latest Distribution

Documentation Map

Document Purpose Key Content
AGENTS.md Agent operating manual Never-Break Rules, coding standards, Git workflow
TECHNICAL_SPECS.md Implementation guide Data Capture Engine, HUD specs, automation logic
GAME_MECHANICS.md Domain knowledge Entropia Universe economy, loot system, calculations
AI_KNOWLEDGE_BASE.md AI context MCP server config, project patterns
OBSIDIAN_WORKFLOW.md Documentation protocol Note structure, auto-update rules
PROJECT_RESUME.md State tracking Current status, next actions

Environment Configuration

Variable Location Status
OBSIDIAN_API_URL .env ✅ Configured (192.168.5.30:27123)
OBSIDIAN_API_KEY .env ✅ Configured
LICENSE_EMAIL .env ⏳ Pending (dev mode)
LICENSE_INVOICE_ID .env ⏳ Pending (dev mode)
EU_CHAT_LOG_PATH .env ✅ Using mock data path

Git Repository

  • Remote: git@git.lemonlink.eu:impulsivefps/Lemontropia-Suite.git
  • Protocol: SSH (port 2222 via ~/.ssh/config)
  • Default Branch: main
  • Commit Convention: type(scope): description
  • Latest Commit: 63c5c8f - feat: add Obsidian REST API endpoint configuration

Integration Status

System Status Endpoint
Gitea 🟢 Connected git.lemonlink.eu:2222
Obsidian 🟢 Operational 192.168.5.30:27123
Code-server 🟢 Running 192.168.5.216:8443
OpenClaw API 🟢 Active localhost:18789/v1

Current Sprint

Sprint 0: Infrastructure & Setup ✅ COMPLETE

  • Repository initialized
  • Environment configuration
  • Documentation structure
  • Obsidian integration
  • Agent identity sync

Sprint 1: Core Data Capture Engine ⏳ NEXT

  • Create /core directory structure
  • Implement LogWatcher (Observer Pattern)
  • Implement ProjectManager (Data Principle)
  • SQLite schema initialization
  • Mock data pipeline
  • Unit tests for core components

Never-Break Rules Reference

See AGENTS.md Section 2 and SOUL.md Lemontropia Core Directives.

Quick Reference:

  1. Data Principle — Every session is a Project
  2. Log Polling First — OCR is fallback only
  3. 60+ FPS Guarantee — Game performance is sacred
  4. Decimal Precision — No rounding errors on PED/PEC
  5. Test Before Commit — pytest tests/ is mandatory
  6. Atomic Commits — Conventional commit format
  7. Obsidian Sync — Document every architectural decision

Project Index maintained by LemonNexus. Last sync: 2026-02-08 16:37 UTC