game-library/docs/user/GHID_UTILIZARE.md

🎮 GHID DE UTILIZARE - COLECȚIA JOCURI ȘI ACTIVITĂȚI

Versiunea: 1.0
Data: 2025-09-09
Autor: Claude AI Assistant

---

📚 PREZENTARE GENERALĂ

Colecția conține 200+ fișiere cu 2000+ activități organizate în 8 categorii principale:

1. [A] Jocuri Cercetășești - 40% din colecție (800+ activități)
2. [B] Team Building - 15% din colecție (300+ activități)
3. [C] Camping & Exterior - 20% din colecție (400+ activități)
4. [D] Escape Room & Puzzle - 5% din colecție (100+ activități)
5. [E] Orientare & Busole - 4% din colecție (80+ activități)
6. [F] Primul Ajutor - 3% din colecție (60+ activități)
7. [G] Activități Educaționale - 10% din colecție (200+ activități)
8. [H] Resurse Speciale - 3% din colecție (60+ activități)

---

🗂️ FIȘIERE PRINCIPALE

📖 Index și Documentație

• INDEX_MASTER_JOCURI_ACTIVITATI.md - Catalogul complet (300+ pagini)
• GHID_UTILIZARE.md - Acest ghid de utilizare
• game_library_manager.py - Script Python pentru automatizare
• search_games.py - Căutare interactivă simplificată

🗄️ Baza de Date

• game_library.db - Baza de date SQLite cu toate activitățile
• Backup automat - Creat la fiecare rulare

---

🔍 MODALITĂȚI DE CĂUTARE

1. CĂUTARE MANUALĂ ÎN INDEX

Deschideți INDEX_MASTER_JOCURI_ACTIVITATI.md și folosiți:

• Ctrl+F (Windows/Linux) sau Cmd+F (Mac) pentru căutare în document
• Ghidul de căutare rapidă din secțiunea finală a indexului
• Cuprinsul principal pentru navigare pe categorii

Exemple de căutări:

"8-11 ani"          → Activități pentru Cubs
"fără materiale"    → Jocuri care nu necesită echipament  
"team building"     → Toate activitățile de construire echipă
"orientare"         → Jocuri cu busole și hărți
"30 minute"         → Activități de durată medie

2. CĂUTARE AUTOMATIZATĂ CU PYTHON

2.1 Instalare și Setup

# Verificați că aveți Python instalat
python --version

# Rulați în directorul sistemului index
cd "/mnt/d/GoogleDrive/Cercetasi/carti-camp-jocuri/INDEX-SISTEM-JOCURI"

# Inițializați sistemul
python game_library_manager.py

2.2 Căutare Interactivă

# Modul interactiv (recomandat pentru începători)
python search_games.py

# Urmați instrucțiunile pe ecran pentru:
# - Specificarea criteriilor de căutare
# - Vizualizarea rezultatelor  
# - Generarea fișelor de activități

2.3 Căutare din Linia de Comandă

# Căutare după categorie
python search_games.py --category "Team Building"

# Căutare după vârstă
python search_games.py --age 10

# Căutare cu cuvinte cheie
python search_games.py --keywords "cooperare,echipă"

# Căutare complexă
python search_games.py --category "Jocuri Cercetășești" --age 8 --keywords "alergare"

# Afișare categorii disponibile
python search_games.py --categories

# Statistici complete
python search_games.py --stats

3. CĂUTARE PROGRAMATICĂ (Pentru Dezvoltatori)

from game_library_manager import GameLibraryManager

# Inițializare
manager = GameLibraryManager()

# Căutări simple
team_activities = manager.search_activities(category="Team Building")
kids_games = manager.search_activities(age_min=5)

# Căutări complexe
outdoor_games = manager.search_activities(
    category="Camping & Exterior",
    age_min=10,
    keywords=["natură", "exterior"]
)

# Generare fișă
for activity in team_activities[:1]:  # Prima activitate
    sheet = manager.generate_activity_sheet(activity, "html")
    with open(f"fisa_{activity.id}.html", 'w', encoding='utf-8') as f:
        f.write(sheet)

---

📄 GENERARE FIȘE DE ACTIVITĂȚI

Tipuri de Fișe Disponibile

1. Fișă Markdown (.md)

sheet = manager.generate_activity_sheet(activity, "markdown")

Conține:

• Informații generale (vârstă, participanți, durata)
• Descrierea detaliată a activității
• Materialele necesare
• Exemple de aplicare
• Sursa originală și cuvinte cheie

2. Fișă HTML (.html)

sheet = manager.generate_activity_sheet(activity, "html")

Conține:

• Design vizual atractiv cu CSS
• Structură organizată în secțiuni
• Printabilă direct din browser
• Formatare profesională

3. Export Rezultate Căutare

export_path = manager.export_search_results(results, "my_search_results")

Generează un fișier cu toate activitățile găsite

---

📊 CRITERII DE CĂUTARE DISPONIBILE

Criterii Principale

Criteriu	Tip	Exemple
category	Text	"Team Building", "Jocuri Cercetășești"
age_min	Număr	5, 8, 12, 15
keywords	Listă	["cooperare", "alergare", "creativitate"]
difficulty	Text	"ușor", "mediu", "avansat"
language	Text	"ro", "en"

Criterii Avansate (În Dezvoltare)

Criteriu	Tip	Descriere
participants_min	Număr	Numărul minim de participanți
participants_max	Număr	Numărul maxim de participanți
duration_max	Număr	Durata maximă în minute
materials_type	Text	"fără materiale", "echipament minim"
location	Text	"interior", "exterior", "teren mare"

---

🎯 CAZURI DE UTILIZARE TIPICE

1. Profesor/Animator caută jocuri pentru o tabără

python search_games.py --keywords "tabără,exterior" --age 10
# Rezultat: Activități de camping și jocuri pe teren mare

2. Coordonator caută team building pentru echipă nouă

python search_games.py --category "Team Building" --keywords "cunoaștere,încredere"
# Rezultat: Exerciții de construire încredere și cunoaștere

3. Instructor Scout caută jocuri pe grupe de vârstă

python search_games.py --category "Jocuri Cercetășești" --age 8
# Rezultat: Jocuri specifice pentru Cubs (8-11 ani)

4. Profesor de biologie caută activități educative

python search_games.py --keywords "biologie,natură,științe"
# Rezultat: Experimente și activități educaționale

5. Organizator evenimente caută escape room

python search_games.py --category "Escape Room" --keywords "puzzle,logică"
# Rezultat: Puzzle-uri și provocări de escape room

---

🔧 ADMINISTRARE ȘI ÎNTREȚINERE

Backup și Actualizări

# Backup baza de date
import shutil
shutil.copy("game_library.db", f"backup_game_library_{datetime.now().strftime('%Y%m%d')}.db")

# Reîncărcare index după actualizări
manager = GameLibraryManager()
manager.load_activities_from_index()  # Reîncarcă datele

Adăugare Activități Noi

1. Adăugați informațiile în game_library_manager.py în lista sample_activities
2. Rulați din nou scriptul pentru a actualiza baza de date
3. Testați căutarea pentru noile activități

Personalizare Formatare Fișe

• Modificați funcția _generate_markdown_sheet() pentru fișe Markdown
• Modificați funcția _generate_html_sheet() pentru fișe HTML
• Adăugați noi formate prin extinderea metodei generate_activity_sheet()

---

⚡ SFATURI ȘI TRUCURI

Căutări Eficiente

1. Folosiți cuvinte cheie generale înainte de cele specifice
2. Combinați criterii multiple pentru rezultate mai precise
3. Verificați categoriile disponibile cu --categories
4. Consultați statisticile cu --stats pentru o vedere generală

Organizarea Rezultatelor

1. Exportați căutările importante pentru referințe viitoare
2. Generați fișe HTML pentru prezentări și printare
3. Salvați căutările frecvente ca scripturi personalizate
4. Creați colecții tematice pentru evenimente specifice

Optimizarea Performanței

1. Baza de date SQLite permite căutări rapide
2. Indexurile sunt create automat pentru criterii frecvente
3. Cache-ul păstrează rezultatele pentru sesiunea curentă
4. Backup-ul automat protejează datele

---

🐛 DEPANARE PROBLEME COMUNE

Probleme de Instalare

# Verificați Python
python --version   # Ar trebui să fie 3.7+

# Verificați dependențele
pip install sqlite3  # Dacă nu e disponibil

# Permisiuni fișiere
chmod +x game_library_manager.py
chmod +x search_games.py

Probleme de Căutare

• Nu găsește activități: Verificați ortografia și folosiți cuvinte cheie generale
• Prea multe rezultate: Adăugați criterii suplimentare pentru filtrare
• Erori baza de date: Ștergeți game_library.db și rulați din nou sistemul

Probleme de Generare Fișe

• Erori de encoding: Asigurați-vă că sistemul suportă UTF-8
• Fișiere mari: Folosiți filtrarea pentru a reduce numărul de rezultate
• Formatarea HTML: Verificați că browser-ul suportă CSS modern

---

📞 SUPORT ȘI CONTACT

Documentație Suplimentară

• Index Principal: INDEX_MASTER_JOCURI_ACTIVITATI.md
• Cod Sursă: game_library_manager.py (comentat detaliat)
• Exemple: Fișierele generate automat în directorul principal

Îmbunătățiri și Feedback

Pentru sugestii de îmbunătățire sau raportarea problemelor:

1. Consultați mai întâi acest ghid și documentația
2. Testați cu exemple simple înainte de cazuri complexe
3. Documentați pas cu pas problema întâlnită
4. Includeți versiunea Python și sistemul de operare

Dezvoltare Viitoare

Funcționalități planificate:

• Interfață web pentru căutări
• Export în format PDF
• Integrare cu calendar pentru planificare
• Evaluarea și rating-ul activităților
• Sincronizare cloud pentru echipe

---

🎉 Succese în organizarea activităților și jocurilor!

Generat automat cu Claude AI Assistant - 2025-09-09