models

type Article struct {
	// ID is a unique identifier for the article, typically generated from URL or content hash
	ID string `json:"id" validate:"required"`

	// Title is the article headline or title
	Title string `json:"title" validate:"required,min=1,max=500"`

	// URL is the original article URL
	URL string `json:"url" validate:"required,url"`

	// Source identifies the publication or website name
	Source string `json:"source" validate:"required,min=1,max=100"`

	// SourceType indicates the collection method: rss, api, or html
	SourceType string `json:"sourceType" validate:"required,oneof=rss api html"`

	// PublishedAt is the article publication timestamp
	PublishedAt time.Time `json:"publishedAt" validate:"required"`

	// Summary is the article summary or excerpt (50-150 characters recommended)
	Summary string `json:"summary" validate:"min=10,max=1000"`

	// Content is the full article text (optional, excluded from JSON by default for size)
	Content string `json:"content,omitempty"`

	// Tags are relevant keywords or categories associated with the article
	Tags []string `json:"tags"`

	// Relevance score (0.0-1.0) calculated based on content matching
	Relevance float64 `json:"relevance" validate:"min=0,max=1"`

	// Quality score (0.0-1.0) based on content completeness and source credibility
	Quality float64 `json:"quality" validate:"min=0,max=1"`

	// Metadata contains additional source-specific information
	Metadata map[string]interface{} `json:"metadata"`
}

type Repository struct {
	// ID is a unique identifier for the repository, typically generated from FullName
	ID string `json:"id" validate:"required"`

	// Name is the repository name (without owner)
	Name string `json:"name" validate:"required,min=1,max=100"`

	// FullName is the complete repository identifier including owner (e.g., "owner/repo")
	FullName string `json:"fullName" validate:"required,min=1,max=200"`

	// Description is the repository description or summary
	Description string `json:"description" validate:"max=1000"`

	// URL is the repository homepage URL
	URL string `json:"url" validate:"required,url"`

	// Language is the primary programming language of the repository
	Language string `json:"language" validate:"max=50"`

	// Stars is the number of stars/likes the repository has received
	Stars int `json:"stars" validate:"min=0"`

	// Forks is the number of times the repository has been forked
	Forks int `json:"forks" validate:"min=0"`

	// TrendScore is a calculated score indicating the repository's trending status (0.0-1.0)
	TrendScore float64 `json:"trendScore" validate:"min=0,max=1"`

	// UpdatedAt is the timestamp of the last repository update
	UpdatedAt time.Time `json:"updatedAt" validate:"required"`

	// Metadata stores additional key-value data for extensibility
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}