# 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