fix(capacity): stabilize PTO flows and calendar consistency

Make PTO creation immediately approved, add PTO deletion, and ensure cache invalidation updates individual/team/revenue capacity consistently.

Harden holiday duplicate handling (422), support PTO-day availability overrides without disabling edits, and align tests plus OpenSpec artifacts with the new behavior.

backend/app/Services/TeamMemberService.php

@@ -3,9 +3,13 @@
 namespace App\Services;
 
 use App\Models\TeamMember;
+use Closure;
+use DateTimeInterface;
 use Illuminate\Database\Eloquent\Collection;
-use Illuminate\Validation\ValidationException;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\ValidationException;
+use Throwable;
 
 /**
  * Team Member Service
@@ -14,28 +18,36 @@ use Illuminate\Support\Facades\Validator;
  */
 class TeamMemberService
 {
+    private ?bool $redisAvailable = null;
+
     /**
      * Get all team members with optional filtering.
      *
-     * @param bool|null $active Filter by active status
+     * @param  bool|null  $active  Filter by active status
      * @return Collection<TeamMember>
      */
     public function getAll(?bool $active = null): Collection
     {
-        $query = TeamMember::with('role');
+        /** @var Collection<TeamMember> $teamMembers */
+        $teamMembers = $this->rememberTeamMembers(
+            $this->buildTeamMembersCacheKey($active),
+            now()->addHour(),
+            function () use ($active): Collection {
+                $query = TeamMember::with('role');
 
-        if ($active !== null) {
-            $query->where('active', $active);
-        }
+                if ($active !== null) {
+                    $query->where('active', $active);
+                }
 
-        return $query->get();
+                return $query->get();
+            }
+        );
+
+        return $teamMembers;
     }
 
     /**
      * Find a team member by ID.
-     *
-     * @param string $id
-     * @return TeamMember|null
      */
     public function findById(string $id): ?TeamMember
     {
@@ -45,8 +57,6 @@ class TeamMemberService
     /**
      * Create a new team member.
      *
-     * @param array $data
-     * @return TeamMember
      * @throws ValidationException
      */
     public function create(array $data): TeamMember
@@ -72,6 +82,7 @@ class TeamMemberService
         ]);
 
         $teamMember->load('role');
+        $this->forgetTeamMembersCache();
 
         return $teamMember;
     }
@@ -79,9 +90,6 @@ class TeamMemberService
     /**
      * Update an existing team member.
      *
-     * @param TeamMember $teamMember
-     * @param array $data
-     * @return TeamMember
      * @throws ValidationException
      */
     public function update(TeamMember $teamMember, array $data): TeamMember
@@ -101,6 +109,7 @@ class TeamMemberService
 
         $teamMember->update($data);
         $teamMember->load('role');
+        $this->forgetTeamMembersCache();
 
         return $teamMember;
     }
@@ -108,8 +117,6 @@ class TeamMemberService
     /**
      * Delete a team member.
      *
-     * @param TeamMember $teamMember
-     * @return void
      * @throws \RuntimeException
      */
     public function delete(TeamMember $teamMember): void
@@ -131,12 +138,12 @@ class TeamMemberService
         }
 
         $teamMember->delete();
+        $this->forgetTeamMembersCache();
     }
 
     /**
      * Check if a team member can be deleted.
      *
-     * @param TeamMember $teamMember
      * @return array{canDelete: bool, reason?: string}
      */
     public function canDelete(TeamMember $teamMember): array
@@ -157,4 +164,77 @@ class TeamMemberService
 
         return ['canDelete' => true];
     }
+
+    private function buildTeamMembersCacheKey(?bool $active): string
+    {
+        if ($active === null) {
+            return 'team-members:all';
+        }
+
+        return $active ? 'team-members:active' : 'team-members:inactive';
+    }
+
+    /**
+     * @param  Closure(): Collection<TeamMember>  $callback
+     * @return Collection<TeamMember>
+     */
+    private function rememberTeamMembers(string $key, DateTimeInterface|int $ttl, Closure $callback): Collection
+    {
+        if (! $this->redisAvailable()) {
+            /** @var Collection<TeamMember> $payload */
+            $payload = Cache::store('array')->remember($key, $ttl, $callback);
+
+            return $payload;
+        }
+
+        try {
+            /** @var Collection<TeamMember> $payload */
+            $payload = Cache::store('redis')->remember($key, $ttl, $callback);
+
+            return $payload;
+        } catch (Throwable) {
+            /** @var Collection<TeamMember> $payload */
+            $payload = Cache::store('array')->remember($key, $ttl, $callback);
+
+            return $payload;
+        }
+    }
+
+    private function forgetTeamMembersCache(): void
+    {
+        Cache::store('array')->forget($this->buildTeamMembersCacheKey(null));
+        Cache::store('array')->forget($this->buildTeamMembersCacheKey(true));
+        Cache::store('array')->forget($this->buildTeamMembersCacheKey(false));
+
+        if (! $this->redisAvailable()) {
+            return;
+        }
+
+        try {
+            Cache::store('redis')->forget($this->buildTeamMembersCacheKey(null));
+            Cache::store('redis')->forget($this->buildTeamMembersCacheKey(true));
+            Cache::store('redis')->forget($this->buildTeamMembersCacheKey(false));
+        } catch (Throwable) {
+            // Ignore cache failures when Redis is unavailable.
+        }
+    }
+
+    private function redisAvailable(): bool
+    {
+        if ($this->redisAvailable !== null) {
+            return $this->redisAvailable;
+        }
+
+        if (! config('cache.stores.redis')) {
+            return $this->redisAvailable = false;
+        }
+
+        $client = config('database.redis.client', 'phpredis');
+
+        if ($client === 'predis') {
+            return $this->redisAvailable = class_exists('Predis\\Client');
+        }
+
+        return $this->redisAvailable = extension_loaded('redis');
+    }
 }