feat: person tags system - org-level skills with self-reported and organiser-assigned sources

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

api/app/Models/PersonTag.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Concerns\HasUlids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class PersonTag extends Model
+{
+    use HasFactory;
+    use HasUlids;
+
+    protected $fillable = [
+        'name',
+        'category',
+        'icon',
+        'color',
+        'is_active',
+        'sort_order',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'is_active' => 'boolean',
+            'sort_order' => 'integer',
+        ];
+    }
+
+    public function organisation(): BelongsTo
+    {
+        return $this->belongsTo(Organisation::class);
+    }
+
+    public function scopeActive(Builder $query): Builder
+    {
+        return $query->where('is_active', true);
+    }
+
+    public function scopeOrdered(Builder $query): Builder
+    {
+        return $query->orderBy('sort_order')->orderBy('name');
+    }
+}

api/app/Models/User.php

@@ -63,4 +63,14 @@ final class User extends Authenticatable
     {
         return $this->hasMany(UserInvitation::class, 'invited_by_user_id');
     }
+
+    public function organisationTags(): HasMany
+    {
+        return $this->hasMany(UserOrganisationTag::class);
+    }
+
+    public function tagsForOrganisation(string $organisationId): HasMany
+    {
+        return $this->organisationTags()->where('organisation_id', $organisationId);
+    }
 }

api/app/Models/UserOrganisationTag.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class UserOrganisationTag extends Model
+{
+    use HasFactory;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'user_id',
+        'organisation_id',
+        'person_tag_id',
+        'source',
+        'assigned_by_user_id',
+        'proficiency',
+        'notes',
+        'assigned_at',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'assigned_at' => 'datetime',
+        ];
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function organisation(): BelongsTo
+    {
+        return $this->belongsTo(Organisation::class);
+    }
+
+    public function personTag(): BelongsTo
+    {
+        return $this->belongsTo(PersonTag::class);
+    }
+
+    public function assignedBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'assigned_by_user_id');
+    }
+}