first commit

app/Models/Team.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Models;
+
+use App\Concerns\GeneratesUniqueTeamSlugs;
+use App\Enums\TeamRole;
+use Database\Factories\TeamFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+#[Fillable(['name', 'slug', 'is_personal'])]
+class Team extends Model
+{
+    /** @use HasFactory<TeamFactory> */
+    use GeneratesUniqueTeamSlugs, HasFactory, SoftDeletes;
+
+    /**
+     * Bootstrap the model and its traits.
+     */
+    protected static function boot(): void
+    {
+        parent::boot();
+
+        static::creating(function (Team $team) {
+            if (empty($team->slug)) {
+                $team->slug = static::generateUniqueTeamSlug($team->name);
+            }
+        });
+
+        static::updating(function (Team $team) {
+            if ($team->isDirty('name')) {
+                $team->slug = static::generateUniqueTeamSlug($team->name, $team->id);
+            }
+        });
+    }
+
+    /**
+     * Get the team owner.
+     */
+    public function owner(): ?Model
+    {
+        return $this->members()
+            ->wherePivot('role', TeamRole::Owner->value)
+            ->first();
+    }
+
+    /**
+     * Get all members of this team.
+     *
+     * @return BelongsToMany<Model, $this>
+     */
+    public function members(): BelongsToMany
+    {
+        return $this->belongsToMany(User::class, 'team_members', 'team_id', 'user_id')
+            ->using(Membership::class)
+            ->withPivot(['role'])
+            ->withTimestamps();
+    }
+
+    /**
+     * Get all memberships for this team.
+     *
+     * @return HasMany<Membership, $this>
+     */
+    public function memberships(): HasMany
+    {
+        return $this->hasMany(Membership::class);
+    }
+
+    /**
+     * Get all invitations for this team.
+     *
+     * @return HasMany<TeamInvitation, $this>
+     */
+    public function invitations(): HasMany
+    {
+        return $this->hasMany(TeamInvitation::class);
+    }
+
+    /**
+     * Get all report periods for this team.
+     *
+     * @return HasMany<ReportPeriod, $this>
+     */
+    public function reportPeriods(): HasMany
+    {
+        return $this->hasMany(ReportPeriod::class);
+    }
+
+    /**
+     * Get the attributes that should be cast.
+     *
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'is_personal' => 'boolean',
+        ];
+    }
+
+    /**
+     * Get the route key for the model.
+     */
+    public function getRouteKeyName(): string
+    {
+        return 'slug';
+    }
+}