feat: improve gas station management workflow

backend/api/internal/logic/platform/gas/gas.go

@@ -1,12 +1,18 @@
 package gas
 
 import (
+	"errors"
+	"strings"
+	"time"
+
 	"git.apinb.com/bsm-sdk/core/errcode"
 	"git.apinb.com/bsm-sdk/core/infra"
 	"git.apinb.com/heqiapp/platforms/backend/api/internal/impl"
 	"git.apinb.com/heqiapp/platforms/backend/api/internal/logic/common"
 	"git.apinb.com/heqiapp/platforms/backend/api/internal/models"
 	"github.com/gin-gonic/gin"
+	"gorm.io/gorm"
+	"gorm.io/gorm/clause"
 )
 
 // ListGasBasic 查询可燃气体站分页列表。
@@ -46,3 +52,78 @@ func UpdateGasBasic(ctx *gin.Context) {
 	}
 	common.UpdateAllowedByIdentity(ctx, &models.GasBasic{}, gin.H{"name": request.Name, "credit_code": request.CreditCode, "principal": request.Principal, "address": request.Address, "longitude": request.Longitude, "latitude": request.Latitude}, []string{"name", "credit_code", "principal", "address", "longitude", "latitude"})
 }
+
+// UpdateGasBasicStatus 仅允许已审核气站在启用和停用之间切换。
+func UpdateGasBasicStatus(ctx *gin.Context) {
+	var request struct {
+		Status int `json:"status" binding:"required"`
+	}
+	if err := ctx.ShouldBindJSON(&request); err != nil ||
+		(request.Status != common.StatusEnable && request.Status != common.StatusDisable) {
+		infra.Response.Error(ctx, errcode.ErrInvalidArgument)
+		return
+	}
+	result := impl.DBService.Model(&models.GasBasic{}).
+		Where("identity = ? AND status IN ?", ctx.Param("identity"), []int{common.StatusEnable, common.StatusDisable}).
+		Update("status", request.Status)
+	if result.Error != nil {
+		infra.Response.Error(ctx, result.Error)
+		return
+	}
+	if result.RowsAffected != 1 {
+		infra.Response.Error(ctx, errcode.ErrInvalidArgument)
+		return
+	}
+	infra.Response.Success(ctx, gin.H{"updated": true})
+}
+
+// ReviewGasBasic 审核待审核气站；不通过时必须填写理由。
+func ReviewGasBasic(ctx *gin.Context) {
+	var request struct {
+		Approved bool   `json:"approved"`
+		Reason   string `json:"reason" binding:"max=2000"`
+	}
+	if err := ctx.ShouldBindJSON(&request); err != nil ||
+		(!request.Approved && strings.TrimSpace(request.Reason) == "") {
+		infra.Response.Error(ctx, errcode.ErrInvalidArgument)
+		return
+	}
+
+	operatorIdentity, operatorName := common.PlatformOperator(ctx)
+	targetStatus := common.StatusDisable
+	reviewStatus := common.StatusRejected
+	if request.Approved {
+		targetStatus = common.StatusEnable
+		reviewStatus = common.StatusApproved
+	}
+	now := time.Now()
+	err := impl.DBService.Transaction(func(tx *gorm.DB) error {
+		var station models.GasBasic
+		if err := tx.Clauses(clause.Locking{Strength: "UPDATE"}).
+			Where("identity = ? AND status <> ?", ctx.Param("identity"), common.StatusArchived).
+			First(&station).Error; err != nil {
+			return err
+		}
+		if station.Status != common.StatusDraft {
+			return errors.New("gas station is not pending review")
+		}
+		if err := tx.Model(&station).Update("status", targetStatus).Error; err != nil {
+			return err
+		}
+		review := models.GasBasicReview{
+			Entity:           common.NewEntity(common.StatusEnable),
+			GasBasicID:       station.ID,
+			ReviewStatus:     reviewStatus,
+			ReviewReason:     strings.TrimSpace(request.Reason),
+			ReviewerIdentity: operatorIdentity,
+			ReviewerName:     operatorName,
+			ReviewedAt:       now,
+		}
+		return tx.Create(&review).Error
+	})
+	if err != nil {
+		common.RespondRecordError(ctx, err)
+		return
+	}
+	infra.Response.Success(ctx, gin.H{"updated": true, "status": targetStatus})
+}