Files
game-library/README.md
2025-09-10 23:19:45 +03:00

5.7 KiB

🎮 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:

# 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)

# 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)

# 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!)

# 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

# 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