Knowledge Base & Documentation

Knowledge Base & Documentation

The Knowledge Base (sidebar → Config → Knowledge Base, route /wiki) is the platform's wiki of classification-domain knowledge: normative sources, general IEC concepts, and rules for each level of the hierarchy. It is not this Docs section — Knowledge Base content is consumed by the classification pipeline as retrieval and learning context.

Docs explains how to use the platform.

What's in it

  • Root pages — WIKI.md, index.md, log.md, shown at the top of the left file list with no folder.
  • Concepts — general IEC 61850 / IEC 81346 explanations (one Markdown file per concept).
  • Sources — normative or utility-specific source material, including common-rules.md, the file the platform itself writes corrected rules into (see Learning from Corrections).

Content is English-only. The Language picker in the top bar controls the frontend interface language (English/Italian) and the language of classification output — it does not affect Knowledge Base content, which is always browsed in English.

How to use it

  1. Browse — click any file in the left panel to load it in the main panel.
  2. Search — type into the top bar search box; results are ranked wiki pages, plant schemas, and platform Docs pages, shown in a dropdown with highlighted matches. Clicking a result jumps straight to the matched text on the destination page, already scrolled into view and highlighted — no need to search again with Ctrl+F.
  3. Read vs. edit — the Edit/Preview toggle in the toolbar switches the main panel between a rendered Markdown preview and a full code editor (line numbers, syntax highlighting).
  4. Create a new page — click + New under Concepts or Sources, give it a filename and a short description, and it's created and opened immediately. Optionally attach a PDF: an LLM transcribes it into Markdown (headings, paragraphs, lists, and tables preserved, translated to English if the source isn't already) and pre-fills the new page — capped at 30 pages per upload. Review and edit the result before saving, exactly like any other page.
  5. Save — edit in the editor and click Save (or Ctrl+S); the toolbar status switches between "Unsaved changes" and "Saved".
  6. Rename or move — click Rename, set a new filename and/or folder (Concepts ↔ Sources).
  7. Delete — click Delete; if other pages link to it, you'll see how many and which ones before confirming, since deleting orphans those links.

Contradiction Checker

The Knowledge Base can grow large enough that two pages start to disagree.

The Contradiction Checker panel (left sidebar, above the file list) runs an LLM pass over the whole Knowledge Base — or, narrowed with the Per topic field, over a single topic — and streams back a live list of contradictions as they're found. The two buttons are independent: Verify contradiction always runs the unscoped, whole-corpus check even if text is still sitting in the topic field; only Verify per topic uses it. When a topic doesn't match any contradiction, the panel reports "Nessuna contraddizione trovata" instead of showing unrelated results.

Each result shows the two conflicting quotes and their file: line locations; clicking a location opens a side-by-side split view (the conflicting line highlighted) so you can fix it in place. Saving marks that specific contradiction resolved (highlighted green) — other contradictions pointing at the same file stay untouched and remain clickable.