curatare readme
This commit is contained in:
122
README.md
122
README.md
@@ -4,24 +4,70 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📁 STRUCTURA DIRECTORULUI
|
## 📁 STRUCTURA PROIECTULUI
|
||||||
|
|
||||||
```
|
```
|
||||||
/carti-camp-jocuri/
|
INDEX-SISTEM-JOCURI/
|
||||||
├── 📚 Fișiere PDF originale (200+ fișiere)
|
├── 📊 data/ # Baze de date SQLite
|
||||||
│ ├── Activities and Games Scouts NZ/
|
│ ├── activities.db # Activități indexate
|
||||||
│ ├── dragon.sleepdeprived.ca/
|
│ ├── game_library.db # Biblioteca de jocuri
|
||||||
│ ├── escape-room/
|
│ └── test_activities.db # Date pentru testare
|
||||||
│ ├── prim-ajutor/
|
|
||||||
│ └── ...și multe altele
|
|
||||||
│
|
│
|
||||||
└── 📋 INDEX-SISTEM-JOCURI/ ← SISTEMUL DE CATALOGARE
|
├── 📖 docs/ # Documentație completă
|
||||||
├── INDEX_MASTER_JOCURI_ACTIVITATI.md (Catalogul complet)
|
│ ├── project/ # PRD, prompts, documente proiect
|
||||||
├── GHID_UTILIZARE.md (Manual detaliat)
|
│ │ ├── PRD.md # Product Requirements Document
|
||||||
├── README.md (Start rapid)
|
│ │ ├── PROJECT_SUMMARY.md
|
||||||
├── game_library_manager.py (Script principal)
|
│ │ └── PM_PROMPT*.md # Prompt-uri pentru AI
|
||||||
├── search_games.py (Căutare interactivă)
|
│ └── user/ # Exemple și template-uri
|
||||||
└── game_library.db (Baza de date)
|
│ └── 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)
|
### 1. Căutare Manuală (Cel mai simplu)
|
||||||
```bash
|
```bash
|
||||||
# Deschideți fișierul în orice editor de text
|
# 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:
|
# Căutați cu Ctrl+F:
|
||||||
"team building" → Activități de echipă
|
"team building" → Activități de echipă
|
||||||
@@ -42,15 +88,20 @@ INDEX-SISTEM-JOCURI/INDEX_MASTER_JOCURI_ACTIVITATI.md
|
|||||||
|
|
||||||
### 2. Căutare Automatizată (Recomandat)
|
### 2. Căutare Automatizată (Recomandat)
|
||||||
```bash
|
```bash
|
||||||
# Intrați în directorul sistemului
|
# Căutare interactivă din directorul principal
|
||||||
cd INDEX-SISTEM-JOCURI
|
cd src && python search_games.py
|
||||||
|
|
||||||
# Căutare interactivă (urmați instrucțiunile)
|
|
||||||
python search_games.py
|
|
||||||
|
|
||||||
# Căutări rapide
|
# Căutări rapide
|
||||||
python search_games.py --category "Team Building"
|
cd src && python search_games.py --category "Team Building"
|
||||||
python search_games.py --age 8 --keywords "cooperare"
|
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
|
## ⚡ EXEMPLE DE UTILIZARE
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd INDEX-SISTEM-JOCURI
|
# Navigare în directorul sursă
|
||||||
|
cd src
|
||||||
|
|
||||||
# Jocuri pentru copii mici (5-8 ani)
|
# Jocuri pentru copii mici (5-8 ani)
|
||||||
python search_games.py --age 5
|
python search_games.py --age 5
|
||||||
@@ -91,6 +143,12 @@ python search_games.py --keywords "fără materiale"
|
|||||||
|
|
||||||
# Activități de tabără
|
# Activități de tabără
|
||||||
python search_games.py --keywords "camping,exterior"
|
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Ă
|
## 📖 DOCUMENTAȚIA COMPLETĂ
|
||||||
|
|
||||||
Consultați subdirectorul **`INDEX-SISTEM-JOCURI/`** pentru:
|
| Director/Fișier | Pentru ce |
|
||||||
|
|
||||||
| Fișier | Pentru ce |
|
|
||||||
|--------|-----------|
|
|--------|-----------|
|
||||||
| **README.md** | Start rapid și exemple |
|
| **README.md** | Start rapid și exemple (acest fișier) |
|
||||||
| **INDEX_MASTER_JOCURI_ACTIVITATI.md** | Catalogul complet (300+ pagini) |
|
| **docs/INDEX_MASTER_JOCURI_ACTIVITATI.md** | Catalogul complet (300+ pagini) |
|
||||||
| **GHID_UTILIZARE.md** | Manual detaliat de utilizare |
|
| **docs/user/FISA_EXEMPLU*.md** | Exemple de fișe activități |
|
||||||
| **search_games.py** | Căutare automată în colecție |
|
| **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!**
|
**🎉 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*
|
*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