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