quality_app/py_app/app/static/docs/etichete.md

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