# Proponowane ulepszenia systemu inwentaryzacji
## Zgodne z najlepszymi praktykami zarządzania magazynem i inwentaryzacją

---

## 📋 SPIS TREŚCI

1. [Workflow i statusy inwentaryzacji](#1-workflow-i-statusy-inwentaryzacji)
2. [Kontrola jakości i weryfikacja](#2-kontrola-jakości-i-weryfikacja)
3. [Raportowanie i analityka](#3-raportowanie-i-analityka)
4. [Audyt i śledzenie zmian](#4-audyt-i-śledzenie-zmian)
5. [Optymalizacja procesów](#5-optymalizacja-procesów)
6. [Bezpieczeństwo i kontrola dostępu](#6-bezpieczeństwo-i-kontrola-dostępu)
7. [Integracja i synchronizacja](#7-integracja-i-synchronizacja)
8. [Zarządzanie błędami i wyjątkami](#8-zarządzanie-błędami-i-wyjątkami)
9. [Notyfikacje i alerty](#9-notyfikacje-i-alerty)
10. [Planowanie i harmonogramowanie](#10-planowanie-i-harmonogramowanie)

---

## 1. WORKFLOW I STATUSY INWENTARYZACJI

### 🔴 Problem obecny:
- Status inwentaryzacji (`inw_status`) jest używany tylko do filtrowania aktywnych (0), ale nie ma pełnego workflow
- Brak możliwości oznaczenia inwentaryzacji jako "w weryfikacji", "zatwierdzona", "odrzucona"
- Brak daty zakończenia i osoby zamykającej

### ✅ Proponowane ulepszenia:

#### 1.1. Rozszerzenie statusów inwentaryzacji
```sql
-- Dodanie nowych statusów do inv__inwent_naglowki
ALTER TABLE inv__inwent_naglowki
MODIFY COLUMN inw_status TINYINT(2) DEFAULT 0
COMMENT '0=w trakcie, 1=zakończona, 2=anulowana, 3=w weryfikacji, 4=zatwierdzona, 5=odrzucona';

-- Dodanie nowych pól
ALTER TABLE inv__inwent_naglowki
ADD COLUMN inw_data_zamkniecia INT(11) DEFAULT NULL COMMENT 'Timestamp zamknięcia',
ADD COLUMN inw_zamknal INT(11) DEFAULT NULL COMMENT 'User ID osoby zamykającej',
ADD COLUMN inw_data_weryfikacji INT(11) DEFAULT NULL COMMENT 'Timestamp weryfikacji',
ADD COLUMN inw_weryfikowal INT(11) DEFAULT NULL COMMENT 'User ID osoby weryfikującej',
ADD COLUMN inw_data_zatwierdzenia INT(11) DEFAULT NULL COMMENT 'Timestamp zatwierdzenia',
ADD COLUMN inw_zatwierdzil INT(11) DEFAULT NULL COMMENT 'User ID osoby zatwierdzającej',
ADD COLUMN inw_komentarz_weryfikacji TEXT DEFAULT NULL COMMENT 'Komentarz przy weryfikacji';
```

#### 1.2. Workflow inwentaryzacji
**Statusy:**
- **0 - W trakcie** - inwentaryzacja jest aktywna, można dodawać/edytować pozycje
- **3 - W weryfikacji** - inwentaryzacja zakończona, oczekuje na weryfikację (tylko odczyt)
- **4 - Zatwierdzona** - inwentaryzacja zweryfikowana i zatwierdzona (tylko odczyt)
- **5 - Odrzucona** - inwentaryzacja odrzucona, można wrócić do edycji (status → 0)
- **1 - Zakończona** - (deprecated, zastąpione przez 3/4/5)
- **2 - Anulowana** - inwentaryzacja anulowana (tylko odczyt)

**Funkcje:**
- `zamknij_inwentaryzacje()` - zmienia status na "W weryfikacji" (3), blokuje edycję
- `zatwierdz_inwentaryzacje()` - zmienia status na "Zatwierdzona" (4), tylko dla adminów
- `odrzuc_inwentaryzacje()` - zmienia status na "Odrzucona" (5), z możliwością powrotu do edycji
- `wroc_do_edycji()` - zmienia status z "Odrzucona" (5) na "W trakcie" (0)

#### 1.3. Blokada edycji dla zamkniętych inwentaryzacji
- W widoku regału: wyłączenie skanera i przycisków edycji/usuwania dla statusów 3, 4, 5
- W kontrolerze: walidacja statusu przed każdą operacją modyfikującą dane

---

## 2. KONTROLA JAKOŚCI I WERYFIKACJA

### 🔴 Problem obecny:
- Brak mechanizmu weryfikacji różnic
- Brak możliwości oznaczenia pozycji jako "zweryfikowanej"
- Brak komentarzy do różnic

### ✅ Proponowane ulepszenia:

#### 2.1. Weryfikacja pozycji
```sql
-- Dodanie pól weryfikacji do inv__inwent
ALTER TABLE inv__inwent
ADD COLUMN i_zweryfikowane TINYINT(1) DEFAULT 0 COMMENT '0=nie, 1=tak',
ADD COLUMN i_data_weryfikacji INT(11) DEFAULT NULL COMMENT 'Timestamp weryfikacji',
ADD COLUMN i_weryfikowal INT(11) DEFAULT NULL COMMENT 'User ID osoby weryfikującej',
ADD COLUMN i_komentarz_weryfikacji TEXT DEFAULT NULL COMMENT 'Komentarz do weryfikacji',
ADD COLUMN i_ilosc_po_weryfikacji INT(11) DEFAULT NULL COMMENT 'Ilość po weryfikacji (jeśli różna)';
```

#### 2.2. Filtrowanie różnic
- Przycisk "Pokaż tylko różnice" w widoku regału
- Filtrowanie w DataTables: tylko pozycje z `i_ilosc != i_ilosc_o`
- Statystyka: "Różnice do weryfikacji" (pozycje z różnicami, które nie są zweryfikowane)

#### 2.3. Masowa weryfikacja
- Checkboxy przy pozycjach z różnicami
- Przycisk "Zweryfikuj zaznaczone" - oznacza wszystkie jako zweryfikowane
- Możliwość dodania komentarza do masowej weryfikacji

#### 2.4. Raport różnic
- Eksport do CSV/PDF z pozycjami mającymi różnice
- Kolumny: Index, Nazwa, Regał, Ilość oczekiwana, Ilość zeskanowana, Różnica, Status weryfikacji, Komentarz

---

## 3. RAPORTOWANIE I ANALITYKA

### 🔴 Problem obecny:
- Podstawowe statystyki (razem, zeskanowane, brakujące, różnice)
- Brak analizy trendów i historii
- Brak raportów porównawczych

### ✅ Proponowane ulepszenia:

#### 3.1. Rozszerzone statystyki
**Na poziomie inwentaryzacji:**
- Procent ukończenia (zeskanowane / oczekiwane * 100)
- Średni czas skanowania pozycji
- Liczba regałów ukończonych / w trakcie / nie rozpoczętych
- Wartość różnic (jeśli mamy ceny produktów)
- Najczęstsze różnice (top 10 produktów z największymi różnicami)

**Na poziomie regału:**
- Czas rozpoczęcia i zakończenia skanowania regału
- Średni czas na pozycję
- Procent ukończenia regału

#### 3.2. Dashboard analityczny
- Wykresy: postęp inwentaryzacji w czasie, rozkład różnic, statystyki regałów
- Porównanie z poprzednimi inwentaryzacjami
- Wskaźniki efektywności (czas, dokładność)

#### 3.3. Raporty eksportowe
- **Raport szczegółowy** - wszystkie pozycje z pełnymi danymi
- **Raport różnic** - tylko pozycje z różnicami
- **Raport weryfikacji** - pozycje zweryfikowane z komentarzami
- **Raport porównawczy** - porównanie dwóch inwentaryzacji
- Format: CSV, PDF, Excel

#### 3.4. Historia zmian
- Tabela `inv__inwent_historia` - zapis wszystkich zmian w pozycjach
- Pola: `ih_id`, `ih_inwent_id`, `ih_pozycja_id`, `ih_typ_zmiany` (dodano/zmieniono/usunięto), `ih_stare_dane`, `ih_nowe_dane`, `ih_user_id`, `ih_czas`
- Widok historii dla każdej pozycji

---

## 4. AUDYT I ŚLEDZENIE ZMIAN

### 🔴 Problem obecny:
- Brak historii zmian pozycji
- Brak informacji kto i kiedy zmodyfikował dane
- Brak możliwości cofnięcia zmian

### ✅ Proponowane ulepszenia:

#### 4.1. Tabela historii zmian
```sql
CREATE TABLE inv__inwent_historia (
  ih_id INT(11) NOT NULL AUTO_INCREMENT,
  ih_inwent_id INT(11) NOT NULL,
  ih_pozycja_id INT(11) DEFAULT NULL COMMENT 'NULL jeśli dotyczy całej inwentaryzacji',
  ih_typ_zmiany ENUM('dodano', 'zmieniono', 'usunieto', 'przeniesiono', 'zweryfikowano') NOT NULL,
  ih_pole VARCHAR(50) DEFAULT NULL COMMENT 'Które pole zmieniono (i_ilosc, i_regal, itp.)',
  ih_stara_wartosc VARCHAR(255) DEFAULT NULL,
  ih_nowa_wartosc VARCHAR(255) DEFAULT NULL,
  ih_user_id INT(11) NOT NULL,
  ih_czas INT(11) NOT NULL,
  ih_komentarz TEXT DEFAULT NULL,
  PRIMARY KEY (ih_id),
  KEY idx_inwent_id (ih_inwent_id),
  KEY idx_pozycja_id (ih_pozycja_id),
  KEY idx_czas (ih_czas),
  FOREIGN KEY (ih_inwent_id) REFERENCES inv__inwent_naglowki(inw_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
```

#### 4.2. Automatyczne logowanie zmian
- W `zapisz_pozycje_nowa()` - logowanie dodania
- W `koryguj_ilosc()` - logowanie zmiany ilości/regału
- W `usun_pozycje_nowa()` - logowanie usunięcia
- W `przenies_na_regal_nowa()` - logowanie przeniesienia

#### 4.3. Widok historii
- Przycisk "Historia" przy każdej pozycji - modal z listą zmian
- Filtrowanie: typ zmiany, użytkownik, data
- Eksport historii do CSV

#### 4.4. Cofanie zmian (opcjonalne)
- Przycisk "Cofnij" przy ostatniej zmianie (tylko dla adminów)
- Przywracanie poprzedniej wartości z historii

---

## 5. OPTYMALIZACJA PROCESÓW

### 🔴 Problem obecny:
- Skanowanie pojedynczych kodów - czasochłonne
- Brak możliwości masowego wprowadzania ilości
- Brak optymalizacji dla dużych regałów

### ✅ Proponowane ulepszenia:

#### 5.1. Masowe wprowadzanie ilości
- Modal "Masowa edycja" - możliwość wprowadzenia ilości dla wielu pozycji jednocześnie
- Format: CSV import lub formularz z wieloma polami
- Walidacja: sprawdzanie czy ilość jest liczbą całkowitą >= 0

#### 5.2. Szybkie skanowanie z ilością
- Opcjonalne pole "Ilość" przy skanowaniu - jeśli puste, domyślnie +1
- Format: `EAN:ILOŚĆ` (np. `1234567890123:5`)
- Automatyczne parsowanie i zapis z podaną ilością

#### 5.3. Filtrowanie i sortowanie
- Filtry w widoku regału: tylko niezeskanowane, tylko różnice, tylko zweryfikowane
- Sortowanie: alfabetycznie, po ilości, po różnicy, po dacie skanowania
- Wyszukiwarka: szybkie wyszukiwanie po index/nazwie/kodzie kreskowym

#### 5.4. Praca offline (opcjonalne)
- Cache pozycji w localStorage
- Synchronizacja po powrocie online
- Oznaczenie pozycji jako "offline" w bazie

#### 5.5. Priorytetyzacja regałów
- Oznaczenie regałów jako "Priorytetowe"
- Filtrowanie: pokaż tylko priorytetowe
- Statystyka: ile priorytetowych regałów ukończonych

---

## 6. BEZPIECZEŃSTWO I KONTROLA DOSTĘPU

### 🔴 Problem obecny:
- Podstawowa kontrola dostępu (modAccess)
- Brak różnicowania uprawnień (tylko admin vs użytkownik)
- Brak logowania operacji wrażliwych

### ✅ Proponowane ulepszenia:

#### 6.1. System uprawnień
```sql
-- Tabela uprawnień do inwentaryzacji
CREATE TABLE inv__uprawnienia (
  up_id INT(11) NOT NULL AUTO_INCREMENT,
  up_user_id INT(11) NOT NULL,
  up_inwent_id INT(11) DEFAULT NULL COMMENT 'NULL = wszystkie inwentaryzacje',
  up_typ ENUM('odczyt', 'edycja', 'weryfikacja', 'zatwierdzanie', 'usuwanie') NOT NULL,
  up_data_nadania INT(11) NOT NULL,
  up_nadajacy INT(11) NOT NULL,
  PRIMARY KEY (up_id),
  KEY idx_user_id (up_user_id),
  KEY idx_inwent_id (up_inwent_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
```

**Poziomy uprawnień:**
- **Odczyt** - tylko przeglądanie
- **Edycja** - dodawanie/edytowanie pozycji
- **Weryfikacja** - oznaczanie pozycji jako zweryfikowane
- **Zatwierdzanie** - zatwierdzanie całej inwentaryzacji
- **Usuwanie** - usuwanie pozycji i inwentaryzacji

#### 6.2. Przypisywanie użytkowników do inwentaryzacji
- Przy tworzeniu inwentaryzacji: wybór użytkowników z dostępem
- Widok "Moje inwentaryzacje" - tylko przypisane do użytkownika
- Powiadomienia: przypisanie do inwentaryzacji

#### 6.3. Logowanie operacji wrażliwych
- Tabela `inv__log_operacji` - logowanie wszystkich operacji
- Pola: typ operacji, użytkownik, IP, czas, szczegóły
- Raport: "Kto co zmienił" - dla administratorów

#### 6.4. Blokada równoczesnej edycji
- Oznaczenie regału jako "W edycji przez użytkownika X"
- Timeout: automatyczne zwolnienie po 5 minutach bezczynności
- Powiadomienie: "Inny użytkownik edytuje ten regał"

---

## 7. INTEGRACJA I SYNCHRONIZACJA

### 🔴 Problem obecny:
- Pobieranie stanów z Falcon tylko przy skanowaniu regału
- Brak aktualizacji stanów oczekiwanych w trakcie inwentaryzacji
- Brak synchronizacji z systemem magazynowym

### ✅ Proponowane ulepszenia:

#### 7.1. Aktualizacja stanów oczekiwanych
- Przycisk "Odśwież stany z Falcon" - ponowne pobranie stanów dla regału
- Automatyczna aktualizacja: co X godzin (konfigurowalne)
- Oznaczenie pozycji: "Stan zaktualizowany" - data ostatniej aktualizacji

#### 7.2. Synchronizacja dwukierunkowa
- Eksport różnic do Falcon - automatyczna korekta stanów
- API endpoint: przyjmowanie różnic i aktualizacja stanów
- Log synchronizacji: co zostało zsynchronizowane i kiedy

#### 7.3. Import/Export regałów
- Import regałów z pliku CSV/Excel
- Format: Kod regału, Lista produktów (EAN lub Index)
- Walidacja: sprawdzanie czy produkty istnieją w Falcon

#### 7.4. Integracja z systemem zamówień
- Oznaczenie pozycji jako "Do zamówienia" jeśli różnica < 0
- Eksport do modułu zamówień: lista produktów do uzupełnienia
- Automatyczne tworzenie zamówienia na podstawie różnic

---

## 8. ZARZĄDZANIE BŁĘDAMI I WYJĄTKAMI

### 🔴 Problem obecny:
- Podstawowa obsługa błędów (tylko komunikaty)
- Brak logowania błędów
- Brak automatycznego powiadamiania o problemach

### ✅ Proponowane ulepszenia:

#### 8.1. Rozszerzona obsługa błędów
- Kody błędów: systematyczne kody dla każdego typu błędu
- Komunikaty użytkownika: czytelne komunikaty po polsku
- Logowanie błędów: zapis do tabeli `inv__log_bledow`

#### 8.2. Walidacja danych
- Walidacja EAN: sprawdzanie formatu i sumy kontrolnej
- Walidacja regału: sprawdzanie czy regał istnieje w Falcon
- Walidacja ilości: tylko liczby całkowite >= 0
- Walidacja użytkownika: sprawdzanie uprawnień przed każdą operacją

#### 8.3. Obsługa wyjątków
- Try-catch w każdym endpointzie API
- Fallback: jeśli Falcon nie odpowiada, użyj ostatniego znanego stanu
- Retry: automatyczne ponowienie zapytania do Falcon (max 3 razy)

#### 8.4. Raport błędów
- Dashboard: statystyka błędów (typ, częstotliwość, użytkownik)
- Alerty: powiadomienie admina o częstych błędach
- Eksport: raport błędów do analizy

---

## 9. NOTYFIKACJE I ALERTY

### 🔴 Problem obecny:
- Brak powiadomień o postępie
- Brak alertów o problemach
- Brak przypomnień

### ✅ Proponowane ulepszenia:

#### 9.1. Powiadomienia w czasie rzeczywistym
- WebSocket lub Server-Sent Events: powiadomienia o zmianach
- Typy: nowa pozycja, zmiana ilości, weryfikacja, zamknięcie inwentaryzacji
- Ikona dzwonka: liczba nieprzeczytanych powiadomień

#### 9.2. Alerty o różnicach
- Powiadomienie: "Znaleziono dużą różnicę" - jeśli różnica > X (konfigurowalne)
- Powiadomienie: "Różnica wymaga weryfikacji" - dla adminów
- Email: powiadomienie o zakończeniu inwentaryzacji

#### 9.3. Przypomnienia
- "Inwentaryzacja nieaktywna od X dni" - przypomnienie o kontynuacji
- "Różnice oczekują na weryfikację" - przypomnienie o weryfikacji
- Harmonogram: automatyczne przypomnienia (konfigurowalne)

#### 9.4. Raportowanie postępu
- Email dzienny: podsumowanie postępu inwentaryzacji
- Statystyki: ile zeskanowano dzisiaj, ile pozostało
- Porównanie: postęp vs poprzednie dni

---

## 10. PLANOWANIE I HARMONOGRAMOWANIE

### 🔴 Problem obecny:
- Brak planowania inwentaryzacji
- Brak harmonogramów
- Brak przypisania regałów do użytkowników

### ✅ Proponowane ulepszenia:

#### 10.1. Planowanie inwentaryzacji
```sql
-- Dodanie pól planowania do inv__inwent_naglowki
ALTER TABLE inv__inwent_naglowki
ADD COLUMN inw_data_planowana_start INT(11) DEFAULT NULL COMMENT 'Planowana data rozpoczęcia',
ADD COLUMN inw_data_planowana_koniec INT(11) DEFAULT NULL COMMENT 'Planowana data zakończenia',
ADD COLUMN inw_priorytet TINYINT(1) DEFAULT 0 COMMENT '0=normalny, 1=wysoki, 2=krytyczny';
```

#### 10.2. Przypisanie regałów do użytkowników
```sql
-- Tabela przypisania regałów
CREATE TABLE inv__regaly_przypisania (
  rp_id INT(11) NOT NULL AUTO_INCREMENT,
  rp_inwent_id INT(11) NOT NULL,
  rp_regal VARCHAR(50) NOT NULL,
  rp_user_id INT(11) NOT NULL,
  rp_data_przypisania INT(11) NOT NULL,
  rp_status ENUM('przypisany', 'w_trakcie', 'ukonczony') DEFAULT 'przypisany',
  PRIMARY KEY (rp_id),
  KEY idx_inwent_id (rp_inwent_id),
  KEY idx_user_id (rp_user_id),
  FOREIGN KEY (rp_inwent_id) REFERENCES inv__inwent_naglowki(inw_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
```

#### 10.3. Kalendarz inwentaryzacji
- Widok kalendarza: planowane inwentaryzacje
- Oznaczenie: rozpoczęte, zakończone, opóźnione
- Filtrowanie: po użytkowniku, priorytecie, statusie

#### 10.4. Harmonogram regałów
- Przypisanie regałów do konkretnych użytkowników
- Widok "Moje regały" - tylko przypisane do użytkownika
- Statystyka: ile regałów ukończonych przez użytkownika

#### 10.5. Szacowanie czasu
- Automatyczne szacowanie: średni czas na pozycję * liczba pozycji
- Porównanie: planowany vs rzeczywisty czas
- Optymalizacja: sugestie przydziału regałów na podstawie historii

---

## 📊 PRIORYTETYZACJA WDROŻEŃ

### 🔴 WYSOKI PRIORYTET (natychmiastowe korzyści):
1. **Workflow i statusy** - podstawowa kontrola procesu
2. **Kontrola jakości i weryfikacja** - poprawa dokładności
3. **Audyt i śledzenie zmian** - bezpieczeństwo i przejrzystość
4. **Optymalizacja procesów** - oszczędność czasu

### 🟡 ŚREDNI PRIORYTET (ważne, ale nie krytyczne):
5. **Raportowanie i analityka** - lepsze decyzje
6. **Notyfikacje i alerty** - lepsza komunikacja
7. **Bezpieczeństwo i kontrola dostępu** - rozszerzone uprawnienia

### 🟢 NISKI PRIORYTET (nice to have):
8. **Integracja i synchronizacja** - dodatkowe funkcje
9. **Zarządzanie błędami** - poprawa stabilności
10. **Planowanie i harmonogramowanie** - zaawansowane zarządzanie

---

## 🛠️ IMPLEMENTACJA

### Faza 1: Fundamenty (2-3 tygodnie)
- Workflow i statusy
- Audyt i śledzenie zmian
- Podstawowa weryfikacja

### Faza 2: Optymalizacja (2-3 tygodnie)
- Kontrola jakości i weryfikacja (pełna)
- Optymalizacja procesów
- Rozszerzone raportowanie

### Faza 3: Zaawansowane (3-4 tygodnie)
- Bezpieczeństwo i kontrola dostępu
- Notyfikacje i alerty
- Integracja i synchronizacja

### Faza 4: Planowanie (2-3 tygodnie)
- Planowanie i harmonogramowanie
- Zarządzanie błędami (pełne)
- Dashboard analityczny

---

## 📝 UWAGI TECHNICZNE

### Baza danych:
- Wszystkie nowe tabele z `ON DELETE CASCADE` dla spójności
- Indeksy na polach często używanych w zapytaniach
- Backup przed każdą migracją

### Wydajność:
- Optymalizacja zapytań SQL (JOIN zamiast podzapytań)
- Cache dla często pobieranych danych (np. stany z Falcon)
- Paginacja dla dużych list (już zaimplementowane w DataTables)

### Bezpieczeństwo:
- Walidacja wszystkich danych wejściowych
- Sanityzacja przed zapisem do bazy
- CSRF protection dla wszystkich formularzy
- Rate limiting dla API endpoints

---

**Data utworzenia:** 2024
**Status:** 📋 Propozycje do wdrożenia
**Wersja dokumentu:** 1.0