feat(t222): add freight ingestion admin flow

2026-07-28 23:26:34 +08:00
parent c524e734fb
commit 6d052b0462
37 changed files with 3397 additions and 101 deletions
@@ -0,0 +1,188 @@
+package httpapi
+
+import (
+	"net/http"
+	"strconv"
+	"strings"
+
+	"cmroubao/backend-api/internal/domain"
+	"cmroubao/backend-api/internal/usecase"
+
+	"github.com/gin-gonic/gin"
+)
+
+func (h *adminHandlers) createFreightSync(ctx *gin.Context) {
+	if !hasMediaType(ctx, "application/json") {
+		writePublicError(
+			ctx,
+			http.StatusUnsupportedMediaType,
+			"UNSUPPORTED_MEDIA_TYPE",
+			"application/json is required",
+			false,
+			gin.H{},
+		)
+		return
+	}
+	var request struct {
+		Mode        string `json:"mode"`
+		OrderNumber string `json:"order_number"`
+	}
+	if err := decodeJSON(ctx, &request); err != nil {
+		writePublicError(
+			ctx,
+			http.StatusBadRequest,
+			"INVALID_JSON",
+			"request body must be valid JSON",
+			false,
+			gin.H{},
+		)
+		return
+	}
+	if request.Mode != domain.FreightSyncOrderNumber {
+		writePublicError(
+			ctx,
+			http.StatusUnprocessableEntity,
+			"FREIGHT_SYNC_MODE_INVALID",
+			"freight sync mode is not supported",
+			false,
+			fieldDetails("mode", "must be ORDER_NUMBER"),
+		)
+		return
+	}
+	result, err := h.services.Freight.CreateOrderSync(
+		ctx.Request.Context(),
+		usecase.CreateFreightSyncCommand{
+			CreatorSubject: localAdminSubject,
+			ActorUserID:    adminActorUserID(ctx),
+			IdempotencyKey: ctx.GetHeader("Idempotency-Key"),
+			OrderNumber:    request.OrderNumber,
+		},
+	)
+	if err != nil {
+		writeUsecaseError(ctx, err)
+		return
+	}
+	ctx.Header("Cache-Control", "no-store")
+	ctx.JSON(http.StatusAccepted, gin.H{
+		"sync":     freightSyncResponse(result.Run),
+		"replayed": result.Replayed,
+	})
+}
+
+func (h *adminHandlers) freightSyncDetail(ctx *gin.Context) {
+	run, err := h.services.Freight.GetSync(
+		ctx.Request.Context(),
+		localAdminSubject,
+		ctx.Param("id"),
+	)
+	if err != nil {
+		writeUsecaseError(ctx, err)
+		return
+	}
+	ctx.Header("Cache-Control", "no-store")
+	ctx.JSON(http.StatusOK, gin.H{"sync": freightSyncResponse(run)})
+}
+
+func (h *adminHandlers) listFreightOrders(ctx *gin.Context) {
+	limit := 0
+	if value := strings.TrimSpace(ctx.Query("limit")); value != "" {
+		parsed, err := strconv.Atoi(value)
+		if err != nil {
+			writePublicError(
+				ctx,
+				http.StatusBadRequest,
+				"FREIGHT_LIST_INVALID",
+				"freight list filter is invalid",
+				false,
+				fieldDetails("limit", "must be an integer"),
+			)
+			return
+		}
+		limit = parsed
+	}
+	orders, err := h.services.Freight.ListOrders(
+		ctx.Request.Context(),
+		localAdminSubject,
+		limit,
+	)
+	if err != nil {
+		writeUsecaseError(ctx, err)
+		return
+	}
+	items := make([]gin.H, 0, len(orders))
+	for _, order := range orders {
+		items = append(items, freightOrderResponse(order))
+	}
+	ctx.Header("Cache-Control", "no-store")
+	ctx.JSON(http.StatusOK, gin.H{
+		"items":       items,
+		"next_cursor": nil,
+	})
+}
+
+func (h *adminHandlers) freightOrderDetail(ctx *gin.Context) {
+	detail, err := h.services.Freight.GetOrder(
+		ctx.Request.Context(),
+		localAdminSubject,
+		ctx.Param("id"),
+	)
+	if err != nil {
+		writeUsecaseError(ctx, err)
+		return
+	}
+	items := make([]gin.H, 0, len(detail.Items))
+	for _, item := range detail.Items {
+		items = append(items, gin.H{
+			"id":                item.ID,
+			"external_item_id":  item.ExternalItemID,
+			"title":             item.Title,
+			"product_spec":      item.ProductSpec,
+			"sku":               item.SKU,
+			"quantity":          item.Quantity,
+			"product_thumb_ref": item.ProductThumbRef,
+			"purchase_status":   item.PurchaseStatus,
+			"revision":          item.Revision,
+			"canonical_sha256":  item.CanonicalSHA256,
+			"updated_at":        formatTime(item.UpdatedAt),
+		})
+	}
+	ctx.Header("Cache-Control", "no-store")
+	ctx.JSON(http.StatusOK, gin.H{
+		"order": freightOrderResponse(detail.Order),
+		"items": items,
+	})
+}
+
+func freightSyncResponse(run domain.FreightSyncRun) gin.H {
+	return gin.H{
+		"id":           run.ID,
+		"mode":         run.Mode,
+		"query_sha256": run.QuerySHA256,
+		"status":       run.Status,
+		"error_code":   run.ErrorCode,
+		"order_count":  run.OrderCount,
+		"item_count":   run.ItemCount,
+		"created_at":   formatTime(run.CreatedAt),
+		"started_at":   formatOptionalTime(run.StartedAt),
+		"finished_at":  formatOptionalTime(run.FinishedAt),
+	}
+}
+
+func freightOrderResponse(order domain.FreightOrder) gin.H {
+	return gin.H{
+		"id":                order.ID,
+		"source_system":     order.SourceSystem,
+		"external_stock_id": order.ExternalStockID,
+		"source_code":       order.SourceCode,
+		"platform_order_no": order.PlatformOrderNo,
+		"shop_name":         order.ShopName,
+		"source_created_at": formatOptionalTime(order.SourceCreatedAt),
+		"order_status":      order.OrderStatus,
+		"purchase_status":   order.PurchaseStatus,
+		"is_canceled":       order.IsCanceled,
+		"revision":          order.Revision,
+		"canonical_sha256":  order.CanonicalSHA256,
+		"item_count":        order.ItemCount,
+		"updated_at":        formatTime(order.UpdatedAt),
+	}
+}