platforms/backend/api/internal/routers/platform.go

package routers

import (
	"fmt"

	"git.apinb.com/bsm-sdk/core/middleware"
	"git.apinb.com/heqiapp/platforms/backend/api/internal/logic/platform"
	"git.apinb.com/heqiapp/platforms/backend/api/internal/models"
	"github.com/gin-gonic/gin"
)

// RegisterPlatform 注册 /heqi/platform/v1 前缀下的平台总后台路由。
func RegisterPlatform(serviceKey string, engine *gin.Engine) {
	basePath := fmt.Sprintf("/%s/platform/v1", serviceKey)
	anonymous := engine.Group(basePath)
	anonymous.GET("/ping/hello", platform.PingHello)
	anonymous.POST("/auth/login", platform.Login)

	protected := engine.Group(basePath)
	protected.Use(middleware.JwtAuth(true))
	protected.Use(platform.RequirePlatformMenuAccess())
	protected.GET("/auth/profile", platform.CurrentProfile)
	protected.PUT("/auth/password", platform.ChangePassword)
	protected.GET("/dashboard/overview", platform.DashboardOverview)

	registerGasRoute(protected)
	registerDeliveryRoute(protected)
	registerStaffRoute(protected)
	registerUserRoute(protected)
	registerDeviceRoute(protected)
	registerCommerceRoute(protected)
	registerFinanceRoute(protected)
	registerContentRoute(protected)
	registerPlatformRoute(protected)
}

func registerGasRoute(group *gin.RouterGroup) {
	registerWritableResource(group, "/gas/gas_basic", platform.ListGasBasic, platform.CreateGasBasic, platform.GetGasBasic, platform.UpdateGasBasic, &models.GasBasic{})
	registerWritableResource(group, "/gas/gas_account", platform.ListGasAccount, platform.CreateGasAccount, platform.GetGasAccount, platform.UpdateGasAccount, &models.GasAccount{})
}

func registerDeliveryRoute(group *gin.RouterGroup) {
	registerWritableResource(group, "/delivery/delivery_basic", platform.ListDeliveryBasic, platform.CreateDeliveryBasic, platform.GetDeliveryBasic, platform.UpdateDeliveryBasic, &models.DeliveryBasic{})
	registerWritableResource(group, "/delivery/delivery_account", platform.ListDeliveryAccount, platform.CreateDeliveryAccount, platform.GetDeliveryAccount, platform.UpdateDeliveryAccount, &models.DeliveryAccount{})
	registerRestrictedWritableResource(group, "/delivery/delivery_task", &models.DeliveryTask{}, nil,
		requiredRelation("ec_order_identity", "ec_order_id", &models.EcOrder{}), optionalRelation("staff_account_identity", "staff_account_id", &models.StaffAccount{}), requiredRelation("delivery_basic_identity", "delivery_point_id", &models.DeliveryBasic{}))
	trackRelations := []platform.ResourceRelation{requiredRelation("delivery_task_identity", "delivery_task_id", &models.DeliveryTask{})}
	list, create, _, update := platform.ResourceHandlers(&models.DeliveryTrack{}, []string{"started_at", "completed_at"}, []string{"started_at", "completed_at"}, trackRelations...)
	registerWritableResource(group, "/delivery/delivery_track", list, create, platform.GetDeliveryTrack, update, &models.DeliveryTrack{})
	registerReadOnlyResource(group, "/delivery/delivery_track_point", &models.DeliveryTrackPoint{})
}

func registerDeviceRoute(group *gin.RouterGroup) {
	registerRestrictedWritableResource(group, "/device/dev_smart_cylinder_valve", &models.DevSmartCylinderValve{}, []string{"device_no", "model", "online_status", "owner_identity"})
	registerRestrictedWritableResource(group, "/device/dev_device_binding", &models.DevDeviceBinding{}, []string{"effective_at", "expired_at"}, requiredRelation("smart_cylinder_valve_identity", "smart_cylinder_valve_id", &models.DevSmartCylinderValve{}), requiredRelation("user_account_identity", "user_account_id", &models.UserAccount{}))
	list, _, get, _ := platform.ResourceHandlers(&models.DevTelemetry{}, nil, nil)
	telemetry := group.Group("/device/dev_telemetry")
	telemetry.GET("", list)
	telemetry.GET("/:identity", get)
}

func registerCommerceRoute(group *gin.RouterGroup) {
	categoryRelations := []platform.ResourceRelation{optionalRelation("parent_identity", "parent_id", &models.EcCategory{})}
	_, categoryCreate, _, categoryUpdate := platform.ResourceHandlers(&models.EcCategory{}, []string{"name", "sort_no"}, []string{"name", "sort_no"}, categoryRelations...)
	registerWritableResource(group, "/ec/ec_category", platform.ListEcCategory, categoryCreate, platform.GetEcCategory, categoryUpdate, &models.EcCategory{})
	registerRestrictedWritableResource(group, "/ec/ec_product", &models.EcProduct{}, []string{"product_code", "name", "price_amount", "stock_quantity"}, requiredRelation("ec_category_identity", "ec_category_id", &models.EcCategory{}))
	registerRestrictedWritableResource(group, "/ec/ec_product_attribute", &models.EcProductAttribute{}, []string{"name", "value", "sort_no"}, requiredRelation("ec_product_identity", "ec_product_id", &models.EcProduct{}))
	registerRestrictedWritableResource(group, "/ec/ec_product_image", &models.EcProductImage{}, []string{"image_uri", "sort_no", "is_cover"}, requiredRelation("ec_product_identity", "ec_product_id", &models.EcProduct{}))
	registerRestrictedWritableResource(group, "/ec/ec_cart", &models.EcCart{}, []string{"quantity", "selected"}, requiredRelation("user_account_identity", "user_account_id", &models.UserAccount{}), requiredRelation("ec_product_identity", "ec_product_id", &models.EcProduct{}))
	orderRelations := []platform.ResourceRelation{requiredRelation("user_account_identity", "user_account_id", &models.UserAccount{}), optionalRelation("gas_basic_identity", "gas_station_id", &models.GasBasic{}), optionalRelation("delivery_basic_identity", "delivery_point_id", &models.DeliveryBasic{})}
	list, create, _, update := platform.ResourceHandlers(&models.EcOrder{}, []string{"order_no", "total_amount"}, []string{"total_amount"}, orderRelations...)
	registerWritableResource(group, "/ec/ec_order", list, create, platform.GetEcOrder, update, &models.EcOrder{})
	registerRestrictedWritableResource(group, "/ec/ec_order_item", &models.EcOrderItem{}, []string{"product_snapshot", "quantity", "sale_amount"}, requiredRelation("ec_order_identity", "ec_order_id", &models.EcOrder{}), requiredRelation("ec_product_identity", "ec_product_id", &models.EcProduct{}))
	registerRestrictedWritableResource(group, "/ec/ec_review", &models.EcReview{}, []string{"score", "content"}, requiredRelation("ec_order_identity", "ec_order_id", &models.EcOrder{}), requiredRelation("ec_product_identity", "ec_product_id", &models.EcProduct{}), requiredRelation("user_account_identity", "user_account_id", &models.UserAccount{}))
}

func registerStaffRoute(group *gin.RouterGroup) {
	registerWritableResource(group, "/staff/account", platform.ListStaff, platform.CreateStaff, platform.GetStaff, platform.UpdateStaff, &models.StaffAccount{})
	registerWritableResource(group, "/staff/credential", platform.ListStaffCredential, platform.CreateStaffCredential, platform.GetStaffCredential, platform.UpdateStaffCredential, &models.StaffCredential{})
}

func registerUserRoute(group *gin.RouterGroup) {
	registerWritableResource(group, "/user/account", platform.ListUser, platform.CreateUser, platform.GetUser, platform.UpdateUser, &models.UserAccount{})
	registerWritableResource(group, "/user/address", platform.ListUserAddress, platform.CreateUserAddress, platform.GetUserAddress, platform.UpdateUserAddress, &models.UserAddress{})
	registerWritableResource(group, "/user/service_relation", platform.ListUserServiceRelation, platform.CreateUserServiceRelation, platform.GetUserServiceRelation, platform.UpdateUserServiceRelation, &models.UserServiceRelation{})
}

func registerPlatformRoute(group *gin.RouterGroup) {
	registerWritableResource(group, "/platform/platfrom_account", platform.ListPlatfromAccount, platform.CreatePlatfromAccount, platform.GetPlatfromAccount, platform.UpdatePlatfromAccount, &models.PlatfromAccount{})
	role := group.Group("/platform/platform_role")
	role.GET("", platform.ListPlatformRole)
	role.POST("", platform.CreatePlatformRole)
	role.GET("/:identity", platform.GetPlatformRole)
	role.PUT("/:identity", platform.UpdatePlatformRole)
	role.PATCH("/:identity/status", platform.UpdatePlatformRoleStatus)
	role.DELETE("/:identity", platform.ArchivePlatformRole)
	role.GET("/:identity/menu", platform.ListPlatformRoleMenuIdentities)
	role.PUT("/:identity/menu", platform.ReplacePlatformRoleMenus)
	role.PUT("/:identity/menus", platform.ReplacePlatformRoleMenus)
	menu := group.Group("/platform/platform_menu")
	menu.GET("", platform.ListPlatformMenu)
	menu.POST("", platform.CreatePlatformMenu)
	menu.GET("/:identity", platform.GetPlatformMenu)
	menu.PUT("/:identity", platform.UpdatePlatformMenu)
	menu.PATCH("/:identity/status", platform.UpdatePlatformMenuStatus)
	menu.DELETE("/:identity", platform.ArchivePlatformMenu)
}

func registerFinanceRoute(group *gin.RouterGroup) {
	registerRestrictedWritableResource(group, "/finance/fin_payment", &models.FinPayment{}, []string{"channel", "amount", "paid_at"}, requiredRelation("ec_order_identity", "ec_order_id", &models.EcOrder{}))
	settlementList, settlementCreate, settlementGet, settlementUpdate := platform.FinSettlementHandlers()
	registerWritableResource(group, "/finance/fin_settlement", settlementList, settlementCreate, settlementGet, settlementUpdate, &models.FinSettlement{})
	registerRestrictedWritableResource(group, "/finance/fin_reconciliation", &models.FinReconciliation{}, []string{"channel", "bill_date", "difference_amount"})

	registerReadOnlyResource(group, "/wallet/wallet", &models.Wallet{})
	registerReadOnlyResource(group, "/wallet/wallet_ledger", &models.WalletLedger{})
	registerReadOnlyResource(group, "/wallet/wallet_recharge", &models.WalletRecharge{})
	registerReadOnlyResource(group, "/wallet/wallet_withdrawal", &models.WalletWithdrawal{})
}

func registerContentRoute(group *gin.RouterGroup) {
	registerRestrictedWritableResource(group, "/content/cms_content", &models.CmsContent{}, []string{"content_type", "title", "body", "version_no", "publish_status"})
	registerRestrictedWritableResource(group, "/customer_service/cs_ticket", &models.CsTicket{}, []string{"ticket_no", "category", "priority"}, requiredRelation("user_account_identity", "user_account_id", &models.UserAccount{}))
}

func registerWritableResource(group *gin.RouterGroup, path string, list, create, get, update gin.HandlerFunc, model any) {
	resource := group.Group(path)
	resource.GET("", list)
	resource.POST("", create)
	resource.GET("/:identity", get)
	resource.PUT("/:identity", update)
	resource.PATCH("/:identity/status", func(ctx *gin.Context) { platform.UpdateRecordStatus(ctx, model) })
	resource.DELETE("/:identity", func(ctx *gin.Context) { platform.ArchiveRecord(ctx, model) })
}

func registerRestrictedWritableResource(group *gin.RouterGroup, path string, model any, fields []string, relations ...platform.ResourceRelation) {
	list, create, get, update := platform.ResourceHandlers(model, fields, fields, relations...)
	registerWritableResource(group, path, list, create, get, update, model)
}

func registerReadOnlyResource(group *gin.RouterGroup, path string, model any) {
	list, _, get, _ := platform.ResourceHandlers(model, nil, nil)
	resource := group.Group(path)
	resource.GET("", list)
	resource.GET("/:identity", get)
}

func requiredRelation(input, column string, model any) platform.ResourceRelation {
	return platform.ResourceRelation{Input: input, Column: column, Model: model, Required: true}
}

func optionalRelation(input, column string, model any) platform.ResourceRelation {
	return platform.ResourceRelation{Input: input, Column: column, Model: model}
}