Files
quality_app/py_app/app/static/docs/etichete.md
2025-12-01 23:48:09 +02:00

332 lines
9.5 KiB
Markdown

# 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