Search by 
mattfalahe / mining-manager
Comprehensive mining management plugin for SeAT - Track mining activities, manage moon extractions, calculate taxes, and generate detailed reports
Maintainers
Package info
github.com/MattFalahe/Mining-Manager
Type:seat-plugin
pkg:composer/mattfalahe/mining-manager
1.0.2
2026-04-21 02:16 UTC
Requires
- php: ^8.1
- barryvdh/laravel-dompdf: ^2.0
- eveseat/services: ^5.0
- eveseat/web: ^5.0
- laravel/framework: ^10.0
Requires (Dev)
- orchestra/testbench: ^8.0
- phpunit/phpunit: ^10.0
This package is auto-updated.
Last update: 2026-04-21 02:31:24 UTC
README
A comprehensive mining management plugin for SeAT 5.x. Track mining operations, manage moon extractions, calculate taxes, and generate detailed reports for your corporation.
Features
- Mining Ledger -- Automated processing of character and corporation mining data with daily summary aggregation
- Moon Mining -- Extraction tracking, ore composition, value estimation, jackpot detection (automatic + manual reporting), chunk arrival alerts. Past Extractions table with sortable/filterable DataTables view, structure column, status filter (expired/fractured/cancelled), and search — scoped to Moon Owner Corporation only
- Tax System -- Daily summary-based tax calculation with per-ore rates (moon R4-R64, regular ore, ice, gas, abyssal, triglavian), multi-corporation support, guest mining rates, event modifiers, configurable minimum tax amount with exempt/enforce behavior, wallet payment verification, and manual payment entry
- Mining Events -- Create events with tax modifiers (tax-free to double-tax), auto-detect participants from mining ledger matching event time + location scope (system/constellation/region/global), leaderboards
- Reports -- Daily/weekly/monthly reports with PDF/CSV/JSON export and scheduled Discord/Slack delivery
- Theft Detection -- Detect and monitor unauthorized mining with severity classification and incident tracking
- Dashboard -- Corporation-wide analytics with 12-month charts, leaderboards, and statistics
- Notifications -- 15 notification types via Discord webhooks and Slack with per-webhook event toggles
- Diagnostics -- 15-tab diagnostic suite: test data, price provider, cache health, system validation, settings health, tax trace, data integrity, valuation test, system status, notification testing, moon extractions, tax pipeline, theft detection, event lifecycle, analytics and reports
Requirements
- SeAT 5.x
- PHP 8.1+
- MariaDB / MySQL
Installation
composer require mattfalahe/mining-manager php artisan migrate php artisan db:seed --class=MiningManager\\Database\\Seeders\\ScheduleSeeder
After installation:
- Open SeAT and navigate to Mining Manager > Settings > General
- Set your Moon Owner Corporation
- Configure tax rates in Settings > Tax Rates
- Run the setup wizard to populate your data:
php artisan mining-manager:initialize
The wizard verifies your settings, populates current month data (prices, mining entries, summaries, extractions), and optionally backfills historical data for reports and analytics.
Configuration
Key Settings
| Setting | Location | Description |
|---|---|---|
| Moon Owner Corporation | Settings > General | Which corporation owns the moon structures -- determines observer data scope |
| Tax Rates | Settings > Tax Rates | Per-corporation rates for moon ore (R4-R64), regular ore, ice, gas, abyssal, triglavian |
| Guest Miner Tax Rates | Settings > General | Global rates for non-member miners on your moons (0% = no tax) |
| Tax Selector | Settings > Tax Rates | Choose what ore types to tax (all moon ore / only corp moon ore / none + regular types) |
| Price Provider | Settings > Pricing | Market data source (SeAT, Fuzzwork, Janice, or Manager Core) |
Corporation Tax Model
| Miner Type | Data Source | Tax Rate Applied |
|---|---|---|
| Member of configured corp | Moon observer + character ledger | That corp's tax rates |
| Guest miner (not in any configured corp) | Moon observer only | Guest tax rates (from General Settings) |
| Non-member mining elsewhere | Not processed | Not taxed |
Moon Arrival Notification Architecture
Moon arrival notifications use two decoupled systems:
┌──────────────────────────────────────────────────────────────────┐
│ STATE SYSTEM (ESI-driven) │
│ - update-extractions every 2h │
│ - Pulls ESI and writes chunk_arrival_time, natural_decay_time, │
│ fractured_at, status │
│ - Answers: "what does EVE say is happening?" │
└──────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────┐
│ NOTIFICATION SYSTEM (time-driven) │
│ - check-extraction-arrivals every 1 min │
│ - Reads stored chunk_arrival_time, compares to now() │
│ - Answers: "has arrival time passed + unnotified?" │
│ - Idempotent via notification_sent flag │
└──────────────────────────────────────────────────────────────────┘
Mental model: ESI tells us WHAT is happening. The clock tells us WHEN to notify.
This decoupling means arrivals notify within ~60 seconds of the actual chunk arrival time regardless of ESI refresh timing or outages. The chunk_arrival_time is known the moment an extraction is first imported (days or weeks before arrival); the notification watchdog just compares it to the current time.
Cancellation handling: If a director cancels an extraction in-game before chunk arrival, EVE sends a MoonminingExtractionCancelled character notification. The state system detects this during its next ESI poll and marks the extraction as cancelled. The notification watchdog then skips it — no false "Moon Chunk Ready" alert fires at the originally scheduled arrival time.
Permissions
4-tier permission model -- higher tiers inherit all lower tier access.
| Permission | Tier | Description |
|---|---|---|
mining-manager.view |
Base | Help page access |
mining-manager.member |
Member | View own mining data, join events, view moon schedules, report jackpots, reprocessing calculator |
mining-manager.director |
Director | View all corp data, manage operations, analytics, reports, theft detection |
mining-manager.admin |
Admin | Full control: settings, tax management, delete actions, API, diagnostics |
Artisan Commands
33 commands available, 22 run on automated schedules via SeAT's scheduler.
Operational Commands
| Command | Schedule | Description |
|---|---|---|
mining-manager:process-ledger |
Every 30min (:15, :45) | Process corporation observer mining data |
mining-manager:import-character-mining |
Every 30min (:20, :50) | Import character mining from SeAT ESI cache |
mining-manager:update-extractions |
Every 2h | Refresh moon extraction data from ESI (state system: what EVE says is happening) |
mining-manager:check-extraction-arrivals |
Every minute | Fire moon_arrival notifications based on stored chunk_arrival_time (notification system: when to notify). Idempotent via notification_sent flag |
mining-manager:update-events |
Every minute | Auto-transition event status (planned→active→completed) with notifications, update participant data |
mining-manager:cache-prices |
Every 4h (:30) | Cache market prices from configured provider |
mining-manager:update-ledger-prices |
Daily 1:00 AM | Lock in daily session prices for mining entries |
mining-manager:update-daily-summaries |
Daily 1:30 AM | Safety net for non-observer mining data |
mining-manager:calculate-taxes |
Daily 2:15 AM | Update running month-to-date tax totals |
mining-manager:generate-invoices |
Daily 2:30 AM | Generate tax invoices for completed periods with automatic tax code assignment |
mining-manager:verify-payments |
Every 6h (:05) | Match wallet transfers against tax codes |
mining-manager:send-reminders |
Daily 10:00 AM | Send tax payment reminders (if enabled in settings) |
mining-manager:generate-reports |
Day 9 of month 4:05 AM + hourly (scheduled) | Generate monthly report (7 days after finalize-month for collection % to mature) and process user-defined scheduled reports. Dedup guard skips if same period+type exists (use --force to override) |
mining-manager:recalculate-extraction-values |
Twice daily (6AM/6PM) | Update moon extraction values with current prices |
mining-manager:archive-extractions |
Daily 5:05 AM | Archive completed extractions older than 7 days |
mining-manager:detect-jackpots |
Daily 6:05 AM | Detect jackpot extractions + verify manual reports |
mining-manager:detect-theft |
1st and 15th 1:00 AM | Full scan for unauthorized moon mining |
mining-manager:monitor-active-thefts |
Every 6h (:10) | Monitor characters already on theft list |
mining-manager:finalize-month |
2nd of month 2:00 AM | Pre-calculate summaries for closed month |
mining-manager:calculate-monthly-stats |
2nd of month 3:00 AM + every 30min (current month) | Dashboard statistics |
Utility Commands
| Command | Description |
|---|---|
mining-manager:initialize |
Guided first-time setup wizard -- verifies settings, populates current month, optional historical backfill |
mining-manager:backfill-ore-types |
One-time backfill of ore type flags on existing data |
mining-manager:backfill-extraction-notifications |
Backfill fractured_at from historical ESI notifications |
mining-manager:backfill-extraction-history |
Reconstruct moon_extraction_history from MoonminingExtractionStarted notifications. Recovers past cycles for structures that pre-date plugin install. Progress bars for both dedup and processing passes. Use --dry-run to preview, --structure=ID to scope to one structure. Automatically invoked during mining-manager:initialize (Phase 3 historical backfill) |
mining-manager:generate-tax-codes |
Generate tax codes for any unpaid taxes missing active codes (auto-generated on invoice creation, this is the manual fallback) |
mining-manager:generate-test-data |
Generate test data for development/testing |
mining-manager:backup-data |
Export Mining Manager data for backup or migration |
mining-manager:restore-data |
Import Mining Manager data from a backup |
mining-manager:diagnose-prices |
Diagnose price cache health and market data |
mining-manager:diagnose-affiliation |
Debug character corporation affiliations |
mining-manager:diagnose-character |
Debug character mining data and imports |
mining-manager:diagnose-extractions |
Debug moon extraction data and notifications |
mining-manager:diagnose-type-ids |
Debug ore type ID classification |
Webhook Notifications
15 notification types across 5 categories. Each webhook can independently toggle which events it receives.
Supported channels: Discord webhooks and Slack.
| Category | Events | Description |
|---|---|---|
| Tax | generated, announcement, reminder, invoice, overdue | Payment lifecycle notifications |
| Moon | arrival, jackpot | Chunk ready and jackpot detection alerts |
| Events | created, started, completed | Mining event lifecycle |
| Theft | detected, critical, active, resolved | Security alerts |
| Reports | generated | Scheduled report delivery |
Support
- Issues: GitHub Issues
- Wiki: Documentation & Screenshots
- In-App Help: Full documentation available at Settings > Help within the plugin
License
GNU General Public License v2.0 -- see LICENSE for details.
EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights are reserved worldwide.