Skip to Content

Changes for page Versioning Architecture

Last modified by Robert Schaub on 2025/12/24 20:34
From version 3.1
edited by Robert Schaub
on 2025/12/15 16:56
Change comment: Imported from XAR
To version 3.3
edited by Robert Schaub
on 2025/12/16 21:40
Change comment: Update document after refactoring.

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -FactHarbor.Specification.Diagrams.WebHome
1 +FactHarbor.Specification V0\.9\.18.Diagrams.WebHome
Content
... ... @@ -5,11 +5,13 @@
5 5  == Versioning Architecture Explanation ==
6 6  
7 7  **Version Chains**:
8 +
8 8  * Each entity type (Claim, Scenario, Evidence, Verdict) maintains independent version history
9 9  * **ParentVersionID** creates directed acyclic graph (DAG) of changes
10 10  * Arrow direction: Old version → New version (evolution over time)
11 11  
12 12  **Version Metadata** (stored with every version):
14 +
13 13  * **VersionID**: Unique identifier for this specific version
14 14  * **ParentVersionID**: Links to previous version (null for v1)
15 15  * **AuthorType**: Human, AI, or ExternalNode
... ... @@ -17,11 +17,13 @@
17 17  * **JustificationText**: Brief explanation of changes
18 18  
19 19  **Entity Relationships** (dotted lines):
22 +
20 20  * Claims **have** Scenarios: One claim can have multiple scenario interpretations
21 21  * Scenarios **use** Evidence: Each scenario version references specific evidence versions
22 22  * Scenarios **produce** Verdicts: Each scenario version gets verdict based on evidence
23 23  
24 24  **Branching Support**:
28 +
25 25  * In federated environments, versions can branch:
26 26   - Node A: Version 1 → Version 2a
27 27   - Node B: Version 1 → Version 2b (parallel branch)
... ... @@ -28,9 +28,9 @@
28 28  * Both branches preserved for conflict resolution
29 29  
30 30  **Immutability**:
35 +
31 31  * Versions never deleted, only superseded
32 32  * Historical versions remain accessible
33 33  * Complete audit trail for all changes
34 34  
35 -{{include reference="Test.FactHarborV09.Specification.Diagrams.Versioning Architecture_Mermaid.WebHome"}}
36 -
40 +{{include reference="FactHarbor.Archive.FactHarbor V0\.9\.23 Lost Data.Specification.Diagrams.Versioning Architecture_Mermaid.WebHome"}}{{/include}}