Compare commits
2 Commits
7cb308d03f
...
ed0fc0d010
| Author | SHA1 | Date | |
|---|---|---|---|
| ed0fc0d010 | |||
| f47a31812e |
2
.gitignore
vendored
2
.gitignore
vendored
@@ -178,4 +178,4 @@ Desktop.ini
|
||||
.LSOverride
|
||||
|
||||
# Linux
|
||||
*~
|
||||
*~desktop.ini
|
||||
|
||||
122
README.md
122
README.md
@@ -4,24 +4,70 @@
|
||||
|
||||
---
|
||||
|
||||
## 📁 STRUCTURA DIRECTORULUI
|
||||
## 📁 STRUCTURA PROIECTULUI
|
||||
|
||||
```
|
||||
/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/
|
||||
├── 📊 data/ # Baze de date SQLite
|
||||
│ ├── activities.db # Activități indexate
|
||||
│ ├── game_library.db # Biblioteca de jocuri
|
||||
│ └── test_activities.db # Date pentru testare
|
||||
│
|
||||
└── 📋 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)
|
||||
├── 📖 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
|
||||
```
|
||||
|
||||
---
|
||||
@@ -31,7 +77,7 @@
|
||||
### 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
|
||||
docs/INDEX_MASTER_JOCURI_ACTIVITATI.md
|
||||
|
||||
# Căutați cu Ctrl+F:
|
||||
"team building" → Activități de echipă
|
||||
@@ -42,15 +88,20 @@ INDEX-SISTEM-JOCURI/INDEX_MASTER_JOCURI_ACTIVITATI.md
|
||||
|
||||
### 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ăutare interactivă din directorul principal
|
||||
cd src && python search_games.py
|
||||
|
||||
# Căutări rapide
|
||||
python search_games.py --category "Team Building"
|
||||
python search_games.py --age 8 --keywords "cooperare"
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
@@ -78,7 +129,8 @@ python search_games.py --age 8 --keywords "cooperare"
|
||||
## ⚡ EXEMPLE DE UTILIZARE
|
||||
|
||||
```bash
|
||||
cd INDEX-SISTEM-JOCURI
|
||||
# Navigare în directorul sursă
|
||||
cd src
|
||||
|
||||
# Jocuri pentru copii mici (5-8 ani)
|
||||
python search_games.py --age 5
|
||||
@@ -91,6 +143,12 @@ 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
|
||||
```
|
||||
|
||||
---
|
||||
@@ -117,18 +175,18 @@ python search_games.py --keywords "camping,exterior"
|
||||
|
||||
## 📖 DOCUMENTAȚIA COMPLETĂ
|
||||
|
||||
Consultați subdirectorul **`INDEX-SISTEM-JOCURI/`** pentru:
|
||||
|
||||
| Fișier | Pentru ce |
|
||||
| Director/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 |
|
||||
| **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ă: `INDEX-SISTEM-JOCURI/GHID_UTILIZARE.md`*
|
||||
*Pentru asistență detaliată: `docs/user/GHID_UTILIZARE.md`*
|
||||
*Sistem creat cu Claude AI - 2025-09-09*
|
||||
@@ -1,318 +0,0 @@
|
||||
# 🎮 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*
|
||||
@@ -1,348 +0,0 @@
|
||||
# 🛠️ 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*
|
||||
@@ -1,209 +0,0 @@
|
||||
# 📖 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*
|
||||
2
requirements.txt
Normal file
2
requirements.txt
Normal file
@@ -0,0 +1,2 @@
|
||||
Flask==2.3.3
|
||||
pathlib2==2.3.7
|
||||
Reference in New Issue
Block a user