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>
2025-09-10 00:40:39 +03:00
commit fd87ebca03
23 changed files with 7317 additions and 0 deletions
--- a/docs/project/PRD.md
+++ b/docs/project/PRD.md
@@ -0,0 +1,213 @@
+# Product Requirements Document (PRD)
+## Sistem de Indexare și Căutare Activități Educaționale
+
+### 1. OVERVIEW
+
+**Nume Produs:** INDEX-SISTEM-JOCURI  
+**Versiune:** 1.0  
+**Data:** Septembrie 2025  
+**Obiectiv:** Sistem web simplu pentru indexarea, căutarea și generarea de fișe pentru activități educaționale din diverse formate de fișiere.
+
+### 2. PROBLEMA ȘI SOLUȚIA
+
+**Problema:**
+- Activități educaționale stocate în ~100+ fișiere de tipuri diferite (PDF, DOC, HTML, MD, TXT)
+- Căutarea manuală prin fișiere este ineficientă
+- Lipsește o modalitate rapidă de a genera fișe de activități
+
+**Soluția:**
+- Sistem de indexare automată multi-format
+- Interfață web cu filtre avansate pentru căutare
+- Generator de fișe HTML fără dependințe LLM
+
+### 3. CERINȚE FUNCȚIONALE
+
+#### 3.1 Indexare Activități
+- **RF1:** Extragerea automată de activități din fișiere PDF, DOC/DOCX, HTML, MD, TXT
+- **RF2:** Detectarea automată a parametrilor: titlu, descriere, vârstă, durată, materiale, participanți
+- **RF3:** Indexare inițială batch pentru toate fișierele existente
+- **RF4:** Indexare incrementală pentru fișiere noi/modificate
+- **RF5:** Progress tracking pentru procesul de indexare
+
+#### 3.2 Interfață Web de Căutare
+- **RF6:** Layout identic cu mockup-ul furnizat (interfata-web.jpg)
+- **RF7:** Search box pentru căutare text liberă
+- **RF8:** 9 filtre dropdown:
+  - Valori (categorie)
+  - Durată (5-15min, 15-30min, 30+min)
+  - Tematică (cercetășesc, team building, educativ)
+  - Domeniu (sport, artă, știință)
+  - Metodă (joc, poveste, atelier)
+  - Materiale necesare (fără, simple, complexe)
+  - Competențe (fizice, mentale, sociale)
+  - Număr participanți (2-5, 5-10, 10-30, 30+)
+  - Vârstă (5-8, 8-12, 12-16, 16+)
+- **RF9:** Butoane "Aplică" și "Resetează"
+- **RF10:** Afișare rezultate în tabel cu coloane: Titlu, Detalii, Metodă, Temă, Valori
+- **RF11:** Link către fișierul sursă pentru fiecare rezultat
+
+#### 3.3 Generator Fișe Activități
+- **RF12:** Buton "Generează fișă" pentru fiecare activitate
+- **RF13:** Template HTML predefinit pentru fișe
+- **RF14:** Algoritm de recomandări bazat pe similaritate (tags, categorie, vârstă)
+- **RF15:** Fișa să conțină:
+  - Informații complete activitate
+  - Instrucțiuni pas cu pas
+  - Lista materiale cu checklist
+  - 3-5 activități similare recomandate
+- **RF16:** Export fișă ca HTML printabil
+- **RF17:** Funcție de copiere conținut fișă
+
+### 4. CERINȚE NON-FUNCȚIONALE
+
+#### 4.1 Performance
+- **NFR1:** Căutarea să returneze rezultate în <2 secunde
+- **NFR2:** Indexarea să proceseze 100+ fișiere în <10 minute
+- **NFR3:** Interfața să fie responsivă pe desktop/tablet
+
+#### 4.2 Usability
+- **NFR4:** Interfață simplă, intuitivă, fără învățare necesară
+- **NFR5:** Feedback vizual pentru toate acțiunile (loading, success, errors)
+- **NFR6:** Mesaje de eroare clare și acționabile
+
+#### 4.3 Maintainability
+- **NFR7:** Cod Python simplu, well-documented, <500 linii total
+- **NFR8:** Dependințe minime (Flask + biblioteci standard)
+- **NFR9:** Baza de date SQLite simplă, fără migrări complexe
+
+### 5. ARHITECTURA TEHNICĂ
+
+#### 5.1 Stack Tehnologic
+- **Backend:** Python 3.8+, Flask
+- **Frontend:** HTML5, CSS3, JavaScript vanilla
+- **Database:** SQLite
+- **Libraries:** PyPDF2, python-docx, BeautifulSoup4, markdown
+
+#### 5.2 Structura Fișiere
+```
+INDEX-SISTEM-JOCURI/
+├── app.py              # Flask server principal (~200 linii)
+├── indexer.py          # Script indexare multi-format (~150 linii)
+├── database.py         # Helper SQLite (~50 linii)
+├── templates/
+│   ├── index.html      # Pagina căutare (~100 linii)
+│   ├── results.html    # Afișare rezultate (~50 linii)
+│   └── fisa.html       # Template fișă activitate (~50 linii)
+├── static/
+│   └── style.css       # CSS minimal (~50 linii)
+├── activities.db       # Baza de date SQLite
+├── PRD.md              # Acest document
+└── PM_PROMPT.md        # Prompt pentru project manager
+```
+
+#### 5.3 Schema Baza de Date
+```sql
+CREATE TABLE activities (
+    id INTEGER PRIMARY KEY,
+    title TEXT NOT NULL,
+    description TEXT,
+    file_path TEXT NOT NULL,
+    file_type TEXT,         -- pdf, doc, html, md, txt
+    page_number INTEGER,
+    tags TEXT,              -- JSON array cu tags
+    category TEXT,
+    age_group TEXT,
+    participants TEXT,
+    duration TEXT,
+    materials TEXT,
+    difficulty TEXT DEFAULT 'mediu',
+    source_text TEXT,       -- full text pentru căutare FTS
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE VIRTUAL TABLE activities_fts USING fts5(
+    title, description, source_text,
+    content='activities'
+);
+```
+
+### 6. FLUXUL UTILIZATORULUI
+
+#### 6.1 Indexare Inițială
+1. Admin rulează `python indexer.py --full`
+2. Scriptul scanează toate fișierele din directoare
+3. Extrage activități folosind parsere specializate
+4. Salvează în baza de date cu progress feedback
+5. Creează indexul full-text pentru căutare rapidă
+
+#### 6.2 Căutare Activități
+1. Utilizatorul accesează http://localhost:5000
+2. Setează filtre din dropdown-uri (opțional)
+3. Introduce termeni în search box (opțional)
+4. Apasă "Aplică" sau Enter
+5. Vezi rezultatele în tabel
+6. Click pe titlu pentru a vedea fișierul sursă
+
+#### 6.3 Generare Fișă
+1. Din rezultate, click "Generează fișă" la o activitate
+2. Sistemul creează fișă HTML cu template predefinit
+3. Algoritm găsește 3-5 activități similare
+4. Afișează fișa completă în pagină nouă
+5. Opțiune printare sau copiere conținut
+
+### 7. CRITERII DE ACCEPTANȚĂ
+
+#### 7.1 MVP (Minimum Viable Product)
+- ✅ Indexează activități din PDF, DOC, HTML, MD, TXT
+- ✅ Interfață web cu search și 9 filtre
+- ✅ Afișare rezultate cu link la sursă
+- ✅ Generare fișe HTML simple
+
+#### 7.2 Success Metrics
+- Indexează >90% din activitățile existente corect
+- Timpul de căutare <2 secunde pentru orice query
+- Interfața funcționează pe Chrome, Firefox, Safari
+- Fișele generate sunt printabile și utile
+
+### 8. RISCURI ȘI MITIGĂRI
+
+| Risc | Probabilitate | Impact | Mitigare |
+|------|--------------|---------|-----------|
+| Parsarea PDF-urilor eșuează | Medie | Mare | Folosire PyPDF2 + pdfplumber ca backup |
+| Detectarea automată parametri inexactă | Mare | Medie | Pattern-uri regex + validare manuală opțională |
+| Performance slab la căutare | Mică | Mare | Index FTS SQLite + limitare rezultate |
+| Interfața nu seamănă cu mockup | Mică | Mică | Review iterativ cu feedback vizual |
+
+### 9. TIMELINE ESTIMAT
+
+| Fază | Durata | Deliverables |
+|------|--------|--------------|
+| **Sprint 1** | 2-3 zile | Indexer funcțional pentru toate formatele |
+| **Sprint 2** | 2-3 zile | Interfață web cu căutare și filtre |
+| **Sprint 3** | 1-2 zile | Generator fișe HTML cu recomandări |
+| **Sprint 4** | 1 zi | Testing, bug fixes, documentație |
+
+**Total:** 6-9 zile lucru
+
+### 10. DEPENDENCIES
+
+#### 10.1 Externe
+- Python 3.8+ instalat
+- Acces la fișierele existente în `/mnt/d/GoogleDrive/Cercetasi/carti-camp-jocuri/`
+- Browser modern pentru testare
+
+#### 10.2 Interne  
+- Baza de date SQLite existentă (`game_library.db`) ca referință
+- Mockup interfață (`interfata-web.jpg`) pentru design
+- Colecția existentă de activități ca date de test
+
+### 11. SUCCESS CRITERIA
+
+**Produs finalizat când:**
+1. ✅ Indexer poate procesa toate tipurile de fișiere fără erori
+2. ✅ Interfața web arată identic cu mockup-ul
+3. ✅ Căutarea returnează rezultate relevante rapid
+4. ✅ Fișele generate sunt complete și utile
+5. ✅ Sistemul poate fi rulat local fără configurare complexă
+6. ✅ Documentația permite unei terțe părți să înțeleagă și să folosească sistemul
+
+---
+
+**Autor:** Claude AI Assistant  
+**Review:** [To be completed by stakeholders]  
+**Approval:** [To be completed by product owner]