Tasks.md formát¶
Struktura dokumentu¶
# Tasks: Add Barcode Scanning
## Phase 1: Backend (8h)
### 1.1 API Endpoint
- [x] Vytvořit endpoint `GET /api/v1/Product/barcode/{ean}`
- [x] Implementovat EAN validaci
- [x] Přidat rate limiting
- [x] Napsat unit testy
### 1.2 Entity Updates
- [x] Přidat pole `scannedAt` na StockReceiptItem
- [x] Přidat pole `scannedById` na StockReceiptItem
- [ ] Migrace databáze
## Phase 2: PWA Application (24h)
### 2.1 Setup
- [ ] Inicializace PWA projektu
- [ ] Service worker pro offline
- [ ] Manifest.json
### 2.2 Camera Integration
- [ ] Implementace camera API
- [ ] Barcode detection library
- [ ] Permission handling
### 2.3 UI Components
- [ ] Scanner component
- [ ] Result display
- [ ] Error handling UI
- [ ] Sound feedback
### 2.4 Sync Logic
- [ ] Offline queue
- [ ] Sync on reconnect
- [ ] Conflict resolution
## Phase 3: Integration (8h)
### 3.1 EspoCRM Integration
- [ ] Nové tlačítko "Skenovat" na formuláři
- [ ] Modal se scannerem
- [ ] Auto-fill produktu
### 3.2 Workflow
- [ ] Trigger po naskenování
- [ ] Logging pro audit
## Phase 4: Testing (8h)
### 4.1 Unit Tests
- [ ] API endpoint testy
- [ ] Validation testy
- [ ] Service testy
### 4.2 E2E Tests
- [ ] Playwright testy (desktop)
- [ ] Mobile test scenarios
### 4.3 UAT
- [ ] Test se skladníky
- [ ] Performance test (100 skenů/min)
## Phase 5: Documentation (4h)
- [ ] Uživatelská příručka
- [ ] Admin dokumentace
- [ ] API dokumentace
- [ ] CHANGELOG update
Progress tracking¶
Progress: ████████░░░░░░░░ 8/16 tasks (50%)
Phase 1: ████████████████ 4/4 (100%) ✅
Phase 2: ░░░░░░░░░░░░░░░░ 0/4 (0%)
Phase 3: ░░░░░░░░░░░░░░░░ 0/2 (0%)
Phase 4: ░░░░░░░░░░░░░░░░ 0/3 (0%)
Phase 5: ░░░░░░░░░░░░░░░░ 0/4 (0%)
Best practices¶
- Tasks jsou granulární (max 4h na task)
- Každý task má jasný výstup
- Postupně označujeme
[x]po dokončení - Progress bar aktualizujeme při změně
➡️ Pokračujte na Design.md.