Lidhja e butonit "Ndihma" me këtë help

Rregulli: key = rruga e formës

Çdo formë në Finabit Web ka një rrugë, për shembull https://web.finabit.com/admin/sales/s-inv. Key i help-it është pjesa pas /admin/:

Forma në web	Key	Faqja e help-it
/admin/sales/s-inv	sales/s-inv	help.finabit.com/sales/s-inv
/admin/sales/s-inv/new	sales/s-inv	help.finabit.com/sales/s-inv
/admin/sales/s-inv/69261/edit	sales/s-inv	help.finabit.com/sales/s-inv
/admin/purchases/p-inv?mode=list	purchases/p-inv	help.finabit.com/purchases/p-inv

Nuk ka nevojë për tabelë të veçantë çelësash: çdo formë e re lidhet vetë sapo t'i shtohet faqja këtu.

Kodi për butonin Ndihma (për zhvilluesit)

Butoni Ndihma duhet të hapë help-in me rrugën aktuale. Mjafton rruga e plotë: help-i vetë i heq /admin/, new, edit, ID-të numerike dhe query string-un.

// Butoni "Ndihma" (sidebar ose shiriti i sipërm)
function openHelp() {
  const path = window.location.pathname            // p.sh. /admin/sales/s-inv/69261/edit
  window.open(`https://help.finabit.com${path}`, '_blank', 'noopener')
}

Nëse preferoni ta pastroni vetë key-n në aplikacion:

export function helpKey(pathname: string): string {
  return pathname
    .replace(/^\/admin\/?/, '')
    .replace(/\/(new|edit|view|copy|\d+)(?=\/|$)/g, '')
    .replace(/\/+$/, '')
}
// https://help.finabit.com/ + helpKey(location.pathname)

Help-i pranon edhe formatin https://help.finabit.com/?key=sales/s-inv.

Çfarë ndodh kur forma s'ka faqe

1. Help-i provon rrugën e plotë, pastaj prindërit e saj (sales/s-inv/x/y → sales/s-inv/x → sales/s-inv).
2. Nëse s'gjen asnjë faqe, hap faqen e modulit sipas prefiksit (sales/... → Shitjet).
3. Përndryshe shfaq "Faqja nuk u gjet" me linkun te lista e moduleve.

Lista e të gjithë key-ve

Skedari /keys.json përmban çdo key me titullin, modulin, URL-në e help-it dhe statusin (gati, draft). Gjenerohet automatikisht në çdo build dhe mund të përdoret nga aplikacioni, për shembull për ta çaktivizuar butonin kur faqja është ende draft.

Eksporti për AI (kërkimi me vektorë)

Në çdo build publikohen:

• /ai/chunks.jsonl: një rresht JSON për çdo seksion (##/###) të faqeve të testuara.
• /ai/index.json: data e gjenerimit, numri i pjesëve dhe skema.

Fushat e çdo rreshti:

Fusha	Përshkrimi
id	key#anchor, unik për seksionin.
key	Key i formës (i njëjti si te butoni Ndihma).
module, section	Moduli dhe seksioni i menysë në web.
title	Faqja › Titulli › Nëntitulli.
url	Linku i saktë te seksioni në help.
status, tested	gati dhe data e testimit. Faqet draft nuk përfshihen.
hash	Ndryshon vetëm kur ndryshon teksti: ri-vektorizoni vetëm rreshtat me hash të ri.
text	Teksti në Markdown; fotot janë zëvendësuar me [Foto: …].

Rrjedha e rekomanduar në projektin e support-it: lexo chunks.jsonl → krahaso hash me indeksin → krijo embedding vetëm për rreshtat e rinj/ndryshuar → fshi id-të që s'ekzistojnë më. Në përgjigjet e modelit përdor url-në si burim.