# 📖 GHID DE UTILIZARE - INDEX-SISTEM-JOCURI

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

---

## 🚀 START RAPID

### 1. Pornirea sistemului
```bash
# 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ă)
```bash
python indexer.py --clear-db
```

#### Indexare incrementală (fișiere noi)
```bash
python indexer.py
```

#### Indexare în modul test (5 fișiere)
```bash
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
```bash
# 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*