已完成用户APP首期功能开发
交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过；完整测试仍有2项失败，后端模型注释检查未通过，详见交付记录。
This commit is contained in:
czl231
173
backend/api/internal/logic/client/user/address.go
Normal file
173
backend/api/internal/logic/client/user/address.go
Normal file
@@ -0,0 +1,173 @@
|
||||
// 功能描述：用户地址新增、编辑、归档及默认切换，账户行锁保护并发写入。
|
||||
// 版本：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")})
|
||||
}
|
||||
Reference in New Issue
Block a user