chore: init project

src/InboxIntel.Domain/Entities/Email.cs

@@ -0,0 +1,59 @@
+using InboxIntel.Domain.Common;
+using InboxIntel.Domain.Enums;
+
+namespace InboxIntel.Domain.Entities;
+
+/// <summary>
+/// A single Gmail message stored locally. Designed for 100k+ rows per user:
+/// search fields are indexed (see EmailConfiguration) and a generated
+/// tsvector column backs PostgreSQL full-text search.
+/// </summary>
+public class Email : AuditableEntity
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+    public Guid UserId { get; set; }
+
+    /// <summary>Gmail message id (stable, unique per account).</summary>
+    public string GmailMessageId { get; set; } = string.Empty;
+
+    public Guid ThreadId { get; set; }
+    public MailThread? Thread { get; set; }
+
+    public Guid SenderId { get; set; }
+    public Sender? Sender { get; set; }
+
+    public string? Subject { get; set; }
+    public string? Snippet { get; set; }
+
+    /// <summary>Plain-text body. Indexed for FTS via SearchVector.</summary>
+    public string? BodyText { get; set; }
+
+    public DateTimeOffset SentAtUtc { get; set; }
+    public DateTimeOffset? ReceivedAtUtc { get; set; }
+
+    public long SizeEstimateBytes { get; set; }
+
+    public bool IsUnread { get; set; }
+    public bool IsStarred { get; set; }
+    public bool IsImportant { get; set; }
+    public bool IsInInbox { get; set; }
+    public bool IsTrashed { get; set; }
+    public bool HasAttachments { get; set; }
+
+    // Unsubscribe signals captured at parse time.
+    public bool HasListUnsubscribe { get; set; }
+    public string? ListUnsubscribeRaw { get; set; }
+    public bool SupportsOneClickUnsubscribe { get; set; }
+
+    /// <summary>Heuristic/AI classification. Defaults to Unknown until classified.</summary>
+    public EmailCategory Category { get; set; } = EmailCategory.Unknown;
+
+    /// <summary>
+    /// PostgreSQL tsvector, maintained as a generated column. Never set in code;
+    /// mapped read-only for querying. Nullable so non-Postgres test providers work.
+    /// </summary>
+    public NpgsqlTypes.NpgsqlTsVector? SearchVector { get; set; }
+
+    public ICollection<EmailLabel> EmailLabels { get; set; } = new List<EmailLabel>();
+    public ICollection<Attachment> Attachments { get; set; } = new List<Attachment>();
+}