Files
platforms/backend/api/internal/logic/client/user/address.go
czl231 3ef33b531d 已完成用户APP首期功能开发
交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过;完整测试仍有2项失败,后端模型注释检查未通过,详见交付记录。
2026-09-13 00:57:32 +08:00

174 lines
6.6 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 功能描述:用户地址新增、编辑、归档及默认切换,账户行锁保护并发写入。
// 版本1.0.0。
package user
import (
"errors"
"math"
"strconv"
"strings"
"git.apinb.com/bsm-sdk/core/errcode"
"git.apinb.com/bsm-sdk/core/infra"
"git.apinb.com/heqiapp/platforms/backend/api/internal/impl"
common "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"
)
// addressRequest 保留旧新增字段,联系人省略时从本账户补齐。
type addressRequest struct {
Address string `json:"address" binding:"required,max=255"`
ContactName *string `json:"contact_name" binding:"omitempty,max=64"`
ContactPhone *string `json:"contact_phone" binding:"omitempty,max=32"`
Longitude string `json:"longitude" binding:"max=32"`
Latitude string `json:"latitude" binding:"max=32"`
IsDefault bool `json:"is_default"`
RequestNo string `json:"request_no" binding:"max=64"`
}
// validAddressCoordinates 接受手动地址的空坐标;有坐标时必须成对且为合法经纬度。
func validAddressCoordinates(longitude, latitude string) bool {
if longitude == "" && latitude == "" {
return true
}
lon, e1 := strconv.ParseFloat(longitude, 64)
lat, e2 := strconv.ParseFloat(latitude, 64)
return e1 == nil && e2 == nil && !math.IsNaN(lon) && !math.IsNaN(lat) && lon >= -180 && lon <= 180 && lat >= -90 && lat <= 90
}
// lockAddressOwner 按账户串行处理默认地址和幂等请求,避免首次新增的并发竞态。
func lockAddressOwner(tx *gorm.DB, id uint64) error {
return tx.Clauses(clause.Locking{Strength: "UPDATE"}).Select("id").First(&models.UserAccount{}, id).Error
}
// clearAddressDefault 在同一事务取消旧默认,保留现有唯一索引约束。
func clearAddressDefault(tx *gorm.DB, userID uint64) error {
return tx.Model(&models.UserAddress{}).Where("user_account_id = ? AND is_default = ?", userID, true).Update("is_default", false).Error
}
// SaveAddress 新增地址,带 request_no 的重试返回原标识,不重复创建。
func SaveAddress(ctx *gin.Context) { writeAddress(ctx, false) }
// UpdateAddress 仅更新本人地址,旧订单使用已有快照,不随地址修改。
func UpdateAddress(ctx *gin.Context) { writeAddress(ctx, true) }
// writeAddress 校验请求后在事务中持久化,失败时保持原地址和默认设置。
func writeAddress(ctx *gin.Context, updating bool) {
account, ok := common.UserAccount(ctx)
if !ok {
return
}
var request addressRequest
if ctx.ShouldBindJSON(&request) != nil {
infra.Response.Error(ctx, errcode.ErrInvalidArgument)
return
}
request.Address = strings.TrimSpace(request.Address)
request.Longitude = strings.TrimSpace(request.Longitude)
request.Latitude = strings.TrimSpace(request.Latitude)
if request.Address == "" || !validAddressCoordinates(request.Longitude, request.Latitude) {
infra.Response.Error(ctx, errcode.ErrInvalidArgument)
return
}
var address models.UserAddress
err := impl.DBService.Transaction(func(tx *gorm.DB) error {
if err := lockAddressOwner(tx, account.ID); err != nil {
return err
}
if updating {
if err := tx.Where("identity = ? AND user_account_id = ? AND status <> ?", ctx.Param("identity"), account.ID, common.StatusArchived).First(&address).Error; err != nil {
return errcode.ErrRecordNotFound
}
} else {
address = models.UserAddress{Entity: common.NewEntity(common.StatusEnable), UserAccountID: account.ID, RequestNo: request.RequestNo}
}
name, phone := address.ContactName, address.ContactPhone
if name == "" {
name = account.Name
}
if phone == "" {
phone = account.Phone
}
if request.ContactName != nil {
name = strings.TrimSpace(*request.ContactName)
}
if request.ContactPhone != nil {
phone = strings.TrimSpace(*request.ContactPhone)
}
if (request.ContactName != nil && name == "") || !common.ValidPhone(phone) {
return errcode.ErrInvalidArgument
}
if !updating && request.RequestNo != "" {
var previous models.UserAddress
err := tx.Where("user_account_id = ? AND request_no = ?", account.ID, request.RequestNo).First(&previous).Error
if err == nil {
if previous.Status == common.StatusArchived || previous.Address != request.Address || previous.ContactName != name || previous.ContactPhone != phone || previous.Longitude != request.Longitude || previous.Latitude != request.Latitude {
return errcode.ErrInvalidArgument
}
address = previous
return nil
}
if !errors.Is(err, gorm.ErrRecordNotFound) {
return err
}
}
if request.IsDefault {
if err := clearAddressDefault(tx, account.ID); err != nil {
return err
}
}
address.Address, address.ContactName, address.ContactPhone = request.Address, name, phone
address.Longitude, address.Latitude, address.IsDefault = request.Longitude, request.Latitude, request.IsDefault
if updating {
return tx.Model(&address).Select("address", "contact_name", "contact_phone", "longitude", "latitude", "is_default").Updates(&address).Error
}
return tx.Create(&address).Error
})
if err != nil {
infra.Response.Error(ctx, err)
return
}
infra.Response.Success(ctx, gin.H{"identity": address.Identity})
}
// SetDefaultAddress 设置本人有效地址为默认,不接受请求体中的用户或地址归属。
func SetDefaultAddress(ctx *gin.Context) { changeAddressState(ctx, false) }
// DeleteAddress 归档本人地址并取消默认;重复删除成功,历史订单引用保留。
func DeleteAddress(ctx *gin.Context) { changeAddressState(ctx, true) }
// changeAddressState 所有权校验先于默认切换,跨账户请求不能影响本人的默认设置。
func changeAddressState(ctx *gin.Context, deleting bool) {
account, ok := common.UserAccount(ctx)
if !ok {
return
}
err := impl.DBService.Transaction(func(tx *gorm.DB) error {
if err := lockAddressOwner(tx, account.ID); err != nil {
return err
}
var address models.UserAddress
if err := tx.Where("identity = ? AND user_account_id = ?", ctx.Param("identity"), account.ID).First(&address).Error; err != nil {
return errcode.ErrRecordNotFound
}
if deleting {
return tx.Model(&address).Updates(map[string]any{"status": common.StatusArchived, "is_default": false}).Error
}
if address.Status == common.StatusArchived {
return errcode.ErrRecordNotFound
}
if err := clearAddressDefault(tx, account.ID); err != nil {
return err
}
return tx.Model(&address).Update("is_default", true).Error
})
if err != nil {
infra.Response.Error(ctx, err)
return
}
infra.Response.Success(ctx, gin.H{"identity": ctx.Param("identity")})
}