Develop

.gitignore

@@ -37,6 +37,9 @@ Thumbs.db
 *.pdf
 !docs/*.pdf
 
+# Exclude markdown documentation files in backend/docs
+backend/docs/*.md
+
 # Backup files
 *.backup
 *.bak

SmartStockManagement.postman_environment.json

@@ -19,6 +19,25 @@
 			"value": "",
 			"type": "default",
 			"enabled": true
+		},
+		{
+			"key": "company_id",
+			"value": "",
+			"type": "default",
+			"enabled": true
+		},
+		{
+			"key": "is_platform_admin",
+			"value": "false",
+			"type": "default",
+			"enabled": true
+		},
+		{
+			"key": "invitation_token",
+			"value": "",
+			"type": "secret",
+			"enabled": true,
+			"description": "Invitation token from email. Used for testing accept invitation endpoints."
 		}
 	],
 	"_postman_variable_scope": "environment"

backend/app/Console/Commands/SeedDatabaseCommand.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Artisan;
+
+class SeedDatabaseCommand extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'db:seed-fresh
+                            {--demo : Include demo/sample data}
+                            {--minimal : Run in minimal mode (default)}
+                            {--force : Force the operation when in production}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Drop all tables and re-run all migrations with optional demo data';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): int
+    {
+        $mode = $this->option('demo') ? 'demo' : 'minimal';
+
+        $this->components->info("Running database fresh with seeding in {$mode} mode...");
+
+        // Set the environment variable for seeder mode
+        putenv("SEED_MODE={$mode}");
+        $_ENV['SEED_MODE'] = $mode;
+
+        // Build migrate:fresh command options
+        $options = ['--seed' => true];
+
+        if ($this->option('force')) {
+            $options['--force'] = true;
+        }
+
+        // Run migrate:fresh with seed
+        $exitCode = Artisan::call('migrate:fresh', $options, $this->output);
+
+        if ($exitCode === 0) {
+            $this->newLine();
+            $this->components->info('Database seeded successfully!');
+
+            if ($mode === 'minimal') {
+                $this->components->info('Minimal mode: Only system essentials were seeded.');
+                $this->components->info('To include demo data, use: php artisan db:seed-fresh --demo');
+            } else {
+                $this->components->info('Demo mode: All sample data has been seeded.');
+            }
+        }
+
+        return $exitCode;
+    }
+}

backend/app/Enums/BomStatus.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Enums;
+
+/**
+ * BOM Status Enum
+ *
+ * Manages BOM lifecycle states.
+ */
+enum BomStatus: string
+{
+    case DRAFT = 'draft';
+    case ACTIVE = 'active';
+    case OBSOLETE = 'obsolete';
+
+    /**
+     * Get human-readable label
+     */
+    public function label(): string
+    {
+        return match ($this) {
+            self::DRAFT => 'Draft',
+            self::ACTIVE => 'Active',
+            self::OBSOLETE => 'Obsolete',
+        };
+    }
+
+    /**
+     * Get allowed status transitions
+     */
+    public function allowedTransitions(): array
+    {
+        return match ($this) {
+            self::DRAFT => [self::ACTIVE],
+            self::ACTIVE => [self::OBSOLETE, self::DRAFT],
+            self::OBSOLETE => [self::DRAFT], // Can reactivate by going back to draft
+        };
+    }
+
+    /**
+     * Check if transition to target status is allowed
+     */
+    public function canTransitionTo(self $target): bool
+    {
+        return in_array($target, $this->allowedTransitions());
+    }
+
+    /**
+     * Check if BOM can be edited
+     */
+    public function canEdit(): bool
+    {
+        return $this === self::DRAFT;
+    }
+
+    /**
+     * Check if BOM can be used for production
+     */
+    public function canUseForProduction(): bool
+    {
+        return $this === self::ACTIVE;
+    }
+
+    /**
+     * Get all values as array
+     */
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+
+    /**
+     * Get all as options for dropdown
+     */
+    public static function options(): array
+    {
+        return array_map(
+            fn(self $case) => ['value' => $case->value, 'label' => $case->label()],
+            self::cases()
+        );
+    }
+}

backend/app/Enums/BomType.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Enums;
+
+/**
+ * BOM Type Enum
+ *
+ * Defines types of Bill of Materials.
+ */
+enum BomType: string
+{
+    case MANUFACTURING = 'manufacturing';
+    case ENGINEERING = 'engineering';
+    case PHANTOM = 'phantom';
+
+    /**
+     * Get human-readable label
+     */
+    public function label(): string
+    {
+        return match ($this) {
+            self::MANUFACTURING => 'Manufacturing',
+            self::ENGINEERING => 'Engineering',
+            self::PHANTOM => 'Phantom',
+        };
+    }
+
+    /**
+     * Get description
+     */
+    public function description(): string
+    {
+        return match ($this) {
+            self::MANUFACTURING => 'Standard production BOM used for manufacturing',
+            self::ENGINEERING => 'Engineering BOM for design/development purposes',
+            self::PHANTOM => 'Phantom BOM - components pass through to parent',
+        };
+    }
+
+    /**
+     * Check if BOM is used for production
+     */
+    public function isProduction(): bool
+    {
+        return $this === self::MANUFACTURING;
+    }
+
+    /**
+     * Get all values as array
+     */
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+
+    /**
+     * Get all as options for dropdown
+     */
+    public static function options(): array
+    {
+        return array_map(
+            fn(self $case) => ['value' => $case->value, 'label' => $case->label()],
+            self::cases()
+        );
+    }
+}

backend/app/Enums/CalendarDayType.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Enums;
+
+/**
+ * Calendar Day Type Enum (for CRP)
+ */
+enum CalendarDayType: string
+{
+    case WORKING = 'working';
+    case HOLIDAY = 'holiday';
+    case MAINTENANCE = 'maintenance';
+    case SHUTDOWN = 'shutdown';
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::WORKING => 'Working Day',
+            self::HOLIDAY => 'Holiday',
+            self::MAINTENANCE => 'Maintenance',
+            self::SHUTDOWN => 'Shutdown',
+        };
+    }
+
+    public function color(): string
+    {
+        return match ($this) {
+            self::WORKING => 'green',
+            self::HOLIDAY => 'blue',
+            self::MAINTENANCE => 'orange',
+            self::SHUTDOWN => 'red',
+        };
+    }
+
+    public function isAvailable(): bool
+    {
+        return $this === self::WORKING;
+    }
+
+    public static function values(): array
+    {
+        return array_column(self::cases(), 'value');
+    }
+
+    public static function options(): array
+    {
+        return array_map(
+            fn(self $case) => ['value' => $case->value, 'label' => $case->label()],
+            self::cases()
+        );
+    }
+}