Initial commit: MyCrib API in Go

Complete rewrite of Django REST API to Go with:
- Gin web framework for HTTP routing
- GORM for database operations
- GoAdmin for admin panel
- Gorush integration for push notifications
- Redis for caching and job queues

Features implemented:
- User authentication (login, register, logout, password reset)
- Residence management (CRUD, sharing, share codes)
- Task management (CRUD, kanban board, completions)
- Contractor management (CRUD, specialties)
- Document management (CRUD, warranties)
- Notifications (preferences, push notifications)
- Subscription management (tiers, limits)

Infrastructure:
- Docker Compose for local development
- Database migrations and seed data
- Admin panel for data management

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

internal/handlers/subscription_handler.go

@@ -0,0 +1,176 @@
+package handlers
+
+import (
+	"errors"
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+
+	"github.com/treytartt/mycrib-api/internal/middleware"
+	"github.com/treytartt/mycrib-api/internal/models"
+	"github.com/treytartt/mycrib-api/internal/services"
+)
+
+// SubscriptionHandler handles subscription-related HTTP requests
+type SubscriptionHandler struct {
+	subscriptionService *services.SubscriptionService
+}
+
+// NewSubscriptionHandler creates a new subscription handler
+func NewSubscriptionHandler(subscriptionService *services.SubscriptionService) *SubscriptionHandler {
+	return &SubscriptionHandler{subscriptionService: subscriptionService}
+}
+
+// GetSubscription handles GET /api/subscription/
+func (h *SubscriptionHandler) GetSubscription(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	subscription, err := h.subscriptionService.GetSubscription(user.ID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, subscription)
+}
+
+// GetSubscriptionStatus handles GET /api/subscription/status/
+func (h *SubscriptionHandler) GetSubscriptionStatus(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	status, err := h.subscriptionService.GetSubscriptionStatus(user.ID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, status)
+}
+
+// GetUpgradeTrigger handles GET /api/subscription/upgrade-trigger/:key/
+func (h *SubscriptionHandler) GetUpgradeTrigger(c *gin.Context) {
+	key := c.Param("key")
+
+	trigger, err := h.subscriptionService.GetUpgradeTrigger(key)
+	if err != nil {
+		if errors.Is(err, services.ErrUpgradeTriggerNotFound) {
+			c.JSON(http.StatusNotFound, gin.H{"error": err.Error()})
+			return
+		}
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, trigger)
+}
+
+// GetFeatureBenefits handles GET /api/subscription/features/
+func (h *SubscriptionHandler) GetFeatureBenefits(c *gin.Context) {
+	benefits, err := h.subscriptionService.GetFeatureBenefits()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, benefits)
+}
+
+// GetPromotions handles GET /api/subscription/promotions/
+func (h *SubscriptionHandler) GetPromotions(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	promotions, err := h.subscriptionService.GetActivePromotions(user.ID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, promotions)
+}
+
+// ProcessPurchase handles POST /api/subscription/purchase/
+func (h *SubscriptionHandler) ProcessPurchase(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	var req services.ProcessPurchaseRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	var subscription *services.SubscriptionResponse
+	var err error
+
+	switch req.Platform {
+	case "ios":
+		if req.ReceiptData == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "receipt_data is required for iOS"})
+			return
+		}
+		subscription, err = h.subscriptionService.ProcessApplePurchase(user.ID, req.ReceiptData)
+	case "android":
+		if req.PurchaseToken == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "purchase_token is required for Android"})
+			return
+		}
+		subscription, err = h.subscriptionService.ProcessGooglePurchase(user.ID, req.PurchaseToken)
+	}
+
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"message":      "Subscription upgraded successfully",
+		"subscription": subscription,
+	})
+}
+
+// CancelSubscription handles POST /api/subscription/cancel/
+func (h *SubscriptionHandler) CancelSubscription(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	subscription, err := h.subscriptionService.CancelSubscription(user.ID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"message":      "Subscription cancelled. You will retain Pro benefits until the end of your billing period.",
+		"subscription": subscription,
+	})
+}
+
+// RestoreSubscription handles POST /api/subscription/restore/
+func (h *SubscriptionHandler) RestoreSubscription(c *gin.Context) {
+	user := c.MustGet(middleware.AuthUserKey).(*models.User)
+
+	var req services.ProcessPurchaseRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	// Same logic as ProcessPurchase - validates receipt/token and restores
+	var subscription *services.SubscriptionResponse
+	var err error
+
+	switch req.Platform {
+	case "ios":
+		subscription, err = h.subscriptionService.ProcessApplePurchase(user.ID, req.ReceiptData)
+	case "android":
+		subscription, err = h.subscriptionService.ProcessGooglePurchase(user.ID, req.PurchaseToken)
+	}
+
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"message":      "Subscription restored successfully",
+		"subscription": subscription,
+	})
+}