feat(server-go): AI 巡检闭环后端（inspection_records + /inspections 幂等接口）

server-go/internal/handler/inspection.go

@@ -0,0 +1,136 @@
+package handler
+
+import (
+	"bytes"
+	"encoding/json"
+	"io"
+	"net/http"
+	"strconv"
+	"strings"
+
+	"silk-server-go/internal/middleware"
+	"silk-server-go/internal/model"
+	"silk-server-go/internal/service"
+
+	"github.com/gin-gonic/gin"
+	"gorm.io/gorm"
+)
+
+// RegisterInspectionRoutes 注册 AI 巡检路由
+func RegisterInspectionRoutes(rg *gin.RouterGroup, db *gorm.DB, s3 *service.S3Service, ai *service.AIClient, imageBucket string) {
+	rg.POST("/inspections", middleware.RequirePermission(db, "inspection:create"), createInspection(db, s3, ai, imageBucket))
+	rg.GET("/inspections", middleware.RequirePermission(db, "inspection:read"), listInspections(db))
+}
+
+// currentUserID 从 JWT 上下文取用户 ID
+func currentUserID(c *gin.Context) *string {
+	if user, ok := c.Get("user"); ok {
+		if m, ok := user.(map[string]interface{}); ok {
+			if s, ok := m["sub"].(string); ok && s != "" {
+				return &s
+			}
+		}
+	}
+	return nil
+}
+
+// createInspection 拍照巡检：图片存 S3 → 调 AI /detect → 写记录。
+// 幂等：客户端传 Idempotency-Key 头时，重复请求返回已有记录。
+func createInspection(db *gorm.DB, s3 *service.S3Service, ai *service.AIClient, bucket string) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		idemKey := strings.TrimSpace(c.GetHeader("Idempotency-Key"))
+		roomID := strings.TrimSpace(c.PostForm("roomId"))
+
+		if idemKey != "" {
+			var exist model.InspectionRecord
+			if db.Where("idempotency_key = ?", idemKey).First(&exist).Error == nil {
+				c.JSON(http.StatusOK, exist)
+				return
+			}
+		}
+
+		file, header, err := c.Request.FormFile("file")
+		if err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": "请选择图片文件（字段名 file）"})
+			return
+		}
+		defer file.Close()
+
+		if err := validateImageFile(header.Filename, header.Size); err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
+		imageBytes, err := io.ReadAll(file)
+		if err != nil {
+			c.JSON(http.StatusInternalServerError, gin.H{"error": "读取图片失败"})
+			return
+		}
+
+		key, ext, err := buildObjectKey("inspections", header.Filename)
+		if err != nil {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+			return
+		}
+		contentType, _ := imageContentType(ext)
+		if err := s3.EnsureBucket(bucket); err != nil {
+			c.JSON(http.StatusInternalServerError, gin.H{"error": "图片存储不可用: " + err.Error()})
+			return
+		}
+		if err := s3.UploadImage(bucket, key, bytes.NewReader(imageBytes), contentType); err != nil {
+			c.JSON(http.StatusInternalServerError, gin.H{"error": "图片上传失败: " + err.Error()})
+			return
+		}
+		imageURL := s3.Endpoint() + "/" + bucket + "/" + key
+
+		rec := model.InspectionRecord{
+			UserID:   currentUserID(c),
+			ImageURL: &imageURL,
+			AIStatus: "done",
+		}
+		if roomID != "" {
+			rec.RoomID = &roomID
+		}
+		if idemKey != "" {
+			rec.IdempotencyKey = &idemKey
+		}
+
+		detRes, aiErr := ai.Detect(c.Request.Context(), imageBytes, header.Filename)
+		if aiErr != nil {
+			rec.AIStatus = "failed"
+		} else {
+			raw, _ := json.Marshal(detRes.Detections)
+			rec.Detections = raw
+		}
+
+		if err := db.Create(&rec).Error; err != nil {
+			// 并发幂等：唯一索引冲突时返回已有记录
+			if idemKey != "" {
+				var exist model.InspectionRecord
+				if db.Where("idempotency_key = ?", idemKey).First(&exist).Error == nil {
+					c.JSON(http.StatusOK, exist)
+					return
+				}
+			}
+			c.JSON(http.StatusInternalServerError, gin.H{"error": "创建巡检记录失败"})
+			return
+		}
+		c.JSON(http.StatusCreated, rec)
+	}
+}
+
+// listInspections 巡检记录列表（roomId/limit 过滤）
+func listInspections(db *gorm.DB) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		q := db.Model(&model.InspectionRecord{})
+		if room := c.Query("roomId"); room != "" {
+			q = q.Where("room_id = ?", room)
+		}
+		limit := 50
+		if l, err := strconv.Atoi(c.Query("limit")); err == nil && l > 0 && l <= 200 {
+			limit = l
+		}
+		var list []model.InspectionRecord
+		q.Order("created_at DESC").Limit(limit).Find(&list)
+		c.JSON(http.StatusOK, list)
+	}
+}