Merge pull request #164 from Mes-Open/release/v0.16.0

Release v0.16.0

Author: jakub-przepiora

CHANGELOG.md

@@ -0,0 +1,4 @@
+; file: deps (@openmes/ui) must be symlinked, not copied, so the Vite
+; watcher sees live edits in packages/ui. npm 9.0–9.3 briefly flipped
+; this default — pin it explicitly.
+install-links=false

backend/.npmrc

@@ -42,6 +42,10 @@ WORKDIR /var/www/html
 # Copy application files
 COPY backend/ .
 COPY modules/ ./modules/
+# Workspace UI package — backend/package.json depends on it via `file:../packages/ui`,
+# which resolves to /var/www/packages/ui relative to this WORKDIR. Must be present
+# before `npm ci` or the `@openmes/ui` import fails to resolve during `npm run build`.
+COPY packages/ /var/www/packages/
 
 # Install PHP dependencies
 RUN composer install --no-dev --optimize-autoloader --no-interaction
@@ -54,8 +58,8 @@ RUN ./vendor/bin/rr get-binary --location /var/www/html \
 # Install Node dependencies and build assets
 RUN npm ci && npm run build
 
-# Clean up node_modules to reduce image size
-RUN rm -rf node_modules
+# Clean up node_modules + the build-only workspace sources to reduce image size
+RUN rm -rf node_modules /var/www/packages
 
 # Copy entrypoint script
 COPY backend/docker-entrypoint.sh /usr/local/bin/

backend/Dockerfile

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Services\Quality\QualityTriggerService;
+use Illuminate\Console\Command;
+
+/**
+ * Fires time-based quality-control triggers (every_n_minutes). Scheduled every
+ * minute in routes/console.php; the service decides which in-progress batches
+ * are due. Other trigger types fire synchronously from the production
+ * lifecycle, so they don't need the scheduler.
+ */
+class FireDueQualityTriggersCommand extends Command
+{
+    protected $signature = 'quality:fire-due-triggers';
+
+    protected $description = 'Create quality-control tasks for due time-based triggers';
+
+    public function handle(QualityTriggerService $service): int
+    {
+        $created = $service->fireDueTimeTriggers();
+
+        $this->info("Quality-control triggers fired: {$created} task(s) created.");
+
+        return self::SUCCESS;
+    }
+}

backend/app/Console/Commands/FireDueQualityTriggersCommand.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\IssueAction;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Flags overdue corrective/preventive/containment actions (#11) — outstanding
+ * (open/in_progress) actions whose due date has passed. Logs a warning per
+ * overdue action (picked up by the security/ops log) and reports to the
+ * console. Naturally idempotent: each run reports the current overdue set.
+ *
+ * Registered in the scheduler (routes/console.php) to run daily.
+ */
+class NotifyOverdueActions extends Command
+{
+    protected $signature = 'quality:notify-overdue-actions';
+
+    protected $description = 'Flag overdue corrective/preventive actions on issues';
+
+    public function handle(): int
+    {
+        $actions = IssueAction::overdue()
+            ->with(['issue:id,title', 'assignedTo:id,name'])
+            ->orderBy('due_date')
+            ->get();
+
+        if ($actions->isEmpty()) {
+            $this->info('No overdue actions.');
+
+            return self::SUCCESS;
+        }
+
+        $rows = [];
+        foreach ($actions as $action) {
+            Log::warning('Issue action overdue', [
+                'issue_action_id' => $action->id,
+                'issue_id' => $action->issue_id,
+                'due_date' => $action->due_date?->toDateString(),
+                'assigned_to_id' => $action->assigned_to_id,
+            ]);
+
+            $rows[] = [
+                $action->id,
+                $action->issue?->title ?? "#{$action->issue_id}",
+                $action->title,
+                $action->due_date?->toDateString(),
+                $action->assignedTo?->name ?? '—',
+            ];
+        }
+
+        $this->table(['Action', 'Issue', 'Title', 'Due', 'Assignee'], $rows);
+        $this->warn($actions->count().' overdue action(s).');
+
+        return self::SUCCESS;
+    }
+}

backend/app/Console/Commands/NotifyOverdueActions.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Database\Seeders\OeeAndDowntimeDemoSeeder;
+use Illuminate\Console\Command;
+
+/**
+ * Keeps a long-running demo's OEE report alive. The OEE page recomputes
+ * today/yesterday from real DONE production, so once the demo's seeded
+ * "today" ages, OEE decays into N/A. This re-runs the (fully idempotent)
+ * demo seeder, which rolls production + OEE forward to the current day.
+ *
+ * Guarded by config('openmmes.demo_mode') so it never touches a real install.
+ */
+class RefreshDemoOeeCommand extends Command
+{
+    protected $signature = 'demo:refresh-oee
+                            {--force : Run even when demo mode is disabled}';
+
+    protected $description = 'Roll demo OEE/production data forward to today so the report never shows N/A';
+
+    public function handle(): int
+    {
+        if (! config('openmmes.demo_mode') && ! $this->option('force')) {
+            $this->warn('Demo mode is off (openmmes.demo_mode) — skipping. Pass --force to run anyway.');
+
+            return self::SUCCESS;
+        }
+
+        $this->info('Refreshing demo OEE/production data for today…');
+
+        // The seeder is idempotent — updateOrCreate for OEE/downtime rows and a
+        // skip for lines that already have DONE batches today — so a daily run
+        // only rolls today/yesterday forward and never duplicates history.
+        $this->callSilent('db:seed', [
+            '--class' => OeeAndDowntimeDemoSeeder::class,
+            '--force' => true,
+        ]);
+
+        $this->info('Demo OEE refreshed.');
+
+        return self::SUCCESS;
+    }
+}

backend/app/Console/Commands/RefreshDemoOeeCommand.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Enums;
+
+/**
+ * Disposition decision for a non-conforming issue (#11): what happens to the
+ * affected material. `Pending` is the default until quality decides.
+ */
+enum IssueDisposition: string
+{
+    case Pending = 'pending';
+    case Scrap = 'scrap';
+    case Rework = 'rework';
+    case ReturnToSupplier = 'return_to_supplier';
+    case UseAsIs = 'use_as_is';
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::Pending => __('Pending'),
+            self::Scrap => __('Scrap'),
+            self::Rework => __('Rework'),
+            self::ReturnToSupplier => __('Return to supplier'),
+            self::UseAsIs => __('Use as is'),
+        };
+    }
+
+    /** @return list<string> */
+    public static function values(): array
+    {
+        return array_map(fn (self $c) => $c->value, self::cases());
+    }
+}