package model // Post kinds. "long" is a normal article; "short" is a Twitter-like note // with no title shown in the timeline. const ( KindLong = "long" KindShort = "short" ) const ( StatusDraft = "draft" StatusPublished = "published" ) type Post struct { ID int64 `json:"id"` Kind string `json:"kind"` Title string `json:"title"` Slug string `json:"slug"` Summary string `json:"summary"` CoverURL string `json:"cover_url"` ContentMd string `json:"content_md,omitempty"` ContentHTML string `json:"content_html"` Status string `json:"status"` PublishedAt string `json:"published_at"` CreatedAt string `json:"created_at"` UpdatedAt string `json:"updated_at"` ReadingMinutes int `json:"reading_minutes"` // ContentLen 是正文字符数:列表接口不返回全文,但后台列表要显示字数。 ContentLen int64 `json:"content_len"` Tags []string `json:"tags"` // Images 是短文配图(快发盒上传,≤4 张,Twitter 式网格展示), // 以 JSON 数组存在 posts.images 列里,正文 content_md 不含它们。 Images []string `json:"images"` } type PostInput struct { Kind string `json:"kind"` Title string `json:"title"` Slug string `json:"slug"` Summary string `json:"summary"` CoverURL string `json:"cover_url"` ContentMd string `json:"content_md"` Status string `json:"status"` PublishedAt string `json:"published_at"` Tags []string `json:"tags"` ReadingMinutes *int `json:"reading_minutes"` // Images 是短文配图 URL(快发盒上传),nil = 不修改、空数组 = 清空 Images []string `json:"images"` } type Tag struct { ID int64 `json:"id"` Name string `json:"name"` Slug string `json:"slug"` Color string `json:"color"` Count int `json:"count"` } // Project is a showcase entry rendered on the public /projects page. It links // out to an external homepage and (optionally) a source repository. type Project struct { ID int64 `json:"id"` Title string `json:"title"` Slug string `json:"slug"` Summary string `json:"summary"` CoverURL string `json:"cover_url"` URL string `json:"url"` RepoURL string `json:"repo_url"` Status string `json:"status"` Position int `json:"position"` CreatedAt string `json:"created_at"` UpdatedAt string `json:"updated_at"` } // ProjectInput carries the editable fields for a project. A blank Slug or // Status is filled in by the store (slug from Title, status defaults to // published) so the admin UI can omit them. type ProjectInput struct { Title string `json:"title"` Slug string `json:"slug"` Summary string `json:"summary"` CoverURL string `json:"cover_url"` URL string `json:"url"` RepoURL string `json:"repo_url"` Status string `json:"status"` Position int `json:"position"` } type ArchiveMonth struct { Month string `json:"month"` Posts []Post `json:"posts"` } type ArchiveYear struct { Year string `json:"year"` Months []ArchiveMonth `json:"months"` Count int `json:"count"` } type Page struct { Items []Post `json:"items"` Total int `json:"total"` Page int `json:"page"` Size int `json:"size"` } // File 是一条上传文件的索引行。内容本体在对象存储里(store 字段记来源: // r2 | local),key 是存储端的对象名,URL 由 API 层按「来源 + PublicBase」 // 在响应时解析——切存储端不破坏存量链接。 type File struct { ID int64 `json:"id"` Key string `json:"key"` Name string `json:"name"` Mime string `json:"mime"` Size int64 `json:"size"` SHA256 string `json:"sha256"` Store string `json:"store"` URL string `json:"url"` CreatedAt string `json:"created_at"` } // FilePage 是文件管理的分页容器(Items 用 File,与文章的 Page 区分开)。 type FilePage struct { Items []File `json:"items"` Total int `json:"total"` Page int `json:"page"` Size int `json:"size"` } // CommentPage 是后台评论管理的分页容器(含文章标题与发表者)。 type CommentPage struct { Items []Comment `json:"items"` Total int `json:"total"` Page int `json:"page"` Size int `json:"size"` } // Dashboard is the snapshot rendered on /admin (homepage). type Dashboard struct { TotalPosts int `json:"total_posts"` PublishedPosts int `json:"published_posts"` DraftPosts int `json:"draft_posts"` ShortPosts int `json:"short_posts"` LongPosts int `json:"long_posts"` TotalTags int `json:"total_tags"` TotalWords int `json:"total_words"` RecentPosts []Post `json:"recent_posts"` RecentDrafts []Post `json:"recent_drafts"` TopTags []Tag `json:"top_tags"` PublishedByMonth []MonthBucket `json:"published_by_month"` } type MonthBucket struct { Month string `json:"month"` // "YYYY-MM" Count int `json:"count"` } // SocialLink 是站主在后台填写的社交 / 源码入口(label + url), // 前台渲染成图标或文字链接。icon 不入库 —— 由前端按 url 域名推导。 type SocialLink struct { Label string `json:"label"` URL string `json:"url"` } type Settings struct { SiteTitle string `json:"site_title"` SiteDesc string `json:"site_desc"` AuthorName string `json:"author_name"` AuthorBio string `json:"author_bio"` FooterNote string `json:"footer_note"` ICPLicense string `json:"icp"` PostsPerPage int `json:"posts_per_page"` // SocialLinks 以 JSON 数组形式存在 settings KV 里(key: social_links), // 解析失败/为空时前台拿到空数组,区块自动隐藏。 SocialLinks []SocialLink `json:"social_links"` // 评论开关(comments_enabled):关着时前台整个评论区不渲染。 CommentsEnabled bool `json:"comments_enabled"` // 审核开关(comments_review):开着时新评论先进「待审」,站主通过后才公开。 CommentsReview bool `json:"comments_review"` // LightSkinID is the front-end skin used when the client (or system) // prefers light. Valid values: paper / sage / rose. // Dark side is fixed to ink for now — kept implicit so we can add // dark variants later without breaking clients. LightSkinID string `json:"light_skin_id"` // ThemeID is kept for backward compatibility with older clients that // only know about a single skin. settingsFromMap falls back to it // when LightSkinID is empty. ThemeID string `json:"theme_id,omitempty"` // UIID selects which front-end UI the whole site renders. Valid values // are "classic" (the original minimalist layout) and "vivid" (the // livelier one). The admin UI is unaffected by this — it always uses the // --admin-* tokens. UIID string `json:"ui_id"` // CustomCSS holds owner-authored stylesheets keyed by page section // ("global", "home", "post", "archive", "tags", "projects", "about"). // Only injected for the vivid UI, and never on /admin. Always non-nil so // the JSON response is {} rather than null. CustomCSS map[string]string `json:"custom_css"` // CustomJS holds owner-authored JavaScript (analytics snippets like // Google Analytics / Plausible / Umami). Injected on every public page // of either UI, never on /admin. Stored raw — it's the owner's own code, // sanitizing it would only break the snippet. CustomJS string `json:"custom_js"` } // Reader 是评论区的登录用户(GitHub OAuth)。Banned = 禁言中。 type Reader struct { ID int64 `json:"id"` Provider string `json:"provider"` Handle string `json:"handle"` Name string `json:"name"` AvatarURL string `json:"avatar_url"` URL string `json:"url"` Banned bool `json:"banned"` // CommentCount 是累计评论数(后台用户列表展示用) CommentCount int64 `json:"comment_count"` CreatedAt string `json:"created_at"` } // Comment 是一条评论。回复扁平存储(parent_id/root_id),渲染时挂到 replies。 // User 是发表者快照;is_deleted = 软删(留壳显示「已删除」,保住楼层上下文)。 type Comment struct { ID int64 `json:"id"` PostID int64 `json:"post_id"` ParentID int64 `json:"parent_id"` RootID int64 `json:"root_id"` User *Reader `json:"user"` UserID int64 `json:"user_id"` BodyMd string `json:"body_md"` BodyHTML string `json:"body_html"` Status string `json:"status"` IsDeleted bool `json:"is_deleted"` CreatedAt string `json:"created_at"` EditedAt string `json:"edited_at"` Replies []Comment `json:"replies"` ReplyCount int `json:"reply_count"` // PostTitle 是文章标题(后台评论列表联表带出,仅管理接口填充) PostTitle string `json:"post_title"` }