chore: adds APC as L1 cache at cache middleware

[smarcet]

No description provided.

[Copilot]

Pull Request Overview

Introduce APCu-backed L1 cache to reduce Redis hits in the cache middleware and clear APC entries when cache regions are flushed.

• Add App\Utils\Cache\APC utility for APCu get/put and region tracking/clearing.
• Update CacheMiddleware to check APC first, then fall back to Redis; add X-Cache-Result distinctions.
• Update RedisCacheService to clear APC region keys on region flush.

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
app/Utils/Cache/APC.php	New APCu cache helper with region tracking and clearing.
app/Services/Utils/RedisCacheService.php	Flush APC region when clearing a Redis cache region.
app/Http/Middleware/CacheMiddleware.php	Introduce APC L1 lookup, Redis fallback, and response headers reflecting cache tier.

Comments suppressed due to low confidence (1)

app/Http/Middleware/CacheMiddleware.php:1

• When APC hits in the non-tagged branch, $data is never decoded because $data = $this->decode($encoded) is inside the if(!$wasAPCHit) block. This causes $data to remain null and the 'safe guard' below sets it to an empty array, returning an empty response. Move the decode outside the if(!$wasAPCHit) block (mirroring the tagged branch), e.g., place $data = $this->decode($encoded) after the closing brace so it runs for both APC and Redis paths.

<?php namespace App\Http\Middleware;

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

[nitpick] The hard-coded 10000 cap is a magic number. Consider extracting it to a class constant (e.g., MAX_KEYS_PER_REGION) or a config value so it can be tuned without code changes.