# 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
- [x] Repository initialized
- [x] Environment configuration
- [x] Documentation structure
- [x] Obsidian integration
- [x] 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*