1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
////////////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2025 Haixing Hu
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
//
////////////////////////////////////////////////////////////////////////////////
//! Traits for audit information recording functionality
//!
//! # Author
//!
//! Haixing Hu
use crate::;
/// A trait indicating that an entity class has auditable properties
///
/// This trait combines the creation time, modification time, and deletion
/// time recording functionalities for complete audit tracking.
///
/// # Features
///
/// - Record creation time
/// - Record last modification time
/// - Record mark deletion time
///
/// # Example
///
/// ```rust
/// use chrono::{DateTime, Utc};
/// use qubit_mixin::{Auditable, Creatable, Modifiable, Deletable};
///
/// struct Order {
/// id: i64,
/// create_time: DateTime<Utc>,
/// modify_time: Option<DateTime<Utc>>,
/// delete_time: Option<DateTime<Utc>>,
/// }
///
/// impl Creatable for Order {
/// fn create_time(&self) -> DateTime<Utc> {
/// self.create_time
/// }
///
/// fn set_create_time(&mut self, time: DateTime<Utc>) {
/// self.create_time = time;
/// }
/// }
///
/// impl Modifiable for Order {
/// fn modify_time(&self) -> Option<DateTime<Utc>> {
/// self.modify_time
/// }
///
/// fn set_modify_time(&mut self, time: Option<DateTime<Utc>>) {
/// self.modify_time = time;
/// }
/// }
///
/// impl Deletable for Order {
/// fn delete_time(&self) -> Option<DateTime<Utc>> {
/// self.delete_time
/// }
///
/// fn set_delete_time(&mut self, time: Option<DateTime<Utc>>) {
/// self.delete_time = time;
/// }
/// }
///
/// impl Auditable for Order {}
///
/// let order = Order {
/// id: 1,
/// create_time: Utc::now(),
/// modify_time: None,
/// delete_time: None,
/// };
/// ```
///
/// # Author
///
/// Haixing Hu