udpdated vier and checked some documentation

py_app/app/static/docs/etichete.md

@@ -0,0 +1,331 @@
+# Modul Etichete - Ghid de Utilizare
+
+## Prezentare Generală
+
+Modulul Etichete este centrul de comandă pentru gestionarea completă a etichetelor de producție. Acesta oferă acces rapid la toate funcționalitățile necesare pentru procesarea comenzilor și generarea etichetelor.
+
+## Cum să Accesați Modulul Etichete
+
+1. Din dashboard principal, accesați **Etichete** din meniul lateral
+2. Sau folosiți butonul de acces rapid "Labels Module"
+
+**Notă**: Trebuie să aveți permisiuni pentru modulul de etichete pentru a-l accesa.
+
+---
+
+## Secțiuni Principale
+
+Modulul Etichete este organizat în carduri funcționale care oferă acces rapid la diferite operațiuni:
+
+### 1. View Orders (Vizualizare Comenzi)
+
+Această secțiune vă permite să gestionați comenzile și datele pentru etichete.
+
+#### Upload Orders (Încărcare Comenzi)
+
+**Descriere**: Încărcați comenzi noi în sistem din fișiere Excel sau CSV.
+
+**Cum să utilizați**:
+
+1. Click pe butonul **"Upload Orders"**
+2. Selectați fișierul cu comenzile (format: `.xlsx`, `.xls`, sau `.csv`)
+3. Verificați preview-ul datelor
+4. Confirmați încărcarea
+
+**Câmpuri Necesare în Fișier**:
+- `comanda_productie` - Număr comandă de producție
+- `cod_articol` - Cod articol produs
+- `descr_com_prod` - Descriere comandă producție
+- `cantitate` - Cantitate comandată
+- `data_livrare` - Data livrare
+- `customer_name` - Nume client
+- `customer_article_number` - Număr articol client
+
+**Formate Acceptate**:
+- 📊 **Excel**: `.xlsx`, `.xls`
+- 📄 **CSV**: `.csv` (UTF-8)
+
+**Tips**:
+- 💡 Verificați întotdeauna preview-ul înainte de confirmare
+- 💡 Asigurați-vă că toate coloanele necesare sunt prezente
+- 💡 Datele duplicate vor fi ignorate
+
+#### View Orders (Vizualizare Comenzi)
+
+**Descriere**: Vizualizați și gestionați comenzile existente în sistem.
+
+**Funcționalități**:
+- 📋 Lista completă a tuturor comenzilor
+- 🔍 Căutare și filtrare avansată
+- ✏️ Editare comenzi existente
+- 🗑️ Ștergere comenzi
+- 📊 Vizualizare status producție
+
+**Filtre Disponibile**:
+- Filtrare după număr comandă
+- Filtrare după client
+- Filtrare după data livrare
+- Filtrare după status (activ/inactiv)
+
+**Acțiuni Disponibile**:
+- ✏️ **Edit**: Modificați detaliile comenzii
+- 🖨️ **Print**: Generați etichete pentru comandă
+- 🗑️ **Delete**: Ștergeți comanda din sistem
+- 👁️ **View**: Vedeți detalii complete
+
+---
+
+### 2. Printing Module (Modul de Printare)
+
+Centrul pentru toate operațiunile de printare a etichetelor.
+
+#### Launch Printing Module
+
+**Descriere**: Deschide modulul principal de printare pentru generarea etichetelor standard.
+
+**Când să utilizați**:
+- Pentru printarea etichetelor pentru comenzi noi
+- Pentru reprintarea etichetelor existente
+- Pentru generarea etichetelor în lot
+
+**Pași de utilizare**:
+
+1. **Click pe "Launch Printing Module"**
+2. **Selectați comanda** din lista disponibilă
+3. **Configurați opțiunile de printare**:
+   - Selectați produsele
+   - Specificați cantitățile
+   - Alegeți formatul etichetelor
+4. **Generați etichetele**
+5. **Printați** automat sau descărcați PDF
+
+**Opțiuni de Printare**:
+- 🖨️ **Printare Automată**: Trimite direct la imprimantă
+- 💾 **Download PDF**: Salvează ca PDF pentru printare ulterioară
+- 📄 **Preview**: Vizualizează înainte de printare
+
+#### Launch Lost Labels Printing Module
+
+**Descriere**: Modul special pentru reprintarea etichetelor pierdute sau deteriorate.
+
+**Când să utilizați**:
+- Etichete pierdute în producție
+- Etichete deteriorate sau ilizibile
+- Etichete printate incorect
+
+**Caracteristici Speciale**:
+- 🔍 Căutare rapidă după număr comandă
+- 🎯 Selectare precisă a etichetelor necesare
+- 📝 Tracking pentru etichete reprinate
+- ⚠️ Alertă pentru printări multiple
+
+**Pași de utilizare**:
+
+1. **Click pe "Launch lost labels printing module"**
+2. **Introduceți numărul comenzii**
+3. **Selectați produsele** pentru care aveți nevoie de etichete
+4. **Specificați motivul** reprintării (opțional)
+5. **Generați și printați** etichetele
+
+---
+
+## Fluxul de Lucru Recomandat
+
+### Pentru Comenzi Noi
+
+```
+1. Upload Orders → 2. View Orders (verificare) → 3. Printing Module → 4. Printare
+```
+
+**Detaliat**:
+
+1. **Încărcați comenzile** folosind "Upload Orders"
+   - Pregătiți fișierul cu comenzile noi
+   - Încărcați și verificați preview-ul
+   - Confirmați încărcarea
+
+2. **Verificați comenzile** în "View Orders"
+   - Asigurați-vă că toate datele sunt corecte
+   - Editați dacă este necesar
+   - Verificați cantitățile
+
+3. **Generați etichetele** în "Printing Module"
+   - Selectați comenzile pentru printare
+   - Configurați opțiunile
+   - Generați etichetele
+
+4. **Printați etichetele**
+   - Printare automată sau download PDF
+   - Verificați calitatea printării
+   - Atașați etichetele la produse
+
+### Pentru Etichete Pierdute
+
+```
+1. Lost Labels Module → 2. Căutare Comandă → 3. Selectare → 4. Reprintare
+```
+
+**Detaliat**:
+
+1. **Accesați modulul** de etichete pierdute
+2. **Căutați comanda** specifică
+3. **Selectați produsele** necesare
+4. **Reprintați** etichetele
+
+---
+
+## Funcționalități Avansate
+
+### 1. Procesare în Lot (Batch Processing)
+
+Pentru comenzi multiple:
+
+1. Accesați "View Orders"
+2. Selectați multiple comenzi (checkbox-uri)
+3. Click pe "Batch Actions"
+4. Alegeți acțiunea dorită:
+   - 🖨️ Print All
+   - ✏️ Bulk Edit
+   - 🗑️ Delete Selected
+
+### 2. Export și Raportare
+
+Exportați date pentru analiză:
+
+- **Export Excel**: Date complete comenzi
+- **Export CSV**: Pentru procesare externă
+- **Print Reports**: Rapoarte printabile
+- **Statistics**: Statistici de utilizare
+
+
+## Integrări și Automatizări
+
+
+
+### QZ Tray
+
+QZ Tray este necesar pentru comunicarea cu imprimanta:
+
+1. Descărcați și instalați QZ Tray
+2. Verificați că rulează (iconiță în system tray)
+3. Extensia Chrome se va conecta automat
+
+---
+
+## Rezolvare Probleme
+
+### Problema: Nu pot încărca fișierul cu comenzi
+
+**Soluții**:
+1. ✓ Verificați formatul fișierului (Excel sau CSV)
+2. ✓ Asigurați-vă că toate coloanele necesare există
+3. ✓ Verificați că fișierul nu este corupt
+4. ✓ Încercați să salvați fișierul din nou
+5. ✓ Verificați dimensiunea fișierului (max 10MB)
+
+### Problema: Comenzile nu apar în listă
+
+**Soluții**:
+1. ✓ Reîmprospătați pagina (F5)
+2. ✓ Verificați filtrele aplicate
+3. ✓ Asigurați-vă că încărcarea s-a finalizat cu succes
+4. ✓ Verificați conexiunea la baza de date
+5. ✓ Contactați administratorul
+
+### Problema: Nu pot printa etichete
+
+**Soluții**:
+1. ✓ Verificați că imprimanta este pornită
+2. ✓ Verificați instalarea extensiei Chrome
+3. ✓ Verificați că QZ Tray rulează
+4. ✓ Testați cu download PDF mai întâi
+5. ✓ Restartați browserul
+
+### Problema: Etichete printate incorect
+
+**Soluții**:
+1. ✓ Verificați setările imprimantei
+2. ✓ Verificați formatul etichetelor selectat
+3. ✓ Testați cu o singură etichetă mai întâi
+4. ✓ Verificați template-ul utilizat
+5. ✓ Recalibrați imprimanta
+
+---
+
+## Tips & Tricks
+
+💡 **Sfat**: Folosiți preview-ul înainte de fiecare încărcare pentru a evita erorile.
+
+💡 **Sfat**: Folosiți căutarea rapidă (CTRL+F) în lista de comenzi pentru a găsi rapid comenzile.
+
+💡 **Sfat**: Exportați lista de comenzi săptămânal pentru evidență.
+
+💡 **Sfat**: Verificați zilnic comenzile cu status "pending" pentru a evita întârzierile.
+
+💡 **Sfat**: Folosiți modulul de etichete pierdute pentru tracking-ul reprintărilor.
+
+---
+
+## Scurtături de Tastatură
+
+Accelerați lucrul cu aceste scurtături:
+
+- **CTRL + U**: Deschide Upload Orders
+- **CTRL + V**: Deschide View Orders
+- **CTRL + P**: Deschide Printing Module
+- **CTRL + L**: Deschide Lost Labels Module
+- **CTRL + F**: Căutare în lista de comenzi
+- **ESC**: Închide dialog-uri/ferestre
+
+---
+
+## Întrebări Frecvente
+
+**Î: Ce format trebuie să aibă fișierul cu comenzi?**
+R: Acceptăm Excel (.xlsx, .xls) și CSV (.csv). Fișierul trebuie să conțină coloanele standard: comanda_productie, cod_articol, cantitate, etc.
+
+**Î: Pot edita o comandă după încărcare?**
+R: Da, accesați "View Orders", găsiți comanda și click pe butonul "Edit".
+
+**Î: Cât timp rămân comenzile în sistem?**
+R: Comenzile rămân permanent până sunt șterse manual sau arhivate de administrator.
+
+**Î: Pot printa etichete pentru multiple comenzi simultan?**
+R: Da, folosiți funcția "Batch Print" din View Orders.
+
+**Î: Ce fac dacă o etichetă s-a deteriorat?**
+R: Folosiți "Lost Labels Printing Module" pentru reprintare rapidă.
+
+**Î: Pot personaliza template-urile de etichete?**
+R: Momentan nu, dar funcționalitatea este în dezvoltare. Contactați administratorul pentru cerințe speciale.
+
+**Î: Cum verific câte etichete am printat pentru o comandă?**
+R: În "View Orders", click pe comandă pentru a vedea istoricul complet de printare.
+
+---
+
+## Suport și Asistență
+
+Pentru ajutor suplimentar:
+
+- 📚 Consultați documentația detaliată a fiecărui modul
+- 💬 Contactați administratorul de sistem
+- 📧 Email: support@quality-app.com
+- 📞 Telefon: Verificați în Settings pentru numărul de contact
+
+---
+
+## Actualizări Recente
+
+**Decembrie 2025**
+- ✨ Interfață îmbunătățită pentru modul etichete
+- ✨ Suport pentru formate multiple de fișiere
+- ✨ Funcție de reprintare etichete pierdute
+- ✨ Integrare îmbunătățită cu QZ Tray
+- ✨ Validare automată date la încărcare
+
+**Viitor**
+- 🔜 Gestionare template-uri personalizate
+- 🔜 Printare QR codes
+- 🔜 Integrare cu sistem WMS
+- 🔜 Aplicație mobilă pentru scanare