backbone-mailing 0.6.0

Email marketing — mass-mail engine: audiences, subscriptions, hand-set mailing lifecycle, seeded A/B testing, per-recipient traces, cycle-44 bridge targets (Odoo mass_mailing port)
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
//! Public types for Mailing module
//!
//! Generated by metaphor-schema. Do not edit manually.
//!
//! These DTOs are the ONLY types other modules should use.
//! They are decoupled from internal domain entities.

use serde::{Deserialize, Serialize};
use uuid::Uuid;
use chrono::{DateTime, Utc};
use crate::domain::entity::*;

// ============================================================================
// MAILINGABTEST TYPES
// ============================================================================

/// Type-safe ID for MailingAbTest
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingAbTestId(pub Uuid);

impl MailingAbTestId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingAbTestId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingAbTestId> for Uuid {
    fn from(id: MailingAbTestId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingAbTest
///
/// This is the public representation of MailingAbTest for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAbTestDto {
    pub id: MailingAbTestId,
    pub campaign_id: Uuid,
    pub winner_selection: AbWinnerSelection,
    pub winner_selection_sms: Option<AbWinnerSelection>,
    pub promote_at: Option<DateTime<Utc>>,
    pub completed: bool,
    pub winner_mailing_id: Option<Uuid>,
    pub sampling_seed: String,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingAbTest for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAbTestSummary {
    pub id: MailingAbTestId,
}

/// Reference to MailingAbTest for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAbTestRef {
    pub id: MailingAbTestId,
}

// ============================================================================
// MAILINGAUDIENCE TYPES
// ============================================================================

/// Type-safe ID for MailingAudience
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingAudienceId(pub Uuid);

impl MailingAudienceId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingAudienceId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingAudienceId> for Uuid {
    fn from(id: MailingAudienceId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingAudience
///
/// This is the public representation of MailingAudience for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAudienceDto {
    pub id: MailingAudienceId,
    pub name: String,
    pub active: bool,
    pub is_public: bool,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingAudience for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAudienceSummary {
    pub id: MailingAudienceId,
    pub name: String,
}

/// Reference to MailingAudience for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingAudienceRef {
    pub id: MailingAudienceId,
}

// ============================================================================
// MAILINGCONTACT TYPES
// ============================================================================

/// Type-safe ID for MailingContact
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingContactId(pub Uuid);

impl MailingContactId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingContactId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingContactId> for Uuid {
    fn from(id: MailingContactId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingContact
///
/// This is the public representation of MailingContact for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingContactDto {
    pub id: MailingContactId,
    pub name: Option<String>,
    pub first_name: Option<String>,
    pub last_name: Option<String>,
    pub email: String,
    pub company_name: Option<String>,
    pub country_code: Option<String>,
    pub phone: Option<String>,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingContact for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingContactSummary {
    pub id: MailingContactId,
    pub name: Option<String>,
    pub first_name: Option<String>,
    pub last_name: Option<String>,
    pub email: String,
    pub company_name: Option<String>,
}

/// Reference to MailingContact for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingContactRef {
    pub id: MailingContactId,
}

// ============================================================================
// MAILINGSUBSCRIPTION TYPES
// ============================================================================

/// Type-safe ID for MailingSubscription
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingSubscriptionId(pub Uuid);

impl MailingSubscriptionId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingSubscriptionId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingSubscriptionId> for Uuid {
    fn from(id: MailingSubscriptionId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingSubscription
///
/// This is the public representation of MailingSubscription for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingSubscriptionDto {
    pub id: MailingSubscriptionId,
    pub contact_id: Uuid,
    pub mailing_audience_id: Uuid,
    pub opt_out: bool,
    pub opt_out_datetime: Option<DateTime<Utc>>,
    pub opt_out_reason_id: Option<Uuid>,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingSubscription for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingSubscriptionSummary {
    pub id: MailingSubscriptionId,
}

/// Reference to MailingSubscription for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingSubscriptionRef {
    pub id: MailingSubscriptionId,
}

// ============================================================================
// OPTOUTREASON TYPES
// ============================================================================

/// Type-safe ID for OptOutReason
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct OptOutReasonId(pub Uuid);

impl OptOutReasonId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for OptOutReasonId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<OptOutReasonId> for Uuid {
    fn from(id: OptOutReasonId) -> Self {
        id.0
    }
}

/// Data transfer object for OptOutReason
///
/// This is the public representation of OptOutReason for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OptOutReasonDto {
    pub id: OptOutReasonId,
    pub name: String,
    pub sequence: i32,
    pub is_feedback: bool,
    pub metadata: serde_json::Value,
}

/// Summary view of OptOutReason for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OptOutReasonSummary {
    pub id: OptOutReasonId,
    pub name: String,
}

/// Reference to OptOutReason for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OptOutReasonRef {
    pub id: OptOutReasonId,
}

// ============================================================================
// MAILING TYPES
// ============================================================================

/// Type-safe ID for Mailing
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingId(pub Uuid);

impl MailingId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingId> for Uuid {
    fn from(id: MailingId) -> Self {
        id.0
    }
}

/// Data transfer object for Mailing
///
/// This is the public representation of Mailing for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingDto {
    pub id: MailingId,
    pub subject: String,
    pub preview: Option<String>,
    pub body_html: String,
    pub body_plaintext: Option<String>,
    pub email_from: String,
    pub reply_to: Option<String>,
    pub keep_archives: bool,
    pub state: MailingState,
    pub schedule_type: MailingScheduleType,
    pub schedule_date: Option<DateTime<Utc>>,
    pub sent_date: Option<DateTime<Utc>>,
    pub mailing_type: MailingType,
    pub target_model: MailingTargetModel,
    pub mailing_domain: serde_json::Value,
    pub use_exclusion_list: bool,
    pub campaign_id: Option<Uuid>,
    pub medium_id: Option<Uuid>,
    pub source_id: Option<Uuid>,
    pub user_id: Option<Uuid>,
    pub ab_testing_enabled: bool,
    pub ab_testing_pc: i32,
    pub ab_test_id: Option<Uuid>,
    pub kpi_mail_required: bool,
    pub metadata: serde_json::Value,
}

/// Summary view of Mailing for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingSummary {
    pub id: MailingId,
}

/// Reference to Mailing for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingRef {
    pub id: MailingId,
}

// ============================================================================
// MAILINGTRACE TYPES
// ============================================================================

/// Type-safe ID for MailingTrace
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingTraceId(pub Uuid);

impl MailingTraceId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingTraceId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingTraceId> for Uuid {
    fn from(id: MailingTraceId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingTrace
///
/// This is the public representation of MailingTrace for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingTraceDto {
    pub id: MailingTraceId,
    pub trace_type: TraceType,
    pub is_test_trace: bool,
    pub mailing_id: Uuid,
    pub campaign_id: Option<Uuid>,
    pub recipient_model: String,
    pub recipient_id: Uuid,
    pub recipient_email: String,
    pub mail_id: Option<Uuid>,
    pub sms_uuid: Option<String>,
    pub recipient_phone: Option<String>,
    pub message_id: Option<String>,
    pub trace_status: TraceStatus,
    pub failure_type: Option<TraceFailureType>,
    pub failure_reason: Option<String>,
    pub sent_datetime: Option<DateTime<Utc>>,
    pub open_datetime: Option<DateTime<Utc>>,
    pub reply_datetime: Option<DateTime<Utc>>,
    pub links_click_datetime: Option<DateTime<Utc>>,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingTrace for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingTraceSummary {
    pub id: MailingTraceId,
}

/// Reference to MailingTrace for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingTraceRef {
    pub id: MailingTraceId,
}

// ============================================================================
// MAILINGFILTER TYPES
// ============================================================================

/// Type-safe ID for MailingFilter
///
/// Use this instead of raw Uuid for type safety across modules.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub struct MailingFilterId(pub Uuid);

impl MailingFilterId {
    pub fn new(id: Uuid) -> Self {
        Self(id)
    }

    pub fn into_inner(self) -> Uuid {
        self.0
    }
}

impl From<Uuid> for MailingFilterId {
    fn from(id: Uuid) -> Self {
        Self(id)
    }
}

impl From<MailingFilterId> for Uuid {
    fn from(id: MailingFilterId) -> Self {
        id.0
    }
}

/// Data transfer object for MailingFilter
///
/// This is the public representation of MailingFilter for other modules.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingFilterDto {
    pub id: MailingFilterId,
    pub name: String,
    pub target_model: MailingTargetModel,
    pub domain: serde_json::Value,
    pub metadata: serde_json::Value,
}

/// Summary view of MailingFilter for list displays
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingFilterSummary {
    pub id: MailingFilterId,
    pub name: String,
}

/// Reference to MailingFilter for foreign key relationships
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MailingFilterRef {
    pub id: MailingFilterId,
}

// ============================================================================
// CUSTOM TYPES
// ============================================================================

// <<< CUSTOM TYPES START >>>
// Add custom public types here
// <<< CUSTOM TYPES END >>>