# 🎮 COLECȚIA JOCURI ȘI ACTIVITĂȚI TINERET

**200+ fișiere PDF | 2000+ activități catalogate | Sistem de căutare automatizat**

---

## 📁 STRUCTURA PROIECTULUI

```
INDEX-SISTEM-JOCURI/
├── 📊 data/                    # Baze de date SQLite
│   ├── activities.db          # Activități indexate
│   ├── game_library.db       # Biblioteca de jocuri
│   └── test_activities.db    # Date pentru testare
│
├── 📖 docs/                   # Documentație completă
│   ├── project/              # PRD, prompts, documente proiect
│   │   ├── PRD.md           # Product Requirements Document
│   │   ├── PROJECT_SUMMARY.md
│   │   └── PM_PROMPT*.md    # Prompt-uri pentru AI
│   └── user/                # Exemple și template-uri
│       └── FISA_EXEMPLU*.md # Exemple de fișe activități
│
├── 🐍 src/                   # Cod Python principal
│   ├── app.py               # Aplicația Flask web
│   ├── database.py          # Manager baze de date
│   ├── game_library_manager.py  # Script principal catalogare
│   ├── indexer.py           # Indexare automată activități
│   └── search_games.py      # Căutare interactivă
│
├── 🎨 static/               # Fișiere CSS/JS/imagini
│   └── style.css           # Stiluri pentru interfața web
│
├── 📄 templates/            # Template-uri Flask HTML
│   ├── index.html          # Pagina principală
│   ├── results.html        # Rezultate căutare
│   ├── fisa.html          # Vizualizare fișă activitate
│   ├── 404.html           # Pagină eroare 404
│   └── 500.html           # Pagină eroare server
│
├── 🔧 scripts/             # Script-uri utilitare
│   └── create_databases.py # Creare/inițializare baze de date
│
├── README.md              # Acest fișier
├── .gitignore            # Fișiere ignorate de Git
├── requirements.txt      # Dependențe Python
└── venv/                 # Environment virtual (după setup)
```

---

## 🔧 INSTALARE ȘI CONFIGURARE

### Cerințe de sistem:
- Python 3.8+ 
- pip (Python package manager)

### Setup environment virtual:
```bash
# Creați environment virtual
python -m venv venv

# Activați environment-ul
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Instalați dependențele
pip install -r requirements.txt
```

---

## 🚀 UTILIZARE RAPIDĂ

### 1. Căutare Manuală (Cel mai simplu)
```bash
# Deschideți fișierul în orice editor de text
docs/INDEX_MASTER_JOCURI_ACTIVITATI.md

# Căutați cu Ctrl+F:
"team building"     → Activități de echipă
"8-11 ani"         → Jocuri pentru Cubs
"fără materiale"   → Jocuri care nu necesită echipament
"orientare"        → Jocuri cu busole
```

### 2. Căutare Automatizată (Recomandat)
```bash
# Căutare interactivă din directorul principal
cd src && python search_games.py

# Căutări rapide
cd src && python search_games.py --category "Team Building"
cd src && python search_games.py --age 8 --keywords "cooperare"
```

### 3. Interfață Web (Nou!)
```bash
# Pornire server web Flask
cd src && python app.py

# Accesați în browser: http://localhost:5000
```

---

## 📊 STATISTICI COLECȚIE

- **📁 Total fișiere:** 200+
- **🎮 Total activități:** 2,000+  
- **📂 Categorii principale:** 8
- **🗣️ Limbi:** Română, Engleză
- **📄 Formate:** PDF (85%), DOC (10%), HTML (5%)

### Distribuția pe categorii:
- **🏕️ Jocuri Cercetășești:** 800+ activități (40%)
- **🤝 Team Building:** 300+ activități (15%)  
- **🏞️ Camping & Exterior:** 400+ activități (20%)
- **🧩 Escape Room & Puzzle:** 100+ activități (5%)
- **🧭 Orientare & Busole:** 80+ activități (4%)
- **🚑 Primul Ajutor:** 60+ activități (3%)
- **📚 Activități Educaționale:** 200+ activități (10%)
- **🎵 Resurse Speciale:** 60+ activități (3%)

---

## ⚡ EXEMPLE DE UTILIZARE

```bash
# Navigare în directorul sursă
cd src

# Jocuri pentru copii mici (5-8 ani)
python search_games.py --age 5

# Activități team building
python search_games.py --category "Team Building"

# Jocuri fără materiale  
python search_games.py --keywords "fără materiale"

# Activități de tabără
python search_games.py --keywords "camping,exterior"

# Indexare automată a unor noi activități
python indexer.py

# Administrare baze de date
python database.py
```

---

## 🎯 PENTRU DIFERITE TIPURI DE UTILIZATORI

### 🏕️ Organizatori de tabere:
- **Categorii:** Camping & Exterior, Orientare
- **Cuvinte cheie:** "tabără", "natură", "orientare", "supraviețuire"

### 👨‍🏫 Profesori și educatori:
- **Categorii:** Activități Educaționale, Team Building
- **Cuvinte cheie:** "științe", "biologie", "primul ajutor", "conflicte"

### 🏕️ Instructori Scout:
- **Categorii:** Jocuri Cercetășești  
- **Cuvinte cheie:** "Cubs", "Scouts", "cercetași", "Baden Powell"

### 🎪 Animatori evenimente:
- **Categorii:** Escape Room, Resurse Speciale
- **Cuvinte cheie:** "puzzle", "cântece", "interior", "fără materiale"

---

## 📖 DOCUMENTAȚIA COMPLETĂ

| Director/Fișier | Pentru ce |
|--------|-----------|
| **README.md** | Start rapid și exemple (acest fișier) |
| **docs/INDEX_MASTER_JOCURI_ACTIVITATI.md** | Catalogul complet (300+ pagini) |
| **docs/user/FISA_EXEMPLU*.md** | Exemple de fișe activități |
| **docs/DATABASE_SCHEMA.md** | Schema bazelor de date |
| **src/search_games.py** | Căutare automată în colecție |
| **src/app.py** | Interfața web Flask |

---

**🎉 Succese în organizarea activităților!**

*Pentru asistență detaliată: `docs/user/GHID_UTILIZARE.md`*  
*Sistem creat cu Claude AI - 2025-09-09*