Wiki source code of Workflows
Version 2.1 by Robert Schaub on 2025/12/18 12:54
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | = Workflows = | ||
| 2 | FactHarbor workflows are **simple, automated, focused on continuous improvement**. | ||
| 3 | == 1. Core Principles == | ||
| 4 | * **Automated by default**: AI processes everything | ||
| 5 | * **Publish immediately**: No centralized approval (removed in V0.9.50) | ||
| 6 | * **Quality through monitoring**: Not gatekeeping | ||
| 7 | * **Fix systems, not data**: Errors trigger improvements | ||
| 8 | * **Human-in-loop**: Only for edge cases and abuse | ||
| 9 | == 2. Claim Submission Workflow == | ||
| 10 | ``` | ||
| 11 | User submits → Duplicate detection → Categorization → Processing queue → User receives ID | ||
| 12 | ``` | ||
| 13 | **Timeline**: Seconds | ||
| 14 | **No approval needed** | ||
| 15 | |||
| 16 | == 2.5 Claim and Scenario Workflow == | ||
| 17 | |||
| 18 | {{include reference="FactHarbor.Specification.Diagrams.Claim and Scenario Workflow.WebHome"/}} | ||
| 19 | |||
| 20 | == 3. Automated Analysis Workflow == | ||
| 21 | ``` | ||
| 22 | Claim from queue | ||
| 23 | ↓ | ||
| 24 | Evidence gathering (AKEL) | ||
| 25 | ↓ | ||
| 26 | Source evaluation (track record check) | ||
| 27 | ↓ | ||
| 28 | Scenario generation | ||
| 29 | ↓ | ||
| 30 | Verdict synthesis | ||
| 31 | ↓ | ||
| 32 | Risk assessment | ||
| 33 | ↓ | ||
| 34 | Quality gates (confidence > 40%? risk < 80%?) | ||
| 35 | ↓ | ||
| 36 | Publish OR Flag for improvement | ||
| 37 | ``` | ||
| 38 | **Timeline**: 10-30 seconds | ||
| 39 | **90%+ published automatically** | ||
| 40 | == 3.5 Evidence and Verdict Workflow == | ||
| 41 | {{include reference="FactHarbor.Specification.Diagrams.Evidence and Verdict Workflow.WebHome"/}} | ||
| 42 | == 4. Publication Workflow == | ||
| 43 | **Standard (90%+)**: Pass quality gates → Publish immediately with confidence scores | ||
| 44 | **High Risk (<10%)**: Risk > 80% → Moderator review | ||
| 45 | **Low Quality**: Confidence < 40% → Improvement queue → Re-process | ||
| 46 | == 5. User Contribution Workflow == | ||
| 47 | ``` | ||
| 48 | Contributor edits → System validates → Applied immediately → Logged → Reputation earned | ||
| 49 | ``` | ||
| 50 | **No approval required** (Wikipedia model) | ||
| 51 | **New contributors** (<50 reputation): Limited to minor edits | ||
| 52 | == 5.5 Quality and Audit Workflow == | ||
| 53 | |||
| 54 | {{include reference="FactHarbor.Specification.Diagrams.Quality and Audit Workflow.WebHome"/}} | ||
| 55 | |||
| 56 | |||
| 57 | == 6. Flagging Workflow == | ||
| 58 | ``` | ||
| 59 | User flags issue → Categorize (abuse/quality) → Automated or manual resolution | ||
| 60 | ``` | ||
| 61 | **Quality issues**: Add to improvement queue → System fix → Auto re-process | ||
| 62 | **Abuse**: Moderator review → Action taken | ||
| 63 | == 7. Moderation Workflow == | ||
| 64 | **Automated pre-moderation**: 95% published automatically | ||
| 65 | **Moderator queue**: Only high-risk or flagged content | ||
| 66 | **Appeal process**: Different moderator → Governing Team if needed | ||
| 67 | == 8. System Improvement Workflow == | ||
| 68 | **Weekly cycle**: | ||
| 69 | ``` | ||
| 70 | Monday: Review error patterns | ||
| 71 | Tuesday-Wednesday: Develop fixes | ||
| 72 | Thursday: Test improvements | ||
| 73 | Friday: Deploy & re-process | ||
| 74 | Weekend: Monitor metrics | ||
| 75 | ``` | ||
| 76 | **Error capture**: | ||
| 77 | ``` | ||
| 78 | Error detected → Categorize → Root cause → Improvement queue → Pattern analysis | ||
| 79 | ``` | ||
| 80 | **A/B Testing**: | ||
| 81 | ``` | ||
| 82 | New algorithm → Split traffic (90% control, 10% test) → Run 1 week → Compare metrics → Deploy if better | ||
| 83 | ``` | ||
| 84 | == 9. Quality Monitoring Workflow == | ||
| 85 | **Continuous**: Every hour calculate metrics, detect anomalies | ||
| 86 | **Daily**: Update source track records, aggregate error patterns | ||
| 87 | **Weekly**: System improvement cycle, performance review | ||
| 88 | == 10. Source Track Record Workflow == | ||
| 89 | **Initial score**: New source starts at 50 (neutral) | ||
| 90 | **Daily updates**: Calculate accuracy, correction frequency, update score | ||
| 91 | **Continuous**: All claims using source recalculated when score changes | ||
| 92 | == 11. Re-Processing Workflow == | ||
| 93 | **Triggers**: System improvement deployed, source score updated, new evidence, error fixed | ||
| 94 | **Process**: Identify affected claims → Re-run AKEL → Compare → Update if better → Log change | ||
| 95 | == 12. Related Pages == | ||
| 96 | * [[Requirements>>FactHarbor.Specification.Requirements.WebHome]] | ||
| 97 | * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] | ||
| 98 | * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] |