Lager Guru Docs

English

Deutsch
Български

English

Deutsch
Български

Appearance

Latest Changelog ​

Most recent changes and updates to Lager Guru.

[4.3.0] - 2025-02-20 — Stability & Caching Layer ​

🔥 Summary ​

Stability-focused release that standardizes React Query caching rules, eliminates low-interval polling, and formalizes "no REST on hover / animation" as a core design principle. This layer sits on top of the Performance Optimization Edition and makes data loading behavior predictable and efficient.

✨ Added ​

  • React Query Global Defaults:
    • staleTime: 30s — dashboard and map data considered fresh for 30 seconds
    • gcTime: 60s — cache retained for 60 seconds for quick back/forward navigation
    • refetchOnWindowFocus: false — no hidden refetch bursts when switching tabs
    • refetchOnReconnect: false — avoids reconnect storms on unstable networks
    • refetchOnMount: false when data is still fresh
    • retry: 1 with exponential backoff for transient Supabase errors
  • REST Spike Prevention:
    • Removed legacy 5-second polling for driver shipments in Driver Dashboard
    • Confirmed that Lagerkarte simulations (useFloorplanSimulation, useWarehouseSimulation) are fully in-memory and never call Supabase on tick/hover
    • Ensured floorplan interactions (hover, panning, zoom) only use cached data (no per-frame fetches)
  • Stability Layer Principles (Documented):
    • Snapshot-first dashboards via get-dashboard-snapshot-v2
    • Cache-first strategy with React Query + IndexedDB
    • Realtime-over-polling for high-frequency updates
    • "No REST on hover / animation" and "Simulation is local" rules

📚 Documentation ​

  • Updated: Performance Optimization guide with stability/caching rules and realtime strategy
  • Updated: Architecture guide with corrected React Query timings (30s / 60s) and stability notes
  • Updated: Changelog index and timeline with v4.3.0 entry

🚀 Migration Notes ​

  • If any feature relied on refetchOnWindowFocus, add explicit invalidation or per-hook overrides.
  • Polling intervals below 30 seconds should be avoided; prefer realtime or manual refresh.

See v4.3.0 Release Notes for complete changelog.

[4.2.0] - 2025-02-06 — Performance Optimization Edition ​

🔥 Summary ​

Major performance optimization release focused on reducing API response sizes by 30-70%, implementing comprehensive REST request reduction strategies, and introducing a new unified dashboard snapshot architecture. This release significantly improves dashboard load times, reduces network traffic, and provides better scalability for enterprise deployments.

✨ Added ​

  • Dashboard Snapshot Architecture: New get-dashboard-snapshot-v2 Edge Function
    • Unified dashboard data aggregation endpoint
    • Lightweight mode for KPI-only dashboards (60-70% size reduction)
    • Pagination support (page, pageSize parameters)
    • Automatic gzip/deflate compression
  • Performance Optimizations:
    • Field selection optimization (reduced payloads by 30-70%)
    • Client-side query optimization (replaced select('*') with specific fields)
    • Pagination for all list endpoints
  • Caching Strategy: Multi-layer caching with stale-while-revalidate pattern
    • Server-side: Edge Function cache (60s TTL)
    • Client-side: React Query + static cache store
    • IndexedDB: Persistent cache for inventory/pick lists
  • Database Performance:
    • JSONB indexes for frequently queried fields
    • Materialized views for complex queries
    • Optimized functions leveraging materialized views

🎯 Performance Impact ​

  • Request Reduction: 60-80% fewer REST requests per dashboard
  • Response Size: 60-90% reduction (500KB → 200KB full / 50KB lightweight)
  • Load Time: 40-60% faster dashboard loads
  • Network Traffic: 70-85% reduction

🚀 Migration Notes ​

  • Additive Only: No breaking changes
  • Optional Deployment: Edge Function deployment optional (fallback available)
  • Database Migration: Includes indexes and materialized views

See v4.2.0 Release Notes for complete changelog.

[3.9.1] - 2025-02-04 — Performance Optimization + Safety Role Sync ​

🔥 Summary ​

Performance optimizations, role system normalization, edge function aggregation layer, and critical bug fixes. This release improves dashboard responsiveness, standardizes user roles, and fixes navigation issues.

✨ Added ​

  • Edge Function Aggregation Layer: New Supabase Edge Functions for dashboard data aggregation
    • admin-dashboard-summary: Aggregates zones, inventory, pick lists, shipments
    • safety-kpis: Aggregates safety metrics (TSR, incidents, actions, checklists)
    • safety-engagement: Aggregates engagement metrics (scores, badges, leaderboard)
  • In-memory Caching: Tenant-scoped caching with configurable TTL (30-60 seconds)
  • Role System Normalization: Complete audit and standardization of all 8 user roles
  • Role Validation: Database functions to validate role assignments
  • Engagement Views: Activity timeline with participation metrics
  • Predictive Warnings (v1): Historical near-miss pattern detection

🐛 Fixed ​

  • Build & Lint Errors: Fixed import errors and case block lint errors
  • Navigation Bugs: Fixed back buttons that reset context unexpectedly
  • Workflow Editor Navigation: Fixed "Neuer Workflow" button navigation issue

🔧 Technical Details ​

  • Edge Functions: In-memory cache with per-tenant isolation
  • Database Improvements: Missing columns added, helper functions & triggers
  • RLS View Security: All dashboard views use SECURITY INVOKER
  • Performance Indexes: Optimized indexes for frequently queried columns

📚 Documentation ​

  • New: Security Roles documentation (docs/en/security/roles.md)
  • New: Edge Functions API reference (docs/api/edge-functions.md)
  • Updated: Changelog, API Reference, Security Overview

🚀 Migration Notes ​

  • Additive Only: No breaking changes
  • Edge Functions: Optional deployment (fallback to direct queries if not deployed)
  • Role System: Backward compatible, existing roles continue to work

See v3.9.1 Release Notes for complete changelog.

[3.9.0] - 2025-01-26 — Enterprise Safety Workflows ​

🔥 Summary ​

Enterprise-grade Safety Workflows with visual drag-and-drop builder, role-based approvals, and full audit trail. Production-ready release suitable for self-hosting and enterprise deployment.

✨ Added ​

  • Visual Safety Workflow Builder: Drag-and-drop workflow editor with ReactFlow canvas
  • Configurable Approval Flows: Role-based approvals (Admin, Safety Officer, Worker) with SLA/timeout
  • Enterprise-Grade Safety Foundation: Full audit trail, tenant isolation, draft/published versions
  • UI/UX Improvements: Standalone editor page, node palette, configuration panel, validation warnings
  • Performance & Stability: Optimized caching, backward compatible, no breaking changes

🔧 Technical Details ​

  • Database Schema: safety_workflows, workflow_instances, workflow_audit_log tables
  • API Enhancements: Workflow CRUD, draft save/publish/rollback, instance management
  • Frontend Architecture: ReactFlow-based visual editor, standalone editor route

🔒 Security & Permissions ​

  • Admin/Safety Officer only for workflow creation/editing
  • Tenant-scoped with full RLS policies
  • Complete audit trail for compliance

📚 Documentation ​

  • Updated Safety Pro documentation with comprehensive Workflows section
  • Visual editor usage guide
  • Workflow configuration best practices

See v3.9.0 Release Notes for complete changelog.

[3.8.0] - 2025-02-XX — Enterprise Foundation ​

🔥 Summary ​

Enterprise-grade positioning with Inventory Intelligence, Audit, granular locations, and Safety Pro expansion.

✨ Added ​

  • Inventory Intelligence & Audit: Metrics, risk scoring, snapshots, audit logs, approval-ready adjustments
  • Granular Inventory: Zone → Storage Unit → Bin; bin-level transfers and reconciliation
  • Safety Pro Expansion: Incidents, trainings, compliance dashboards, multi-role support
  • Performance & Offline: Caching, offline-first PWA messaging
  • Multi-tenant Readiness: Clear edition mapping (Free / Pro / Enterprise), SaaS-ready deployment

See v3.8.0 Release Notes for complete changelog.

[3.7.0] - 2025-01-28 — Werkstatt & Asset Management Module ​

🔥 Summary ​

Enterprise-grade asset and storage unit tracking system with full configurability and multi-tenant support.

✨ Added ​

  • Werkstatt & Asset Management Module: Complete asset and storage unit management (Enterprise edition)
  • 7 New Database Tables: asset_types, storage_unit_types, asset_conditions, storage_units, assets, asset_usage_logs, asset_maintenance_links
  • Configuration UI: Dedicated interface for managing types and conditions
  • Asset Checkout/Return: Track asset usage with checkout and return functionality
  • Usage History: Complete audit trail of asset usage
  • QR/Barcode Scanning: Support for QR code and barcode scanning
  • Maintenance Integration: Integration with existing Maintenance module
  • Safety Integration: Integration with Safety module

🔧 Improved ​

  • Form Handling: Fixed Select component issues with proper controlled state
  • Loading States: Added loading indicators for better UX
  • Empty States: Clear messages when no data is available
  • Internationalization: Added translations for Werkstatt module (DE, EN, BG)
  • Error Handling: Improved error messages and validation

🐛 Fixed ​

  • Select Component Issues: Fixed empty string values causing Radix UI errors
  • Form State Management: Fixed form state issues with controlled components
  • Translation Keys: Fixed missing translation keys for Werkstatt module
  • Default Exports: Fixed React.lazy import issues with default exports
  • Navigation Visibility: Fixed module visibility in admin panel

🔒 Security ​

  • RLS Policies: All tables protected with Row-Level Security
  • Tenant Isolation: Full tenant isolation maintained
  • Access Control: Role-based access control implemented

⚙ Migration Notes ​

  • Required Migration: Run 20250128000000_werkstatt_asset_module.sql
  • No Breaking Changes: All changes are additive
  • Backward Compatible: Fully backward compatible with existing data

View Full Release Notes | View on GitHub

Recent Releases ​

[3.6.0] - 2025-12-08 — Worker/Driver Dashboard Redesign ​

Complete dashboard redesign with mobile optimization, enhanced accessibility, and full i18n support.

View Release Notes

[3.5.0] - 2025-12-08 — i18n Multi-Language Upgrade ​

🔥 Summary ​

Complete dashboard redesign with mobile optimization, enhanced accessibility, and full i18n support.

✨ Added ​

  • Modern UI: Complete visual overhaul with modern, professional interface
  • Mobile Optimization: Enhanced mobile responsiveness and touch-friendly interface
  • Responsive Layout: Adaptive layouts for desktop, tablet, and mobile devices
  • Improved Navigation: Enhanced sidebar navigation with collapsible panels
  • Better Accessibility: Larger tap areas, keyboard navigation support, ARIA labels
  • Pick & Pack Access: Drivers now have access to Pick & Pack module
  • Enhanced Safety Dashboard: Improved Safety Dashboard layouts and organization
  • Driver RLS Policies: New Row-Level Security policies for driver access
  • Improved KPI Cards: Horizontal scrolling KPI cards on mobile, grid layout on desktop
  • Collapsible Panels: "Aktive Fahrer" panel can be toggled on/off for better screen space
  • Full i18n Support: Includes all features from v3.5.0 (i18n Multi-Language Upgrade)

🔧 Improved ​

  • Mobile Experience: Significantly improved mobile user experience
  • Navigation: Better navigation structure and organization
  • Visual Design: Modern, clean, and professional visual design
  • Performance: Improved page load times and rendering performance
  • Accessibility: Better accessibility for users with disabilities
  • Responsive Sidebar: Sidebar collapses to icon-only mode on smaller screens
  • Bottom Navigation: Mobile-friendly bottom navigation on small screens
  • KPI Dashboard: Improved KPI dashboard with better mobile support

🐛 Fixed ​

  • CI/CD Build Errors: Fixed build errors related to let vs const in shipments.ts queries
  • VitePress Build: Fixed VitePress build errors with proper bash syntax
  • PDF Generator: Fixed parsing error by renaming pdfGenerator.ts to .tsx
  • Documentation Links: Fixed dead links in documentation
  • Build Configuration: Improved build configuration and error handling
  • Zone Fixes: Fixed zone-related issues from i18n implementation
  • Language Routing: Prevented language prefix duplication in routes

🔒 Security ​

  • RLS Policies: New driver RLS policies added
  • Access Control: Enhanced access control for driver features
  • Security: All security measures maintained and improved

⚙ Migration Notes ​

  • No Breaking Changes: All existing functionality remains unchanged
  • UI Only: This is a UI/UX enhancement, no backend changes required
  • Backward Compatible: Fully backward compatible with existing data and APIs

View Full Release Notes | View on GitHub

Recent Releases ​

[3.5.0] - 2025-12-08 — i18n Multi-Language Upgrade ​

Comprehensive multi-language support with English and Bulgarian translations.

View Release Notes

[3.4.0] - 2025-12-08 — Safety Pro Ultra ​

Advanced Safety Pro tier with enhanced HSE management and performance optimizations.

View Release Notes

[3.3.0] - 2025-12-08 — Safety Pro AI Upgrade ​

AI-powered safety management with intelligent incident analysis and predictive insights.

View Release Notes

[3.2.0] - 2025-12-08 — Safety Pro Edition ​

Universal safety management system for any industry with incident reporting and checklists.

View Release Notes

[3.1.0] - 2025-12-08 — Tenant Edition System ​

Foundational edition system enabling FREE, PRO, and ENTERPRISE tiers.

View Release Notes

Version History ​

Released under Commercial License

Copyright © 2025 HashMatrix