release: v0.8.0 — onboarding wizard, help icon, welcome popup, UI fixes

Author: jakub-przepiora

backend/app/Http/Controllers/Web/AuthController.php

@@ -36,7 +36,7 @@ public function login(Request $request)
         ]);
 
         // Attempt authentication
-        if (!Auth::attempt([
+        if (! Auth::attempt([
             'username' => $request->input('username'),
             'password' => $request->input('password'),
         ], $request->filled('remember'))) {
@@ -71,15 +71,15 @@ public function loginWithPin(\App\Http\Requests\PinLoginRequest $request)
             true
         );
 
-        if (!$pinEnabled) {
+        if (! $pinEnabled) {
             throw ValidationException::withMessages([
                 'pin' => ['PIN login is not enabled.'],
             ]);
         }
 
         $user = User::where('username', $request->input('username'))->first();
 
-        if (!$user || empty($user->pin) || !Hash::check($request->input('pin'), $user->pin)) {
+        if (! $user || empty($user->pin) || ! Hash::check($request->input('pin'), $user->pin)) {
             throw ValidationException::withMessages([
                 'username' => ['Invalid username or PIN.'],
             ]);
@@ -155,6 +155,10 @@ protected function redirectToDashboard()
         $user = auth()->user();
 
         if ($user->hasRole('Admin')) {
+            if (OnboardingController::shouldShowWizard()) {
+                return redirect()->route('onboarding.index');
+            }
+
             return redirect()->route('admin.dashboard');
         }
 

backend/app/Http/Controllers/Web/OnboardingController.php

@@ -0,0 +1,184 @@
+<?php
+
+namespace App\Http\Controllers\Web;
+
+use App\Http\Controllers\Controller;
+use App\Models\Line;
+use App\Models\ProcessTemplate;
+use App\Models\ProductType;
+use App\Models\TemplateStep;
+use App\Services\WorkOrder\WorkOrderService;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class OnboardingController extends Controller
+{
+    public function index()
+    {
+        if ($this->isCompleted()) {
+            return redirect()->route('admin.dashboard');
+        }
+
+        return redirect()->route('onboarding.step1');
+    }
+
+    public function step1()
+    {
+        return view('onboarding.step1-line');
+    }
+
+    public function storeStep1(Request $request)
+    {
+        $validated = $request->validate([
+            'code' => 'required|string|max:50|unique:lines,code',
+            'name' => 'required|string|max:255',
+            'description' => 'nullable|string',
+        ]);
+
+        $line = Line::create([...$validated, 'is_active' => true]);
+        $line->users()->attach(auth()->id());
+
+        $request->session()->put('onboarding.line_id', $line->id);
+
+        return redirect()->route('onboarding.step2');
+    }
+
+    public function step2(Request $request)
+    {
+        if (! $request->session()->has('onboarding.line_id')) {
+            return redirect()->route('onboarding.step1');
+        }
+
+        return view('onboarding.step2-product-type');
+    }
+
+    public function storeStep2(Request $request)
+    {
+        $validated = $request->validate([
+            'code' => 'required|string|max:50|unique:product_types,code',
+            'name' => 'required|string|max:255',
+            'unit_of_measure' => 'nullable|string|max:20',
+        ]);
+
+        $validated['unit_of_measure'] = $validated['unit_of_measure'] ?? 'pcs';
+        $validated['is_active'] = true;
+
+        $productType = ProductType::create($validated);
+
+        $lineId = $request->session()->get('onboarding.line_id');
+        if ($lineId) {
+            Line::find($lineId)?->productTypes()->attach($productType->id);
+        }
+
+        $request->session()->put('onboarding.product_type_id', $productType->id);
+
+        return redirect()->route('onboarding.step3');
+    }
+
+    public function step3(Request $request)
+    {
+        if (! $request->session()->has('onboarding.product_type_id')) {
+            return redirect()->route('onboarding.step1');
+        }
+
+        return view('onboarding.step3-process-template');
+    }
+
+    public function storeStep3(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:255',
+            'steps' => 'required|array|min:1',
+            'steps.*.name' => 'required|string|max:255',
+            'steps.*.estimated_duration_minutes' => 'nullable|integer|min:0',
+        ]);
+
+        $productTypeId = $request->session()->get('onboarding.product_type_id');
+
+        $template = ProcessTemplate::create([
+            'product_type_id' => $productTypeId,
+            'name' => $validated['name'],
+            'version' => 1,
+            'is_active' => true,
+        ]);
+
+        foreach ($validated['steps'] as $i => $stepData) {
+            TemplateStep::create([
+                'process_template_id' => $template->id,
+                'step_number' => $i + 1,
+                'name' => $stepData['name'],
+                'estimated_duration_minutes' => $stepData['estimated_duration_minutes'] ?? null,
+            ]);
+        }
+
+        $request->session()->put('onboarding.template_id', $template->id);
+
+        return redirect()->route('onboarding.step4');
+    }
+
+    public function step4(Request $request)
+    {
+        if (! $request->session()->has('onboarding.template_id')) {
+            return redirect()->route('onboarding.step1');
+        }
+
+        return view('onboarding.step4-work-order');
+    }
+
+    public function storeStep4(Request $request, WorkOrderService $workOrderService)
+    {
+        $validated = $request->validate([
+            'order_no' => 'required|string|max:100|unique:work_orders,order_no',
+            'planned_qty' => 'required|numeric|min:0.01',
+            'description' => 'nullable|string',
+        ]);
+
+        $workOrderService->createWorkOrder([
+            'order_no' => $validated['order_no'],
+            'line_id' => $request->session()->get('onboarding.line_id'),
+            'product_type_id' => $request->session()->get('onboarding.product_type_id'),
+            'planned_qty' => $validated['planned_qty'],
+            'description' => $validated['description'] ?? null,
+        ]);
+
+        return redirect()->route('onboarding.complete');
+    }
+
+    public function complete(Request $request)
+    {
+        $this->markCompleted();
+        $request->session()->forget('onboarding');
+
+        return view('onboarding.complete');
+    }
+
+    public function skip(Request $request)
+    {
+        $this->markCompleted();
+        $request->session()->forget('onboarding');
+
+        return redirect()->route('admin.dashboard')->with('success', 'Onboarding skipped. You can re-launch it from Settings.');
+    }
+
+    public static function shouldShowWizard(): bool
+    {
+        $completed = json_decode(
+            DB::table('system_settings')->where('key', 'onboarding_completed')->value('value') ?? 'true',
+            true
+        );
+
+        return ! $completed && Line::count() === 0;
+    }
+
+    private function isCompleted(): bool
+    {
+        return ! self::shouldShowWizard();
+    }
+
+    private function markCompleted(): void
+    {
+        DB::table('system_settings')
+            ->where('key', 'onboarding_completed')
+            ->update(['value' => json_encode(true)]);
+    }
+}

backend/config/version.php

@@ -1,5 +1,5 @@
 <?php
 
 return [
-    'current' => 'v0.7.0',
+    'current' => 'v0.8.0',
 ];

backend/database/migrations/2026_05_05_100001_add_onboarding_completed_setting.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        DB::table('system_settings')->insertOrIgnore([
+            'key' => 'onboarding_completed',
+            'value' => json_encode(false),
+            'description' => 'Whether the onboarding wizard has been completed',
+        ]);
+    }
+
+    public function down(): void
+    {
+        DB::table('system_settings')->where('key', 'onboarding_completed')->delete();
+    }
+};

backend/resources/views/layouts/app.blade.php

@@ -269,5 +269,28 @@ class="flex items-center justify-center gap-2 px-4 py-1.5 text-sm font-medium te
     });
 })();
 </script>
+@auth
+@if(auth()->user()->hasRole('Admin') && \App\Http\Controllers\Web\OnboardingController::shouldShowWizard())
+<div x-data="{ open: !sessionStorage.getItem('wizard_dismissed') }" x-show="open" x-cloak
+     class="fixed inset-0 z-[100] flex items-center justify-center p-4"
+     x-transition:enter="transition ease-out duration-200" x-transition:enter-start="opacity-0" x-transition:enter-end="opacity-100">
+    <div class="fixed inset-0 bg-black/50" @click="open = false; sessionStorage.setItem('wizard_dismissed','1')"></div>
+    <div class="relative bg-white dark:bg-slate-800 rounded-xl shadow-2xl max-w-md w-full p-8 text-center"
+         x-transition:enter="transition ease-out duration-200" x-transition:enter-start="opacity-0 scale-95" x-transition:enter-end="opacity-100 scale-100">
+        <div class="w-14 h-14 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center mx-auto mb-4">
+            <svg class="w-7 h-7 text-blue-600 dark:text-blue-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>
+            </svg>
+        </div>
+        <h3 class="text-xl font-bold text-gray-800 dark:text-white mb-2">Welcome to OpenMES!</h3>
+        <p class="text-gray-600 dark:text-gray-300 mb-6">Looks like this is a fresh installation. Would you like to run the setup wizard? It takes about 2 minutes.</p>
+        <div class="flex flex-col gap-3">
+            <a href="{{ route('onboarding.step1') }}" class="btn-touch btn-primary w-full">Start Setup Wizard</a>
+            <button @click="open = false; sessionStorage.setItem('wizard_dismissed','1')" class="btn-touch btn-secondary w-full">I'll do it later</button>
+        </div>
+    </div>
+</div>
+@endif
+@endauth
 </body>
 </html>

backend/resources/views/layouts/components/sidebar.blade.php

@@ -37,6 +37,17 @@ class="flex items-center gap-2.5 min-w-0 overflow-hidden">
                 <span class="block text-slate-400 text-[10px] leading-none truncate">{{ config('version.current', 'v0.1') }}</span>
             </span>
         </a>
+        @auth
+            @if(auth()->user()->hasRole('Admin'))
+                <a href="{{ route('onboarding.step1') }}" title="Setup Wizard"
+                   class="ml-auto shrink-0 p-1.5 rounded-md text-slate-400 hover:text-white hover:bg-slate-700 transition-colors hidden lg:block"
+                   x-show="!collapsed || mobileOpen" x-cloak>
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                </a>
+            @endif
+        @endauth
         {{-- Mobile close button --}}
         <button @click="mobileOpen = false"
                 class="lg:hidden ml-auto p-1.5 rounded-md text-slate-400 hover:text-white

backend/resources/views/onboarding/complete.blade.php

@@ -0,0 +1,18 @@
+@extends('onboarding.layout', ['step' => 5])
+
+@section('content')
+<div class="text-center py-8">
+    <div class="w-16 h-16 bg-green-100 rounded-full flex items-center justify-center mx-auto mb-4">
+        <svg class="w-8 h-8 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/>
+        </svg>
+    </div>
+    <h2 class="text-2xl font-bold text-gray-800 mb-2">Setup Complete!</h2>
+    <p class="text-gray-600 mb-6">Your production line, product type, process template, and first work order have been created.</p>
+
+    <div class="space-y-3">
+        <a href="{{ route('admin.dashboard') }}" class="btn-touch btn-primary block">Go to Dashboard</a>
+        <a href="{{ route('operator.select-line') }}" class="btn-touch btn-secondary block">Start as Operator</a>
+    </div>
+</div>
+@endsection

backend/resources/views/onboarding/layout.blade.php

@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>OpenMES — Setup Wizard</title>
+    @vite(['resources/css/app.css', 'resources/js/app.js'])
+</head>
+<body class="bg-gray-100 min-h-screen flex flex-col items-center justify-center p-4">
+    <div class="w-full max-w-2xl">
+        <!-- Logo -->
+        <div class="text-center mb-8">
+            <img src="/logo_open_mes.png" alt="OpenMES" class="h-10 mx-auto mb-2">
+            <p class="text-sm text-gray-500">Setup Wizard</p>
+        </div>
+
+        <!-- Stepper -->
+        <div class="flex items-center justify-center mb-8">
+            @php $currentStep = $step ?? 1; @endphp
+            @foreach(['Line', 'Product', 'Process', 'Work Order'] as $i => $label)
+                <div class="flex items-center">
+                    <div class="flex flex-col items-center">
+                        <div class="w-8 h-8 rounded-full flex items-center justify-center text-sm font-bold
+                            {{ $i + 1 < $currentStep ? 'bg-green-500 text-white' :
+                               ($i + 1 === $currentStep ? 'bg-blue-600 text-white' : 'bg-gray-300 text-gray-600') }}">
+                            @if($i + 1 < $currentStep)
+                                <svg class="w-4 h-4" fill="currentColor" viewBox="0 0 20 20"><path fill-rule="evenodd" d="M16.707 5.293a1 1 0 010 1.414l-8 8a1 1 0 01-1.414 0l-4-4a1 1 0 011.414-1.414L8 12.586l7.293-7.293a1 1 0 011.414 0z" clip-rule="evenodd"/></svg>
+                            @else
+                                {{ $i + 1 }}
+                            @endif
+                        </div>
+                        <span class="text-xs mt-1 {{ $i + 1 === $currentStep ? 'text-blue-600 font-medium' : 'text-gray-500' }}">{{ $label }}</span>
+                    </div>
+                    @if($i < 3)
+                        <div class="w-12 h-0.5 mx-1 {{ $i + 1 < $currentStep ? 'bg-green-500' : 'bg-gray-300' }}"></div>
+                    @endif
+                </div>
+            @endforeach
+        </div>
+
+        <!-- Content -->
+        <div class="bg-white rounded-xl shadow-lg p-8">
+            @yield('content')
+        </div>
+
+        <!-- Skip -->
+        <div class="text-center mt-4">
+            <form action="{{ route('onboarding.skip') }}" method="POST" class="inline">
+                @csrf
+                <button type="submit" class="text-sm text-gray-400 hover:text-gray-600">Skip wizard →</button>
+            </form>
+        </div>
+    </div>
+</body>
+</html>