docs: Add comprehensive FG Scan workflow documentation in Romanian
- Added detailed FG Scan module documentation - Includes scanning interface workflow (Step 1) - Includes box assignment and label printing workflow (Step 2) - Complete troubleshooting guide - System requirements and keyboard shortcuts - Image placeholders for visual workflow documentation
This commit is contained in:
Quality App Developer
757
py_app/app/static/docs/fg_scan.md
Normal file
757
py_app/app/static/docs/fg_scan.md
Normal file
@@ -0,0 +1,757 @@
|
||||
# Modulul FG Scan - Fluxul de Scanare Produse Finite
|
||||
|
||||
## Prezentare generală
|
||||
|
||||
Modulul **FG Scan** (Finish Good Scan) este interfața de scanare în timp real pentru înregistrarea produselor finite prin punctele de control de calitate. Sistemul permite o înregistrare rapidă și validare automată a produselor cu capabilități avansate de urmărire și asignare la cutii de depozitare.
|
||||
|
||||
## Descriere generală a sistemului
|
||||
|
||||
Fluxul de lucru se bazează pe scannarea codurilor de bare în ordine specifică, cu validări în timp real și înregistrare automată a datelor. Sistemul suportă:
|
||||
|
||||
- **Înregistrarea rapidă** a produselor scannate
|
||||
- **Validarea automată** a calității prin coduri de defecte
|
||||
- **Urmărirea operatorilor** care efectuează controalele
|
||||
- **Asignarea produselor** la cutii de depozitare (opțional)
|
||||
- **Crearea și tiparirea** etichetelor pentru cutii
|
||||
|
||||
---
|
||||
|
||||
## 1. Interfața de Scanare - Fluxul Principal
|
||||
|
||||
|
||||
|
||||
### Structura Formularului
|
||||
|
||||
Formularul de scanare conține 5 câmpuri de intrare obligatorii care trebuie completate în ordine:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────┐
|
||||
│ MODULUL FG SCAN - FORMULAR │
|
||||
├─────────────────────────────────┤
|
||||
│ 1. Operator Code (OP) ← Prima validare
|
||||
│ ├─ Exemplu: OP001
|
||||
│ └─ Format: OP + 2-3 caractere
|
||||
│
|
||||
│ 2. CP Code (Produs) ← A doua validare
|
||||
│ ├─ Exemplu: CP123456
|
||||
│ └─ Format: CP + numere/litere
|
||||
│
|
||||
│ 3. OC1 Code (Control Op. 1) ← A treia validare
|
||||
│ ├─ Exemplu: OC001
|
||||
│ └─ Format: OC + numere
|
||||
│
|
||||
│ 4. OC2 Code (Control Op. 2) ← A patra validare
|
||||
│ ├─ Exemplu: OC002
|
||||
│ └─ Format: OC + numere
|
||||
│
|
||||
│ 5. Defect Code (3 cifre) ← Trigger de submit
|
||||
│ ├─ Exemplu: 000 (OK) sau 001 (Defect)
|
||||
│ └─ Format: Exact 3 cifre
|
||||
│
|
||||
│ ☐ Enable Scan-to-Boxes [Opțional]
|
||||
└─────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Descrierea Câmpurilor
|
||||
|
||||
| Camp | Format | Descriere | Exemplu | Notă |
|
||||
|------|--------|-----------|---------|------|
|
||||
| **Operator Code** | OP + 2-3 caractere | Codul operatorului de calitate care scanează | OP001, OP123 | Se salvează local după validare |
|
||||
| **CP Code** | CP + numere/litere | Codul produsului finit | CP123456 | Produsul trebuie să existe în bază |
|
||||
| **OC1 Code** | OC + numere | Primul operator de control | OC001 | Validație în bază de date |
|
||||
| **OC2 Code** | OC + numere | Al doilea operator de control | OC002 | Validație în bază de date |
|
||||
| **Defect Code** | 3 cifre exacte | Codul defectului (000=OK, 001-999=defect) | 000, 001, 123 | Trigger pentru submit automat |
|
||||
|
||||
---
|
||||
|
||||
## 2. Etapele Detaliate de Scanare
|
||||
|
||||
### Etapa 1: Introducerea Codului Operator
|
||||
|
||||
```
|
||||
ACTION: Scannează sau introducă codul operator
|
||||
INPUT: OP001
|
||||
VALIDARE:
|
||||
✓ Trebuie să înceapă cu "OP"
|
||||
✓ Lungime: 4-6 caractere
|
||||
✓ Se acceptă doar caractere alfanumerice
|
||||
REZULTAT:
|
||||
✓ Acceptat - Focusul merge la CP Code
|
||||
✗ Eroare - Mesaj roșu: "Please scan Quality Operator code (must start with OP)"
|
||||
SALVARE: Codul se salvează local (localStorage) pentru utilizări viitoare
|
||||
```
|
||||
|
||||
### Etapa 2: Scanarea Codului Produs (CP)
|
||||
|
||||
```
|
||||
ACTION: Scannează codul produsului finit
|
||||
INPUT: CP123456
|
||||
VALIDARE:
|
||||
✓ Trebuie să înceapă cu "CP"
|
||||
✓ Produsul trebuie să existe în baza de date
|
||||
✓ Se acceptă numere și litere după "CP"
|
||||
REZULTAT:
|
||||
✓ Acceptat - Focusul merge la OC1 Code
|
||||
✗ Eroare - Mesaj roșu: "Please scan a valid CP"
|
||||
```
|
||||
|
||||
### Etapa 3: Scanarea Operatorului de Control 1 (OC1)
|
||||
|
||||
```
|
||||
ACTION: Scannează primul operator de control
|
||||
INPUT: OC001
|
||||
VALIDARE:
|
||||
✓ Trebuie să înceapă cu "OC"
|
||||
✓ Trebuie să fie valid în baza de date
|
||||
✓ Diferit de OC2 (pot fi aceiași oameni)
|
||||
REZULTAT:
|
||||
✓ Acceptat - Focusul merge la OC2 Code
|
||||
✗ Eroare - Mesaj roșu: "Please scan a valid OC (must start with OC)"
|
||||
```
|
||||
|
||||
### Etapa 4: Scanarea Operatorului de Control 2 (OC2)
|
||||
|
||||
```
|
||||
ACTION: Scannează al doilea operator de control
|
||||
INPUT: OC002
|
||||
VALIDARE:
|
||||
✓ Trebuie să înceapă cu "OC"
|
||||
✓ Trebuie să fie valid în baza de date
|
||||
REZULTAT:
|
||||
✓ Acceptat - Focusul merge la Defect Code
|
||||
✗ Eroare - Mesaj roșu: "Please scan a valid OC (must start with OC)"
|
||||
```
|
||||
|
||||
### Etapa 5: Introducerea Codului de Defect
|
||||
|
||||
```
|
||||
ACTION: Introduceți/scannați codul de defect (3 cifre)
|
||||
INPUT: 000 (pentru OK) sau 001-999 (pentru defecte)
|
||||
VALIDARE:
|
||||
✓ Exact 3 cifre
|
||||
✓ Numai caractere numerice
|
||||
✓ Valori valide: 000 (OK) sau 001-999 (defect)
|
||||
REZULTAT:
|
||||
✓ Acceptat la 3 cifre - SUBMIT AUTOMAT
|
||||
✗ Eroare - Mesaj roșu: "Defect code must be a 3-digit number (e.g., 000, 001, 123)"
|
||||
```
|
||||
|
||||
### Etapa 6: Înregistrare Automată și Feedback
|
||||
|
||||
```
|
||||
ACTION: Sistemul finalizează scanarea automat
|
||||
PROCES:
|
||||
1. Salvează datele în baza de date
|
||||
2. Afișează notificare de succes
|
||||
3. Resetează formularul (minus Operator Code)
|
||||
4. Focusul merge la CP Code pentru următoarea scanare
|
||||
|
||||
FEEDBACK UTILIZATOR:
|
||||
✅ Notificare verde: "✅ Scan recorded successfully!"
|
||||
⏱️ Durata: 4 secunde (apoi dispare)
|
||||
🔄 Formularul se resetează automat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. Fluxul de Asignare la Cutii (Save to Box)
|
||||
|
||||
|
||||
|
||||
### Condiții de Declanșare a Modalului
|
||||
|
||||
Modalul de asignare la cutie apare **automat și obligatoriu** atunci când sunt **SIMULTAN** îndeplinite:
|
||||
|
||||
1. ✅ Opțiunea **"Enable Scan-to-Boxes"** este **BIFATĂ**
|
||||
2. ✅ Codul de defect este **EXACT 000** (Produs fără defecte)
|
||||
3. ✅ Scanarea s-a **FINALIZAT cu SUCCES**
|
||||
|
||||
```
|
||||
IF (scanToBoxesEnabled == TRUE) AND (defectCode == "000") THEN
|
||||
SHOW box_assignment_modal
|
||||
ELSE
|
||||
RELOAD page normally
|
||||
END IF
|
||||
```
|
||||
|
||||
### Structura Modalului
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────┐
|
||||
│ ASIGNARE PRODUS LA CUTIE │
|
||||
├────────────────────────────────────────┤
|
||||
│ CP Code: CP123456 │
|
||||
│ │
|
||||
│ Opțiuni: │
|
||||
│ [🔲] Create New Box │
|
||||
│ [📥] Scan Existing Box Label │
|
||||
│ │
|
||||
│ Input: "Scan the printed label now..." │
|
||||
│ [________________] │
|
||||
│ │
|
||||
│ [Anulare] [Salvare] │
|
||||
└────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Etapa 1: Deschiderea Modalului
|
||||
|
||||
```
|
||||
TRIGGER: După scanarea cu defect code = 000
|
||||
AFIȘARE:
|
||||
- Modalul se deschide centrat pe ecran
|
||||
- Se afișează codul produsului (CP123456)
|
||||
- Focusul este pe câmpul de input pentru cutie
|
||||
- Placeholder: "Scan the printed label now..."
|
||||
OPȚIUNI:
|
||||
a) Create New Box - Creează o nouă cutie
|
||||
b) Scan Box - Scannează o cutie existentă
|
||||
```
|
||||
|
||||
### Etapa 2: Crearea Unei Noi Cutii
|
||||
|
||||
```
|
||||
ACTION: Apasă butonul "Create New Box"
|
||||
PROCES:
|
||||
1. Sistemul crează o nouă cutie în baza de date
|
||||
2. Generează automat un cod unic (ex: BOX12345)
|
||||
3. Conectează la serviciul QZ Tray
|
||||
4. Generează etichetă în format ZPL (Zebra)
|
||||
|
||||
ETICHETĂ GENERATĂ:
|
||||
┌──────────────────┐
|
||||
│ Box: BOX12345 │
|
||||
│ │
|
||||
│ ║│││┌─┐ │ │
|
||||
│ ║│ │ │ │ │ │ ← Cod de bare generat
|
||||
│ ║│ │ │ │ │ │
|
||||
│ ║││ │ │ │ │
|
||||
│ BOX12345 │
|
||||
└──────────────────┘
|
||||
|
||||
FORMAT: ZPL (Zebra Programming Language)
|
||||
CONȚINUT:
|
||||
- Textul "Box: BOX12345"
|
||||
- Cod de bare 1D (CODE128 sau similar)
|
||||
- Copie text cod box pentru scanare manuală
|
||||
```
|
||||
|
||||
### Etapa 3: Tipărirea Automată a Etichetei
|
||||
|
||||
```
|
||||
ACTION: Etichetă generată → Tipărire automată
|
||||
CERINȚE SISTEM:
|
||||
✓ QZ Tray instalat și activ
|
||||
✓ Imprimantă configurată și conectată
|
||||
✓ Hârtie de etichetă (de obicei 4x6 inch)
|
||||
|
||||
PROCES TIPĂRIRE:
|
||||
1. Conectare la QZ Tray
|
||||
2. Detectare imprimantă disponibilă
|
||||
3. Trimitere job tipărire în format ZPL
|
||||
4. Imprimantă primește și procesează comanda
|
||||
5. Se tipărește eticheta
|
||||
|
||||
FEEDBACK UTILIZATOR:
|
||||
✅ Notificare: "✅ Box 12345 created and label printed!"
|
||||
⏱️ Durata: 3-5 secunde
|
||||
📥 Câmpul de input devine activ pentru scannare etichetă
|
||||
Placeholder se schimbă în: "Scan the printed label now..."
|
||||
```
|
||||
|
||||
### Etapa 4: Scannarea Etichetei Tipărite
|
||||
|
||||
```
|
||||
ACTION: Scannează eticheta nou tipărită
|
||||
PROCES:
|
||||
1. Scaneaza codul de bare de pe etichetă
|
||||
2. Sistemul validează: BOX12345
|
||||
3. Asociază produsul (CP123456) la cutie (BOX12345)
|
||||
4. Setează status "Packed" pentru produs
|
||||
5. Salvează relația în baza de date
|
||||
|
||||
VALIDĂRI:
|
||||
✓ Codul scanned trebuie să coincidă cu BOX generat
|
||||
✓ Produsul nu trebuie să fie deja asignat
|
||||
✓ Cutia trebuie să existe în baza de date
|
||||
|
||||
FEEDBACK UTILIZATOR:
|
||||
✅ Notificare verde: "✅ CP123456 assigned to Box BOX12345!"
|
||||
```
|
||||
|
||||
### Etapa 5: Finalizare și Revenire
|
||||
|
||||
```
|
||||
ACTION: După scannare validă a etichetei
|
||||
PROCES:
|
||||
1. Modalul se închide automat
|
||||
2. Pagina se reîncarcă complet
|
||||
3. Se resetează formularul
|
||||
4. Se prepară pentru următoarea scanare
|
||||
|
||||
REZULTAT FINAL:
|
||||
✅ Produs înregistrat în sistem
|
||||
✅ Produs asignat la cutie
|
||||
✅ Etichetă tipărită și validată
|
||||
🔄 Sistem gata pentru următoarea scanare
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. Situații Speciale și Comportament
|
||||
|
||||
### Scenariul 1: Produs OK - Cu Asignare la Cutie ✅
|
||||
|
||||
```
|
||||
SECVENȚĂ COMPLETĂ:
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 1. Scannează OP001 → ✓ Valid │
|
||||
│ 2. Scannează CP123456 → ✓ Valid │
|
||||
│ 3. Scannează OC001 → ✓ Valid │
|
||||
│ 4. Scannează OC002 → ✓ Valid │
|
||||
│ 5. Introduceți 000 → ✓ Valid │
|
||||
│ │
|
||||
│ ✅ "Scan recorded successfully!" │
|
||||
│ 🎬 MODAL APARE: "Scan-to-Boxes enabled" │
|
||||
│ │
|
||||
│ 6. Click "Create New Box" → BOX12345 │
|
||||
│ ✅ "Box created and label printed!" │
|
||||
│ 🖨️ Etichetă tipărită │
|
||||
│ │
|
||||
│ 7. Scannează eticheta BOX12345 → ✓ Valid │
|
||||
│ ✅ "CP123456 assigned to Box 12345!" │
|
||||
│ │
|
||||
│ 🔄 Pagina se reîncarcă │
|
||||
│ → Gata pentru următoarea scanare │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Scenariul 2: Produs cu Defect - Fără Modal ⚠️
|
||||
|
||||
```
|
||||
SECVENȚĂ CU DEFECT:
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 1. Scannează OP001 → ✓ Valid │
|
||||
│ 2. Scannează CP789999 → ✓ Valid │
|
||||
│ 3. Scannează OC001 → ✓ Valid │
|
||||
│ 4. Scannează OC002 → ✓ Valid │
|
||||
│ 5. Introduceți 001 → ✓ Valid │
|
||||
│ │
|
||||
│ ✅ "Scan recorded successfully!" │
|
||||
│ ⚠️ Defect code detected │
|
||||
│ ❌ NO BOX MODAL (porque defect ≠ 000) │
|
||||
│ │
|
||||
│ 🔄 Pagina se reîncarcă automat după 1s │
|
||||
│ → Produs înregistrat cu defect │
|
||||
│ → Fără asignare la cutie │
|
||||
│ → Gata pentru următoarea scanare │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Scenariul 3: Eroare de Validare ❌
|
||||
|
||||
```
|
||||
SECVENȚĂ CU EROARE:
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ 1. Scannează XX001 → ❌ EROARE │
|
||||
│ "Must start with OP" │
|
||||
│ 🔴 Mesajul apare în roșu │
|
||||
│ 👆 Focusul revine la Operator Code │
|
||||
│ │
|
||||
│ 2. Reîncercați scannarea → ✓ Valid │
|
||||
│ Mesajul de eroare dispare │
|
||||
│ │
|
||||
│ (Continuă fluxul normal...) │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Scenariul 4: QZ Tray Inactiv - La Tipărire ❌
|
||||
|
||||
```
|
||||
SITUAȚIE: Utilizatorul apasă "Create New Box"
|
||||
dar QZ Tray nu este conectat
|
||||
|
||||
REZULTAT:
|
||||
❌ Eroare: "QZ Tray not connected.
|
||||
Please ensure QZ Tray is running."
|
||||
|
||||
🔘 Butonul "Create New Box" devine inactiv
|
||||
|
||||
SOLUȚIE:
|
||||
1. Pornește serviciul QZ Tray pe computer
|
||||
2. Verifică conexiunea la imprimantă
|
||||
3. Reîncarcă pagina
|
||||
4. Încearcă din nou
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. Configurația - Opțiunea "Enable Scan-to-Boxes"
|
||||
|
||||
### Activarea/Dezactivarea Funcției
|
||||
|
||||
```
|
||||
UI ELEMENT:
|
||||
┌────────────────────────────────┐
|
||||
│ ☐ Enable Scan-to-Boxes │
|
||||
│ ← Click pentru a activa │
|
||||
└────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Comportament Comparativ
|
||||
|
||||
| Stare | Comportament | Rezultat |
|
||||
|-------|-------------|----------|
|
||||
| **❌ DEZACTIVAT** | După scanare, formular se resetează | Fără modal; Produs doar înregistrat |
|
||||
| **✅ ACTIVAT** | După scanare cu defect=000, apare modal | Modal pentru asignare la cutie |
|
||||
|
||||
### Persistență și Salvare
|
||||
|
||||
```
|
||||
COMPORTAMENT:
|
||||
1. Starea opțiunii este salvată LOCAL (în browser)
|
||||
2. Folosește localStorage pentru persistență
|
||||
3. Rămâne activă după reîncărcarea paginii
|
||||
4. Se resetează la ștergerea cache-ului
|
||||
|
||||
SETARE: localStorage.setItem('scan_to_boxes_enabled', true/false)
|
||||
|
||||
IMPLICAȚII:
|
||||
✓ Fiecare utilizator poate avea preferințe diferite
|
||||
✓ Preferințele se salvează per computer/browser
|
||||
✗ Se pierd dacă se șterge localStorage
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Validări în Timp Real
|
||||
|
||||
### Mesajele de Eroare Înroșite
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ MESAJE DE VALIDARE - Display în Timp Real │
|
||||
├─────────────────────────────────────────────────┤
|
||||
│ 🔴 Operator Code: │
|
||||
│ "Please scan Quality Operator code │
|
||||
│ (must start with OP)" │
|
||||
│ │
|
||||
│ 🔴 CP Code: │
|
||||
│ "Please scan a valid CP" │
|
||||
│ │
|
||||
│ 🔴 OC1 Code: │
|
||||
│ "Please scan a valid OC │
|
||||
│ (must start with OC)" │
|
||||
│ │
|
||||
│ 🔴 OC2 Code: │
|
||||
│ "Please scan a valid OC │
|
||||
│ (must start with OC)" │
|
||||
│ │
|
||||
│ 🔴 Defect Code: │
|
||||
│ "Defect code must be a 3-digit number │
|
||||
│ (e.g., 000, 001, 123)" │
|
||||
└─────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Auto-Advance între Câmpuri
|
||||
|
||||
```
|
||||
MECANISMUL DE AUTO-ADVANCE:
|
||||
1. Operator Code: După 4 caractere valide → Auto-advance la CP Code
|
||||
2. CP Code: După scanare validă → Auto-advance la OC1 Code
|
||||
3. OC1 Code: După scanare validă → Auto-advance la OC2 Code
|
||||
4. OC2 Code: După scanare validă → Auto-advance la Defect Code
|
||||
5. Defect Code: După 3 cifre valide → AUTO-SUBMIT FORMULAR
|
||||
|
||||
COMPORTAMENT:
|
||||
✓ Crește viteza de lucru
|
||||
✓ Eliminate nevoia de click manual
|
||||
✓ Reduce erori de introducere
|
||||
✓ Optimizat pentru scanere barcode
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. Salvare și Persistență de Date
|
||||
|
||||
### Ce se Salvează Local
|
||||
|
||||
```
|
||||
LOCALSTORAGE ITEMS:
|
||||
1. fg_scan_operator_code
|
||||
- Salvează: Codul operator valid
|
||||
- Scop: Reîncarcă codul la revenire pe pagină
|
||||
- Trigger: După validare OP Code
|
||||
- Durata: Persistent (până la ștergere manuală)
|
||||
|
||||
2. scan_to_boxes_enabled
|
||||
- Salvează: TRUE/FALSE
|
||||
- Scop: Ține minte preferința utilizatorului
|
||||
- Trigger: La click bifă
|
||||
- Durata: Persistent (până la ștergere manuală)
|
||||
|
||||
3. fg_scan_clear_after_submit
|
||||
- Salvează: TRUE (flag)
|
||||
- Scop: Semnalizează dacă să reseteze după reload
|
||||
- Trigger: Înainte de submit
|
||||
- Durata: Temporară (se șterge după reload)
|
||||
```
|
||||
|
||||
### Comportament După Reîncărcare
|
||||
|
||||
```
|
||||
SCENARIUL: Utilizatorul reîncarcă pagina
|
||||
REZULTAT:
|
||||
1. Se restaurează Operator Code din localStorage
|
||||
2. Se restaurează starea "Enable Scan-to-Boxes"
|
||||
3. Alte câmpuri rămân goale (din motive de securitate)
|
||||
4. Focusul merge pe CP Code
|
||||
5. Sistemul este gata pentru scanare
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Coduri și Format Special
|
||||
|
||||
### Coduri de Prefix Obligatorii
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────┐
|
||||
│ CODURI SPECIALE - Format Strict │
|
||||
├──────────────────────────────────────────┤
|
||||
│ OP = Operator Code (Calitate) │
|
||||
│ Format: OP + 2-3 caractere │
|
||||
│ Ex: OP001, OP123, OPA01 │
|
||||
│ Lungime totală: 4-6 caractere │
|
||||
│ │
|
||||
│ CP = Cod Produs (Product Code) │
|
||||
│ Format: CP + numere/litere │
|
||||
│ Ex: CP123456, CP-ABC-999 │
|
||||
│ Lungime variabilă (min 4) │
|
||||
│ │
|
||||
│ OC = Operator Control (Calitate) │
|
||||
│ Format: OC + numere │
|
||||
│ Ex: OC001, OC999 │
|
||||
│ Lungime: 5-6 caractere │
|
||||
│ │
|
||||
│ 000 = Status OK (Fără defecte) │
|
||||
│ 001-999 = Coduri de defecte specifice │
|
||||
└──────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Numerele de Cutie
|
||||
|
||||
```
|
||||
GENERARE AUTOMATĂ:
|
||||
Format: BOX + numere incrementale
|
||||
Exemplu: BOX00001, BOX00002, BOX12345
|
||||
|
||||
ETICHETA TIPĂRITĂ:
|
||||
- Conținut: "Box: BOX12345"
|
||||
- Cod de bare: 1D barcode (scanabil)
|
||||
- Format: ZPL (Zebra Programming Language)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. Tastele Rapid și Navigare
|
||||
|
||||
### Comenzi Tastatură
|
||||
|
||||
| Tasta | Funcție |
|
||||
|-------|---------|
|
||||
| **Tab** | Navigare între câmpuri (în ordine) |
|
||||
| **Enter** | Avansare la câmpul următor (dacă valid) |
|
||||
| **Backspace** | Ștergere caractere |
|
||||
| **Scan Barcode** | Completează câmpul și avansează automat |
|
||||
| **Escape** | Închide modalul (nu-l recomand) |
|
||||
|
||||
### Flux Recomandat
|
||||
|
||||
```
|
||||
1. Scannez barcode operator
|
||||
↓ (automat cu 4 char)
|
||||
2. Scannez barcode produs
|
||||
↓ (automat după validare)
|
||||
3. Scannez barcode operator 1
|
||||
↓ (automat după validare)
|
||||
4. Scannez barcode operator 2
|
||||
↓ (automat după validare)
|
||||
5. Scannez/introduc cod defect (3 cifre)
|
||||
↓ (automat la 3 cifre)
|
||||
6. SUBMIT AUTOMAT
|
||||
↓
|
||||
7. [Dacă Enable Scan-to-Boxes] MODAL APARE
|
||||
└→ Asignare la cutie
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. Troubleshooting și Rezolvare Probleme
|
||||
|
||||
### Problemă: "Scan not submitted"
|
||||
|
||||
**Cauze:**
|
||||
- Operator Code nu începe cu OP
|
||||
- CP Code nu începe cu CP
|
||||
- OC1/OC2 Code nu încep cu OC
|
||||
- Defect code nu are exact 3 cifre
|
||||
|
||||
**Soluție:**
|
||||
```
|
||||
1. Verificați formatul fiecărui cod
|
||||
2. Asigurați-vă că codurile încep cu literele corecte
|
||||
3. Pentru defect, introduceți EXACT 3 cifre (001, nu 1 sau 0001)
|
||||
4. Resetați formularul și reîncercați
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Problemă: "QZ Tray not connected"
|
||||
|
||||
**Cauze:**
|
||||
- QZ Tray nu este instalat
|
||||
- QZ Tray nu este activ/pornit
|
||||
- Firewall blochează conexiunea
|
||||
|
||||
**Soluție:**
|
||||
```
|
||||
1. Descărcați și instalați QZ Tray de la qz.io
|
||||
2. Porniți serviciul QZ Tray (din tasktray)
|
||||
3. Verificați conexiunea la localhost:8383
|
||||
4. Reîncărcați pagina
|
||||
5. Încercați din nou "Create New Box"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Problemă: "No printers found"
|
||||
|
||||
**Cauze:**
|
||||
- Nicio imprimantă conectată
|
||||
- Imprimantă nu este configurată
|
||||
- Driver-ul imprimantei este defect
|
||||
|
||||
**Soluție:**
|
||||
```
|
||||
1. Conectați imprimanta fizic (USB sau rețea)
|
||||
2. Instalați driver-ii necesari
|
||||
3. Configurați imprimanta în setările sistemului
|
||||
4. Testați tipărirea din alt program
|
||||
5. Reîncărcați pagina FG Scan
|
||||
6. Încercați din nou
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Problemă: "Defect code must be 3 digits"
|
||||
|
||||
**Cauze:**
|
||||
- Introdusă mai puțin de 3 cifre (ex: 00, 1)
|
||||
- Introdusă mai mult de 3 cifre (ex: 0000)
|
||||
- Introduse caractere non-numerice
|
||||
|
||||
**Soluție:**
|
||||
```
|
||||
Introduceți EXACT 3 CIFRE NUMERICE:
|
||||
✓ CORECT: 000, 001, 123, 999
|
||||
✗ GREȘIT: 00, 1, 0001, 12a, defect
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Problemă: Etichetele nu se tipăresc
|
||||
|
||||
**Verificări:**
|
||||
```
|
||||
1. QZ Tray conectat? → Verificați status
|
||||
2. Imprimanta selectată? → Setări sistem
|
||||
3. Hârtie în imprimantă? → Reîncărcați hârtie
|
||||
4. Driver corect? → Reinstalați driver
|
||||
5. Format ZPL acceptat? → Imprimanta suportă ZPL?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. Cerințe Sistem și Configurație
|
||||
|
||||
### Hardware Necesar
|
||||
|
||||
```
|
||||
✓ Computer/Server cu browser modern
|
||||
✓ Imprimantă etichetă (cu suport ZPL de preferință)
|
||||
✓ Scannere barcode (pentru eficiență)
|
||||
✓ Conexiune rețea (pentru baza de date)
|
||||
```
|
||||
|
||||
### Software Necesar
|
||||
|
||||
```
|
||||
✓ Browser: Chrome, Firefox, Edge (versiuni recente)
|
||||
✓ QZ Tray: v2.2.0 sau mai nou (pentru tipărire)
|
||||
✓ Java Runtime Environment (pentru QZ Tray)
|
||||
✓ Driver imprimantă compatibil
|
||||
```
|
||||
|
||||
### Setări Browser
|
||||
|
||||
```
|
||||
✓ JavaScript activat
|
||||
✓ LocalStorage activat
|
||||
✓ Pop-ups dezblocate pentru QZ Tray
|
||||
✓ Certificate SSL valid (dacă HTTPS)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 12. Informații Suplimentare
|
||||
|
||||
### Integrare Bază de Date
|
||||
|
||||
```
|
||||
TABELE IMPLICITE:
|
||||
1. fg_scans - Înregistrează scanări
|
||||
2. boxes - Stochează cutii create
|
||||
3. cp_to_box - Relații produs-cutie
|
||||
4. operators - Informații operatori
|
||||
5. products - Informații produse
|
||||
```
|
||||
|
||||
### Fluxul Datelor
|
||||
|
||||
```
|
||||
INPUT (Barcode/Tastatură)
|
||||
↓
|
||||
VALIDARE (în client + server)
|
||||
↓
|
||||
SALVARE DB (fg_scans table)
|
||||
↓
|
||||
[IF Scan-to-Boxes AND defect=000]
|
||||
├→ CREATE BOX (boxes table)
|
||||
├→ PRINT LABEL (QZ Tray)
|
||||
├→ SCAN LABEL (verficare)
|
||||
└→ CREATE RELATION (cp_to_box table)
|
||||
↓
|
||||
CONFIRMAȚIE (notificare utilizator)
|
||||
↓
|
||||
RESET & READY (pentru următoarea scanare)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 13. Suport și Contact
|
||||
|
||||
Pentru probleme sau întrebări:
|
||||
|
||||
- **Administrator Sistem**: Contactați dept. IT
|
||||
- **Documentație QZ Tray**: https://qz.io
|
||||
- **Report Bug**: Contactați manager-ul modulului
|
||||
- **Training**: Consultați alte pagini de ajutor din aplicație
|
||||
|
||||
---
|
||||
|
||||
**Document**: Ghid Utilizare FG Scan Module
|
||||
**Versiune**: 1.0
|
||||
**Dată Actualizare**: 4 Ianuarie 2026
|
||||
**Limbă**: Română
|
||||
**Status**: Activ
|
||||
|
||||
Reference in New Issue
Block a user