Versioning Architecture Mermaid

Last modified by Robert Schaub on 2025/12/22 14:38

The [mermaid] macro is a standalone macro and it cannot be used inline. Click on this message for details.
== Explanation ==
Linear Versioning Only:

  • Each edit creates a new version (V1 → V2 → V3 → ... → VN)
  • No branching, no parallel versions
  • Simple sequential numbering
    Edit Records:
  • Every version change stored in EDIT table
  • Contains: before_state (JSON), after_state (JSON), user_id, reason, timestamp
  • Full audit trail preserved forever
    Revert Mechanism:
  • "Revert to V2" doesn't delete V3-VN
  • Instead, creates new version VN+1 with V2's content
  • History never deleted, only moved forward
    What Gets Versioned:
  • Claims: assertion text, domain, status, scores
  • Evidence: excerpt, relevance, support type
  • Scenarios: description, assumptions, confidence
    Not Versioned (current state only):
  • Source track records (continuously updated)
  • Quality metrics (time-series data)
  • User reputation (accumulated score)
    Access:
  • Current version: Default view
  • Version history: Click "History" tab
  • Diff between versions: Compare any two versions
  • Revert: Select version → "Revert to this version" → Creates new version
    Storage:
  • Current state: In entity table (CLAIM, EVIDENCE, SCENARIO)
  • Historical states: In EDIT table (before_state, after_state JSON)
  • Hot storage: Last 3 months of edits
  • Cold storage: Older edits archived to S3