mattfalahe / blueprint-manager
Corporation blueprint library management plugin for SeAT
Package info
github.com/MattFalahe/Blueprint-Manager
Language:Blade
Type:seat-plugin
pkg:composer/mattfalahe/blueprint-manager
Requires
- php: ^8.0
- eveseat/services: ^5.0
- eveseat/web: ^5.0
- laravel/framework: ^10.0
Requires (Dev)
- orchestra/testbench: ^8.0
- phpunit/phpunit: ^10.0
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.
What's New in v2.0.0: The Ecosystem Era
Blueprint Manager still runs perfectly on its own, but it now plugs into the wider plugin suite through Manager Core:
- Manager Core integration (optional, guarded). Publishes the request lifecycle (
blueprint.request.created/.approved/.rejected/.fulfilled) to the Manager Core EventBus, and exposesblueprint.getCharacterStats/blueprint.getCorpSummarythrough the PluginBridge. Every call isclass_exists-guarded, so nothing changes when Manager Core is absent. - HR Manager engagement. With HR Manager installed, a member's blueprint requests (totals, fulfilled vs rejected, favourite types) surface on their HR profile plus a corp-wide engagement card.
- Main-character attribution. Requests and management actions attribute to your SeAT main character, not whichever alt was linked most recently.
- Design-system refresh to match the rest of the suite, plus a Version Status card in the help page that tells you when an update is available.
- Security & correctness hardening (authorization scope, route gating, stored-XSS escaping, research activity-ID labels).
See the CHANGELOG for the full list. No database migrations; standalone behaviour is unchanged.
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: Configure and manage the blueprint libraries of multiple corporations from one place
- Cross-Corporation Sharing: Open a corporation's library to specific corporations, its alliance, or everyone (defaults to private; request management always stays with the owning corporation)
- 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
- Library Sharing: Choose who can view and request from each corporation's library (private, specific corporations, alliance, or everyone)
🔐 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
- Add patterns matching your container names (e.g.,
-
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 libraryblueprint-manager.request- Create and view own requestsblueprint-manager.manage_requests- Process requests and view statisticsblueprint-manager.settings- Configure system settings
Support
- Documentation: In-app help system (
Blueprint Manager → Help) - Issues: GitHub Issue Tracker
- Discord: Join the SeAT community
- Email: mattfalahe@gmail.com
- 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
The Plugin Suite
Blueprint Manager is part of a family of SeAT plugins that interoperate through Manager Core:
- Manager Core - Optional ecosystem hub: pricing, EventBus, PluginBridge, shared SDE and ESI services
- HR Manager - Recruitment funnel and director assessment / retention (consumes Blueprint Manager engagement data)
- Mining Manager - Mining tax, ledger, moon extraction and theft detection
- Structure Manager - Fuel tracking, timers and alerts for Upwell structures and POSes
- Corp Wallet Manager - Corporation wallet analytics and predictions
- Buyback Manager - Corp buyback program: appraise, offer, contract
- SeAT Broadcast - Discord broadcasts, fleet calendar and FC opportunities
Happy blueprint managing! o7