huang
409a68d60b
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 5m45s
主要变更： 1. OpenAPI 文档契约对齐 - 统一错误响应字段名为 msg（非 message） - 规范 envelope 响应结构（code, msg, data, timestamp） - 个人客户路由纳入文档体系（使用 Register 机制） - 新增 BuildDocHandlers() 统一管理 handler 构造 - 确保文档生成的幂等性 2. Service 层错误处理统一 - 全面替换 fmt.Errorf 为 errors.New/Wrap - 统一错误码使用规范 - Handler 层参数校验不泄露底层细节 - 新增错误码验证集成测试 3. 代码质量提升 - 删除未使用的 Task handler 和路由 - 新增代码规范检查脚本（check-service-errors.sh） - 新增注释路径一致性检查（check-comment-paths.sh） - 更新 API 文档生成指南 4. OpenSpec 归档 - 归档 openapi-contract-alignment 变更（63 tasks） - 归档 service-error-unify-core 变更 - 归档 service-error-unify-support 变更 - 归档 code-cleanup-docs-update 变更 - 归档 handler-validation-security 变更 - 同步 delta specs 到主规范文件 影响范围： - pkg/openapi: 新增 handlers.go，优化 generator.go - internal/service/*: 48 个 service 文件错误处理统一 - internal/handler/admin: 优化参数校验错误提示 - internal/routes: 个人客户路由改造，删除 task 路由 - scripts: 新增 3 个代码检查脚本 - docs: 更新 OpenAPI 文档（15750+ 行） - openspec/specs: 同步 3 个主规范文件 破坏性变更：无 向后兼容：是
98 lines
3.0 KiB
Go
98 lines
3.0 KiB
Go
package commission_stats
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/break/junhong_cmp_fiber/internal/model"
|
|
"github.com/break/junhong_cmp_fiber/internal/store/postgres"
|
|
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
type Service struct {
|
|
statsStore *postgres.ShopSeriesCommissionStatsStore
|
|
}
|
|
|
|
func New(statsStore *postgres.ShopSeriesCommissionStatsStore) *Service {
|
|
return &Service{
|
|
statsStore: statsStore,
|
|
}
|
|
}
|
|
|
|
func (s *Service) GetCurrentStats(ctx context.Context, allocationID uint, periodType string) (*model.ShopSeriesCommissionStats, error) {
|
|
now := time.Now()
|
|
|
|
stats, err := s.statsStore.GetCurrent(ctx, allocationID, periodType, now)
|
|
if err != nil {
|
|
if err == gorm.ErrRecordNotFound {
|
|
return nil, errors.New(errors.CodeNotFound, "统计数据不存在")
|
|
}
|
|
return nil, errors.Wrap(errors.CodeInternalError, err, "获取统计数据失败")
|
|
}
|
|
|
|
return stats, nil
|
|
}
|
|
|
|
func (s *Service) UpdateStats(ctx context.Context, allocationID uint, periodType string, salesCount int64, salesAmount int64) error {
|
|
now := time.Now()
|
|
periodStart, periodEnd := calculatePeriod(now, periodType)
|
|
|
|
stats, err := s.statsStore.GetCurrent(ctx, allocationID, periodType, now)
|
|
if err != nil && err != gorm.ErrRecordNotFound {
|
|
return errors.Wrap(errors.CodeInternalError, err, "查询统计数据失败")
|
|
}
|
|
|
|
if stats == nil {
|
|
stats = &model.ShopSeriesCommissionStats{
|
|
AllocationID: allocationID,
|
|
PeriodType: periodType,
|
|
PeriodStart: periodStart,
|
|
PeriodEnd: periodEnd,
|
|
TotalSalesCount: salesCount,
|
|
TotalSalesAmount: salesAmount,
|
|
Status: "active",
|
|
LastUpdatedAt: now,
|
|
Version: 1,
|
|
}
|
|
return s.statsStore.Create(ctx, stats)
|
|
}
|
|
|
|
return s.statsStore.IncrementSales(ctx, stats.ID, salesCount, salesAmount, stats.Version)
|
|
}
|
|
|
|
func (s *Service) ArchiveCompletedPeriod(ctx context.Context, allocationID uint, periodType string) error {
|
|
now := time.Now()
|
|
stats, err := s.statsStore.GetCurrent(ctx, allocationID, periodType, now)
|
|
if err != nil {
|
|
if err == gorm.ErrRecordNotFound {
|
|
return nil
|
|
}
|
|
return errors.Wrap(errors.CodeInternalError, err, "查询统计数据失败")
|
|
}
|
|
|
|
return s.statsStore.CompletePeriod(ctx, stats.ID)
|
|
}
|
|
|
|
func calculatePeriod(now time.Time, periodType string) (time.Time, time.Time) {
|
|
var periodStart, periodEnd time.Time
|
|
|
|
switch periodType {
|
|
case "monthly":
|
|
periodStart = time.Date(now.Year(), now.Month(), 1, 0, 0, 0, 0, now.Location())
|
|
periodEnd = periodStart.AddDate(0, 1, 0).Add(-time.Second)
|
|
case "quarterly":
|
|
quarter := (int(now.Month()) - 1) / 3
|
|
periodStart = time.Date(now.Year(), time.Month(quarter*3+1), 1, 0, 0, 0, 0, now.Location())
|
|
periodEnd = periodStart.AddDate(0, 3, 0).Add(-time.Second)
|
|
case "yearly":
|
|
periodStart = time.Date(now.Year(), 1, 1, 0, 0, 0, 0, now.Location())
|
|
periodEnd = periodStart.AddDate(1, 0, 0).Add(-time.Second)
|
|
default:
|
|
periodStart = time.Date(now.Year(), now.Month(), 1, 0, 0, 0, 0, now.Location())
|
|
periodEnd = periodStart.AddDate(0, 1, 0).Add(-time.Second)
|
|
}
|
|
|
|
return periodStart, periodEnd
|
|
}
|