Add PDF reports, file uploads, admin auth, and comprehensive tests

Features:
- PDF service for generating task reports with ReportLab-style formatting
- Storage service for file uploads (local and S3-compatible)
- Admin authentication middleware with JWT support
- Admin user model and repository

Infrastructure:
- Updated Docker configuration for admin panel builds
- Email service enhancements for task notifications
- Updated router with admin and file upload routes
- Environment configuration updates

Tests:
- Unit tests for handlers (auth, residence, task)
- Unit tests for models (user, residence, task)
- Unit tests for repositories (user, residence, task)
- Unit tests for services (residence, task)
- Integration test setup
- Test utilities for mocking database and services

Database:
- Admin user seed data
- Updated test data seeds

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

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

internal/handlers/document_handler.go

@@ -2,10 +2,14 @@ package handlers
 
 import (
 	"errors"
+	"mime/multipart"
 	"net/http"
 	"strconv"
+	"strings"
+	"time"
 
 	"github.com/gin-gonic/gin"
+	"github.com/shopspring/decimal"
 
 	"github.com/treytartt/mycrib-api/internal/dto/requests"
 	"github.com/treytartt/mycrib-api/internal/middleware"
@@ -16,11 +20,15 @@ import (
 // DocumentHandler handles document-related HTTP requests
 type DocumentHandler struct {
 	documentService *services.DocumentService
+	storageService  *services.StorageService
 }
 
 // NewDocumentHandler creates a new document handler
-func NewDocumentHandler(documentService *services.DocumentService) *DocumentHandler {
-	return &DocumentHandler{documentService: documentService}
+func NewDocumentHandler(documentService *services.DocumentService, storageService *services.StorageService) *DocumentHandler {
+	return &DocumentHandler{
+		documentService: documentService,
+		storageService:  storageService,
+	}
 }
 
 // ListDocuments handles GET /api/documents/
@@ -70,12 +78,113 @@ func (h *DocumentHandler) ListWarranties(c *gin.Context) {
 }
 
 // CreateDocument handles POST /api/documents/
+// Supports both JSON and multipart form data (for file uploads)
 func (h *DocumentHandler) CreateDocument(c *gin.Context) {
 	user := c.MustGet(middleware.AuthUserKey).(*models.User)
 	var req requests.CreateDocumentRequest
-	if err := c.ShouldBindJSON(&req); err != nil {
-		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
-		return
+
+	contentType := c.GetHeader("Content-Type")
+
+	// Check if this is a multipart form request (file upload)
+	if strings.HasPrefix(contentType, "multipart/form-data") {
+		// Parse multipart form
+		if err := c.Request.ParseMultipartForm(32 << 20); err != nil { // 32MB max
+			c.JSON(http.StatusBadRequest, gin.H{"error": "failed to parse multipart form: " + err.Error()})
+			return
+		}
+
+		// Parse residence_id (required)
+		residenceIDStr := c.PostForm("residence_id")
+		if residenceIDStr == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "residence_id is required"})
+			return
+		}
+		residenceID, err := strconv.ParseUint(residenceIDStr, 10, 32)
+		if err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "invalid residence_id"})
+			return
+		}
+		req.ResidenceID = uint(residenceID)
+
+		// Parse title (required)
+		req.Title = c.PostForm("title")
+		if req.Title == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "title is required"})
+			return
+		}
+
+		// Parse optional fields
+		req.Description = c.PostForm("description")
+		req.Vendor = c.PostForm("vendor")
+		req.SerialNumber = c.PostForm("serial_number")
+		req.ModelNumber = c.PostForm("model_number")
+
+		// Parse document_type
+		if docType := c.PostForm("document_type"); docType != "" {
+			dt := models.DocumentType(docType)
+			req.DocumentType = dt
+		}
+
+		// Parse task_id (optional)
+		if taskIDStr := c.PostForm("task_id"); taskIDStr != "" {
+			if taskID, err := strconv.ParseUint(taskIDStr, 10, 32); err == nil {
+				tid := uint(taskID)
+				req.TaskID = &tid
+			}
+		}
+
+		// Parse purchase_price (optional)
+		if priceStr := c.PostForm("purchase_price"); priceStr != "" {
+			if price, err := decimal.NewFromString(priceStr); err == nil {
+				req.PurchasePrice = &price
+			}
+		}
+
+		// Parse purchase_date (optional)
+		if dateStr := c.PostForm("purchase_date"); dateStr != "" {
+			if t, err := time.Parse(time.RFC3339, dateStr); err == nil {
+				req.PurchaseDate = &t
+			} else if t, err := time.Parse("2006-01-02", dateStr); err == nil {
+				req.PurchaseDate = &t
+			}
+		}
+
+		// Parse expiry_date (optional)
+		if dateStr := c.PostForm("expiry_date"); dateStr != "" {
+			if t, err := time.Parse(time.RFC3339, dateStr); err == nil {
+				req.ExpiryDate = &t
+			} else if t, err := time.Parse("2006-01-02", dateStr); err == nil {
+				req.ExpiryDate = &t
+			}
+		}
+
+		// Handle file upload (look for "file", "document", or "image" field)
+		var uploadedFile *multipart.FileHeader
+		for _, fieldName := range []string{"file", "document", "image", "images"} {
+			if file, err := c.FormFile(fieldName); err == nil {
+				uploadedFile = file
+				break
+			}
+		}
+
+		if uploadedFile != nil && h.storageService != nil {
+			result, err := h.storageService.Upload(uploadedFile, "documents")
+			if err != nil {
+				c.JSON(http.StatusBadRequest, gin.H{"error": "failed to upload file: " + err.Error()})
+				return
+			}
+			req.FileURL = result.URL
+			req.FileName = result.FileName
+			req.MimeType = result.MimeType
+			fileSize := result.FileSize
+			req.FileSize = &fileSize
+		}
+	} else {
+		// Standard JSON request
+		if err := c.ShouldBindJSON(&req); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
 	}
 
 	response, err := h.documentService.CreateDocument(&req, user.ID)