storage

type ArticleContent struct {
	ArticleID   int64
	ContentType string
	FileName    string
	FileSize    int64
	Content     []byte
	Metadata    map[string]string
	CreatedTime time.Time
	CreatedBy   int
}

type Backend interface {
	// Store saves article content and returns a storage reference
	Store(ctx context.Context, articleID int64, content *ArticleContent) (*StorageReference, error)

	// Retrieve gets article content by reference
	Retrieve(ctx context.Context, ref *StorageReference) (*ArticleContent, error)

	// Delete removes article content
	Delete(ctx context.Context, ref *StorageReference) error

	// Exists checks if article content exists
	Exists(ctx context.Context, ref *StorageReference) (bool, error)

	// List returns all storage references for an article
	List(ctx context.Context, articleID int64) ([]*StorageReference, error)

	// Migrate moves content between backends
	Migrate(ctx context.Context, ref *StorageReference, target Backend) (*StorageReference, error)

	// GetInfo returns backend information
	GetInfo() *BackendInfo

	// HealthCheck verifies backend is operational
	HealthCheck(ctx context.Context) error
}

type BackendConstructor func(config map[string]interface{}) (Backend, error)

type BackendInfo struct {
	Name         string
	Type         string
	Capabilities []string
	Status       string
	Statistics   *BackendStats
}

type BackendStats struct {
	TotalFiles   int64
	TotalSize    int64
	FreeSpace    int64
	ReadLatency  time.Duration
	WriteLatency time.Duration
}

type Config struct {
	// Backend type: "DB" or "FS"
	Backend string

	// Filesystem backend settings
	FSBasePath string

	// Mixed mode settings
	CheckAllBackends bool

	// Migration settings
	MigrationBatchSize int
	MigrationSleepMs   int

	// Database connection (for both backends)
	DB *sql.DB
}

type DatabaseBackend struct {
	// contains filtered or unexported fields
}

type Factory interface {
	// Create instantiates a storage backend
	Create(backendType string, config map[string]interface{}) (Backend, error)

	// Register adds a new backend type
	Register(backendType string, constructor BackendConstructor)

	// List returns available backend types
	List() []string
}

type FilesystemBackend struct {
	// contains filtered or unexported fields
}

type MixedModeBackend struct {
	// contains filtered or unexported fields
}

type StorageFactory struct {
	// contains filtered or unexported fields
}

type StorageReference struct {
	ID           int64
	ArticleID    int64
	Backend      string
	Location     string
	ContentType  string
	FileName     string
	FileSize     int64
	Checksum     string
	CreatedTime  time.Time
	AccessedTime time.Time
}

type StreamingBackend interface {
	Backend

	// StoreStream saves content from a reader
	StoreStream(ctx context.Context, articleID int64, reader io.Reader, metadata *ArticleContent) (*StorageReference, error)

	// RetrieveStream gets content as a reader
	RetrieveStream(ctx context.Context, ref *StorageReference) (io.ReadCloser, error)
}