Changes for page Data Model (From Specification Chat)

Last modified by Robert Schaub on 2025/12/24 20:35

From 2.1 to 1.2 From 4.1 to 3.1

From version 3.1

edited by Robert Schaub
on 2025/11/27 12:08

Change comment: There is no comment for this version

To version 2.1

edited by Robert Schaub
on 2025/11/27 12:05

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -41,10 +41,10 @@
    (scenarios live at the *claim* level, not per individual phrasing).
  * Verdicts and Scenario–Evidence links are always attached to **versions**:
  * {{code}}SCENARIO_VERSION{{/code}} +
--{{code}}EVIDENCE_VERSION{{/code}} →
--{{code}}SCENARIO_EVIDENCE_LINK_VERSION{{/code}}
++  {{code}}EVIDENCE_VERSION{{/code}} →
++  {{code}}SCENARIO_EVIDENCE_LINK_VERSION{{/code}}
  * {{code}}SCENARIO_VERSION{{/code}} →
--{{code}}VERDICT_VERSION{{/code}}
++  {{code}}VERDICT_VERSION{{/code}}
  This ensures that when a Scenario or Evidence changes, old verdicts and links
  remain intact as historical records and can be revisited.
@@ -172,145 +172,83 @@
  {{mermaid}}
  erDiagram
--    %% Core clusters shown for context
--    CLAIM_CLUSTER {
--        string ClusterID PK
--        string EmbeddingVectorRef
--        string Theme
--    }
--    CLAIM {
--        string ClaimID PK
--        string ClusterID FK
--        string Status
--        datetime CreatedAt
++    USER {
++        string userId
++        string displayName
++        string email
++        string userType      %% "human" or "technical"
++        datetime createdAt
      }
--    CLAIM_VERSION {
--        string ClaimVersionID PK
--        string ClaimID FK
--        string Text
--        string ClaimType
--        string Domain
--        datetime CreatedAt
++    TECHNICAL_USER {
++        string technicalUserId
++        string userIdFk
++        string description
++        string systemIdentifier
      }
--    SCENARIO {
--        string ScenarioID PK
--        string ClaimID FK
--        string Name
--        datetime CreatedAt
++    ROLE {
++        string roleId
++        string code          %% e.g. READER, CONTRIBUTOR, REVIEWER, TRUSTED_CONTRIBUTOR, MODERATOR, SYSTEM_ADMIN, FEDERATION_OPERATOR, FEDERATION_ADMIN
++        string description
++        boolean isFederationRole
      }
--    SCENARIO_VERSION {
--        string ScenarioVersionID PK
--        string ScenarioID FK
--        string Definitions
--        string Assumptions
--        string Boundaries
--        datetime CreatedAt
++    USER_ROLE_MEMBERSHIP {
++        string membershipId
++        string userIdFk
++        string roleIdFk
++        datetime grantedAt
++        string grantedByUserIdFk
      }
--    EVIDENCE {
--        string EvidenceID PK
--        string SourceType
--        string URL
--        float ReliabilityScore
++    REVIEW_ACTION {
++        string reviewActionId
++        string subjectType         %% e.g. CLAIM_VERSION, SCENARIO_VERSION...
++        string subjectVersionId
++        string actionType          %% APPROVE, REJECT, FLAG, COMMENT, REQUEST_CHANGES...
++        string outcome             %% ACCEPTED, REJECTED, ESCALATED...
++        string comment
++        string createdByUserIdFk
++        datetime createdAt
      }
--    EVIDENCE_VERSION {
--        string EvidenceVersionID PK
--        string EvidenceID FK
--        string Summary
--        float ReliabilityScore
--        datetime CreatedAt
--    }
++    %% Versioned data entities (references from the core model)
--    VERDICT {
--        string VerdictID PK
--        string ScenarioID FK
++    CLAIM_VERSION {
++        string claimVersionId
      }
--    VERDICT_VERSION {
--        string VerdictVersionID PK
--        string VerdictID FK
--        float Verdict
--        float Confidence
--        string Reasoning
--        datetime CreatedAt
++    SCENARIO_VERSION {
++        string scenarioVersionId
      }
--    %% Users and roles
--    USER {
--        string UserID PK
--        string Handle
--        string Email
++    EVIDENCE_VERSION {
++        string evidenceVersionId
      }
--    TECHNICAL_USER {
--        string UserID PK
--        string SystemName
++    SCENARIO_EVIDENCE_LINK_VERSION {
++        string scenarioEvidenceLinkVersionId
      }
--    CONTRIBUTING_USER {
--        string UserID PK
--        string DisplayName
++    VERDICT_VERSION {
++        string verdictVersionId
      }
--    TRUSTED_CONTRIBUTOR {
--        string UserID PK
--        string TrustLevel
--    }
++    %% Relationships
--    REVIEWER {
--        string UserID PK
--        string Domain
--    }
++    USER ||--o{ TECHNICAL_USER : may_be
++    USER ||--o{ USER_ROLE_MEMBERSHIP : has_role
++    ROLE ||--o{ USER_ROLE_MEMBERSHIP : assigned_to
--    EXPERT {
--        string UserID PK
--        string ExpertiseArea
--    }
--
--    FEDERATION_NODE {
--        string NodeID PK
--        string Region
--    }
--
--    FEDERATION_ADMIN {
--        string UserID PK
--        string Permissions
--    }
--
--    REVIEW_ACTION {
--        string ReviewActionID PK
--        string UserID FK
--        string TargetEntityType
--        string TargetEntityVersionID
--        string ActionType
--        string Comment
--        datetime Timestamp
--    }
--
--    %% Inheritance / specialization (modelled as relationships)
--    USER ||--o{ TECHNICAL_USER : "is a"
--    USER ||--o{ CONTRIBUTING_USER : "is a"
--
--    CONTRIBUTING_USER ||--o{ TRUSTED_CONTRIBUTOR : "subset"
--    CONTRIBUTING_USER ||--o{ REVIEWER : "subset"
--    CONTRIBUTING_USER ||--o{ EXPERT : "subset"
--
--    TECHNICAL_USER ||--o{ FEDERATION_NODE : "operates"
--    TECHNICAL_USER ||--o{ FEDERATION_ADMIN : "administers"
--
--    %% Review actions on versioned entities
      USER ||--o{ REVIEW_ACTION : performs
--    REVIEW_ACTION }o--|| CLAIM_VERSION : reviews
--    REVIEW_ACTION }o--|| SCENARIO_VERSION : reviews
--    REVIEW_ACTION }o--|| EVIDENCE_VERSION : reviews
--    REVIEW_ACTION }o--|| VERDICT_VERSION : reviews
--
++    CLAIM_VERSION ||--o{ REVIEW_ACTION : is_reviewed_in
++    SCENARIO_VERSION ||--o{ REVIEW_ACTION : is_reviewed_in
++    EVIDENCE_VERSION ||--o{ REVIEW_ACTION : is_reviewed_in
++    SCENARIO_EVIDENCE_LINK_VERSION ||--o{ REVIEW_ACTION : is_reviewed_in
++    VERDICT_VERSION ||--o{ REVIEW_ACTION : is_reviewed_in
  {{/mermaid}}
  Notes:
@@ -342,7 +342,7 @@
  * It may inherit some links from earlier scenarios, or start empty depending
      on the change classification (cosmetic vs. conceptual).
  * All verdicts for that scenario are recalculated and stored as new
--{{code}}VERDICT_VERSION{{/code}} entries.
++  {{code}}VERDICT_VERSION{{/code}} entries.
  * REVIEW_ACTIONs are always attached to the **exact version** that was seen by
    the reviewer. This preserves a faithful audit trail if data later changes.

Changes for page Data Model (From Specification Chat)

Summary

Details

Applications

Navigation

Need help?