99 lines
2.3 KiB
Markdown
99 lines
2.3 KiB
Markdown
# Sprint 2: GUI Foundation + Loadout Manager
|
|
|
|
**Date:** 2026-02-08
|
|
**Status:** IN PROGRESS
|
|
**Lead Engineer:** LemonNexus
|
|
**Objective:** Build PyQt6 GUI with transparent HUD overlay + Entropia Nexus loadout manager
|
|
|
|
---
|
|
|
|
## Sprint 2 Scope
|
|
|
|
### Phase 1: GUI Foundation (PyQt6)
|
|
- [ ] Main application window
|
|
- [ ] Transparent HUD overlay (always-on-top, click-through)
|
|
- [ ] Real-time stats display panel
|
|
- [ ] Session controls (start/stop/pause)
|
|
- [ ] Theme system (dark/light)
|
|
|
|
### Phase 2: Loadout Manager
|
|
- [ ] Weapon/Armor/Tool configuration UI
|
|
- [ ] Entropia Nexus API client (stats fetching)
|
|
- [ ] Cost calculations (PED/hour, PED/drop)
|
|
- [ ] Loadout save/load system
|
|
- [ ] DPP (Damage Per Pec) calculator
|
|
|
|
### Phase 3: Integration
|
|
- [ ] Connect HUD to live session data
|
|
- [ ] Display current loadout stats
|
|
- [ ] Real-time cost tracking
|
|
- [ ] ROI calculations with gear costs
|
|
|
|
---
|
|
|
|
## Technical Stack
|
|
|
|
| Component | Technology |
|
|
|-----------|------------|
|
|
| GUI Framework | PyQt6 6.4+ |
|
|
| Overlay | Qt Widgets with WA_TransparentForMouseEvents |
|
|
| Styling | QSS (Qt StyleSheets) |
|
|
| API Client | httpx (async) |
|
|
| Data Storage | SQLite (existing) |
|
|
|
|
---
|
|
|
|
## Development Notes
|
|
|
|
**Self-Testing Strategy:**
|
|
- Use mock data for UI development
|
|
- Test overlay positioning with fake stats
|
|
- Validate Entropia Nexus API integration
|
|
- Simulate loadout changes
|
|
|
|
**User Testing Required For:**
|
|
- Real Entropia Nexus API responses
|
|
- Actual gear stats validation
|
|
- In-game HUD positioning
|
|
- Live loadout switching
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
/ui
|
|
/components → Reusable widgets
|
|
/windows → Main window, HUD overlay
|
|
/themes → QSS stylesheets
|
|
/loadout → Loadout manager UI
|
|
/core
|
|
/nexus_api.py → Entropia Nexus client (expand)
|
|
/loadout.py → Loadout data models
|
|
```
|
|
|
|
---
|
|
|
|
## Entropia Nexus Integration
|
|
|
|
**Status:** ✅ OFFICIAL REST API FOUND!
|
|
|
|
**API Docs:** https://api.entropianexus.com/docs/
|
|
|
|
**Approach:** Use official REST API (no scraping needed!)
|
|
|
|
**Endpoints to Explore:**
|
|
- `/items` — Weapon/Armor/Tool stats
|
|
- `/weapons` — Weapon-specific data
|
|
- `/markets` — Markup data (optional)
|
|
|
|
**Data Needed:**
|
|
- Weapon: damage, decay, ammo, DPP
|
|
- Armor: protection values, decay
|
|
- Tools: depth, radius, cost
|
|
- Market: markups (optional)
|
|
|
|
---
|
|
|
|
**Next Update:** When Phase 1 (GUI Foundation) is ready for review
|