Changes for page System Architecture

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

From version 1.2
edited by Robert Schaub
on 2025/12/21 13:38
Change comment: Renamed back-links.
To version 1.1
edited by Robert Schaub
on 2025/12/21 11:25
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,7 @@
2 2  
3 3  **FactHarbor system architecture including POC simplifications and full system design**
4 4  
5 ------
5 +---
6 6  
7 7  == 1. Architecture Evolution ==
8 8  
... ... @@ -49,7 +49,6 @@
49 49  {{/diagram}}
50 50  
51 51  **Components:**
52 -
53 53  * Single AKEL API call (Claude Sonnet 4.5)
54 54  * Gates 1 & 4 (claim validation, verdict confidence)
55 55  * Basic UI display
... ... @@ -57,7 +57,7 @@
57 57  
58 58  **Data Storage:** Minimal (stateless or simple SQLite)
59 59  
60 ------
59 +---
61 61  
62 62  === 1.2 POC2 Architecture (Enhanced) ===
63 63  
... ... @@ -103,7 +103,6 @@
103 103  {{/diagram}}
104 104  
105 105  **New Components:**
106 -
107 107  * Scenario generation
108 108  * Evidence deduplication system
109 109  * Gates 2 & 3 (evidence relevance, scenario coherence)
... ... @@ -111,7 +111,7 @@
111 111  
112 112  **Data Storage:** Enhanced (claims, scenarios, evidence, metrics)
113 113  
114 ------
112 +---
115 115  
116 116  === 1.3 Full System Architecture (V1.0+) ===
117 117  
... ... @@ -163,7 +163,6 @@
163 163  {{/diagram}}
164 164  
165 165  **Production Components:**
166 -
167 167  * Multi-component AKEL pipeline
168 168  * Review workflow system
169 169  * Audit sampling framework
... ... @@ -170,7 +170,7 @@
170 170  * Federation architecture
171 171  * Full data model (PostgreSQL + Redis + S3)
172 172  
173 ------
170 +---
174 174  
175 175  == 2. Quality Gate Architecture ==
176 176  
... ... @@ -216,7 +216,7 @@
216 216  (Any gate FAIL → Block + Explain)
217 217  {{/diagram}}
218 218  
219 ------
216 +---
220 220  
221 221  === 2.2 Gate Implementation by Phase ===
222 222  
... ... @@ -228,7 +228,7 @@
228 228  
229 229  **Hardening** means: Thresholds validated, edge cases handled, <5% failure rate
230 230  
231 ------
228 +---
232 232  
233 233  == 3. Data Architecture ==
234 234  
... ... @@ -237,7 +237,6 @@
237 237  **Storage:** SQLite or minimal database
238 238  
239 239  **Entities:**
240 -
241 241  * Articles (input text/URL)
242 242  * Claims (extracted from articles)
243 243  * Verdicts (per claim)
... ... @@ -245,7 +245,7 @@
245 245  
246 246  **No complex relationships, versioning, or scenarios**
247 247  
248 ------
244 +---
249 249  
250 250  === 3.2 Full System Data Model (V1.0+) ===
251 251  
... ... @@ -252,7 +252,6 @@
252 252  **Storage:** PostgreSQL (primary), Redis (cache), S3 (documents)
253 253  
254 254  **Core Entities:**
255 -
256 256  * Claims (with versions, clustering)
257 257  * Scenarios (interpretations of claims)
258 258  * Evidence (deduplicated, provenance tracked)
... ... @@ -262,7 +262,7 @@
262 262  
263 263  **Complex relationships, full audit trail, federation support**
264 264  
265 ------
260 +---
266 266  
267 267  == 4. Component Architecture ==
268 268  
... ... @@ -272,7 +272,6 @@
272 272  **Full System:** Multi-component orchestration
273 273  
274 274  **Responsibilities:**
275 -
276 276  * Route input through component pipeline
277 277  * Manage component state
278 278  * Handle errors and retries
... ... @@ -279,7 +279,7 @@
279 279  * Coordinate quality gates
280 280  * Trigger review workflows
281 281  
282 ------
276 +---
283 283  
284 284  === 4.2 Quality Gate Validator ===
285 285  
... ... @@ -286,7 +286,6 @@
286 286  **All Phases:** Present but evolving complexity
287 287  
288 288  **Responsibilities:**
289 -
290 290  * Execute all configured gates
291 291  * Aggregate gate results
292 292  * Make publication decisions
... ... @@ -293,7 +293,7 @@
293 293  * Generate explanatory messages
294 294  * Log quality metrics
295 295  
296 ------
289 +---
297 297  
298 298  === 4.3 Review Queue Manager ===
299 299  
... ... @@ -302,7 +302,6 @@
302 302  **V1.0:** Full implementation
303 303  
304 304  **Responsibilities:**
305 -
306 306  * Route low-confidence verdicts to review
307 307  * Manage reviewer assignments
308 308  * Track review status
... ... @@ -309,7 +309,7 @@
309 309  * Implement audit sampling
310 310  * Generate review metrics
311 311  
312 ------
304 +---
313 313  
314 314  == 5. Architecture Decisions ==
315 315  
... ... @@ -316,7 +316,6 @@
316 316  === 5.1 Why Single AKEL Call for POC? ===
317 317  
318 318  **Rationale:**
319 -
320 320  * Validates core capability fastest
321 321  * Simplest to implement and test
322 322  * Fail-fast if AI fundamentally can't do task
... ... @@ -325,12 +325,11 @@
325 325  
326 326  **Trade-off:** Less granular control, harder to optimize individual steps
327 327  
328 ------
319 +---
329 329  
330 330  === 5.2 Why Add Components in V1.0? ===
331 331  
332 332  **Rationale:**
333 -
334 334  * Better error handling per step
335 335  * Independent optimization of each component
336 336  * Easier to add new capabilities
... ... @@ -339,7 +339,7 @@
339 339  
340 340  **Trade-off:** More complexity, more to maintain
341 341  
342 ------
332 +---
343 343  
344 344  == 6. Related Pages ==
345 345  
... ... @@ -346,10 +346,11 @@
346 346  * [[Requirements>>Test.FactHarbor.Specification.Requirements.WebHome]] - System requirements
347 347  * [[Design>>Test.FactHarbor.Specification.Design.WebHome]] - UI/UX design
348 348  * [[Roadmap>>Test.FactHarbor.Roadmap.WebHome]] - Implementation phases
349 -* [[POC1>>FactHarbor.Archive.FactHarbor delta for V0\.9\.70.Roadmap.POC1.WebHome]] - POC1 details
339 +* [[POC1>>Test.FactHarbor.Roadmap.POC1.WebHome]] - POC1 details
350 350  * [[POC2>>Test.FactHarbor.Roadmap.POC2.WebHome]] - POC2 details
351 351  
352 ------
342 +---
353 353  
354 354  **Document Status:** ✅ Architecture Specified (POC1, POC2, Full System)
355 355  **Version:** V0.9.70
346 +