game-library/docs/user/INSTALL.md

🛠️ 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
• pip - Instalat automat cu Python
• Browser modern - Chrome, Firefox, Safari, Edge

---

🚀 INSTALARE RAPIDĂ

Pasul 1: Verificați Python

# 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

# Pe Windows
cd "C:\path\to\INDEX-SISTEM-JOCURI"

# Pe Mac/Linux
cd /path/to/INDEX-SISTEM-JOCURI

Pasul 3: Instalați dependențele

pip install flask PyPDF2 python-docx beautifulsoup4 markdown pdfplumber

Pasul 4: Testați instalarea

python indexer.py --test-mode

Pasul 5: Porniți aplicația

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:

   python --version
   pip --version
   

2. Instalați dependențele

# 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

# 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)

# Folosind Homebrew (recomandat)
brew install python

# Sau descărcați de la python.org

2. Instalați dependențele

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

# 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

sudo apt update
sudo apt install python3 python3-pip python3-venv

# Verificați instalarea
python3 --version
pip3 --version

2. Instalați dependențele sistem

# 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

# 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)

python indexer.py --test-mode --clear-db

Indexare completă (toate fișierele)

python indexer.py --clear-db

⚠️ Atenție: Indexarea completă poate dura 10-30 minute pentru 100+ fișiere

2. Verificarea rezultatelor

# 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

python app.py

---

🐛 REZOLVAREA PROBLEMELOR DE INSTALARE

Erori comune și soluții

"Python is not recognized"

Windows:

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

# 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'"

# Verificați că sunteți în mediul corect
which python
which pip

# Reinstalați explicit
pip install --upgrade flask

Erori la procesarea PDF-urilor

# 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"

# Ștergeți fișierul bazei de date și recreați
rm activities.db
python indexer.py --test-mode --clear-db

Port 5000 este ocupat

# Modificați portul în app.py, linia finală:
# app.run(port=5001)  # sau orice alt port liber

---

🔐 CONFIGURARE AVANSATĂ

Environment Variables

# Windows
set FLASK_ENV=development
set FLASK_DEBUG=1

# Mac/Linux
export FLASK_ENV=development
export FLASK_DEBUG=1

Virtual Environment (Recomandat pentru dezvoltare)

# 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

# Î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

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

# 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