192 lines
5.7 KiB
Markdown
192 lines
5.7 KiB
Markdown
# 🎮 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* |