yggdrasil/models/
comment.rs

1//! 评论模型。
2//!
3//! 定义评论状态、服务端内部使用的 Comment 结构体，
4//! 以及面向前端展示的 PublicComment 与面向后台管理的 AdminComment。
5
6use chrono::{DateTime, Utc};
7use serde::{Deserialize, Serialize};
8
9/// 评论审核状态枚举，序列化时使用小写字符串。
10#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
11#[serde(rename_all = "lowercase")]
12pub enum CommentStatus {
13    /// 待审核。
14    Pending,
15    /// 已通过。
16    Approved,
17    /// 垃圾评论。
18    Spam,
19    /// 已删除/回收站。
20    Trash,
21}
22
23impl CommentStatus {
24    /// 将数据库或 API 中的状态字符串解析为 CommentStatus，未知值默认回退到 Pending。
25    #[cfg(feature = "server")]
26    pub fn from_str(s: &str) -> Self {
27        match s {
28            "approved" => Self::Approved,
29            "spam" => Self::Spam,
30            "trash" => Self::Trash,
31            _ => Self::Pending,
32        }
33    }
34
35    /// 将 CommentStatus 序列化为小写字符串。
36    #[cfg(test)]
37    pub fn as_str(&self) -> &'static str {
38        match self {
39            Self::Pending => "pending",
40            Self::Approved => "approved",
41            Self::Spam => "spam",
42            Self::Trash => "trash",
43        }
44    }
45}
46
47/// 面向前端展示的评论结构体，已脱敏。
48#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
49pub struct PublicComment {
50    /// 评论主键。
51    pub id: i64,
52    /// 父评论主键，None 表示顶层评论。
53    pub parent_id: Option<i64>,
54    /// 嵌套深度。
55    pub depth: i32,
56    /// 评论者名称。
57    pub author_name: String,
58    /// 评论者个人主页 URL。
59    pub author_url: Option<String>,
60    /// 评论者头像 URL。
61    pub avatar_url: String,
62    /// 是否为登录用户（作者）发表的评论。
63    pub is_author: bool,
64    /// 渲染后的 HTML 内容。
65    pub content_html: Option<String>,
66    /// 用于展示的人类可读创建时间。
67    pub created_at: String,
68    /// ISO 8601 格式的创建时间。
69    pub created_at_iso: String,
70}
71
72/// 面向后台管理的评论结构体，包含审核所需字段。
73#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
74pub struct AdminComment {
75    /// 评论主键。
76    pub id: i64,
77    /// 所属文章主键。
78    pub post_id: i32,
79    /// 所属文章标题。
80    pub post_title: String,
81    /// 所属文章 slug。
82    pub post_slug: String,
83    /// 父评论主键。
84    pub parent_id: Option<i64>,
85    /// 嵌套深度。
86    pub depth: i32,
87    /// 评论者名称。
88    pub author_name: String,
89    /// 评论者邮箱。
90    pub author_email: String,
91    /// 评论者个人主页 URL。
92    pub author_url: Option<String>,
93    /// 评论者头像 URL。
94    pub avatar_url: String,
95    /// 原始 Markdown 内容。
96    pub content_md: String,
97    /// 当前审核状态。
98    pub status: CommentStatus,
99    /// 评论创建时间。
100    pub created_at: DateTime<Utc>,
101}
102
103#[cfg(test)]
104mod tests {
105    use super::*;
106
107    #[test]
108    #[cfg(feature = "server")]
109    fn comment_status_from_str() {
110        assert_eq!(CommentStatus::from_str("pending"), CommentStatus::Pending);
111        assert_eq!(CommentStatus::from_str("approved"), CommentStatus::Approved);
112        assert_eq!(CommentStatus::from_str("spam"), CommentStatus::Spam);
113        assert_eq!(CommentStatus::from_str("trash"), CommentStatus::Trash);
114    }
115
116    #[test]
117    #[cfg(feature = "server")]
118    fn comment_status_from_str_unknown_defaults_to_pending() {
119        assert_eq!(CommentStatus::from_str("unknown"), CommentStatus::Pending);
120        assert_eq!(CommentStatus::from_str(""), CommentStatus::Pending);
121    }
122
123    #[test]
124    fn comment_status_as_str() {
125        assert_eq!(CommentStatus::Pending.as_str(), "pending");
126        assert_eq!(CommentStatus::Approved.as_str(), "approved");
127        assert_eq!(CommentStatus::Spam.as_str(), "spam");
128        assert_eq!(CommentStatus::Trash.as_str(), "trash");
129    }
130
131    #[test]
132    fn comment_status_serde_roundtrip() {
133        let statuses = vec![
134            CommentStatus::Pending,
135            CommentStatus::Approved,
136            CommentStatus::Spam,
137            CommentStatus::Trash,
138        ];
139        for status in statuses {
140            let json = serde_json::to_string(&status).unwrap();
141            let expected = format!("\"{}\"", status.as_str());
142            assert_eq!(json, expected);
143            let deserialized: CommentStatus = serde_json::from_str(&json).unwrap();
144            assert_eq!(deserialized, status);
145        }
146    }
147
148    #[test]
149    fn comment_status_deserialize_from_lowercase() {
150        let pending: CommentStatus = serde_json::from_str("\"pending\"").unwrap();
151        assert_eq!(pending, CommentStatus::Pending);
152        let approved: CommentStatus = serde_json::from_str("\"approved\"").unwrap();
153        assert_eq!(approved, CommentStatus::Approved);
154    }
155}
yggdrasil/models/comment.rs

yggdrasil/models/
comment.rs
