feat: implement Redis caching for property operations

[sbafsk]

🚀 Redis Caching Implementation

This PR implements a comprehensive Redis caching layer for property operations to improve performance and reduce database load.

✨ Features Added

1. Redis Infrastructure (lib/redis.ts)

• Redis Client Configuration: Connection pooling, error handling, and retry logic
• CacheManager Class: Centralized cache operations (get/set/delete) with JSON serialization
• Cache Key Generators: Structured key generation for different data types
• TTL Management: Configurable time-to-live constants for different cache types
• Cache Decorator: Method-level caching with automatic key generation
• Health Monitoring: Connection status and cache statistics

2. Cached Property Repository (lib/repositories/cached-property-repository.ts)

• Cached CRUD Operations: All property operations now use Redis caching
• Smart Cache Invalidation: Automatic cache invalidation on data mutations
• Search Caching: Full-text search results are cached for improved performance
• Agency Queries: Agency-specific property queries with dedicated caching
• Cache Key Strategy: Hierarchical cache keys for efficient invalidation

3. Performance Benefits

• Reduced Database Load: Frequently accessed data served from Redis
• Faster Response Times: Sub-millisecond cache retrieval vs database queries
• Scalable Architecture: Redis can handle high concurrent read operations
• Intelligent TTL: Different cache durations based on data volatility

🔧 Technical Details

Cache Strategy

• Property Details: 5 minutes TTL
• Property Lists: 3 minutes TTL
• Search Results: 1 minute TTL
• Agency Data: 10 minutes TTL

Cache Invalidation

• Write Operations: Automatic cache invalidation on create/update/delete
• Pattern-based Cleanup: Bulk invalidation using Redis pattern matching
• Consistency Guarantees: Cache is always invalidated before database writes

🧪 Testing

• All existing tests pass
• New caching layer is transparent to existing code
• Graceful fallback to database if Redis is unavailable

📝 Documentation

• Updated configuration documentation
• Added inline code documentation
• Cache key patterns documented

🎯 Impact

• Performance: Significant reduction in database query load
• Scalability: Better handling of concurrent property requests
• User Experience: Faster page loads and search results
• Cost Efficiency: Reduced database resource usage

---

Ready for Review ✅
All commits are atomic and focused on specific functionality. The implementation follows best practices for cache invalidation and error handling.

[vercel]

Deployment failed with the following error:

Environment Variable "NEXT_PUBLIC_SUPABASE_URL" references Secret "next_public_supabase_url", which does not exist.

Learn More: https://vercel.com/docs/environment-variables