// HandleStream manages Server-Sent Events (SSE) connections for real-time plate detection updates
// This allows the dashboard to receive instant notifications when a new plate is detected
// without polling or WebSocket overhead
func (h *StreamHandler) HandleStream(c *gin.Context) {
  // Configure response headers for SSE protocol
  c.Writer.Header().Set("Content-Type", "text/event-stream")  // Tell browser this is an event stream
  c.Writer.Header().Set("Cache-Control", "no-cache")          // Prevent caching of events
  c.Writer.Header().Set("Connection", "keep-alive")           // Maintain persistent connection
  
  // Stream creates a long-lived HTTP connection that pushes events to the client
  c.Stream(func(w io.Writer) bool {
    // Listen for new plate detections on the client-specific channel
    if msg, ok := <-clientChan; ok {
      // Send the plate detection data (format: "plate|uuid")
      // The uuid can be used to fetch the full plate image and metadata
      c.SSEvent("message", msg)
      return true  // Keep connection alive for more events
    }
    return false  // Close connection if channel is closed
  })
}