Changes for page System Architecture
Last modified by Robert Schaub on 2025/12/24 20:35
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 - Test.FactHarbor.Specification.WebHome1 +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 -* [[Design>> Test.FactHarbor.Specification.Design.WebHome]] - UI/UX design338 -* [[Roadmap>> Test.FactHarbor.Roadmap.WebHome]] - Implementation phases339 -* [[POC1>> Test.FactHarbor.Roadmap.POC1.WebHome]] - POC1 details340 -* [[POC2>> Test.FactHarbor.Roadmap.POC2.WebHome]] - POC2 details347 +* [[Design>>FactHarbor.Archive.FactHarbor delta for V0\.9\.70.Specification.Design.WebHome]] - UI/UX design 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 -