Task 2.2: Real-Time Availability Updates

[scrollinondubs]

Description

Implement real-time updates for service availability using TanStack Query and Next.js Server Actions.

Epic

Part of Epic 2: Service Information Display (#15)

Technical Details

• Files: /app/api/availability/route.ts, /lib/hooks/useAvailability.ts
• Framework: Next.js API Routes with TanStack Query
• Real-time Strategy: Polling with TanStack Query or Server-Sent Events
• Database: DrizzleORM for availability queries
• Optimization: Caching and optimistic updates

Acceptance Criteria

• Reflect real-time changes in service availability
• Ensure no lag in data refresh (< 2 second latency)
• Handle concurrent availability checks efficiently
• Implement proper caching strategy
• WebSocket/SSE support for real-time updates (optional)

Dependencies

• Depends on: Epic 4: Technical Foundation (#TBD) - Models before services
• Required by: Task 1.1: Implement Booking Request API (Task 1.1: Implement Booking Request API #13) - Database before API
• Required by: Task 1.2: Calendar Sync Feature (Task 1.2: Calendar Sync Feature #14) - Setup before features
• Required by: Task 3.2: Notification System for Staff (#TBD) - Database before API

Estimated Effort

20 hours

Priority

P1

Git Worktree

This is a foundational task that enables other API features. Should be completed early.