Changes for page Architecture

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

From version 5.1
edited by Robert Schaub
on 2025/12/12 15:41
Change comment: Imported from XAR
To version 2.2
edited by Robert Schaub
on 2025/12/11 21:33
Change comment: Renamed back-links.

Summary

Details

Page properties
Content
... ... @@ -12,12 +12,12 @@
12 12  * **UI Frontend**
13 13  * **REST API Layer**
14 14  * **Core Logic Layer**
15 -** Claim Processing
16 -** Scenario Engine
17 -** Evidence Repository
18 -** Verdict Engine
19 -** Re-evaluation Engine
20 -** Roles / Identity / Reputation
15 +** Claim Processing
16 + Scenario Engine
17 + Evidence Repository
18 + Verdict Engine
19 + Re-evaluation Engine
20 + Roles / Identity / Reputation**
21 21  * **AKEL (AI Knowledge Extraction Layer)**
22 22  * **Federation Layer**
23 23  * **Workers & Background Jobs**
... ... @@ -27,11 +27,11 @@
27 27  
28 28  Key ideas:
29 29  
30 -* Core logic is deterministic, auditable, and versioned 
31 -* AKEL drafts structured outputs but never publishes directly 
32 -* Workers run long or asynchronous tasks 
33 -* Storage is separated for scalability and clarity 
34 -* Federation Layer provides optional distributed operation 
30 +* Core logic is deterministic, auditable, and versioned
31 +* AKEL drafts structured outputs but never publishes directly
32 +* Workers run long or asynchronous tasks
33 +* Storage is separated for scalability and clarity
34 +* Federation Layer provides optional distributed operation
35 35  
36 36  ----
37 37  
... ... @@ -39,10 +39,10 @@
39 39  
40 40  FactHarbor separates structured data, embeddings, and evidence files:
41 41  
42 -* **PostgreSQL** — canonical structured entities, all versioning, lineage, signatures 
43 -* **Vector DB (Qdrant or pgvector)** — semantic search, duplication detection, cluster mapping 
44 -* **Object Storage** — PDFs, datasets, raw evidence, transcripts 
45 -* **Optional (Release 1.0)**: Redis for caching, IPFS for decentralized object storage 
42 +* **PostgreSQL** — canonical structured entities, all versioning, lineage, signatures
43 +* **Vector DB (Qdrant or pgvector)** — semantic search, duplication detection, cluster mapping
44 +* **Object Storage** — PDFs, datasets, raw evidence, transcripts
45 +* **Optional (Release 1.0)**: Redis for caching, IPFS for decentralized object storage
46 46  
47 47  {{include reference="FactHarbor.Specification.Diagrams.Storage Architecture.WebHome"/}}
48 48  
... ... @@ -56,12 +56,12 @@
56 56  
57 57  Responsibilities:
58 58  
59 -* Ingest text, URLs, documents, transcripts, federated input 
60 -* Extract claims (AKEL-assisted) 
61 -* Normalize structure 
62 -* Classify (type, domain, evaluability, safety) 
63 -* Deduplicate via embeddings 
64 -* Assign to claim clusters 
59 +* Ingest text, URLs, documents, transcripts, federated input
60 +* Extract claims (AKEL-assisted)
61 +* Normalize structure
62 +* Classify (type, domain, evaluability, safety)
63 +* Deduplicate via embeddings
64 +* Assign to claim clusters
65 65  
66 66  Flow:
67 67  **Ingest → Normalize → Classify → Deduplicate → Cluster**
... ... @@ -72,11 +72,11 @@
72 72  
73 73  Responsibilities:
74 74  
75 -* Create and validate scenarios 
76 -* Enforce required fields (definitions, assumptions, boundaries...) 
77 -* Perform safety checks (AKEL-assisted) 
78 -* Manage versioning and lifecycle 
79 -* Provide contextual evaluation settings to the Verdict Engine 
75 +* Create and validate scenarios
76 +* Enforce required fields (definitions, assumptions, boundaries...)
77 +* Perform safety checks (AKEL-assisted)
78 +* Manage versioning and lifecycle
79 +* Provide contextual evaluation settings to the Verdict Engine
80 80  
81 81  Flow:
82 82  **Create → Validate → Version → Lifecycle → Safety**
... ... @@ -87,12 +87,12 @@
87 87  
88 88  Responsibilities:
89 89  
90 -* Store metadata + files (object store) 
91 -* Classify evidence 
92 -* Compute preliminary reliability 
93 -* Maintain version history 
94 -* Detect retractions or disputes 
95 -* Provide structured metadata to the Verdict Engine 
90 +* Store metadata + files (object store)
91 +* Classify evidence
92 +* Compute preliminary reliability
93 +* Maintain version history
94 +* Detect retractions or disputes
95 +* Provide structured metadata to the Verdict Engine
96 96  
97 97  Flow:
98 98  **Store → Classify → Score → Version → Update/Retract**
... ... @@ -103,11 +103,11 @@
103 103  
104 104  Responsibilities:
105 105  
106 -* Aggregate scenario-linked evidence 
107 -* Compute likelihood ranges **per scenario**
108 -* Generate reasoning chain 
109 -* Track uncertainty factors 
110 -* Maintain verdict version timelines 
106 +* Aggregate scenario-linked evidence
107 +* Compute likelihood ranges
108 +* Generate reasoning chain
109 +* Track uncertainty factors
110 +* Maintain verdict version timelines
111 111  
112 112  Flow:
113 113  **Aggregate → Compute → Explain → Version → Timeline**
... ... @@ -118,18 +118,18 @@
118 118  
119 119  Responsibilities:
120 120  
121 -* Listen for upstream changes 
122 -* Trigger partial or full recomputation 
123 -* Update verdicts + summary views 
124 -* Maintain consistency across federated nodes 
121 +* Listen for upstream changes
122 +* Trigger partial or full recomputation
123 +* Update verdicts + summary views
124 +* Maintain consistency across federated nodes
125 125  
126 126  Triggers include:
127 127  
128 -* Evidence updated or retracted 
129 -* Scenario definition or assumption changes 
130 -* Claim type or evaluability changes 
131 -* Contradiction detection 
132 -* Federation sync updates 
128 +* Evidence updated or retracted
129 +* Scenario definition or assumption changes
130 +* Claim type or evaluability changes
131 +* Contradiction detection
132 +* Federation sync updates
133 133  
134 134  Flow:
135 135  **Trigger → Impact Analysis → Recompute → Publish Update**
... ... @@ -141,17 +141,17 @@
141 141  AKEL is fully documented in its own chapter.
142 142  Here is only the architectural integration summary:
143 143  
144 -* Receives raw input for claims 
145 -* Proposes scenario drafts 
146 -* Extracts and summarizes evidence 
147 -* Gives reliability hints 
148 -* Suggests draft verdicts 
149 -* Monitors contradictions 
150 -* Syncs metadata with trusted nodes 
144 +* Receives raw input for claims
145 +* Proposes scenario drafts
146 +* Extracts and summarizes evidence
147 +* Gives reliability hints
148 +* Suggests draft verdicts
149 +* Monitors contradictions
150 +* Syncs metadata with trusted nodes
151 151  
152 152  AKEL runs in parallel to human review — never overrides it.
153 153  
154 -{{include reference="FactHarbor.Specification.Diagrams.AKEL Architecture.WebHome"/}}
154 +{{include reference="FactHarbor.Archive.Diagrams v0\.8q.AKEL Architecture.WebHome"/}}
155 155  
156 156  ----
157 157  
... ... @@ -159,25 +159,25 @@
159 159  
160 160  Each FactHarbor node:
161 161  
162 -* Has its own dataset (claims, scenarios, evidence, verdicts) 
163 -* Runs its own AKEL 
164 -* Maintains local governance and reviewer rules 
165 -* May partially mirror global or domain-specific data 
166 -* Contributes to global knowledge clusters 
162 +* Has its own dataset (claims, scenarios, evidence, verdicts)
163 +* Runs its own AKEL
164 +* Maintains local governance and reviewer rules
165 +* May partially mirror global or domain-specific data
166 +* Contributes to global knowledge clusters
167 167  
168 168  Nodes synchronize via:
169 169  
170 -* Signed version bundles 
171 -* Merkle-tree lineage structures 
172 -* Optionally IPFS for evidence 
173 -* Trust-weighted acceptance 
170 +* Signed version bundles
171 +* Merkle-tree lineage structures
172 +* Optionally IPFS for evidence
173 +* Trust-weighted acceptance
174 174  
175 175  Benefits:
176 176  
177 -* Community independence 
178 -* Scalability 
179 -* Resilience 
180 -* Domain specialization 
177 +* Community independence
178 +* Scalability
179 +* Resilience
180 +* Domain specialization
181 181  
182 182  {{include reference="FactHarbor.Specification.Diagrams.Federation Architecture.WebHome"/}}
183 183  
... ... @@ -207,11 +207,11 @@
207 207  
208 208  All entities (Claim, Scenario, Evidence, Verdict) use immutable version chains:
209 209  
210 -* VersionID 
211 -* ParentVersionID 
212 -* Timestamp 
213 -* AuthorType (Human, AI, ExternalNode) 
214 -* ChangeReason 
215 -* Signature (optional POC, required in 1.0) 
210 +* VersionID
211 +* ParentVersionID
212 +* Timestamp
213 +* AuthorType (Human, AI, ExternalNode)
214 +* ChangeReason
215 +* Signature (optional POC, required in 1.0)
216 216  
217 217  {{include reference="FactHarbor.Specification.Diagrams.Versioning Architecture.WebHome"/}}