Přeskočit obsah

Proposal.md formát

Struktura dokumentu

# Add Barcode Scanning for Warehouse

## Why

### Problem Statement
Skladníci aktuálně musí ručně vyhledávat produkty při příjmu zboží.
Průměrná doba příjmu jedné položky je 45 sekund, z toho 30 sekund
zabírá vyhledání produktu v systému.

### Business Impact
- Pomalý příjem zboží (200 položek/den = 100 minut hledání)
- Vysoká chybovost (3% chybně zadaných produktů)
- Frustrace zaměstnanců

### Success Metrics
- Snížení času příjmu položky na 15 sekund
- Snížení chybovosti pod 0.5%
- NPS skladníků > 8

## What Changes

### Scope
1. **Mobilní interface pro skenování**
   - PWA aplikace pro Android/iOS
   - Integrace camera API
   - Offline-first architektura

2. **Backend úpravy**
   - Endpoint pro vyhledání podle EAN
   - Validace čárového kódu
   - Logging skenování

3. **UI změny**
   - Nové pole "Skenovat" na příjemce
   - Zvuková/vizuální zpětná vazba

### Out of Scope
- RFID skenování (Phase 2)
- Automatické objednávky při nízkém stavu
- Integrace s externími sklady

## Impact Analysis

### Affected Entities
| Entity | Změna |
|--------|-------|
| StockReceipt | Nové pole `scannedAt`, `scannedById` |
| StockReceiptItem | Nové pole `scannedEan` |
| Product | Bez změn (EAN již existuje) |

### Affected Modules
- Warehouse Management (primary)
- Product Base (secondary - EAN lookup)

### Dependencies
- Produkty musí mít vyplněný EAN kód
- Mobilní zařízení s kamerou
- HTTPS pro camera API

### Risks
| Risk | Probability | Impact | Mitigation |
|------|-------------|--------|------------|
| Nečitelné čárové kódy | Medium | Low | Ruční zadání jako fallback |
| Offline problémy | Low | Medium | Local storage + sync |
| Performance na starších zařízeních | Medium | Medium | Minimální requirements |

## Effort Estimation

| Komponenta | Hodiny |
|------------|--------|
| Backend API | 8 |
| PWA aplikace | 24 |
| UI integrace | 8 |
| Testování | 8 |
| Dokumentace | 4 |
| **Celkem** | **52** |

## Approval

| Role | Jméno | Status | Datum |
|------|-------|--------|-------|
| Product Owner | Marie R. | ✅ Approved | 2025-02-10 |
| Tech Lead | Jan V. | ✅ Approved | 2025-02-11 |
| Architect | Petr K. | ✅ Approved | 2025-02-11 |

Review checklist

  • [ ] Proposal jasně vysvětluje PROČ (ne jen CO)
  • [ ] Impact analysis je kompletní
  • [ ] Odhad effort je realistický
  • [ ] Rizika jsou identifikována s mitigací

➡️ Pokračujte na Tasks.md.