game-library/docs/user/USAGE.md

📖 GHID DE UTILIZARE - INDEX-SISTEM-JOCURI

Sistem web pentru căutarea și indexarea activităților educaționale

---

🚀 START RAPID

1. Pornirea sistemului

# Intrați în directorul sistemului
cd INDEX-SISTEM-JOCURI

# Porniți serverul web
python app.py

2. Accesarea interfeței

• URL: http://localhost:5000
• Browser: Chrome, Firefox, Safari, Edge

---

📋 FUNCȚIONALITĂȚI PRINCIPALE

🔍 Căutare avansată

Interfața oferă 9 filtre dropdown pentru căutare precisă:

1. Valori - Valorile educaționale vizate
2. Durată - Timpul necesar (5-15min, 15-30min, 30+min)
3. Tematică - Tipul activității (cercetășesc, team building, educativ)
4. Domeniu - Aria de activitate (sport, artă, știință)
5. Metodă - Modalitatea de desfășurare (joc, poveste, atelier)
6. Materiale necesare - Echipamentul necesar (fără, simple, complexe)
7. Competențe Europene - Competențele dezvoltate
8. Competențe Impactate - Abilitățile vizate
9. Numărul de participanți - Mărimea grupului (2-5, 5-10, 10-30, 30+)
10. Vârsta - Grupa de vârstă (5-8, 8-12, 12-16, 16+)

🎯 Căutare text liberă

• Căutați folosind cuvinte cheie în caseta "cuvinte cheie"
• Sistemul caută în titluri, descrieri și textul complet
• Căutarea este insensibilă la majuscule/minuscule

📊 Afișare rezultate

Rezultatele sunt prezentate într-un tabel cu următoarele coloane:

• TITLU - Numele activității și durata
• DETALII - Materiale necesare, durata, participanți
• METODĂ - Categoria activității
• TEMĂ - Cuvintele cheie asociate
• VALORI - Competențele dezvoltate
• ACȚIUNI - Butoane pentru generare fișe și vizualizare sursă

---

📄 GENERAREA FIȘELOR DE ACTIVITĂȚI

Acces la fișe

1. Din lista de rezultate, faceți clic pe "📄 Generează fișă"
2. Se va deschide o nouă pagină cu fișa completă

Conținutul fișei include:

• Informații generale (participanți, durată, vârstă, dificultate)
• Descrierea activității
• Materiale necesare cu checklist
• Instrucțiuni pas cu pas
• Cuvinte cheie
• Activități similare recomandate
• Informații despre sursa

Opțiuni de export:

• 🖨️ Printare - Pentru printarea directă
• 📋 Copiere - Pentru copierea în clipboard
• 📁 Salvare - Folosiți "Salvare ca" din browser

---

⚡ EXEMPLE DE UTILIZARE

🏕️ Pentru organizatori de tabere

1. Selectați "Domeniu: sport" 
2. Alegeți "Durată: 15-30min"
3. Specificați "Vârsta: 8-12"
4. Clic pe "Aplică"

👨‍🏫 Pentru educatori

1. Căutați: "team building"
2. Selectați "Materiale necesare: fără"
3. Alegeți "Participanți: 10-30"

🔍 Căutări rapide

Folosiți butoanele de start rapid:

• Team Building - Activități de echipă
• Jocuri Scout - Activități cercetășești
• Cubs (8-11 ani) - Pentru vârsta 8-11 ani
• Fără materiale - Activități fără echipament
• Orientare - Jocuri cu busole

---

🛠️ ADMINISTRARE SISTEM

Indexarea fișierelor

Indexare completă (prima dată)

python indexer.py --clear-db

Indexare incrementală (fișiere noi)

python indexer.py

Indexare în modul test (5 fișiere)

python indexer.py --test-mode

Verificarea statisticilor

• API: http://localhost:5000/api/statistics
• Din interfață: Statisticile se încarcă automat pe pagina principală

Fișierele suportate

• PDF - Documente PDF (.pdf)
• Word - Documente Word (.doc, .docx)
• HTML - Pagini web (.html, .htm)
• Markdown - Fișiere Markdown (.md)
• Text - Fișiere text (.txt)

---

🔧 REZOLVAREA PROBLEMELOR

Probleme comune

Sistemul nu pornește

# Verificați instalarea dependențelor
pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber

# Verificați că sunteți în directorul corect
cd INDEX-SISTEM-JOCURI

Nu găsește activități

1. Verificați că indexarea a fost făcută: python indexer.py --test-mode
2. Verificați numărul de activități: http://localhost:5000/api/statistics
3. Încercați căutări mai generale

Fișele nu se generează

1. Verificați că activitatea există în baza de date
2. Verificați erorile în terminal
3. Asigurați-vă că template-urile HTML există

Performanța este lentă

1. Limitați numărul de rezultate folosind filtrele
2. Indexați doar fișierele necesare
3. Verificați că baza de date nu este coruptă

Logs și debug

• Flask debug: Activat automat în app.py
• Procesare fișiere: Informații în timp real la indexare
• Erori API: Verificați terminalul unde rulează python app.py

---

📊 SPECIFICAȚII TEHNICE

Cerințe sistem

• Python: 3.8+
• RAM: 512MB minimum, 2GB recomandat
• Storage: 100MB pentru cod + spațiu pentru baza de date
• Browser: Orice browser modern

Performanță

• Căutare: < 2 secunde pentru orice query
• Indexare: ~100 fișiere în < 10 minute
• Interfață: Responsive pe desktop și tablet

Limitări

• Concurență: Max ~20 utilizatori simultani
• Fișiere: Procesare secvențială, nu paralelă
• Storage: SQLite - pentru volume mici/medii

---

🆘 SUPORT

Pentru probleme tehnice:

1. Verificați logs-urile în terminal
2. Testați în mod izolat cu --test-mode
3. Reinitializați baza cu --clear-db

Pentru sugestii și îmbunătățiri:

• Documentați problema exact
• Includeți screenshots dacă e necesar
• Specificați versiunea de browser și sistemul de operare

---

🎮 INDEX-SISTEM-JOCURI v1.0
Dezvoltat cu Claude AI pentru eficientizarea căutării în activitățile educaționale

Ultima actualizare: Septembrie 2025