基础架构

2025-07-13 16:36:20 +08:00
parent e3d64e7485
commit 807004f78d
128 changed files with 17232 additions and 11396 deletions
--- a/internal/domains/certification/repositories/certification_repository_interface.go
+++ b/internal/domains/certification/repositories/certification_repository_interface.go
@@ -0,0 +1,98 @@
+package repositories
+
+import (
+	"context"
+	"tyapi-server/internal/domains/certification/entities"
+	"tyapi-server/internal/domains/certification/repositories/queries"
+	"tyapi-server/internal/shared/interfaces"
+)
+
+// CertificationStats 认证统计信息
+type CertificationStats struct {
+	TotalCertifications     int64
+	PendingCertifications   int64
+	CompletedCertifications int64
+	RejectedCertifications  int64
+	TodaySubmissions        int64
+}
+
+// CertificationRepository 认证申请仓储接口
+type CertificationRepository interface {
+	interfaces.Repository[entities.Certification]
+
+	// 基础查询 - 直接使用实体
+	GetByUserID(ctx context.Context, userID string) (*entities.Certification, error)
+	GetByStatus(ctx context.Context, status string) ([]*entities.Certification, error)
+	GetPendingCertifications(ctx context.Context) ([]*entities.Certification, error)
+
+	// 复杂查询 - 使用查询参数
+	ListCertifications(ctx context.Context, query *queries.ListCertificationsQuery) ([]*entities.Certification, int64, error)
+
+	// 业务操作
+	UpdateStatus(ctx context.Context, certificationID string, status string, adminID *string, notes string) error
+
+	// 统计信息
+	GetStats(ctx context.Context) (*CertificationStats, error)
+	GetStatsByDateRange(ctx context.Context, startDate, endDate string) (*CertificationStats, error)
+}
+
+// FaceVerifyRecordRepository 人脸识别记录仓储接口
+type FaceVerifyRecordRepository interface {
+	interfaces.Repository[entities.FaceVerifyRecord]
+
+	// 基础查询 - 直接使用实体
+	GetByCertificationID(ctx context.Context, certificationID string) ([]*entities.FaceVerifyRecord, error)
+	GetLatestByCertificationID(ctx context.Context, certificationID string) (*entities.FaceVerifyRecord, error)
+
+	// 复杂查询 - 使用查询参数
+	ListRecords(ctx context.Context, query *queries.ListFaceVerifyRecordsQuery) ([]*entities.FaceVerifyRecord, int64, error)
+
+	// 统计信息
+	GetSuccessRate(ctx context.Context, days int) (float64, error)
+}
+
+// ContractRecordRepository 合同记录仓储接口
+type ContractRecordRepository interface {
+	interfaces.Repository[entities.ContractRecord]
+
+	// 基础查询 - 直接使用实体
+	GetByCertificationID(ctx context.Context, certificationID string) ([]*entities.ContractRecord, error)
+	GetLatestByCertificationID(ctx context.Context, certificationID string) (*entities.ContractRecord, error)
+
+	// 复杂查询 - 使用查询参数
+	ListRecords(ctx context.Context, query *queries.ListContractRecordsQuery) ([]*entities.ContractRecord, int64, error)
+
+	// 业务操作
+	UpdateContractStatus(ctx context.Context, recordID string, status string, adminID *string, notes string) error
+}
+
+// LicenseUploadRecordRepository 营业执照上传记录仓储接口
+type LicenseUploadRecordRepository interface {
+	interfaces.Repository[entities.LicenseUploadRecord]
+
+	// 基础查询 - 直接使用实体
+	GetByCertificationID(ctx context.Context, certificationID string) (*entities.LicenseUploadRecord, error)
+
+	// 复杂查询 - 使用查询参数
+	ListRecords(ctx context.Context, query *queries.ListLicenseUploadRecordsQuery) ([]*entities.LicenseUploadRecord, int64, error)
+
+	// 业务操作
+	UpdateOCRResult(ctx context.Context, recordID string, ocrResult string, confidence float64) error
+}
+
+// NotificationRecordRepository 通知记录仓储接口
+type NotificationRecordRepository interface {
+	interfaces.Repository[entities.NotificationRecord]
+
+	// 基础查询 - 直接使用实体
+	GetByCertificationID(ctx context.Context, certificationID string) ([]*entities.NotificationRecord, error)
+	GetUnreadByUserID(ctx context.Context, userID string) ([]*entities.NotificationRecord, error)
+
+	// 复杂查询 - 使用查询参数
+	ListRecords(ctx context.Context, query *queries.ListNotificationRecordsQuery) ([]*entities.NotificationRecord, int64, error)
+
+	// 批量操作
+	BatchCreate(ctx context.Context, records []entities.NotificationRecord) error
+	MarkAsRead(ctx context.Context, recordIDs []string) error
+	MarkAllAsReadByUser(ctx context.Context, userID string) error
+}