Skip to main content
Expert Corrections

ArcaQ feature

ยง1 โ€” How Expert Corrections work

Corrections are structured objects with a full audit trail โ€” not free-text notes.

๐Ÿ“

Structured correction fields

Original value, corrected value, entity URI, domain, justification, confidence score.

๐Ÿ›ก๏ธ

Role-gated access

Only users with knowledge:expert permission can submit corrections.

๐ŸŸก

Visual highlight in graph

Corrected nodes receive a yellow accent in the knowledge graph view.

๐Ÿ”„

Versioned diffs

Every correction is stored as a new version snapshot with diff view.

๐Ÿท๏ธ

Domain attribution

Corrections carry a domain field enabling domain-level quality metrics.

๐Ÿ”

SPARQL queryable

Query all corrections โ€” filter by domain, expert, date, or confidence.

ยง2 โ€” Correction data model

Each correction is a first-class RDF resource in <arcaq:corrections/>.

@prefix arcaq: <http://arcaq.com/> . @prefix xsd: <http://www.w3.org/2001/XMLSchema#> . arcaq:corrections/corr-001 a arcaq:ExpertCorrection ; arcaq:targetEntity <http://arcaq.com/kg/entity/42> ; arcaq:originalValue "Aspirin inhibits COX-1 only" ; arcaq:correctedValue "Aspirin inhibits both COX-1 and COX-2" ; arcaq:domain arcaq:Medicine ; arcaq:confidence "0.97"^^xsd:decimal ; arcaq:correctedBy arcaq:users/dr-chen ; arcaq:correctedAt "2026-05-14T10:00:00Z"^^xsd:dateTime .

ยง3 โ€” Admin: Expert Promotion

Admins promote trusted users to expert status via the Second Brain admin panel. Experts stored in <arcaq:admin-roles/>.

MethodEndpointDescription
POST/second-brain/admin/promotePromote a user to expert (requires knowledge:admin)
DELETE/second-brain/admin/promote/{user_id}Revoke expert status
GET/second-brain/admin/expertsList all promoted experts
GET/second-brain/admin/is-expertCheck if current user is expert

Get started