diff --git a/README.md b/README.md index 7334a00..8034909 100644 --- a/README.md +++ b/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* \ No newline at end of file diff --git a/docs/user/GHID_UTILIZARE.md b/docs/user/GHID_UTILIZARE.md deleted file mode 100644 index fc8a220..0000000 --- a/docs/user/GHID_UTILIZARE.md +++ /dev/null @@ -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* \ No newline at end of file diff --git a/docs/user/INSTALL.md b/docs/user/INSTALL.md deleted file mode 100644 index 1e624ad..0000000 --- a/docs/user/INSTALL.md +++ /dev/null @@ -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* \ No newline at end of file diff --git a/docs/user/USAGE.md b/docs/user/USAGE.md deleted file mode 100644 index 00eaf6c..0000000 --- a/docs/user/USAGE.md +++ /dev/null @@ -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* \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..b1a6ab0 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,2 @@ +Flask==2.3.3 +pathlib2==2.3.7 \ No newline at end of file