README

A comprehensive blueprint library and request management system for EVE Online corporations using SeAT. Organize your corporation's blueprints, manage member requests, track statistics, and receive Discord/Slack notifications for seamless blueprint distribution.

Features

📚 Blueprint Library

Pattern-Based Organization: Configure container name patterns with wildcards to automatically categorize blueprints
Custom Categories: Group blueprints by ship class, module type, or any custom system
Automatic Detection: Scan corporation containers to quickly discover and configure blueprint locations
Multi-Corporation Support: Manage blueprints across multiple corporations
Real-Time Data: Automatically syncs with SeAT's ESI updates

📝 Request System

Simple Request Creation: Members request blueprints with specified quantity and runs
Complete Workflow: Pending → Approved → Rejected → Fulfilled states
Request Management: Approve, reject, and fulfill requests with notes
Self-Service: Users can delete their own pending/rejected requests
Request History: Complete audit trail with filtering and search

🔔 Discord & Slack Notifications

Webhook Integration: Rich embed notifications for request events
Event Types: New requests, approvals, rejections, and fulfillments
Per-Event Configuration: Enable/disable notifications individually
Corporation Filtering: Target notifications to specific corporations
Clean Formatting: Professional, minimal emoji design
Test Function: Verify webhook configuration

📊 Statistics & Analytics

Overall Metrics: Total requests, approval rates, fulfillment rates, processing times
Time Series Analysis: Visualize trends over 7, 30, and 90 days
Character Statistics: Track most active requesters
Blueprint Popularity: Identify most-requested blueprints
Corporation Comparison: Compare activity across multiple corporations
Interactive Charts: Visual graphs for trend analysis

⚙️ Configuration & Settings

Container Configuration: Define patterns to organize blueprint library
Container Detection: Automatically scan and suggest configurations
Webhook Management: Configure multiple Discord/Slack webhooks
Detection Settings: Customize which hangars to scan per corporation

🔐 Permission System

View Library: Browse available blueprints
Create Requests: Submit blueprint requests
Manage Requests: Approve/reject/fulfill requests and view statistics
Settings: Configure container patterns and webhooks

Installation

composer require mattfalahe/blueprint-manager
php artisan migrate

That's it! The plugin will automatically:

Create database tables
Register permissions
Set up navigation menu items
Begin tracking blueprints on next SeAT sync

Usage

Getting Started

Configure Container Patterns (Settings page)
- Add patterns matching your container names (e.g., *Capital*, *Frigate*)
- Use "Detect Containers" to automatically scan your corporation
- Assign display categories for organization
Set Up Notifications (Optional)
- Create Discord/Slack webhooks
- Configure which events to notify
- Test webhook to verify connectivity
Configure Permissions
- Assign Blueprint Manager permissions to corporation roles in SeAT
- At minimum, members need "View Library" and "Create Requests"
- Managers need "Manage Requests" for processing

Blueprint Library

Access the library from the SeAT sidebar. The main page shows:

All corporation blueprints organized by configured categories
Quantity available, ME/TE ranges, and runs for each blueprint type
Category filtering for easy browsing
Detail views showing individual blueprint copies

Request System

For Members:

Navigate to Requests page
Click "New Request"
Select corporation and blueprint
Specify quantity and runs
Add notes explaining your need
Submit request

For Managers:

Review pending requests on Requests page
Click "Approve" to accept or "Reject" to decline
Add notes about delivery or rejection reason
Click "Fulfill" after providing the blueprint in-game

Statistics

Access comprehensive analytics:

Overall request metrics
Time series graphs showing trends
Character activity rankings
Most popular blueprints
Corporation comparisons

Data Synchronization

Blueprint Manager reads directly from SeAT's asset and blueprint tables, which sync automatically with EVE's ESI API. This means:

✅ New blueprints added in-game appear after SeAT's next sync
✅ Research changes (ME/TE) update automatically
✅ Location changes reflect when assets sync
✅ No manual sync needed - completely automatic

Help & Documentation

Complete in-app help system available at Blueprint Manager → Help:

10 major documentation sections
12 FAQ entries
Troubleshooting guides
Configuration examples
Permission setup guides

Screenshots

Coming soon - check the Wiki

Requirements

SeAT 5.x
PHP 8.1+
Laravel 10+
Active ESI token with asset and blueprint scopes

Permissions

Configure in SeAT's role management:

blueprint-manager.view - View blueprint library
blueprint-manager.request - Create and view own requests
blueprint-manager.manage_requests - Process requests and view statistics
blueprint-manager.settings - Configure system settings

Support

Documentation: In-app help system
Issues: GitHub Issue Tracker
Source: GitHub Repository
Changelog: CHANGELOG.MD

Contributing

Found a bug or have a feature request? Please create an issue on GitHub!

License

This plugin is licensed under the GPL-2.0 License.

Credits

Developed by Matt Falahe for the EVE Online community.

Built for SeAT (Simple EVE API Tool) by eveseat.github.io

Other Plugins by Matt Falahe

Structure Manager - Comprehensive fuel tracking for Upwell structures and POSes
Corp Wallet Manager - Corporation wallet journal analysis
SeAT-Discord-Pings - Discord ping and broadcast management for SeAT

Happy blueprint managing! o7

mattfalahe / blueprint-manager

Maintainers

Details