refactor: 对齐后端样例工程规范

backend/api/internal/logic/org_gas_station/org_gas_station.go

@@ -0,0 +1,60 @@
+// Package org_gas_station 提供气站管理的 HTTP 业务逻辑。
+package org_gas_station
+
+import (
+	"git.apinb.com/bsm-sdk/core/errcode"
+	"git.apinb.com/bsm-sdk/core/infra"
+	"git.apinb.com/bsm-sdk/core/utils"
+	"git.apinb.com/heqiapp/platforms/backend/api/internal/models"
+	"github.com/gin-gonic/gin"
+)
+
+// CreateRequest 是创建 org_gas_station 的请求体。
+type CreateRequest struct {
+	StationCode string `json:"station_code" binding:"required,max=32"`
+	Name        string `json:"name" binding:"required,max=128"`
+	Principal   string `json:"principal" binding:"required,max=64"`
+	ServiceArea string `json:"service_area" binding:"required,max=128"`
+}
+
+// ListReply 是标准分页响应。
+type ListReply struct {
+	Total int64                  `json:"total"`
+	List  []models.OrgGasStation `json:"list"`
+}
+
+// Create 创建待审核气站并由数据库层保证唯一编码。
+func Create(ctx *gin.Context) {
+	var request CreateRequest
+	if err := ctx.ShouldBindJSON(&request); err != nil {
+		infra.Response.Error(ctx, errcode.ErrInvalidArgument)
+		return
+	}
+	data := models.OrgGasStation{StationCode: request.StationCode, Name: request.Name, Principal: request.Principal, ServiceArea: request.ServiceArea}
+	data.Identity = models.NewIdentity()
+	data.Status = "draft"
+	data.Version = 1
+	if err := models.CreateOrgGasStation(&data); err != nil {
+		infra.Response.Error(ctx, err)
+		return
+	}
+	infra.Response.Success(ctx, data)
+}
+
+// List 查询气站分页列表。
+func List(ctx *gin.Context) {
+	page := utils.String2Int(ctx.DefaultQuery("page", "1"))
+	size := utils.String2Int(ctx.DefaultQuery("size", "20"))
+	if page < 1 {
+		page = 1
+	}
+	if size < 1 || size > 100 {
+		size = 20
+	}
+	list, total, err := models.ListOrgGasStation(page, size)
+	if err != nil {
+		infra.Response.Error(ctx, err)
+		return
+	}
+	infra.Response.Success(ctx, ListReply{Total: total, List: list})
+}