### ✨ Improvements
- Minor polish across business command help and GUI documentation.

### Bug Fixes
- Fixed a critical bug in `ConsolidatedBusinessManager.getBusinessPerformanceReport(...)` where a missing return could lead to incorrect or empty results.
- Fixed a lot of misbeaving Business GUI related issues.

### Testing
- Verified full compile via Maven and prepared test plan for GUI navigation and reload behavior (no duplicate revenue tasks).

### Docs
- Updated `README.md` to reference 1.0.5 artifacts and clarified admin vs player command visibility.
- Updated `ROADMAP.md` current version to 1.0.5 and rolled near-term targets forward.

### Bug Fixes
- Fixed persistent blank tooltip when hovering over empty GUI slots by introducing a config toggle to disable filler panes.
- Hardened GUI protections to prevent moving items on Business GUI screens by cancelling both click and drag interactions while a `BusinessGUI` is open.
- Fixed broken/inconsistent UI screens by ensuring all Business GUI inventories use `BusinessGUIHolder` and validating top-inventory checks.

### Config
- New key in `config.yml`:
- `gui.useFillerPanes` (default: `true`) — when `false`, empty GUI slots are left empty to avoid hover tooltips.

### Notes
- Behavior for click/drag blocking in GUI is unchanged; interactions remain canceled while a `BusinessGUI` inventory is open.

A quality-of-life update focused on safer admin economy actions, better i18n consistency, and faster access to the Business GUI.

## ✨ Improvements
- Prefix precedence in admin messages now respects `config.yml` first, then `messages.yml`, then defaults; reloaded on `/djeconomy reload`.
- Added `/business gui` and `/business menu` helpers to open the business GUI faster, with tab completion. (perm: `djeconomy.gui.access`)

## Bug Fixes
- Offline player deposits now correctly use `EconomyManager.depositPlayer(...)` for offline targets.
- Confirmation threshold/expiry now read with defaults using the correct `FileConfiguration#get*` overloads.
- Added guard for missing economy manager with a friendly `admin.economy_unavailable` message.
- Aligned i18n keys and placeholders across give/take/set, confirm prompts, expiry, offline flow, and reload success.

## Docs
- Updated README/INSTALLATION with JAR guidance and new business GUI commands.

---

## Compatibility
- Minecraft: 1.20.4 – 1.21.x
- Integrations: Vault, WorldGuard, McMMO, LuckPerms
- Databases: SQLite, MySQL, MongoDB

Version 1.0.2 represents the largest feature expansion in Dynamic Jobs & Economy Pro history, introducing a complete business management ecosystem with GUI interfaces, advanced analytics, and Minecraft-integrated business operations.

---

## **NEW FEATURES**

### **Complete GUI Business Management System**
- **Interactive Business Dashboard**: Full inventory-based GUI for business management
- **Employee Management GUI**: Visual interface for hiring, firing, promoting, and managing employees
- **Revenue Overview GUI**: Comprehensive revenue tracking with daily/weekly/monthly breakdowns
- **Location Management GUI**: Visual management of business locations and operational costs
- **Processing Chain GUI**: Interactive resource processing chain management
- **Construction Contract GUI**: Visual project management for construction contracts

### **Minecraft-Integrated Business Features**
- **Physical Business Locations**: 10 location types with WorldGuard region integration
- Headquarters, Branch Offices, Warehouses, Shop Fronts, Factories, Farms, Mines, Construction Sites, Service Centers, Research Labs
- Location-based efficiency bonuses and operational costs
- Automatic region protection and naming
- **Resource Processing Chains**: 12 processing types for realistic business operations
- Mining Refinery, Food Processing, Lumber Mill, Textile Factory, Smelting, Brewing, Enchanting, Tool Manufacturing, Armor Smithing, Construction Materials, Agricultural Processing, Redstone Engineering
- Material input/output mapping with profit calculations
- Employee efficiency scaling and processing time optimization
- **Construction Contract System**: 11 construction types for player-business interactions
- House Building, Commercial Building, Infrastructure, Landscaping, Mining Operations, Farm Setup, Defensive Structures, Redstone Engineering, Renovation, Demolition, Custom Builds
- Automated cost estimation and deadline management
- Contract status tracking with quality review phases

### **Advanced Business Analytics & Management**
- **Multi-Model Revenue System**: Service-based, product sales, contracts/gigs, and passive income streams
- **Position-Based Employee Management**: Create custom job positions with specific salaries and requirements
- **Employee Performance Tracking**: Notes, history, productivity analytics, and performance reports
- **Business Department System**: Organize employees into departments for better management
- **Automated Payroll Processing**: Scheduled payroll with atomic transaction safety
- **Business Effectiveness Reports**: Comprehensive analytics for position utilization and business performance

### **Enhanced Command System**
- **Consolidated Business Commands**: Over 20 new business management commands
- **Advanced Employee Operations**: Promote, demote, add notes, view history, performance reports
- **Position Management**: Create, edit, activate/deactivate positions
- **Business Analytics**: Revenue reports, productivity analysis, effectiveness insights
- **GUI Integration**: All commands now have GUI equivalents for visual management

---

## **IMPROVEMENTS & ENHANCEMENTS**

### **Security & Performance**
- **Comprehensive Permissions System**: Fine-grained role-based access control for all business operations
- **Database Connection Pooling**: Improved performance and reliability for high-traffic servers
- **Atomic Transaction Processing**: Enhanced transaction safety for all business operations
- **Memory Optimization**: Efficient caching and session management for GUI systems
- **Anti-Exploit Protections**: Enhanced security for all business transactions and operations

### **User Experience**
- **Professional GUI Design**: Intuitive inventory-based interfaces with color-coded materials
- **Session Management**: Smart GUI session tracking with automatic cleanup
- **Enhanced Error Handling**: Comprehensive validation and user-friendly error messages
- **Improved Documentation**: Updated user manual and installation guides
- **Tab Completion**: Full tab completion support for all new commands

### **Integration & Compatibility**
- **Enhanced ShopGUIPlus Integration**: Full API integration with graceful fallback
- **Improved WorldGuard Support**: Automatic region management for business locations
- **McMMO Skill Bonuses**: Employee skills affect business productivity and processing efficiency
- **LuckPerms Integration**: Advanced permission management for business operations
- **Vault Economy**: Seamless integration with existing economy systems

---

## **BUG FIXES**

### **Critical Fixes**
- Fixed all compilation errors and IDE warnings for production-ready codebase
- Resolved method signature mismatches in GUI system
- Fixed duplicate class definitions causing build failures
- Corrected database transaction rollback issues
- Fixed memory leaks in GUI session management

### **Business System Fixes**
- Fixed employee hiring consent system edge cases
- Resolved payroll calculation inconsistencies
- Fixed business creation permission validation
- Corrected revenue tracking for multi-model businesses
- Fixed location operational cost calculations

### **Command & GUI Fixes**
- Fixed tab completion for all business commands
- Resolved GUI navigation issues between menus
- Fixed material mapping for business type icons
- Corrected employee position display in GUI
- Fixed business analytics calculation errors

---

## **TECHNICAL IMPROVEMENTS**

### **Code Quality**
- **Complete Code Refactor**: Consolidated 5+ legacy managers into unified ConsolidatedBusinessManager
- **Eliminated Code Duplication**: Removed redundant methods and streamlined business logic
- **Enhanced Error Handling**: Comprehensive try-catch blocks with detailed logging
- **Improved Documentation**: Extensive JavaDoc comments and inline documentation
- **Clean Architecture**: Proper separation of concerns and dependency injection

### **Database Enhancements**
- **New Database Tables**: business_locations, processing_chains, construction_contracts, business_positions, business_employees
- **Optimized Queries**: Improved performance with prepared statements and connection pooling
- **Data Validation**: Enhanced validation for all business data operations
- **Backup Safety**: Automatic data backup before major operations

### **Performance Optimizations**
- **Efficient Caching**: Smart caching for frequently accessed business data
- **Lazy Loading**: On-demand loading of business components to reduce memory usage
- **Batch Operations**: Optimized database operations for bulk employee management
- **Memory Management**: Automatic cleanup of unused GUI sessions and cached data

## **Dynamic Jobs & Economy Pro v1.0.1 - Polish & Security Update**

### **️ Security Enhancements**
- ** Gig Escrow System**: Gigs now require poster approval before payment is released
- ** Employee Consent**: Business hiring/firing now requires employee acceptance
- **⚠️ Admin Transaction Safety**: Large admin transactions (>$100k) require confirmation
- ** Atomic Business Operations**: All business transactions are now rollback-safe

### ** New Automated Features**
- ** Auto-Payroll**: Businesses automatically pay employee salaries every hour
- ** Auto-Save**: Player data saves every 5 minutes and on logout
- ** Memory Cleanup**: Automatic cleanup of tracking data to prevent memory leaks

### **‍ Enhanced Admin Commands**
- ** Offline Player Support**: All admin economy commands now work with offline players
- **✅ New Confirmation System**: Use `/djeconomy confirm` for large transactions
- ** Enhanced Logging**: All admin actions are logged with timestamps

### ** Improved User Experience**
- **⌨️ Complete Tab Completion**: All commands now have full tab completion
- ** Real Job Perks**: Job perks now provide actual potion effects
- **️ Anti-Exploit Protection**: Added cooldowns to prevent farming abuse
- ** Better Error Messages**: Clearer feedback for all operations

### ** New Command Features**

**Business Commands:**
- `/business accept-hire` - Accept a business job offer
- `/business reject-hire` - Reject a business job offer
- Enhanced `/business hire <player> <business_id>` - Now requires employee consent

**Gig Commands:**
- `/gigs approve <gig_id>` - Approve completed gig work (poster only)
- `/gigs reject <gig_id>` - Reject completed gig work (poster only)
- Enhanced `/gigs complete <gig_id>` - Now submits for approval instead of auto-paying

**Admin Commands:**
- `/djeconomy confirm` - Confirm large admin transactions
- Enhanced `/djeconomy economy give/take/set <player> <amount>` - Now works with offline players
- Enhanced `/djeconomy setlevel <player> <job> <level>` - Now works with offline players

### ** Critical Bug Fixes**
- Fixed compilation errors in command classes
- Resolved null pointer exceptions in admin commands
- Fixed missing employee tracking in businesses
- Corrected offline player economy operations
- Improved plugin reload functionality

### **⚡ Performance Improvements**
- Optimized database queries
- Fixed memory leaks in tracking systems
- Enhanced async task management
- Reduced server lag impact