comment

type Comment struct {
	bun.BaseModel `bun:"table:comments,alias:cm"`

	ID          int64     `bun:"id,pk,autoincrement" json:"id"`
	PostID      int64     `bun:"post_id,notnull"     json:"postId"`
	ParentID    *int64    `bun:"parent_id"           json:"parentId" doc:"父评论 ID，顶层评论为 null"`
	UserID      *int64    `bun:"user_id"             json:"userId" doc:"已登录用户的 ID；访客评论为 null"`
	AuthorName  string    `bun:"author_name,notnull" json:"authorName"`
	AuthorEmail string    `bun:"author_email"        json:"authorEmail" doc:"仅 Console 可见"`
	AuthorURL   string    `bun:"author_url"          json:"authorUrl"`
	Content     string    `bun:"content,notnull"     json:"content" doc:"访客提交的原文，纯文本"`
	ContentHTML string    `bun:"content_html"        json:"contentHtml" doc:"转义并线性化后的展示版本"`
	Status      Status    `bun:"status,notnull"      json:"status" enum:"pending,approved,spam"`
	IP          string    `bun:"ip"                  json:"ip" doc:"仅 Console 可见"`
	UserAgent   string    `bun:"user_agent"          json:"userAgent" doc:"仅 Console 可见"`
	CreatedAt   time.Time `bun:"created_at,nullzero" json:"createdAt"`
	UpdatedAt   time.Time `bun:"updated_at,nullzero" json:"updatedAt"`

	// 以下为关联数据，由存储层按需填充，不是数据库列。
	Post *PostRef `bun:"-" json:"post,omitempty"`
}

type ConfigFunc func(ctx context.Context) Settings

type DefaultChecker struct{}

type Filter struct {
	Status Status
	PostID int64
	// AuthorID 非零时只返回该作者名下内容的评论，用于不带 _any 权限的调用者。
	AuthorID int64
	Q        string
}

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

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

type Notifier interface {
	CommentCreated(ctx context.Context, event *NotifyEvent)
}

type NotifyEvent struct {
	Comment *Comment
	Post    *PostRef
	// Settings 是判定时的评论设置，避免通知侧再读一次。
	Settings Settings
	// AutoApproved 为真表示该评论已直接展示，通知里不必再提「待审核」。
	AutoApproved bool
	// Parent 是被回复的评论，仅在这是一条回复时有值。
	Parent *Comment
}

type PostRef struct {
	ID       int64  `json:"id"`
	Type     string `json:"type"`
	Title    string `json:"title"`
	Slug     string `json:"slug"`
	AuthorID int64  `json:"authorId"`
	// Status 与 Visibility 供前台接口复刻正文的可见性规则。
	Status     string `json:"-"`
	Visibility string `json:"-"`
}

type PublicView struct {
	ID          int64         `json:"id"`
	ParentID    *int64        `json:"parentId"`
	AuthorName  string        `json:"authorName"`
	AuthorURL   string        `json:"authorUrl"`
	ContentHTML string        `json:"contentHtml" doc:"已转义的展示 HTML，主题直出即可"`
	IsAuthor    bool          `json:"isAuthor" doc:"是否为该内容的作者本人所发"`
	CreatedAt   time.Time     `json:"createdAt"`
	Children    []*PublicView `json:"children" doc:"回复，按时间正序"`
}

type Settings struct {
	Enabled         bool   `json:"enabled"`
	AllowAnonymous  bool   `json:"allowAnonymous"`
	RequireEmail    bool   `json:"requireEmail"`
	RequireApproval bool   `json:"requireApproval"`
	MaxLength       int    `json:"maxLength"`
	IntervalSeconds int    `json:"intervalSeconds"`
	MaxLinks        int    `json:"maxLinks"`
	Blocklist       string `json:"blocklist"`
	NotifyNew       bool   `json:"notifyNew"`
	NotifyReply     bool   `json:"notifyReply"`
	NotifyTo        string `json:"notifyTo"`
}

type SpamChecker interface {
	Check(cfg *Settings, in *SpamInput) Verdict
}

type SpamInput struct {
	AuthorName string
	AuthorURL  string
	Content    string
	// Honeypot 是表单里的隐藏字段：正常访客看不见也不会填，填了的必是机器人。
	Honeypot string
	// LastFromIP 是同一 IP 的上一条评论时间，零值表示没有。
	LastFromIP time.Time
	Now        time.Time
}

type Status string

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

type Verdict struct {
	// Spam 为真时直接标为垃圾，不进审核队列。
	Spam bool
	// Reason 说明判据，写进日志便于调规则。
	Reason string
}