honeyDueAPI/internal/handlers/static_data_handler.go

package handlers

import (
	"net/http"
	"strings"

	"github.com/gin-gonic/gin"
	"github.com/redis/go-redis/v9"
	"github.com/rs/zerolog/log"

	"github.com/treytartt/casera-api/internal/dto/responses"
	"github.com/treytartt/casera-api/internal/i18n"
	"github.com/treytartt/casera-api/internal/services"
)

// SeededDataResponse represents the unified seeded data response
type SeededDataResponse struct {
	ResidenceTypes        interface{}                            `json:"residence_types"`
	TaskCategories        interface{}                            `json:"task_categories"`
	TaskPriorities        interface{}                            `json:"task_priorities"`
	TaskFrequencies       interface{}                            `json:"task_frequencies"`
	ContractorSpecialties interface{}                            `json:"contractor_specialties"`
	TaskTemplates         responses.TaskTemplatesGroupedResponse `json:"task_templates"`
}

// StaticDataHandler handles static/lookup data endpoints
type StaticDataHandler struct {
	residenceService    *services.ResidenceService
	taskService         *services.TaskService
	contractorService   *services.ContractorService
	taskTemplateService *services.TaskTemplateService
	cache               *services.CacheService
}

// NewStaticDataHandler creates a new static data handler
func NewStaticDataHandler(
	residenceService *services.ResidenceService,
	taskService *services.TaskService,
	contractorService *services.ContractorService,
	taskTemplateService *services.TaskTemplateService,
	cache *services.CacheService,
) *StaticDataHandler {
	return &StaticDataHandler{
		residenceService:    residenceService,
		taskService:         taskService,
		contractorService:   contractorService,
		taskTemplateService: taskTemplateService,
		cache:               cache,
	}
}

// GetStaticData handles GET /api/static_data/
// Returns all lookup/reference data in a single response with ETag support
func (h *StaticDataHandler) GetStaticData(c *gin.Context) {
	ctx := c.Request.Context()

	// Check If-None-Match header for conditional request
	// Strip W/ prefix if present (added by reverse proxy, but we store without it)
	clientETag := strings.TrimPrefix(c.GetHeader("If-None-Match"), "W/")

	// Try to get cached ETag first (fast path for 304 responses)
	if h.cache != nil && clientETag != "" {
		cachedETag, err := h.cache.GetSeededDataETag(ctx)
		if err == nil && cachedETag == clientETag {
			// Client has the latest data, return 304 Not Modified
			c.Status(http.StatusNotModified)
			return
		}
	}

	// Try to get cached seeded data
	if h.cache != nil {
		var cachedData SeededDataResponse
		err := h.cache.GetCachedSeededData(ctx, &cachedData)
		if err == nil {
			// Cache hit - get the ETag and return data
			etag, etagErr := h.cache.GetSeededDataETag(ctx)
			if etagErr == nil {
				c.Header("ETag", etag)
				c.Header("Cache-Control", "private, max-age=3600")
			}
			c.JSON(http.StatusOK, cachedData)
			return
		} else if err != redis.Nil {
			// Log cache error but continue to fetch from DB
			log.Warn().Err(err).Msg("Failed to get cached seeded data")
		}
	}

	// Cache miss - fetch all data from services
	residenceTypes, err := h.residenceService.GetResidenceTypes()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_residence_types")})
		return
	}

	taskCategories, err := h.taskService.GetCategories()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_task_categories")})
		return
	}

	taskPriorities, err := h.taskService.GetPriorities()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_task_priorities")})
		return
	}

	taskFrequencies, err := h.taskService.GetFrequencies()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_task_frequencies")})
		return
	}

	contractorSpecialties, err := h.contractorService.GetSpecialties()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_contractor_specialties")})
		return
	}

	taskTemplates, err := h.taskTemplateService.GetGrouped()
	if err != nil {
		c.JSON(http.StatusInternalServerError, gin.H{"error": i18n.LocalizedMessage(c, "error.failed_to_fetch_task_templates")})
		return
	}

	// Build response
	seededData := SeededDataResponse{
		ResidenceTypes:        residenceTypes,
		TaskCategories:        taskCategories,
		TaskPriorities:        taskPriorities,
		TaskFrequencies:       taskFrequencies,
		ContractorSpecialties: contractorSpecialties,
		TaskTemplates:         taskTemplates,
	}

	// Cache the data and get ETag
	if h.cache != nil {
		etag, cacheErr := h.cache.CacheSeededData(ctx, seededData)
		if cacheErr != nil {
			log.Warn().Err(cacheErr).Msg("Failed to cache seeded data")
		} else {
			c.Header("ETag", etag)
			c.Header("Cache-Control", "private, max-age=3600")
		}
	}

	c.JSON(http.StatusOK, seededData)
}

// RefreshStaticData handles POST /api/static_data/refresh/
// This is a no-op since data is fetched fresh each time
// Kept for API compatibility with mobile clients
func (h *StaticDataHandler) RefreshStaticData(c *gin.Context) {
	c.JSON(http.StatusOK, gin.H{
		"message": i18n.LocalizedMessage(c, "message.static_data_refreshed"),
		"status":  "success",
	})
}