namespace Bifrost.Web.Domain;
/// The whole lifecycle of an account merge, declared once; later cuts add columns, not states. Stored as a string.
public enum AccountMergeState
{
Proposed,
Confirmed,
HeimdallMoved,
Committed,
Final,
UndoRequested,
HeimdallReversed,
Undone,
Failed
}
public enum AccountMergeEntryKind
{
Vote,
ConceptAppraisal,
Membership,
Standing,
PatronSupportEvent
}
public enum AccountMergeEntryAction
{
Voided,
Moved,
Closed,
Suspended,
Created,
Restored,
KeptAfterUndo
}
///
/// The merge receipt: two Heimdall-backed accounts, one survivor. Whether an account is folded or frozen is derived from this row's
/// State on every request (AccountMergeLedger.StandingAsync); no column on the account says so.
///
public sealed class AccountMerge
{
public Guid Id { get; set; } = Guid.NewGuid();
public AccountMergeState State { get; set; } = AccountMergeState.Proposed;
public Guid SurvivorUserAccountId { get; set; }
public Guid FoldedUserAccountId { get; set; }
public DateTimeOffset CreatedUtc { get; set; }
public DateTimeOffset? CommittedUtc { get; set; }
public DateTimeOffset? GraceEndsUtc { get; set; }
public DateTimeOffset? FinalizedUtc { get; set; }
public DateTimeOffset? UndoneUtc { get; set; }
public DateTimeOffset? FailedUtc { get; set; }
public string FailureCode { get; set; } = string.Empty;
// ---- the saga's columns (AccountMergeSaga is their one writer; docs/account-merge.md, Saga) ----
/// Heimdall's idempotency key of the forward move: random, minted in the save that enters Confirmed, never derived from , never re-minted.
public string? HeimdallMoveId { get; set; }
/// The same for the reversal, minted in the save that enters UndoRequested.
public string? HeimdallReverseMoveId { get; set; }
/// The Heimdall bearers the move or reversal will replay, protected; non-null only from Confirmed/UndoRequested until Heimdall's final answer.
public string? SealedProofs { get; set; }
/// Digest of the plan the member saw when confirming (MergePlan.Digest); with the next four columns it is the consent record.
public string PreviewDigest { get; set; } = string.Empty;
public Guid? ConfirmedByUserAccountId { get; set; }
public DateTimeOffset? ConfirmedUtc { get; set; }
public string SurvivorProofProvider { get; set; } = string.Empty;
/// The providers of the folded side's proofs, sorted and comma-joined.
public string FoldedProofProviders { get; set; } = string.Empty;
/// The proof tiers Heimdall's receipt named (weak or strong); ProofToTier is null for a receipt without one.
public string? ProofFromTier { get; set; }
public string? ProofToTier { get; set; }
/// The logins the forward move carried, a JSON array of Heimdall identity ids, from the receipt.
public string? MovedIdentityIds { get; set; }
public int Attempts { get; set; }
public DateTimeOffset? NextAttemptUtc { get; set; }
/// The last Heimdall answer's class or refusal code, or the saga's own stall code; never an input value.
public string LastOutcome { get; set; } = string.Empty;
public DateTimeOffset? UndoRequestedUtc { get; set; }
public DateTimeOffset? ReversedUtc { get; set; }
public ICollection Entries { get; set; } = [];
}
/// Append-only journal of what a merge did to one record; undo and the later preview read it, tallies and gates never do.
public sealed class AccountMergeEntry
{
public Guid Id { get; set; } = Guid.NewGuid();
public Guid MergeId { get; set; }
public int Seq { get; set; }
public AccountMergeEntryKind Kind { get; set; }
public Guid RecordId { get; set; }
public AccountMergeEntryAction Action { get; set; }
public Guid? PriorUserAccountId { get; set; }
/// What the record held before: the prior status; for a moved vote its weight; for a moved appraisal its voter class and key (class|key).
public string? PriorText { get; set; }
/// The cast time of a moved vote or appraisal, so undo can tell whether the survivor re-cast it.
public DateTimeOffset? PriorAtUtc { get; set; }
public DateTimeOffset AtUtc { get; set; }
public AccountMerge Merge { get; set; } = null!;
}