mirror of
https://github.com/fleetbase/fleetbase.git
synced 2026-01-06 06:15:51 +00:00
Preparing major release
This commit is contained in:
Ronald A. Richardson
284
RELEASE.md
284
RELEASE.md
@@ -1,22 +1,277 @@
|
||||
# 🚀 Fleetbase v0.7.19 — 2025-11-17
|
||||
# 🚀 Fleetbase v0.7.20 — 2025-12-05
|
||||
|
||||
> "A major leap forward in scheduling, reporting, and user interface capabilities."
|
||||
> "Major architectural & universe framework refactor for improved build, loading and initialization of extensions and system."
|
||||
|
||||
---
|
||||
|
||||
## ✨ Highlights
|
||||
- **Core Scheduling Module**: A comprehensive, polymorphic, and reusable scheduling system has been integrated into the core API, providing the foundation for a wide range of scheduling applications.
|
||||
- **Driver Scheduling with HOS Compliance**: FleetOps now includes built-in compliance for FMCSA Hours of Service regulations.
|
||||
- **Computed Columns in Query Builder**: The query builder now supports computed columns, allowing for more complex and powerful data queries with secure expression validation.
|
||||
- **Advanced Table Functionality**: The Ember UI table component now supports multi-column sorting, horizontal scrolling, and sticky columns.
|
||||
- **New Filter Components**: New filter components for multi-input and range selection have been added to the Ember UI.
|
||||
- **Dispatched Flag Control**: The order creation process in FleetOps now allows for explicit control over the dispatch behavior.
|
||||
- **Vehicle Attributes Enhancement**: The vehicle model and API resources in FleetOps have been enhanced with additional attributes.
|
||||
## @fleetbase/ember-core v0.3.7
|
||||
|
||||
### 🎯 Major Features
|
||||
|
||||
#### Universe Service Refactor
|
||||
Complete architectural overhaul of the Universe service with separation of concerns into specialized sub-services:
|
||||
|
||||
- **ExtensionManager**: Manages extension loading, engine instances, and lifecycle hooks
|
||||
- **RegistryService**: Fully dynamic, Map-based registry system for cross-engine resource sharing
|
||||
- **MenuService**: Dedicated menu item and panel management with event support
|
||||
- **WidgetService**: Dashboard widget registration and retrieval system
|
||||
- **HookService**: Application lifecycle hooks and custom event hooks
|
||||
|
||||
**Key Benefits:**
|
||||
- Improved performance with lazy loading and proper engine lifecycle management
|
||||
- Better separation of concerns and maintainability
|
||||
- Enhanced cross-engine resource sharing via Ember's application container
|
||||
- Backward compatibility maintained through facade pattern
|
||||
|
||||
#### Enhanced Extension System
|
||||
|
||||
**New Extension Patterns:**
|
||||
- `extension.js` hook patterns with `setupExtension()` and `onEngineLoaded()` support
|
||||
- `whenEngineLoaded()` utility method that handles both loaded and not-yet-loaded engines
|
||||
- Comprehensive extension checking methods: `isInstalled()`, `isEngineLoaded()`, `isEngineLoading()`
|
||||
- Automatic hook execution for router-loaded engines
|
||||
|
||||
**Engine Loading Improvements:**
|
||||
- Fixed race conditions between engine loading and hook registration
|
||||
- Proper tracking of router-loaded engines in `loadedEngines` Map
|
||||
- Patched `buildChildEngineInstance` to run hooks for router-loaded engines
|
||||
- Two-phase extension setup: registration first, then hook execution
|
||||
|
||||
**Performance Optimizations:**
|
||||
- `extensions.json` loading with localStorage caching
|
||||
- Reduced console noise by removing excessive debug logs
|
||||
- Performance monitoring for extension load times
|
||||
|
||||
#### Helper Registration System
|
||||
- Cross-engine helper sharing via application container
|
||||
- `registerHelper()` method for template helpers
|
||||
- Support for both class-based and function-based helpers
|
||||
- Automatic registration to application container for global access
|
||||
|
||||
#### Component Registration Enhancements
|
||||
- `registerRenderableComponent()` for cross-engine component sharing
|
||||
- Support for component classes via `ExtensionComponent`
|
||||
- Automatic component registration to engine containers
|
||||
- `getRenderableComponents()` for retrieving registered components
|
||||
|
||||
### 🔧 API Improvements
|
||||
|
||||
#### UniverseService
|
||||
- `getService()` method with flexible naming pattern resolution:
|
||||
- Short names: `"menu"` → `universe/menu-service`
|
||||
- Plural variations: `"hooks"` or `"hook"` → `universe/hook-service`
|
||||
- CamelCase: `"menuService"` → `universe/menu-service`
|
||||
- Full names: `"menu-service"` → `universe/menu-service`
|
||||
- With namespace: `"universe/menu-service"` → `universe/menu-service`
|
||||
- `whenEngineLoaded()` for simplified engine-dependent setup
|
||||
- `getServiceFromEngine()` for accessing engine-specific services
|
||||
- `getApplicationInstance()` with fallback to `window.Fleetbase`
|
||||
|
||||
#### MenuService
|
||||
- Computed getters for template access: `headerMenuItems`, `adminMenuItems`, `adminMenuPanels`
|
||||
- Event triggers for backward compatibility
|
||||
- Proper `finalView` normalization for all menu items
|
||||
- `onClick` handlers wrapped with `menuItem` and `universe` parameters
|
||||
- Fixed panel item slug/view structure to match original behavior
|
||||
|
||||
#### WidgetService
|
||||
- Per-dashboard widget registration
|
||||
- `registerWidgets()` for making widgets available on dashboards
|
||||
- `registerDefaultWidgets()` for auto-loading specific widgets
|
||||
- Proper widget filtering by dashboard ID
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
#### Extension Loading
|
||||
- Resolved timeout errors during engine boot
|
||||
- Fixed duplicate dashboard ID errors
|
||||
- Corrected engine instance tracking and retrieval
|
||||
- Fixed race conditions in extension setup
|
||||
|
||||
#### Menu System
|
||||
- Fixed registry name mismatch for header menu items
|
||||
- Corrected panel item structure for proper routing
|
||||
- Added null checks before `dasherize` calls
|
||||
- Fixed `onClick` handler parameter passing
|
||||
|
||||
#### Registry System
|
||||
- Fixed widget registry lookup to work with array storage
|
||||
- Proper filtering by registration key
|
||||
- Shared registries Map across all engines via application container
|
||||
- Triggered reactivity when creating new registries
|
||||
|
||||
#### Service Resolution
|
||||
- Fixed service injection on engine boot
|
||||
- Corrected service map injection
|
||||
- Added missing `getServiceFromEngine` method
|
||||
- Fixed `virtualRouteRedirect` and `getViewFromTransition` methods
|
||||
|
||||
### 📦 Exports & Structure
|
||||
- Named exports on "exports" namespace
|
||||
- Separated default and named exports in app/exports re-exports
|
||||
|
||||
### 🔄 ResourceActionService
|
||||
- Allow properties to be set from initialization options
|
||||
- Improved flexibility for service configuration
|
||||
|
||||
## @fleetbase/ember-ui v0.3.12
|
||||
|
||||
### 🎯 Major Features
|
||||
|
||||
#### Dashboard Service Refactor
|
||||
Complete rewrite to support the new Universe service architecture:
|
||||
|
||||
- Direct injection of `widgetService` instead of going through universe
|
||||
- Updated to use new widget service API
|
||||
- Proper dashboard cleanup and recreation on route revisit
|
||||
- Race condition fixes with `drop` task modifier
|
||||
|
||||
#### Widget Panel Enhancements
|
||||
|
||||
**Search & Filter:**
|
||||
- Real-time keyword search for widgets by name and description
|
||||
- `@tracked searchQuery` with `updateSearchQuery` action
|
||||
- Improved widget discoverability
|
||||
|
||||
**Floating Pagination:**
|
||||
- New floating pagination style (bottom-right, rounded, shadowed)
|
||||
- Reveals horizontal scrollbar for better table navigation
|
||||
- `@useTfootPagination` arg for backward compatibility
|
||||
- Default to floating, opt-in to table footer pagination
|
||||
|
||||
**Thin Scrollbars:**
|
||||
- Consistent 8px scrollbar height for both axes
|
||||
- Webkit scrollbar styles for modern browsers
|
||||
- Firefox `scrollbar-width: thin` support
|
||||
- Dark mode scrollbar colors
|
||||
|
||||
### 🔧 Component Improvements
|
||||
|
||||
#### LazyEngineComponent
|
||||
- Support for both path-based (lazy) and class-based (immediate) components
|
||||
- Automatic component registration to engine containers
|
||||
- Proper engine component lookup
|
||||
- Helper for use with `{{component}}` syntax
|
||||
|
||||
#### RegistryYield
|
||||
- Converted `yieldables` to computed getter for automatic reactivity
|
||||
- Automatic wrapping of components with `LazyEngineComponent`
|
||||
- `isComponent` getter to detect component types vs menu items
|
||||
- Updated to use `registryService.getRenderableComponents()`
|
||||
- Removed event listener approach (now uses reactive getters)
|
||||
|
||||
#### LoadEngine Component
|
||||
- New component for explicit engine loading
|
||||
- Complements `LazyEngineComponent` for different use cases
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
#### Dashboard Service
|
||||
- Fixed duplicate dashboard ID errors with `drop` task modifier
|
||||
- Added try-catch in `_createDefaultDashboard` for race conditions
|
||||
- Proper state checks (`isDeleted`, `isDestroying`, `isDestroyed`)
|
||||
- Fixed reset() to unload dashboard-widgets before dashboards
|
||||
- Prevents identity map conflicts when recreating dashboards
|
||||
|
||||
#### Widget Panel
|
||||
- Fixed `availableWidgets` reactivity by converting to getter
|
||||
- Use `args.defaultDashboardId` first, then fallback to `this.defaultDashboardId`
|
||||
- Ensures widgets registered after component creation are visible
|
||||
- Handles string-represented widgets and components
|
||||
|
||||
#### RegistryYield
|
||||
- Fixed TypeError by removing `registryService.on` event listener
|
||||
- RegistryService doesn't have Evented mixin, now uses reactive getters
|
||||
- Components registered after construction now properly yielded
|
||||
|
||||
#### Table Styling
|
||||
- Fixed floating pagination spacing (reduced padding, adjusted margins)
|
||||
- Applied `overflow-x` to `.next-table-wrapper` instead of table
|
||||
- Horizontal scrollbar now visible and not hidden by pagination
|
||||
- Added `overflow-y: visible` to prevent vertical scroll issues
|
||||
|
||||
### 🎨 UX Improvements
|
||||
- Minor UX tweaks to widget panel component
|
||||
- Improved widget panel layout and spacing
|
||||
- Better visual hierarchy for widget selection
|
||||
- Enhanced table navigation with floating pagination
|
||||
|
||||
## Migration Guide
|
||||
|
||||
### For Extension Developers
|
||||
|
||||
#### Using the New Extension Patterns
|
||||
|
||||
**Before:**
|
||||
```javascript
|
||||
// In addon/engine.js
|
||||
export default class MyEngine extends Engine {
|
||||
setupExtension() {
|
||||
// Setup code here
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**After:**
|
||||
```javascript
|
||||
// In addon/extension.js
|
||||
import { Widget } from '@fleetbase/ember-core/contracts';
|
||||
|
||||
export default {
|
||||
setupExtension(universe) {
|
||||
// Get widget service
|
||||
const widgetService = universe.getService('widget');
|
||||
|
||||
// Register widgets, menu items, etc.
|
||||
widgetService.registerWidgets('dashboard', [new Widget({ ... })]);
|
||||
|
||||
// Register hooks for when other engines load
|
||||
universe.whenEngineLoaded('@fleetbase/fleetops-engine', (engineInstance) => {
|
||||
// Setup integration with FleetOps
|
||||
});
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### Accessing Universe Sub-Services
|
||||
|
||||
**Flexible Service Resolution:**
|
||||
```javascript
|
||||
// All of these work:
|
||||
const menuService = universe.getService('menu');
|
||||
const menuService = universe.getService('menu-service');
|
||||
const menuService = universe.getService('menuService');
|
||||
const menuService = universe.getService('universe/menu-service');
|
||||
|
||||
const hookService = universe.getService('hooks');
|
||||
const widgetService = universe.getService('widgets');
|
||||
const registry = universe.getService('registry');
|
||||
```
|
||||
|
||||
#### Widget Registration
|
||||
|
||||
**Before:**
|
||||
```javascript
|
||||
universe.registerWidget(widgetObject);
|
||||
```
|
||||
|
||||
**After:**
|
||||
```javascript
|
||||
// Register widgets available for a dashboard
|
||||
universe.registerWidgets('dashboard', [widget1, widget2]);
|
||||
|
||||
// Register widgets that auto-load on a dashboard
|
||||
universe.registerDefaultWidgets('dashboard', [widget1]);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ Breaking Changes
|
||||
- None
|
||||
- **NO MAJOR BREAKING CHANGED** Both releases maintain full backward compatibility with existing code. The refactor uses a facade pattern to ensure all existing APIs continue to work while providing new, improved patterns for future development.
|
||||
### Notice
|
||||
- Extensions must adapt to the new `extension.js` pattern for initialization setup.
|
||||
- Extension dependencies are not auto-loaded and initialized, dependencies must be explicitly loaded from the setup `extension.js`
|
||||
- `UniverseService` has major changes which refactored core responsibilities to sub-services. There is backwards compatability, but plan to migrate to the new integration architecture.
|
||||
|
||||
---
|
||||
|
||||
@@ -33,5 +288,12 @@ docker compose down && docker compose up -d
|
||||
docker compose exec application bash -c "./deploy.sh"
|
||||
```
|
||||
|
||||
### Post-Upgrade
|
||||
|
||||
1. Clear browser cache and localStorage
|
||||
2. Restart your development server
|
||||
3. Test extension loading and dashboard functionality
|
||||
4. Check console for any deprecation warnings
|
||||
|
||||
## Need help?
|
||||
Join the discussion on [GitHub Discussions](https://github.com/fleetbase/fleetbase/discussions) or drop by [#fleetbase on Discord](https://discord.com/invite/HnTqQ6zAVn)
|
||||
|
||||
Reference in New Issue
Block a user