# NewsTrader — Ghid de instalare pas cu pas (Hostico / cPanel)

Acest ghid te duce de la zero la o platformă funcțională, cu date reale.
Estimat: 15–30 de minute. Pentru cripto poți porni **fără nicio cheie**.

---

## 0. De ce ai nevoie
- Un cont de hosting cu **PHP ≥ 8.0**, extensiile **pdo_mysql, curl, openssl, mbstring** (Hostico le are).
- Acces la **cPanel** (File Manager + MySQL Databases).
- Opțional: chei API pentru modelele AI (măcar una: Claude / Gemini / OpenAI / DeepSeek).

---

## 1. Baza de date
1. cPanel → **MySQL® Databases**.
2. Creează o bază (ex: `user_newstrader`).
3. Creează un utilizator + parolă și **adaugă-l la bază** cu **All Privileges**.
4. Notează: nume bază, utilizator, parolă, host (de obicei `localhost`).

## 2. Urcă fișierele
1. Dezarhivează `newstrader-vX.Y.zip` local.
2. cPanel → **File Manager** → urcă folderul `newstrader/` într-un loc web-accesibil,
   ex: `public_html/semnale/`.
   - Astfel vei accesa: `https://domeniul-tau.ro/semnale/install/index.php`.
   - (Alternativ, un subdomeniu cu document root pe folder.)
3. Dă folderului **`config/`** drept de scriere: selectează-l → **Permissions** → `775`.
   > ⚠️ Nu pune document root direct pe `public/` — `install/`, `migrate.php` și `cron/`
   > sunt frați cu `public/` și trebuie să rămână accesibili.

## 3. Rulează installer-ul
1. Deschide `https://domeniul-tau.ro/semnale/install/index.php`.
2. Urmează cei 4 pași: cerințe → baza de date → cont admin → finalizare.
3. La final, **notează CRON_KEY** afișat (îți trebuie la cron).
4. **Șterge folderul `/install`** de pe server (securitate). Poți readuce `config/` la `755`.

## 4. Intră și configurează (Admin → Setări)
1. Loghează-te la `.../public/index.php`.
2. **Provideri AI:** pune cel puțin o cheie (Claude / Gemini / OpenAI / DeepSeek),
   bifează providerii doriți, alege arbitrul. (Un singur provider e ok pentru început.)
3. **Surse de date** — alege cea mai simplă cale:
   - **Cripto, fără cheie:** Furnizor prețuri = **Binance**; simboluri urmărite ex: `BTCUSDT, ETHUSDT`.
   - **Acțiuni/FX, fără cheie:** Furnizor prețuri = **Stooq**; simboluri ex: `aapl.us, msft.us, eurusd`.
   - Știri: **GNews** sau **CryptoPanic** (cu cheie) — sau lasă pe „custom” cu URL propriu.
4. **Simboluri urmărite:** completează lista.
5. Apasă **Testează ingestia** (jos în Setări) cu un simbol (ex: `BTCUSDT`).
   Ar trebui să vezi „prețuri X salvate”. Dacă apar erori, verifică simbolul/cheia.

## 5. Cron jobs (cPanel → Cron Jobs)
Înlocuiește `USER` și calea reală. Folosește **CRON_KEY** de la instalare doar dacă
rulezi prin HTTP; prin CLI (recomandat) nu e nevoie.

```
# Ingestie știri + prețuri + sentiment + (opțional) semnale din știri — la 30 min
0,30 * * * *  /usr/bin/php /home/USER/public_html/semnale/cron/ingest.php >/dev/null 2>&1

# Generare semnale AI — din oră în oră
0 * * * *     /usr/bin/php /home/USER/public_html/semnale/cron/generate_signals.php >/dev/null 2>&1

# Evaluarea rezultatelor (acuratețe) — din oră în oră, după ingestie
15 * * * *    /usr/bin/php /home/USER/public_html/semnale/cron/evaluate_signals.php >/dev/null 2>&1
```

## 6. Verifică
- **Panou:** checklist-ul „Start aici” ar trebui să fie tot bifat.
- **Sistem:** vezi „ultima ingestie”, „ultimul preț”, erori 0.
- Generează manual un semnal din Panou și deschide-i **Detaliile** (grafic + voturi).

---

## Actualizări ulterioare
La fiecare versiune nouă: urci fișierele modificate, apoi (dacă versiunea are
migrări) rulezi o singură dată `https://.../migrate.php?key=CRON_KEY`.
Vezi secțiunea „upgrade” din `README.md`.

## Notă
Semnalele sunt preliminare, generate automat — **nu constituie sfat financiar**.