content

type AuthorView struct {
	ID          int64  `json:"id"`
	Username    string `json:"username"`
	DisplayName string `json:"displayName"`
	AvatarURL   string `json:"avatarUrl"`
}

type Filter struct {
	Type Type
	// Status 为空表示回收站之外的全部状态。
	Status Status
	// AuthorID 非 0 时只取该作者的内容。
	AuthorID int64
	// CategorySlug / TagSlug 非空时按分类或标签筛选。
	CategorySlug string
	TagSlug      string
	// Query 非空时按标题模糊匹配。
	Query string
	// PublicOnly 为真时只取已发布内容：公开的，或属于 ViewerID 的私密内容。
	PublicOnly bool
	ViewerID   int64
}

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

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

type Post struct {
	bun.BaseModel `bun:"table:posts,alias:p"`

	ID          int64          `bun:"id,pk,autoincrement" json:"id"`
	Type        Type           `bun:"type,notnull"        json:"type" enum:"post,page"`
	Title       string         `bun:"title,notnull"       json:"title"`
	Slug        string         `bun:"slug,notnull"        json:"slug" doc:"URL 片段，同类型内唯一"`
	Status      Status         `bun:"status,notnull"      json:"status" enum:"draft,published,scheduled,trashed"`
	Visibility  Visibility     `bun:"visibility,notnull"  json:"visibility" enum:"public,private"`
	RawType     RawType        `bun:"raw_type,notnull"    json:"rawType" enum:"html,markdown" doc:"原稿格式"`
	Raw         string         `bun:"raw"                 json:"raw" doc:"原稿：Markdown 源码或规范 HTML"`
	Content     string         `bun:"content"             json:"content" doc:"渲染后的 HTML，主题只消费此字段"`
	Excerpt     string         `bun:"excerpt"             json:"excerpt"`
	ExcerptAuto bool           `bun:"excerpt_auto"        json:"excerptAuto" doc:"摘要是否由正文自动生成"`
	CoverURL    string         `bun:"cover_url"           json:"coverUrl"`
	Pinned      bool           `bun:"pinned"              json:"pinned"`
	Template    string         `bun:"template"            json:"template" doc:"页面模板名，如 page-about；空为默认"`
	AuthorID    int64          `bun:"author_id,notnull"   json:"authorId"`
	PublishedAt *time.Time     `bun:"published_at"        json:"publishedAt" doc:"发布时间；定时发布时为计划时间"`
	TrashedAt   *time.Time     `bun:"trashed_at"          json:"trashedAt"`
	Meta        map[string]any `bun:"meta,type:jsonb"     json:"meta" doc:"扩展元数据"`
	CreatedAt   time.Time      `bun:"created_at,nullzero" json:"createdAt"`
	UpdatedAt   time.Time      `bun:"updated_at,nullzero" json:"updatedAt"`

	// 以下为关联数据，由存储层按需填充，不是数据库列。
	Author     *AuthorView         `bun:"-" json:"author,omitempty"`
	Categories []taxonomy.Category `bun:"-" json:"categories"`
	Tags       []taxonomy.Tag      `bun:"-" json:"tags"`
}

type PostCategory struct {
	bun.BaseModel `bun:"table:post_categories,alias:pc"`

	PostID     int64 `bun:"post_id,pk"`
	CategoryID int64 `bun:"category_id,pk"`
}

type PostTag struct {
	bun.BaseModel `bun:"table:post_tags,alias:pt"`

	PostID int64 `bun:"post_id,pk"`
	TagID  int64 `bun:"tag_id,pk"`
}

type RawType string

type Revision struct {
	bun.BaseModel `bun:"table:post_revisions,alias:rv"`

	ID        int64     `bun:"id,pk,autoincrement" json:"id"`
	PostID    int64     `bun:"post_id,notnull"     json:"postId"`
	AuthorID  *int64    `bun:"author_id"           json:"authorId" doc:"保存该版本的用户；用户已删除时为 null"`
	Title     string    `bun:"title,notnull"       json:"title"`
	RawType   RawType   `bun:"raw_type,notnull"    json:"rawType" enum:"html,markdown"`
	Raw       string    `bun:"raw"                 json:"raw"`
	Content   string    `bun:"content"             json:"content"`
	Excerpt   string    `bun:"excerpt"             json:"excerpt"`
	CreatedAt time.Time `bun:"created_at,nullzero" json:"createdAt"`
}

type RevisionSummary struct {
	bun.BaseModel `bun:"table:post_revisions,alias:rv"`

	ID        int64     `bun:"id,pk"            json:"id"`
	PostID    int64     `bun:"post_id"          json:"postId"`
	AuthorID  *int64    `bun:"author_id"        json:"authorId"`
	Title     string    `bun:"title"            json:"title"`
	RawType   RawType   `bun:"raw_type"         json:"rawType" enum:"html,markdown"`
	CreatedAt time.Time `bun:"created_at,nullzero" json:"createdAt"`
}

type Slugger func(ctx context.Context, text string) string

type Status string

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

type Type string

type Visibility string

type WriteParams struct {
	Title string `json:"title"`
	// Slug 留空时新建按站点策略由标题生成、修改保留原值。
	Slug string `json:"slug"`
	// RawType 是原稿格式，缺省 html。
	RawType     RawType `json:"rawType"`
	Raw         string  `json:"raw"`
	Excerpt     string  `json:"excerpt"`
	CategoryIDs []int64 `json:"categoryIds"`
	TagIDs      []int64 `json:"tagIds"`
}

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