Albanian Rules Bot Logo
Dokumentacioni Teknik

📊 Statistika: Sistemi përdor teknologjinë më të re të inteligjencës artificiale për të ofruar përgjigje të sakta dhe të shpejta mbi Rregulloren e Kuvendit.

1. Modeli i Inteligjencës Artificiale
Modeli Kryesor

OpenAI GPT-4

Për përgjigje komplekse dhe të detajuara

Modeli Ndihmës

OpenAI GPT-3.5 Turbo

Për nxjerrjen dhe përmbledhjen e tekstit

Konfigurimi
  • Kreativiteti: I kufizuar (low creativity setting)

  • Temperatura: 0.1-0.3 (për saktësi maksimale)

  • Tokens maksimale: 4,096 për përgjigje

2. Dokumentet Reference
Burimi Kryesor
📜 Rregullorja e Kuvendit të Republikës së Shqipërisë
  • Versioni: I miratuar më 2025

  • Nenet: 1-200+ (të gjitha nenet procedurale)

  • Gjuha: Shqip (me përkthime në Anglisht)

  • Formati: Tekst i strukturuar me metadata

  • Përditësimi i fundit: December 2025

Dokumentet Mbështetëse
📋 Udhëzuesit Procedural
  • Udhëzuesi për zhvillimin e seancave

  • Procedurat e votimit

  • Rregullat e debatit parlamentar

  • Organizimi i komisioneve

📚 Interpretimet Zyrtare
  • Vendimet e Kryesisë së Kuvendit

  • Praktikat e konsoliduara

  • Interpretimet juridike

  • Raste studimore

3. Arkitektura e Sistemit
🔍 Retrieval Augmented Generation (RAG)

Sistemi përdor teknologjinë RAG për të gjetur informacionin më relevant:

  1. Pyetja e përdoruesit analizohet dhe konvertohet në vektor

  2. Kërkohen fragmentet më relevante nga baza e të dhënave

  3. 5 fragmentet më të rëndësishme dërgohen te GPT-4

  4. GPT-4 formulon përgjigjen bazuar në këto fragmente

  5. Përgjigja kontrollohet për saktësi dhe formatohet

💾 Ruajtja e të Dhënave
  • Pinecone: Baza e të dhënave vektoriale për kërkimin semantik

  • Redis: Cache për përgjigjet e shpeshta

  • MySQL: Ruajtja e bisedave dhe metadatave

  • Laravel Framework: Sistemi i menaxhimit të aplikacionit

4. Performanca dhe Optimizimi
~2-5s

Koha mesatare e përgjigjes

95%+

Saktësia e përgjigjeve

7 ditë

Cache i përgjigjeve

5. Siguria dhe Privatësia

Enkriptim i plotë: Të gjitha të dhënat transmetohen me HTTPS dhe ruhen të enkriptuara.

  • Session TTL: 60 minuta (pastrohen automatikisht)

  • Data minimization: Ruhen vetëm të dhënat e nevojshme

  • GDPR compliant: Respekton të drejtën e fshirjes së të dhënave

  • No personal data: Nuk ruhen të dhëna personale të identifikueshme

6. Limitimet dhe Përmirësimet e Ardhshme
⚠️ Limitimet Aktuale
  • Nuk ka qasje në informacione në kohë reale

  • Fokusi vetëm në Rregulloren e Kuvendit

  • Mund të ketë gabime në interpretime komplekse

  • Nuk jep këshilla ligjore zyrtare

🚀 Përmirësimet e Planifikuara
  • Shtim i dokumenteve të reja ligjore

  • Përmirësim i saktësisë së përgjigjeve

  • Interface më interaktiv

  • Integrimi me sisteme të tjera parlamentare

7. Kontakti Teknik

Për pyetje teknike ose raportim të problemeve:

  • POPVOX Foundation: tech@popvox.org

  • Parliamentary Institute: [email placeholder]

  • GitHub Repository: [link placeholder]