Marius Mutu
fd87ebca03
- 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>
209 lines
5.8 KiB
Markdown
209 lines
5.8 KiB
Markdown
# 📖 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* |