curatare readme

This commit is contained in:
2025-09-10 23:19:45 +03:00
parent 7cb308d03f
commit f47a31812e
5 changed files with 92 additions and 907 deletions

122
README.md
View File

@@ -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*