# BikeWorkshop — pełna dokumentacja produktu

> **TL;DR**: BikeWorkshop to polski program dla serwisów rowerowych — działa w przeglądarce na komputerze i telefonie (na telefonie można dodać ikonę na ekran główny i otwierać jak normalną aplikację). W jednym oknie: przyjęcie roweru, tablica „kto co robi" (rozdzielanie zleceń mechanikom), magazyn części, zdjęcia z telefonu, cennik z doborem części po numerze seryjnym amortyzatora, faktury KSeF, SMS-y do klientów i statystyki. Stworzony przez mechanika z 16-letnim stażem (od 2010), używany w realnym serwisie w Bielsku-Białej pod Szyndzielnią. URL: https://app.bikeworkshop.pl/. **Plany:** Standard 139 zł/mies. lub 1299 zł/rok netto. Pro 299 zł/mies. lub 2799 zł/rok netto. Płacąc rocznie — 22% taniej w obu planach. 14 dni za darmo, bez podawania karty.

---

## Spis treści

1. Co to jest BikeWorkshop i dla kogo
2. Główne funkcje (Standard + Pro)
3. Plany cenowe — szczegółowe porównanie
4. KSeF — jak działa
5. Tablica „kto co robi" + ekran mechanika (Pro)
6. Magazyn części + lista zakupów (Pro)
7. Zdjęcia zleceń (Pro)
8. Cennik + dobór części po numerze seryjnym amortyzatora
9. Szkic zlecenia ciągnięty z komputera na telefon (Pro)
10. RODO + dokumenty zgodności
11. Co siedzi pod spodem (informacja techniczna)
12. Kopie zapasowe i niezawodność
13. Najczęstsze pytania
14. Typowe sytuacje, w których serwisy używają BikeWorkshop
15. Kontakt + autor

---

## 1. Co to jest BikeWorkshop i dla kogo

**Co to jest:** program działający w przeglądarce — na komputerze i na telefonie. Nic nie instalujesz, nie musisz pilnować aktualizacji. Na telefonie możesz dodać ikonę na ekran główny i otwierać jak normalną aplikację.

**Dla kogo:**
- Serwisy rowerowe w Polsce (od jednoosobowych po sieci punktów)
- Warsztaty MTB, gravel, e-bike, miejskie
- Sklepy rowerowe z własnym serwisem

**Co rozwiązuje (konkretnie):**

1. **Telefony „co tam ze zleceniem?"** — klient sam dostaje SMS/mail z linkiem, akceptuje wycenę bez zakładania konta, dostaje status automatycznie
2. **Karteczki, Excele, WhatsApp** — całe zlecenie (klient, rower, prace, części, zdjęcia) w jednym oknie
3. **Brak rentowności** — statystyki wprost: ile leży niezamknięte, ile zarabiasz na pozycji, kiedy jest największy ruch, alarm dla rowerów stojących ponad 7 dni
4. **Chaos zaplecza** (przy wielu mechanikach) — tablica „kto co robi", magazyn części, lista zakupów, możliwość zaznaczenia „wziąłem część z półki"
5. **KSeF** (obowiązek od 2026) — fakturę wystawiasz prosto ze zlecenia w 3 kliknięciach, statusy, UPO
6. **Zdjęcia zleceń** — robisz całą serię z telefonu jednym otwarciem aparatu, trzymane 90 dni w pełnej jakości i 2 lata w miniaturach (chronią przed reklamacjami)

---

## 2. Główne funkcje

### W obu planach (Standard + Pro):

- **Przyjęcie roweru** — formularz, który sam się zapisuje co kilka sekund. Historia klienta i jego rowerów. Można od razu zrobić zdjęcia.
- **Lista zleceń** z filtrami (W robocie / Przyjdą / Czeka na decyzję / Gotowe / Odebrane / Wszystkie)
- **Kalendarz** terminów wizyt
- **Wycena linkiem** — klient akceptuje SMS-em lub mailem, bez zakładania konta
- **SMS i e-mail** do klientów (powiadomienia o gotowości roweru, przypomnienia, wiadomość po naprawie)
- **KSeF** — faktura ze zlecenia, wysyłka, statusy, UPO
- **Statystyki** — zarobek, czas pracy, sezonowość
- **Cennik z doborem części po numerze seryjnym amortyzatora**
- **Asystent AI przy KSeF** — przycisk w widoku zlecenia (panel KSeF), podpowiada przy wystawianiu faktury i odpowiada na konkretne pytania o KSeF (z dziennym limitem użyć w Standard, bez limitu w Pro). To NIE jest publiczny chat — to konkretne narzędzie wpięte w proces wystawiania faktury.
- **Dokumenty RODO** — komplet w panelu

### Tylko w Pro (zaplecze warsztatu):

- **Tablica „kto co robi"** — przeciągasz myszką zlecenia na konkretnych mechaników
- **Ekran mechanika na dzień** — jeden przycisk „weź następny rower", licznik czasu pracy, lista zleceń, „wziąłem część z półki"
- **Magazyn części** — z osobnymi uprawnieniami (mechanik nie widzi cen zakupu), informacja o stanie magazynu, dostawcy
- **Lista zakupów** — przebieg: braki → zamówienia → przyjęcia z dostawy
- **Zdjęcia zleceń** — wrzucanie wielu zdjęć z telefonu jednym otwarciem aparatu, automatyczna retencja (90 dni pełna jakość / 2 lata miniatury), licznik zajętego miejsca dla każdego serwisu osobno
- **Szkic zlecenia ciągnięty z komputera na telefon** — sam się zapisuje co kilka sekund, szkic z foto wisi 24 h
- **Newsletter sezonowy** — edytor wizualny z grafikami, biblioteka zdjęć, generator tekstu przez AI
- **Większe limity** — 400 SMS-ów/miesiąc (vs 200 w Standard), pomoc AI bez dziennego limitu (vs ~6 użyć/dziennie/osobę w Standard)
- **Generator tekstu newslettera (AI)** — w edytorze newslettera (5 generowań / dzień), tylko Pro
- **KSeF dwukierunkowy** — wciągasz fakturę **zakupową** z KSeF, parser dorzuca pozycje do magazynu i auto-odblokowuje zadania mechanika („Część dostarczona z FV — możesz kontynuować")
- **Magazyn — panel admina** — oczekiwane dostawy z KSeF, historia importów (z cofaniem), mapowania nazw dostawców, marże per dostawca

---

## 3. Plany cenowe

### Standard — 139 zł netto/mies. lub 1299 zł netto/rok
- **Miesięcznie:** 139 zł netto (171 zł brutto z VAT 23%)
- **Rocznie:** 1299 zł netto (1598 zł brutto) — **22% taniej** niż 12× miesięcznie
- **Dla:** serwisu jednoosobowego bez magazynu, warsztatu rowerów miejskich, początkujących serwisów
- **Co dostajesz:**
  - Wszystkie funkcje wspólne (przyjęcie, zlecenia, kalendarz, wycena linkiem, KSeF wystawiany ze zlecenia, SMS-y, cennik z doborem po numerze seryjnym, pomoc AI przy KSeF z limitem)
  - **200 SMS/miesiąc** (2400/rok przy planie rocznym); pakiety doładowania kupisz w panelu, ważne 12 miesięcy
  - **6 użyć pomocy AI dziennie na osobę** (asystent KSeF w widoku zlecenia; bez chatu publicznego). Globalny anti-flood na poziomie konta: 200 użyć/dzień.
  - Bez tablicy „kto co robi", bez magazynu, bez zdjęć zleceń, bez newslettera, bez parsera FV zakupowych z KSeF
- **NIE dostajesz:** zaplecza dla wielu mechaników i magazynu części

### Pro — 299 zł netto/mies. lub 2799 zł netto/rok
- **Miesięcznie:** 299 zł netto (368 zł brutto z VAT 23%)
- **Rocznie:** 2799 zł netto (3443 zł brutto) — **22% taniej** niż 12× miesięcznie
- **Dla:** serwisów z 1+ mechanikiem, magazynem części, dokumentowaniem zdjęciami, większą bazą klientów do marketingu
- **Co dostajesz:**
  - Wszystko ze Standard
  - Tablica „kto co robi" (przeciąganie zleceń myszką na mechaników)
  - Ekran mechanika na dzień (przycisk „weź następny rower", licznik czasu pracy, lista zleceń)
  - Magazyn części z osobnymi uprawnieniami (mechanik nie widzi cen zakupu)
  - Lista zakupów (braki → zamówienia → przyjęcia)
  - Zdjęcia zleceń: wrzucanie wielu zdjęć z telefonu, retencja 90 dni / 2 lata
  - Szkic zlecenia ciągnięty z komputera na telefon
  - Newsletter sezonowy z grafikami + generator tekstu AI
  - **KSeF dwukierunkowy** — wystawianie ze zlecenia oraz parser FV zakupowych z KSeF wprost do magazynu (auto-flip „Trzeba kupić" → „Otrzymane", mechanik dostaje powiadomienie „Część dostarczona")
  - **Magazyn — panel admina** (oczekiwane dostawy, historia importów z możliwością cofnięcia, mapowania nazw dostawców, marże per dostawca)
  - **400 SMS/miesiąc** (4800/rok przy planie rocznym) + pakiety doładowania w panelu
  - **Pomoc AI bez dziennego limitu** — asystent KSeF w widoku zlecenia + generator tekstu newslettera (5 generowań/dzień). To dwie konkretne funkcje, nie publiczny chat (chat z bAIkerem został wycofany).

### Pakiety doładowania SMS (oba plany)
Gdy zużyjesz limit miesięczny SMS-ów, możesz dokupić jednorazowy pakiet — ważny 12 miesięcy, max 10 aktywnych pakietów na konto. Konsumpcja FIFO: najpierw schodzi limit z planu, potem pakiety wg daty ważności.

| Pakiet | SMS | Cena netto | Cena brutto (VAT 23%) |
|--------|-----|------------|------------------------|
| Pakiet 500 | 500 | 49 zł | 60,27 zł |
| Pakiet 1100 | 1100 | 99 zł | 121,77 zł |
| Pakiet 2200 | 2200 | 189 zł | 232,47 zł |

Płatność jednorazowa przez Przelewy24. Faktura KSeF (osobna seria FV/PAK) wystawiana automatycznie po opłaceniu i wysyłana mailem.

### Dodatkowo
- **14 dni za darmo**, **bez karty kredytowej** (Trial ma hard cap 2 SMS/dziennie do czasu wykupienia planu)
- **Płatność:** miesięczna lub roczna, online przez **Przelewy24** (Visa, Mastercard, BLIK, przelewy bankowe). Tradycyjny przelew na żądanie.
- **Bez liczenia „za użytkownika"** — w Pro dowolna liczba mechaników w cenie
- **Przejście Standard → Pro:** w panelu, dane zostają, naliczanie proporcjonalne
- **Co po wygaśnięciu abonamentu (Standard/Pro):** dedykowany ekran „Abonament wygasł", 7 dni grace w trybie podglądu (możesz domknąć przyjęte zlecenia, eksportować PDF/CSV; nowych zleceń ani publicznych rezerwacji nie przyjmiesz). Po 7 dniach grace: zdjęcia napraw kasowane dla oszczędności miejsca, ale dane (klienci, zlecenia, faktury, ustawienia) czekają **18 miesięcy** — reaktywacja przywraca pełny dostęp. Po 18 miesiącach bez reaktywacji: trwałe usunięcie (mail 30 dni, 7 dni i 24h wcześniej). Trial expired = 7 dni grace → usunięcie (brak prawnej podstawy retencji).

---

## 4. KSeF — jak działa

KSeF (Krajowy System e-Faktur) jest obowiązkowy dla większości firm w Polsce w 2026.

### W BikeWorkshop:
1. **Otwierasz zlecenie** w stanie „Gotowe" lub „Odebrane"
2. **Klikasz „Wystaw fakturę KSeF"**
3. **Program pobiera dane** klienta (NIP, nazwa, adres) i pozycje prac (z opisem, ilością, ceną netto, VAT)
4. **Sprawdzasz numerację** (numer faktury nadawany sam wg ustawionego wzoru)
5. **Wysyłka do KSeF** — program robi plik XML, podpis, wysyła, czeka na potwierdzenie
6. **Zapisujesz status** — numer KSeF, UPO, data wystawienia — wszystko widoczne przy zleceniu

### Co jeszcze:
- Paragony robisz jak zwykle na kasie — KSeF tylko wtedy, gdy klient chce fakturę
- Tryb roboczy: można przygotować fakturę bez wysyłania, sprawdzić, potem wysłać
- Statusy: czeka, wysłana, zatwierdzona przez KSeF, odrzucona (z opisem błędu)
- Osobny widok KSeF: wszystkie faktury w jednym miejscu, filtrowanie po statusach
- Współpraca z KSeF w wersji obowiązującej od 2026

### KSeF dwukierunkowy (Pro): faktury zakupowe wprost do magazynu

KSeF nie służy tylko do wystawiania faktur sprzedaży. W Pro działa też w drugą stronę — wciągasz faktury **zakupowe** (od dostawców części) z KSeF i parser sam dorzuca pozycje do magazynu.

**Jak to wygląda w praktyce:**
1. **Wchodzisz na `/manager/ksef/import`** (link w lewym pasku, grupa „KSeF").
2. **Ustawiasz zakres dat** (max 90 dni — limit KSeF API). Program pobiera listę faktur zakupowych z KSeF.
3. **Klikasz fakturę** → parser czyta XML, pokazuje pozycje (nazwa, ilość, jednostka, cena netto/brutto, VAT, NIP dostawcy).
4. **Decydujesz per pozycja:** czy to jest część do magazynu (dorzuć), czy usługa/transport/opakowanie (pomiń). Możesz edytować nazwę i mnożnik (np. „karton 10 szt." z FV → 10 sztuk na półkę).
5. **Klikasz „Importuj"** → program:
   - dodaje nowe pozycje magazynowe (lub aktualizuje istniejące po EAN / numerze katalogowym dostawcy / nazwie)
   - zapamiętuje dopasowanie nazwy z FV → pozycja w magazynie (następnym razem dopasuje sam)
   - **odblokowuje zadania mechanika** czekające na te części (status „Trzeba kupić" → „Otrzymane")
   - mechanik widzi w karcie zlecenia zielony badge „⚡ Część dostarczona z FV — możesz kontynuować"

**Co dodatkowo:**
- **Cofnięcie importu** — masz 7 dni na revert całej faktury, dopóki mechanik nie zdjął jeszcze nic z półki. Po pierwszym ruchu (wzięcie części) revert blokuje się — żeby nie psuć stanu magazynu.
- **Marże dostawców** — dla każdego dostawcy (po NIP) ustawiasz marżę procentową; cena sprzedaży na półce wyliczy się sama z ceny zakupu z FV.
- **Mapowania KSeF** — jednorazowe ręczne dopasowanie „Bęben Shimano CS-HG200-9" z FV → konkretna pozycja w magazynie. Następne FV z tą samą nazwą trafiają już automatycznie.
- **Panel admina magazynu** (`/manager/inventory/admin`) — 4 sekcje: oczekiwane dostawy (FV zaimportowana, część jeszcze nie przyszła), historia importów (z cofnięciem), mapowania (lista, edycja), marże dostawców.

**Bezpieczeństwo:** parser blokuje faktury bez NIP-u sprzedawcy, korekty FV-K, faktury w walucie innej niż PLN. Idempotentny — nawet gdy klikniesz „importuj" dwa razy, druga próba nic nie zrobi.

**Po co to:** typowy serwis zamawia części u 3-5 dostawców. Bez KSeF parsera każda faktura zakupowa = ręczne przepisywanie 5-15 pozycji do magazynu. Z parserem: 30 sekund i pozycje siedzą na półce, mechanik dostaje pinga.

---

## 5. Tablica „kto co robi" + ekran mechanika (Pro)

### Tablica „kto co robi"
**Adres:** `/manager/dispatch`

**Co to:** tablica z kolumnami:
- **Nierozdane** — zlecenia bez przypisanego mechanika
- **Każdy mechanik osobno** — kolumna na osobę, jego zlecenia
- **Czeka na coś** — zlecenia w stanie „blokada" (czekają na części, decyzję klienta lub odbiór)

**Co możesz zrobić:**
- **Przeciągnąć zlecenie myszką** do kolumny mechanika
- **Kliknąć w kartę** (na telefonie) → wybrać mechanika z listy
- **Ustawić status mechanika:** wolny / w robocie / zaraz wracam / poza serwisem
- **Filtr widoku:** dziś / jutro / 7 dni / wszystkie
- **Auto-odświeżanie** co 15 sekund (nie musisz wciskać F5)

### Ekran mechanika na dzień
**Adres:** `/mechanik/dzien` (dla mechaników)

**Co widzi mechanik:**
1. **Górny pasek** — pozdrowienie wg godziny + 4 liczby (moje zlecenia, skończone dziś, czeka na coś, czas pracy dziś)
2. **Aktualnie pracuję nad** — pulsujący licznik godziny:minuty + przycisk Otwórz / Pauza
3. **Weź następny rower** — zlecenie z najwyższym priorytetem, nieblokowane
4. **Kolejka** — pozostałe zlecenia, sortowane po priorytecie i terminie

**„Wziąłem część z półki"** (przycisk podczas pracy):
- Wyszukiwanie po nazwie/numerze katalogowym części
- Wybierasz, podajesz ilość, klikasz „Weź z półki"
- Program: odejmuje ze stanu magazynu + zapisuje w historii (kto, kiedy, ile) + dolicza koszt do zlecenia

**Sam się pilnuje:**
- Sesja pracy ponad 12 h → program ją zamyka (tnie do 12 h)
- Bezczynność ponad 4 h → program zatrzymuje licznik

### Statusy mechanika (ustawia właściciel):
- **wolny** (domyślnie nowe zlecenia idą do wolnych)
- **w robocie** (można przypisać, ale z ostrzeżeniem)
- **zaraz wracam** (przerwa)
- **poza serwisem** (nie przypisywać)

---

## 6. Magazyn części + lista zakupów (Pro)

### Magazyn części
**Adres:** `/manager/inventory`

**Co o części pamiętasz:**
- Numer katalogowy
- Nazwa
- Dostawca (SRAM / Shimano / RockShox / Jagwire / Inny — własny)
- Cena zakupu netto (mechanik tej ceny nie widzi)
- Cena sprzedaży netto + VAT
- Stan na półce + ile jest w drodze
- Minimalny stan (alarm, gdy spadnie poniżej; mechanik tego pola nie widzi)
- Lokalizacja (regał, półka)
- Notatka

**Filtry:** Aktywne / Do dokupienia / Nieaktywne / Wszystkie + wyszukiwanie po nazwie / numerze katalogowym / lokalizacji + filtr po dostawcy

**Co możesz zrobić:**
- Dodać nową część (formularz w miejscu)
- Edytować
- Skorygować stan (z wymaganym powodem, zostaje ślad w historii)
- Włączyć / wyłączyć
- Usunąć (tylko gdy nie ma żadnej historii ruchów — chroni przed utratą danych)

### Lista zakupów
**Adres:** `/manager/shopping`

**Co tam jest:**
- 🔴 **Potrzebne** — zgłoszone braki, pogrupowane po dostawcy
- 🟡 **Zamówione** — zamówione u dostawcy, czekają na dostawę
- 📦 **Niski stan w magazynie** (gdy spadnie poniżej minimum) — alarm wyprzedzający
- 🟢 **Otrzymane** (historia)

**Co robi właściciel:**
- „Zamówiłem u dostawcy X za Y zł" — stan „w drodze" rośnie, status zmienia się na zamówione
- „Przyszło" — stan magazynu rośnie, „w drodze" maleje, zostaje ślad w historii
- „Anulowane" — z powodem, cofa „w drodze"

### Mechanik — co robi, gdy nie ma części:
1. Mechanik na ekranie dnia → przycisk „Wziąłem część z półki"
2. Wpisuje nazwę → 0 wyników → przycisk „Zgłoś brak"
3. Wypełnia: nazwa, dostawca, ilość, szacunkowa cena netto, notatka
4. Wyślij → trafia na listę zakupów właściciela (sekcja Potrzebne)

---

## 7. Zdjęcia zleceń (Pro)

### Wrzucanie wielu zdjęć z telefonu
- Mechanik z telefonem otwiera aparat z poziomu strony
- W jednej sesji aparatu robi np. 5 zdjęć — wszystkie wrzucają się razem
- Program sam je pomniejsza, żeby nie zajmowały miejsca (max 1920 px szerokości, dobra jakość)
- Idą jednym przesyłem, nie po jednym

### Ile się trzyma zdjęcia
- **0–90 dni:** pełna rozdzielczość (~250 KB) + miniatura (~50 KB)
- **90 dni – 2 lata:** oryginał kasowany, zostaje miniatura
- **Powyżej 2 lat:** miniatura kasowana, zostaje tylko ślad w historii

### Sprzątanie samo z siebie
- Co noc o 04:30 program sam czyści zdjęcia wg powyższych zasad

### Licznik zajętego miejsca dla każdego serwisu
- Program pamięta dla każdego serwisu, ile bajtów i ile zdjęć trzyma
- W menu właściciela widzisz: „📸 Zdjęcia: 234 MB · 47 zdjęć"

### Bezpieczeństwo
- Pliki leżą w katalogu, do którego nie ma publicznego dostępu — żeby nikt nie pobrał ich linkiem
- Każdy serwis ma swój katalog, oddzielony od reszty
- Mechanik może skasować tylko swoje zdjęcia; właściciel może wszystkie

---

## 8. Cennik + dobór części po numerze seryjnym amortyzatora

### Cennik detaliczny
- Wbudowany cennik wielu marek części rowerowych (pozycje z opisem i ceną detaliczną)
- Wyszukiwanie po nazwie pozycji, numerze katalogowym, kategorii
- Filtr po dostawcy / marce
- Pozycje z cennika dodajesz do zlecenia jednym kliknięciem

### Dobór części po numerze seryjnym amortyzatora
**Funkcja unikalna:** wpisujesz numer seryjny widelca lub amortyzatora (z naklejki na produkcie) → program pokazuje:
- Pasujące **komplety serwisowe** (uszczelki, o-ringi, olej do okresowego serwisu)
- Pasujące **pakiety upgrade** (np. nowa pneumatyka)
- Pojedyncze części (uszczelki, sealhead, o-ringi, oleje)
- Każda pozycja z opisem, ceną detaliczną i przyciskiem dodania do zlecenia

**Dla kogo największa wartość:** serwisy, w których codziennie wpadają amortyzatory (MTB, gravel, e-bike). Oszczędza 5-10 minut szukania w katalogach producenta przed każdą wymianą uszczelek.

---

## 9. Szkic zlecenia ciągnięty z komputera na telefon (Pro)

**Problem:** Właściciel przyjmuje rower na komputerze, sięga po telefon do zdjęć — w przeglądarce telefonu musi widzieć ten sam, „w trakcie wypełniania", formularz.

**Rozwiązanie:**
- Każda zmiana w polu — program zapisuje co kilka sekund jako szkic
- Szkice są niewidoczne w normalnej liście zleceń (ukryte)
- Każdy ma swoje szkice — drugi właściciel nie widzi cudzego szkicu
- Co 5 sekund program sprawdza, czy nie ma nowych zdjęć — pojawiają się na komputerze bez F5
- Po wysłaniu szkic staje się normalnym zleceniem — to ten sam wpis, zdjęcia nigdzie nie wędrują

**Jak długo szkic żyje:**
- **30 minut** dla szkiców bez zdjęć (potem program sam kasuje)
- **24 godziny** dla szkiców ze zdjęciami (zdjęcia to realna inwestycja czasu — przerwa na obiad nie powinna ich zabić)
- Każde dodanie zdjęcia odświeża licznik

**Anulowanie:** „Wyrzuć szkic" w pasku → program kasuje wszystko (zdjęcia + zadania + szkic zlecenia)

---

## 10. RODO + dokumenty zgodności

W aplikacji w `/manager/options` → zakładka „Zgodność":

- **Umowa powierzenia danych (DPA)** — generowana automatycznie z danymi serwisu
- **Polityka prywatności** (gotowy szablon do dostosowania, opublikowana na `/polityka-prywatnosci`)
- **Polityka cookies** (`/polityka-cookies`) — zgodna z TTDSG
- **Procedura odpowiedzi na pytania klientów o ich dane (DSAR)** — gotowy schemat odpowiedzi
- **Procedura zgłaszania naruszeń** — krok po kroku, co robić przy wycieku danych
- **Rejestr czynności przetwarzania** — wymagany przez RODO art. 30
- **Lista podmiotów przetwarzających** — kto przetwarza dane (hosting, dostawca SMS, KSeF)

### Co program robi sam:
- Co noc sprawdza klientów, którzy nie kontaktowali się ponad 5 lat — anonimizuje ich dane
- Sprawdza, czy umowy z dostawcami nie wygasają (alarm 30 dni przed)
- Każda zmiana na zleceniu zostaje zapisana (kto, kiedy, co)
- Na publicznej stronie zgoda na cookies

---

## 11. Co siedzi pod spodem (informacja techniczna)

- **Po stronie serwera:** PHP 8.4 + Laravel
- **Po stronie przeglądarki:** Livewire 3 (większość renderowana po stronie serwera, mało JavaScriptu) + Alpine.js + Tailwind CSS 4
- **Baza danych:** MySQL
- **Aplikacja na telefonie:** strona webowa, którą można dodać do ekranu głównego i otwierać jak normalną aplikację (z plikami manifest + service worker)
- **Bezpieczeństwo:** Content-Security-Policy z dwiema warstwami
- **Build frontendu:** Vite 7
- **AI:** Anthropic Claude (pomoc przy KSeF w widoku zlecenia) + OpenAI (generator newslettera w Pro)
- **SMS-y:** HostedSms (polski dostawca)
- **KSeF:** w wersji obowiązującej od 2026

---

## 12. Kopie zapasowe i niezawodność

### Główny serwer (LH.pl):
- Kopia bazy danych co dzień o 03:17
- Kopia bazy w niedziele o 03:19 (cotygodniowa)
- Kopia zdjęć i danych co dzień o 03:21

### Kopia poza siedzibą (zewnętrzny serwer OVH):
- Pobieranie kopii z LH.pl przez bezpieczne połączenie SSH (klucz ograniczony tylko do odczytu)
- Trzymane: 7 ostatnich dziennych / 4 tygodniowe / 6 miesięcznych
- Pobiera codziennie o 04:30, w niedziele o 05:00, pierwszego dnia miesiąca o 06:00

### Lustra na komputerze właściciela:
- 2 lokalne dyski z bieżącą kopią

### Sprawdzanie odtworzenia kopii:
- Procedura przygotowana, zalecane uruchamianie raz na kwartał

### Sprawdzanie czy strona żyje:
- Wewnętrzne (po wgraniu zmian): odpalenie strony i sprawdzenie odpowiedzi
- Zewnętrzne (co 10 minut): osobny skrypt sprawdzający + log
- Automatyczne cofnięcie zmian, jeśli po wgraniu strona zwraca błąd

### Wgrywanie zmian:
- Lokalne `git push` → na serwerze nowa wersja → instalacja zależności → migracje bazy → odbudowa cache → restart kolejki → sprawdzenie odpowiedzi → cofnięcie zmian, jeśli błąd

---

## 13. Najczęstsze pytania

### Czy klient musi zakładać konto?
Nie. Klient dostaje SMS lub mail z linkiem i klika decyzję — bez zakładania konta, bez rejestracji.

### Czy działa na telefonie?
Tak. Otwierasz w przeglądarce telefonu, możesz dodać ikonę na ekran główny i otwierać jak normalną aplikację. Mechanik z telefonem ma pełną funkcjonalność.

### Ile to kosztuje?
- Standard: 139 zł netto/mies. lub 1299 zł netto/rok (rocznie taniej o 22%)
- Pro: 299 zł netto/mies. lub 2799 zł netto/rok (rocznie taniej o 22%)
- 14 dni za darmo, bez karty kredytowej
- Bez liczenia „za użytkownika" (Pro: dowolna liczba mechaników w cenie)

### Czy KSeF jest skomplikowany?
W BikeWorkshop nie. Otwierasz zlecenie → „Wystaw fakturę KSeF" → 3 kliknięcia → wysyłka, numer i UPO widoczne przy zleceniu. Program sam pobiera dane klienta i pozycje prac.

### Czy mogę zacząć od Standard i przejść na Pro?
Tak. Zmiana planu w panelu, dane zostają, naliczanie proporcjonalne. Naturalna ścieżka dla rosnącego serwisu (Standard → zatrudniam mechanika → Pro).

### Co, jeśli aplikacja padnie?
- Codzienne kopie bazy + kopia poza siedzibą (OVH) + 2 lokalne lustra (3 niezależne lokalizacje)
- Sprawdzanie z zewnątrz co 10 minut
- Automatyczne cofnięcie zmian, jeśli po wgraniu strona zwraca błąd

### Czy są statystyki rentowności?
Tak. Wartość zleceń niezamkniętych (pieniądze, które „leżą"), zarobek na pozycji, mapa najgorętszych dni tygodnia, alarm dla rowerów stojących ponad 7 dni jako „gotowe".

### Czy obsługuje wiele lokalizacji (sieć serwisów)?
Każdy punkt to dziś osobne konto. Wspólny przepływ między punktami uzgadniamy indywidualnie.

### Co z RODO?
Komplet dokumentów w panelu: umowa powierzenia, polityka prywatności, procedura DSAR, procedura zgłaszania naruszeń, rejestr czynności, lista podmiotów przetwarzających. Anonimizacja danych klientów po 5 latach od ostatniego kontaktu. Każda zmiana na zleceniu zostaje w historii.

### Czy obsługujecie e-bike?
Tak. Program nie pyta, jaki to typ sprzętu — przyjmujesz cokolwiek (rower, e-bike, hulajnoga elektryczna). Cennik z doborem po numerze seryjnym amortyzatora działa szczególnie dobrze dla MTB, gravel, e-bike.

### Czy jest interfejs do łączenia z innymi programami?
Obecnie nie ma publicznego interfejsu (REST API). KSeF jest w środku. Inne połączenia (księgowość, magazyn zewnętrzny) — uzgadniamy indywidualnie.

### Czy można drukować protokół wydania roweru?
Tak. Po odbiorze: okno z gwarancją (zapamiętywaną dla danego serwisu) + notatka. Drukowalny protokół A4 z miejscem na podpis klienta. Adnotacja prawna o gwarancji. Status zlecenia zmienia się na „odebrany", trafia do zakładki „Odebrane".

---

## 14. Typowe sytuacje, w których serwisy używają BikeWorkshop

### Sytuacja 1: Serwis MTB w szczycie sezonu (kwiecień-czerwiec)
**Profil:** 2-3 mechaników, 30-50 zleceń tygodniowo w sezonie, dużo amortyzatorów (RockShox, FOX, Marzocchi) i napędów. Klienci z całej Polski (turyści w Beskidach), komunikacja przez SMS i mail.

**Co potrzebne:** tablica „kto co robi", magazyn części z osobnymi uprawnieniami (mechanik nie widzi cen zakupu), dobór części po numerze seryjnym amortyzatora, zdjęcia zleceń (turyści zostawiają droższe rowery, większe ryzyko reklamacji), wycena linkiem (klient w Krakowie nie odbierze telefonu).

**Plan:** Pro. Plus newsletter sezonowy, żeby przed wiosną przypomnieć klientom o przeglądzie.

### Sytuacja 2: Jednoosobowy warsztat rowerów miejskich
**Profil:** 1 mechanik (właściciel), 5-10 zleceń tygodniowo, głównie wymiana łańcucha, klocków, regulacja przerzutek. Klienci sąsiedzi — komunikacja telefoniczna OK. KSeF kilka razy w miesiącu.

**Co potrzebne:** prosty formularz przyjęcia, kalendarz terminów, KSeF prosto ze zlecenia, SMS „rower gotowy". Bez magazynu, bez tablicy „kto co robi" (jest jedna osoba).

**Plan:** Standard. 139 zł netto/mies. albo 1299 zł rocznie (22% taniej) — koszt minimalny, funkcjonalność wystarczająca.

### Sytuacja 3: Sieć 3 punktów serwisowych
**Profil:** 3 lokalizacje, każda z właścicielem i 1-2 mechanikami. Wspólny magazyn lub osobny w każdym punkcie. Klient czasem odbiera w innym punkcie niż przywiózł.

**Co potrzebne (poza Pro):** osobne dane dla każdego punktu ALBO wspólna tablica zleceń (właściciel przerzuca zlecenia między punktami). Osobne uprawnienia dla różnych ról (właściciel-bez-cen-zakupu, mechanik widzi tylko swoje zlecenia).

**Stan obecny:** każdy punkt to osobne konto. Wspólny przepływ między punktami uzgadniamy indywidualnie.

---

## 15. Kontakt + autor

**E-mail:** kontakt@bikeworkshop.pl
**Telefon:** +48 889 009 420 (Pon-Pt 8:00-17:00)

**Strona główna:** https://app.bikeworkshop.pl/
**Cennik:** https://app.bikeworkshop.pl/cennik-aplikacji
**Demo (bez rejestracji):** https://app.bikeworkshop.pl/demo
**Blog:** https://app.bikeworkshop.pl/blog
**Załóż konto (14 dni za darmo):** https://app.bikeworkshop.pl/register
**Logowanie:** https://app.bikeworkshop.pl/login

### Autor

Arkadiusz Brańka — mechanik rowerowy z 16-letnim stażem (od 2010). Aplikację BikeWorkshop zbudował we własnym serwisie w Bielsku-Białej, pod Szyndzielnią. Cytat:

> „W serwisie pracuję od 2010 roku. Aplikację zacząłem pisać dla siebie — bo żaden gotowy program nie pasował do tego, jak realnie wygląda dzień w warsztacie pod Szyndzielnią. Pierwsza funkcja, jaką zrobiłem, to formularz przyjęcia, który sam zapisuje co kilka sekund. Bo właśnie tam ginęło najwięcej informacji — przerywało się przyjęcie, żeby odebrać telefon, klient wracał, dane przepisywało się ręcznie. Magazyn części dorzuciłem dopiero wtedy, gdy zatrudniłem drugiego mechanika i okazało się, że wieczorem nie wiem, co kto wziął z półki. Każda funkcja powstała z konkretnego problemu, który nas codziennie bolał."

---

*Ostatnia aktualizacja: 2026-05-02*