Changes for page System Architecture

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

From version 1.1
edited by Robert Schaub
on 2025/12/21 11:25
Change comment: Imported from XAR
To version 1.5
edited by Robert Schaub
on 2025/12/21 13:38
Change comment: Update document after refactoring.

Summary

Details

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