Initial commit: Organize project structure
- Create organized directory structure (src/, docs/, data/, static/, templates/) - Add comprehensive .gitignore for Python projects - Move Python source files to src/ - Move documentation files to docs/ with project/ and user/ subdirectories - Move database files to data/ - Update all database path references in Python code - Maintain Flask static/ and templates/ directories 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
29
docs/user/FISA_EXEMPLU_cubs_acting_01.md
Normal file
29
docs/user/FISA_EXEMPLU_cubs_acting_01.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# FIȘA ACTIVITĂȚII: Animal Mimes
|
||||
|
||||
## 📋 INFORMAȚII GENERALE
|
||||
- **Categorie:** Jocuri Cercetășești → Acting Games
|
||||
- **Grupa de vârstă:** 8-11 ani
|
||||
- **Numărul participanților:** 8-30 copii
|
||||
- **Durata estimată:** 5-10 minute
|
||||
- **Nivel de dificultate:** Mediu
|
||||
|
||||
## 🎯 DESCRIEREA ACTIVITĂȚII
|
||||
Joc de imitare animale prin mimică, dezvoltă creativitatea și expresia corporală
|
||||
|
||||
## 🧰 MATERIALE NECESARE
|
||||
Fără materiale
|
||||
|
||||
## 💡 EXEMPLE DE APLICARE
|
||||
- Imitarea unui leu
|
||||
- Mișcarea unei broaște
|
||||
- Zborul unei păsări
|
||||
|
||||
## 🔗 SURSA
|
||||
**Fișier:** `./Activities and Games Scouts NZ/Cubs Acting Games.pdf`
|
||||
|
||||
## 🏷️ CUVINTE CHEIE
|
||||
acting, mimică, animale, creativitate, expresie
|
||||
|
||||
---
|
||||
**Generat automat:** 2025-09-09 22:46
|
||||
**ID Activitate:** cubs_acting_01
|
||||
318
docs/user/GHID_UTILIZARE.md
Normal file
318
docs/user/GHID_UTILIZARE.md
Normal file
@@ -0,0 +1,318 @@
|
||||
# 🎮 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
|
||||
```bash
|
||||
# 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ă
|
||||
```bash
|
||||
# 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ă
|
||||
```bash
|
||||
# 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)
|
||||
```python
|
||||
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`)
|
||||
```python
|
||||
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`)
|
||||
```python
|
||||
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
|
||||
```python
|
||||
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ă**
|
||||
```bash
|
||||
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ă**
|
||||
```bash
|
||||
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ă**
|
||||
```bash
|
||||
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**
|
||||
```bash
|
||||
python search_games.py --keywords "biologie,natură,științe"
|
||||
# Rezultat: Experimente și activități educaționale
|
||||
```
|
||||
|
||||
### 5. **Organizator evenimente caută escape room**
|
||||
```bash
|
||||
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
|
||||
```python
|
||||
# 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
|
||||
```bash
|
||||
# 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*
|
||||
348
docs/user/INSTALL.md
Normal file
348
docs/user/INSTALL.md
Normal file
@@ -0,0 +1,348 @@
|
||||
# 🛠️ GHID DE INSTALARE - INDEX-SISTEM-JOCURI
|
||||
|
||||
**Instrucțiuni complete pentru instalarea și configurarea sistemului**
|
||||
|
||||
---
|
||||
|
||||
## 📋 CERINȚE PREALABILE
|
||||
|
||||
### Sistem de operare
|
||||
- ✅ **Windows** 10/11
|
||||
- ✅ **macOS** 10.15+
|
||||
- ✅ **Linux** (Ubuntu, Debian, CentOS, etc.)
|
||||
|
||||
### Software necesar
|
||||
- **Python 3.8+** - [Descărcați aici](https://python.org/downloads)
|
||||
- **pip** - Instalat automat cu Python
|
||||
- **Browser modern** - Chrome, Firefox, Safari, Edge
|
||||
|
||||
---
|
||||
|
||||
## 🚀 INSTALARE RAPIDĂ
|
||||
|
||||
### Pasul 1: Verificați Python
|
||||
```bash
|
||||
# Verificați versiunea Python
|
||||
python --version
|
||||
# sau
|
||||
python3 --version
|
||||
|
||||
# Trebuie să vedeți: Python 3.8.x sau mai nou
|
||||
```
|
||||
|
||||
### Pasul 2: Navigați la director
|
||||
```bash
|
||||
# Pe Windows
|
||||
cd "C:\path\to\INDEX-SISTEM-JOCURI"
|
||||
|
||||
# Pe Mac/Linux
|
||||
cd /path/to/INDEX-SISTEM-JOCURI
|
||||
```
|
||||
|
||||
### Pasul 3: Instalați dependențele
|
||||
```bash
|
||||
pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
```
|
||||
|
||||
### Pasul 4: Testați instalarea
|
||||
```bash
|
||||
python indexer.py --test-mode
|
||||
```
|
||||
|
||||
### Pasul 5: Porniți aplicația
|
||||
```bash
|
||||
python app.py
|
||||
```
|
||||
|
||||
### Pasul 6: Accesați interfața
|
||||
Deschideți browserul la: **http://localhost:5000**
|
||||
|
||||
---
|
||||
|
||||
## 🔧 INSTALARE DETALIATĂ
|
||||
|
||||
### Pentru Windows
|
||||
|
||||
#### 1. Instalați Python
|
||||
1. Descărcați Python de la https://python.org/downloads
|
||||
2. Rulați installer-ul cu opțiunea "Add Python to PATH" bifată
|
||||
3. Verificați instalarea în Command Prompt:
|
||||
```cmd
|
||||
python --version
|
||||
pip --version
|
||||
```
|
||||
|
||||
#### 2. Instalați dependențele
|
||||
```cmd
|
||||
# Deschideți Command Prompt ca Administrator
|
||||
pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
|
||||
# În caz de eroare, încercați:
|
||||
python -m pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
```
|
||||
|
||||
#### 3. Configurați sistemul
|
||||
```cmd
|
||||
# Navigați la directorul sistemului
|
||||
cd "D:\GoogleDrive\Cercetasi\carti-camp-jocuri\INDEX-SISTEM-JOCURI"
|
||||
|
||||
# Testați indexer-ul
|
||||
python indexer.py --test-mode --max-files 3
|
||||
```
|
||||
|
||||
### Pentru macOS
|
||||
|
||||
#### 1. Instalați Python (dacă nu este instalat)
|
||||
```bash
|
||||
# Folosind Homebrew (recomandat)
|
||||
brew install python
|
||||
|
||||
# Sau descărcați de la python.org
|
||||
```
|
||||
|
||||
#### 2. Instalați dependențele
|
||||
```bash
|
||||
pip3 install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
|
||||
# În caz de probleme cu permisiuni:
|
||||
pip3 install --user flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
```
|
||||
|
||||
#### 3. Configurați sistemul
|
||||
```bash
|
||||
# Navigați la directorul sistemului
|
||||
cd "/Users/username/GoogleDrive/Cercetasi/carti-camp-jocuri/INDEX-SISTEM-JOCURI"
|
||||
|
||||
# Testați indexer-ul
|
||||
python3 indexer.py --test-mode
|
||||
```
|
||||
|
||||
### Pentru Linux (Ubuntu/Debian)
|
||||
|
||||
#### 1. Instalați Python și pip
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt install python3 python3-pip python3-venv
|
||||
|
||||
# Verificați instalarea
|
||||
python3 --version
|
||||
pip3 --version
|
||||
```
|
||||
|
||||
#### 2. Instalați dependențele sistem
|
||||
```bash
|
||||
# Pentru procesarea PDF-urilor
|
||||
sudo apt install python3-dev
|
||||
|
||||
# Instalați pachetele Python
|
||||
pip3 install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
```
|
||||
|
||||
#### 3. Configurați sistemul
|
||||
```bash
|
||||
# Navigați la directorul sistemului
|
||||
cd "/home/username/GoogleDrive/Cercetasi/carti-camp-jocuri/INDEX-SISTEM-JOCURI"
|
||||
|
||||
# Dați permisiuni de execuție
|
||||
chmod +x indexer.py app.py
|
||||
|
||||
# Testați sistemul
|
||||
python3 indexer.py --test-mode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🗃️ CONFIGURARE INIȚIALĂ
|
||||
|
||||
### 1. Indexarea primelor fișiere
|
||||
|
||||
#### Indexare test (5 fișiere)
|
||||
```bash
|
||||
python indexer.py --test-mode --clear-db
|
||||
```
|
||||
|
||||
#### Indexare completă (toate fișierele)
|
||||
```bash
|
||||
python indexer.py --clear-db
|
||||
```
|
||||
|
||||
**⚠️ Atenție:** Indexarea completă poate dura 10-30 minute pentru 100+ fișiere
|
||||
|
||||
### 2. Verificarea rezultatelor
|
||||
```bash
|
||||
# Verificați numărul de activități indexate
|
||||
python -c "
|
||||
from database import DatabaseManager
|
||||
db = DatabaseManager('activities.db')
|
||||
stats = db.get_statistics()
|
||||
print(f'Total activități: {stats[\"total_activities\"]}')
|
||||
print(f'Categorii: {list(stats[\"categories\"].keys())}')
|
||||
"
|
||||
```
|
||||
|
||||
### 3. Pornirea serviciului web
|
||||
```bash
|
||||
python app.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 REZOLVAREA PROBLEMELOR DE INSTALARE
|
||||
|
||||
### Erori comune și soluții
|
||||
|
||||
#### "Python is not recognized"
|
||||
**Windows:**
|
||||
```cmd
|
||||
# Reinstalați Python cu "Add to PATH" bifat
|
||||
# Sau adaugați manual la PATH:
|
||||
set PATH=%PATH%;C:\Python39;C:\Python39\Scripts
|
||||
```
|
||||
|
||||
#### "Permission denied" pe pip install
|
||||
**Mac/Linux:**
|
||||
```bash
|
||||
# Folosiți --user flag
|
||||
pip3 install --user flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
|
||||
# Sau creați un virtual environment
|
||||
python3 -m venv myenv
|
||||
source myenv/bin/activate # Mac/Linux
|
||||
# myenv\Scripts\activate # Windows
|
||||
pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
```
|
||||
|
||||
#### "No module named 'flask'"
|
||||
```bash
|
||||
# Verificați că sunteți în mediul corect
|
||||
which python
|
||||
which pip
|
||||
|
||||
# Reinstalați explicit
|
||||
pip install --upgrade flask
|
||||
```
|
||||
|
||||
#### Erori la procesarea PDF-urilor
|
||||
```bash
|
||||
# Instalați dependențe suplimentare
|
||||
pip install pdfplumber PyPDF2 --upgrade
|
||||
|
||||
# Pe Linux, poate fi nevoie de:
|
||||
sudo apt install python3-dev libffi-dev
|
||||
```
|
||||
|
||||
#### "Database is locked"
|
||||
```bash
|
||||
# Ștergeți fișierul bazei de date și recreați
|
||||
rm activities.db
|
||||
python indexer.py --test-mode --clear-db
|
||||
```
|
||||
|
||||
#### Port 5000 este ocupat
|
||||
```bash
|
||||
# Modificați portul în app.py, linia finală:
|
||||
# app.run(port=5001) # sau orice alt port liber
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔐 CONFIGURARE AVANSATĂ
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# Windows
|
||||
set FLASK_ENV=development
|
||||
set FLASK_DEBUG=1
|
||||
|
||||
# Mac/Linux
|
||||
export FLASK_ENV=development
|
||||
export FLASK_DEBUG=1
|
||||
```
|
||||
|
||||
### Virtual Environment (Recomandat pentru dezvoltare)
|
||||
```bash
|
||||
# Creați environment
|
||||
python -m venv venv
|
||||
|
||||
# Activați
|
||||
source venv/bin/activate # Mac/Linux
|
||||
venv\Scripts\activate # Windows
|
||||
|
||||
# Instalați dependențele
|
||||
pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber
|
||||
|
||||
# Dezactivați când terminați
|
||||
deactivate
|
||||
```
|
||||
|
||||
### Configurare pentru producție
|
||||
```python
|
||||
# În app.py, pentru producție schimbați:
|
||||
app.run(
|
||||
host='127.0.0.1', # doar localhost
|
||||
port=5000,
|
||||
debug=False, # dezactivați debug
|
||||
threaded=True
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ VERIFICAREA INSTALĂRII
|
||||
|
||||
### Checklist final
|
||||
- [ ] Python 3.8+ instalat și funcțional
|
||||
- [ ] Toate dependențele pip instalate fără erori
|
||||
- [ ] `python indexer.py --test-mode` rulează cu succes
|
||||
- [ ] `python app.py` pornește fără erori
|
||||
- [ ] http://localhost:5000 se încarcă în browser
|
||||
- [ ] Interfața afișează statistici (numărul de activități)
|
||||
- [ ] Căutarea funcționează (există cel puțin 1 rezultat)
|
||||
- [ ] Generarea fișelor funcționează
|
||||
|
||||
### Test complet
|
||||
```bash
|
||||
# 1. Test indexer
|
||||
python indexer.py --test-mode --clear-db
|
||||
|
||||
# 2. Test statistici
|
||||
python -c "
|
||||
from database import DatabaseManager
|
||||
db = DatabaseManager('activities.db')
|
||||
print('Stats:', db.get_statistics())
|
||||
"
|
||||
|
||||
# 3. Test server (într-un terminal separat)
|
||||
python app.py
|
||||
|
||||
# 4. Test API (într-un alt terminal)
|
||||
curl http://localhost:5000/api/statistics
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🆘 SUPORT INSTALARE
|
||||
|
||||
### În caz de probleme:
|
||||
|
||||
1. **Verificați versiunea Python:** `python --version`
|
||||
2. **Verificați permisiunile:** Rulați ca administrator/root dacă e necesar
|
||||
3. **Verificați spațiul pe disk:** Minim 100MB liber
|
||||
4. **Verificați conexiunea internet:** Pentru descărcarea dependențelor
|
||||
|
||||
### Informații pentru suport:
|
||||
```bash
|
||||
# Colectați informații sistem pentru suport
|
||||
python -c "
|
||||
import sys
|
||||
import platform
|
||||
print('Python:', sys.version)
|
||||
print('Platform:', platform.platform())
|
||||
print('Architecture:', platform.architecture())
|
||||
"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**🎮 INDEX-SISTEM-JOCURI v1.0**
|
||||
*Ghid de instalare - Actualizat Septembrie 2025*
|
||||
134
docs/user/README.md
Normal file
134
docs/user/README.md
Normal file
@@ -0,0 +1,134 @@
|
||||
# 🎮 COLECȚIA JOCURI ȘI ACTIVITĂȚI TINERET
|
||||
|
||||
**200+ fișiere PDF | 2000+ activități catalogate | Sistem de căutare automatizat**
|
||||
|
||||
---
|
||||
|
||||
## 📁 STRUCTURA DIRECTORULUI
|
||||
|
||||
```
|
||||
/carti-camp-jocuri/
|
||||
├── 📚 Fișiere PDF originale (200+ fișiere)
|
||||
│ ├── Activities and Games Scouts NZ/
|
||||
│ ├── dragon.sleepdeprived.ca/
|
||||
│ ├── escape-room/
|
||||
│ ├── prim-ajutor/
|
||||
│ └── ...și multe altele
|
||||
│
|
||||
└── 📋 INDEX-SISTEM-JOCURI/ ← SISTEMUL DE CATALOGARE
|
||||
├── INDEX_MASTER_JOCURI_ACTIVITATI.md (Catalogul complet)
|
||||
├── GHID_UTILIZARE.md (Manual detaliat)
|
||||
├── README.md (Start rapid)
|
||||
├── game_library_manager.py (Script principal)
|
||||
├── search_games.py (Căutare interactivă)
|
||||
└── game_library.db (Baza de date)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 UTILIZARE RAPIDĂ
|
||||
|
||||
### 1. Căutare Manuală (Cel mai simplu)
|
||||
```bash
|
||||
# Deschideți fișierul în orice editor de text
|
||||
INDEX-SISTEM-JOCURI/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
|
||||
# Intrați în directorul sistemului
|
||||
cd INDEX-SISTEM-JOCURI
|
||||
|
||||
# Căutare interactivă (urmați instrucțiunile)
|
||||
python search_games.py
|
||||
|
||||
# Căutări rapide
|
||||
python search_games.py --category "Team Building"
|
||||
python search_games.py --age 8 --keywords "cooperare"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 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
|
||||
cd INDEX-SISTEM-JOCURI
|
||||
|
||||
# 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"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 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Ă
|
||||
|
||||
Consultați subdirectorul **`INDEX-SISTEM-JOCURI/`** pentru:
|
||||
|
||||
| Fișier | Pentru ce |
|
||||
|--------|-----------|
|
||||
| **README.md** | Start rapid și exemple |
|
||||
| **INDEX_MASTER_JOCURI_ACTIVITATI.md** | Catalogul complet (300+ pagini) |
|
||||
| **GHID_UTILIZARE.md** | Manual detaliat de utilizare |
|
||||
| **search_games.py** | Căutare automată în colecție |
|
||||
|
||||
---
|
||||
|
||||
**🎉 Succese în organizarea activităților!**
|
||||
|
||||
*Pentru asistență detaliată: `INDEX-SISTEM-JOCURI/GHID_UTILIZARE.md`*
|
||||
*Sistem creat cu Claude AI - 2025-09-09*
|
||||
209
docs/user/USAGE.md
Normal file
209
docs/user/USAGE.md
Normal file
@@ -0,0 +1,209 @@
|
||||
# 📖 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*
|
||||
Reference in New Issue
Block a user