全局审计完成

internal/query/audit/resources.go

@@ -8,12 +8,15 @@ import (
 	"gorm.io/datatypes"
 	"gorm.io/gorm"
 
+	auditinfra "github.com/break/junhong_cmp_fiber/internal/infrastructure/audit"
 	"github.com/break/junhong_cmp_fiber/internal/model"
 	retentionquery "github.com/break/junhong_cmp_fiber/internal/query/retention"
 	"github.com/break/junhong_cmp_fiber/pkg/constants"
 	"github.com/break/junhong_cmp_fiber/pkg/errors"
 )
 
+var timelineRegistry = auditinfra.NewRegistry()
+
 // ResourceSearchFilter 定义注册资源的精确标识搜索。
 type ResourceSearchFilter struct {
 	ResourceType string
@@ -25,21 +28,21 @@ type ResourceSearchFilter struct {
 
 // ResourceSearchPage 是资源候选稳定分页结果。
 type ResourceSearchPage struct {
-	Total     int64               `json:"total"`
-	Page      int                 `json:"page"`
-	PageSize  int                 `json:"page_size"`
-	Items     []ResourceCandidate `json:"items"`
-	Retention retentionquery.Info `json:"retention"`
+	Total     int64               `json:"total" description:"符合精确标识的资源总数"`
+	Page      int                 `json:"page" description:"当前页码"`
+	PageSize  int                 `json:"page_size" description:"每页数量"`
+	Items     []ResourceCandidate `json:"items" description:"当前资源或历史快照解析出的候选资源"`
+	Retention retentionquery.Info `json:"retention" description:"在线查询留存边界"`
 }
 
 // ResourceCandidate 是当前业务表或历史事件快照解析出的稳定资源候选。
 type ResourceCandidate struct {
-	ResourceType     string         `json:"resource_type"`
-	ResourceID       string         `json:"resource_id"`
-	ResourceKey      string         `json:"resource_key"`
-	DisplayName      string         `json:"display_name"`
-	IdentitySnapshot map[string]any `json:"identity_snapshot"`
-	Historical       bool           `json:"historical"`
+	ResourceType     string         `json:"resource_type" enum:"iot_card,device,shop,order,refund" description:"资源类型稳定编码"`
+	ResourceID       string         `json:"resource_id" description:"资源内部稳定ID，可传给通用资源时间线接口"`
+	ResourceKey      string         `json:"resource_key" description:"资源业务稳定Key"`
+	DisplayName      string         `json:"display_name" description:"资源展示名称"`
+	IdentitySnapshot map[string]any `json:"identity_snapshot" description:"当前业务表或历史事件保存的资源身份快照"`
+	Historical       bool           `json:"historical" description:"是否仅由历史事件快照解析，true不代表资源当前仍存在"`
 }
 
 // ResourceTimelineFilter 定义通用资源时间线筛选。
@@ -95,16 +98,8 @@ func (q *Query) ResourceTimeline(ctx context.Context, filter ResourceTimelineFil
 }
 
 func timelineResourceType(resourceType string) bool {
-	switch resourceType {
-	case constants.AuditResourceAccount, constants.AuditResourceShop, constants.AuditResourceEnterprise,
-		constants.AuditResourceIotCard, constants.AuditResourceDevice, constants.AuditResourceDeviceSIMBinding,
-		constants.AuditResourceAssetAllocationRecord, constants.AuditResourceExchangeOrder, constants.AuditResourceOrder,
-		constants.AuditResourceRefund, constants.AuditResourceAgentRecharge, constants.AuditResourceAssetWallet,
-		constants.AuditResourceApprovalInstance:
-		return true
-	default:
-		return false
-	}
+	_, ok := timelineRegistry.Resource(resourceType)
+	return ok
 }
 
 func (q *Query) searchCurrent(ctx context.Context, filter ResourceSearchFilter) ([]ResourceCandidate, int64, error) {