docs: update README and .env.example for project root start convention

Fix start command (python -m uvicorn api.app.main:app from project root),
correct JSON_OUTPUT_DIR path (vfp/output not ../vfp/output), document
all env variables with descriptions, add dashboard features overview,
business rules, and WSL2 notes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

api/.env.example

@@ -1,15 +1,75 @@
-# Oracle Database Configuration
-ORACLE_USER=YOUR_ORACLE_USERNAME
-ORACLE_PASSWORD=YOUR_ORACLE_PASSWORD
-ORACLE_DSN=YOUR_TNS_CONNECTION_NAME
-TNS_ADMIN=/app
-INSTANTCLIENTPATH=/opt/oracle/instantclient_21_1
+# =============================================================================
+# GoMag Import Manager - Configurare
+# Copiaza in api/.env si completeaza cu datele reale
+# =============================================================================
 
-# Flask Configuration  
-FLASK_ENV=development
-FLASK_DEBUG=1
-PYTHONUNBUFFERED=1
+# =============================================================================
+# ORACLE MODE - Alege una din urmatoarele doua optiuni:
+# =============================================================================
 
-# Application Settings
-APP_PORT=5000
-LOG_LEVEL=DEBUG
+# THICK MODE (Oracle 10g/11g/12.1+) - Recomandat pentru compatibilitate maxima
+# Necesita Oracle Instant Client instalat
+INSTANTCLIENTPATH=/opt/oracle/instantclient_21_15
+
+# THIN MODE (Oracle 12.1+ only) - Fara Instant Client, mai simplu
+# Comenteaza INSTANTCLIENTPATH de sus si decommenteaza urmatoarea linie:
+# FORCE_THIN_MODE=true
+
+# =============================================================================
+# ORACLE - Credentiale baza de date
+# =============================================================================
+
+ORACLE_USER=USER_ORACLE
+ORACLE_PASSWORD=parola_oracle
+ORACLE_DSN=TNS_ALIAS
+
+# Calea absoluta la directorul cu tnsnames.ora
+# De obicei: directorul api/ al proiectului
+TNS_ADMIN=/cale/absoluta/la/gomag/api
+
+# =============================================================================
+# APLICATIE
+# =============================================================================
+
+APP_PORT=5003
+LOG_LEVEL=INFO
+
+# =============================================================================
+# CALE FISIERE (relative la project root - directorul gomag/)
+# =============================================================================
+
+# JSON-uri descarcate de VFP
+JSON_OUTPUT_DIR=vfp/output
+
+# SQLite tracking DB
+SQLITE_DB_PATH=api/data/import.db
+
+# =============================================================================
+# ROA - Setari import comenzi (din vfp/settings.ini sectiunea [ROA])
+# =============================================================================
+
+# Politica de pret
+ID_POL=39
+
+# Gestiune implicita
+ID_GESTIUNE=0
+
+# Sectie implicita
+ID_SECTIE=6
+
+# =============================================================================
+# SMTP - Notificari email (optional)
+# =============================================================================
+
+# SMTP_HOST=smtp.gmail.com
+# SMTP_PORT=587
+# SMTP_USER=email@exemplu.com
+# SMTP_PASSWORD=parola_app
+# SMTP_TO=destinatar@exemplu.com
+
+# =============================================================================
+# AUTH - HTTP Basic Auth pentru dashboard (optional)
+# =============================================================================
+
+# API_USERNAME=admin
+# API_PASSWORD=parola_sigura