Propozycja: System „wozkownia"

1 · Streszczenie

Po spotkaniu discovery 2026-04-23 (2 godz., Agnieszka Potrykus-Serema, Artur Plichta, Piotr Tchórz) proponujemy zbudowanie systemu wozkownia — jednej platformy operacyjnej zastępującej obecny zestaw narzędzi (Excel, Outlook, Fakturownia, Google Drive, SALDEO).

Modułów MVP

Czas do MVP

14–16 tyg.

Stack INPI

Flask + HTMX

Hosting

OVH VPS Warsaw

Co rozwiązujemy

Czas spędzany dziś na ręcznym formatowaniu ofert (Word + zmiana czcionek), kopiowaniu danych z Excela, szukaniu informacji w mailach Outlook → szablony + 1 baza floty.
Ewidencja 20 wózków wynajmowanych — Excel przestaje wystarczać przy elastycznym wydawaniu (noce, weekendy) → kalendarz dostępności w jednym miejscu.
Rozbijanie faktur zakupowych (5 faktur per wózek) → kartoteka kosztów per nr seryjny + integracja OCR (SALDEO/własny).
Brak CRM — wiedza rozproszona w Outlookach ludzi → karta klienta z pełną historią (oferty, sprzedaże, serwis, wynajem, komentarze, źródło pozyskania).
Compliance UDT — papierowy dziennik konserwacji → automatyczna generacja PDF dziennika + alerty 30 dni przed przeglądem.
Brzydkie zdjęcia wózków używanych z Holandii → AI nakładka (usuwanie tła, „lakier jak nowy") — jak ujął Artur: „kupuje się oczami".
4 domeny z różnymi mailami → wspólna kolejka leadów z tagowaniem kanału, jedna spójna marka.

Czego nie robimy w MVP

Sklepu internetowego HD (Hangcha Heavy Duty) — Faza 2.
Portalu klienta Wozko (instrukcje + deklaracje UDT) — Faza 3.
Integracji z TVH (B2B częsci zamiennych) — long-term roadmap.
Własnej marki wózków (private-label z Chin) — biznesowo odrębne.

Decyzja klienta z 2026-04-23: werbalnie potwierdzono wejście w projekt. Zakres MVP — 6 modułów. Nazwa robocza systemu „wozkownia".

2 · Moduły MVP

1 · Flota wózków (CMDB)

Centralna baza każdej sztuki: nr wewnętrzny + nr seryjny + nr UDT.

Atrybuty katalogowe: producent, model, rok, napęd, udźwig, maszt (Duplex/Triplex), wysokość podnoszenia, długość widel, opony, bateria.
Atrybuty zmienne: status (dostępny / wynajęty / sprzedany / w serwisie / zarezerwowany), stan licznika, lokalizacja.
Auto-uzupełnianie z katalogu producenta (Toyota/Linde/Hangcha — ręcznie zaczytane karty).
Galeria zdjęć z AI nakładką (usuwanie tła, korekta światła, dodanie wzorcowego tła).
Sync ze stroną wozkow.pl — auto-publikacja oferty sprzedażowej z portalu.

Obecny pain: Excel z 50+ wierszami, ręczna aktualizacja CMS-a strony.

krytyczneSprint: 1–2 (4 tyg.)

2 · Ofertowanie

Generator ofert PDF z pojedynczego wózka lub zestawu, z brandingowymi szablonami per marka.

Karta wózka → przycisk „Generuj ofertę" → PDF z firmowym headerem + zdjęciami + specyfikacją.
Kontrola widoczności pól — co widzi klient vs co widzimy wewnętrznie (np. długość widel ukryta).
Szablony per marka (HANGCHA/HELI/HYUNDAI) — bez ręcznego formatowania.
Numeracja, status (draft/wysłana/zaakceptowana/przegrana), historia per klient.
Wysyłka z jednej domeny — spójna marka, niezależnie od kanału lead'a.
Powiązanie z CRM: oferta → klient → kartoteka aktywności.

Obecny pain: Word + ręczne kopiowanie + zmiana czcionek („zabiera czasu").

krytyczneSprint: 3–4 (4 tyg.)

3 · Zlecenia serwisowe (mobile-first)

Cyfrowy odpowiednik papierowej książki konserwacji + dispatch dla Przemka.

Formularz zgłoszenia (1:1 z PDF na wozkow.pl): nr UDT, nr seryjny, producent, model, rok, licznik, opis.
Mobile UI dla serwisanta — dodawanie wpisu na telefonie, skan tabliczki znamionowej (OCR / kod kreskowy).
Historia per nr seryjny — wszystkie naprawy, części, czasy.
Auto-generacja dziennika konserwacji UDT (PDF) — gotowy do druku dla klienta.
Alerty: 30 dni przed terminem przeglądu UDT (per wózek).
Umowy serwisowe abonamentowe — kalendarz konserwacji.

Obecny pain: mail na sprzedaz@wozkow.pl + papierowa książka u Przemka, brak centralnej historii.

krytyczneUDT complianceSprint: 4–6 (4 tyg.)

4 · CRM

Karta klienta z pełną historią + analityka źródeł leadów.

Baza firm i osób — minimum: NIP, kontakt, branża, status.
Aktywność per klient: oferty, sprzedaże, serwis, wynajem, komentarze („trudny klient", „VIP").
Źródło pozyskania — kanał (4 domeny + 5-ta serwisowa, polecenie, Izba Norda) → analityka konwersji per kanał.
Routing formularzy z 4 domen → wspólna kolejka z tagowaniem.
Weryfikacja firm przez Facebook (link, notatka) — bez auto-scrapingu.

Obecny pain: wiedza w Outlookach (Piotr/Artur/Agnieszka) + Excel + telefony — brak jednego miejsca.

ważneSprint: 5–6 (3 tyg.)

5 · Wynajem

Kalendarz dostępności + szybkie umowy wynajmu krótko/długoterminowego.

20 wózków aktywnych w wynajmie — kalendarz Gantta z statusem dostępności.
Szybki podgląd stanu wózka (osprzęt, opony, widły) z karty CMDB.
Wydawanie elastyczne: noce, soboty, niedziele — UI uproszczone do mobilnego.
Umowy wynajmu (krótko / długoterm) — szablony PDF.
Fakturowanie cykliczne — integracja z modułem 6.

Obecny pain: „przy 20 wózkach jest ciężko, Excel to zbiera".

ważneSprint: 6–7 (3 tyg.)

6 · Faktury i kartoteka kosztów

Kartoteka per wózek (zakup + doposażenie) + integracja KSeF.

Kartoteka per nr seryjny — wszystkie faktury (5 typowo per wózek: zakup, doposażenie, części, serwis).
Historia kosztów inwestycyjnych — ile zainwestowano vs cena ofertowa = marża.
Integracja KSeF (obowiązek od 2026-02): wybór architektury — własny moduł vs Fakturownia API (decyzja po prototypie, ADR-001).
OCR faktur zakupowych: integracja SALDEO API albo własny (Tesseract / Anthropic Vision).
Rozbijanie 1 faktury na N wózków (proporcje kosztów).

Obecny pain: SALDEO + Fakturownia + Excel — Fakturownia „wywala się na KSeF, za dużo danych".

krytyczneKSeF 2026-02Sprint: 7–8 (4 tyg.)

3 · Stack techniczny

Warstwa	Technologia	Uzasadnienie
Backend	Flask + PostgreSQL 16	Standard INPI (InPIpedia, projekty.inpi.pl, NordaBiznesPl). Stabilny, sprawdzony, łatwy do utrzymania.
Frontend	HTMX 2 + Tailwind CSS	Szybki rozwój, brak SPA-overhead, doskonałe UX bez ciężkiego JS-frameworka. Gotowe komponenty z `frontend-design`.
Mobile (serwisant)	PWA	Offline-capable, instalacja jako ikonka — bez App Store. Native app w fazie 2 jeśli potrzeba.
Auth	Local + magic link	Email + hasło + opcjonalnie TOTP. Bez Keycloak (overkill dla 5–10 userów).
Hosting	OVH VPS Warsaw	Niski ping z Wejherowa. RODO-compliant (EU). Skalowanie wertikalne.
Repo / CI	Gitea on-prem (`git.inpi.pl/INPI/WozkowSystem`)	Standard INPI. Webhook → auto-deploy.
Storage zdjęć/PDF	S3 OVH (cheap object storage)	Skalowalne, tanie, niezależne od serwera aplikacji.
OCR / AI nakładka zdjęć	Photoroom API albo Anthropic Claude Vision	Decyzja po prototypie ADR-005.

Integracje

KSeF (obowiązek 2026-02)	Własny moduł lub Fakturownia API — wybór po prototypie
SALDEO	API (jeśli dostępne) lub zastąpienie własnym OCR
wozkow.pl (CMS strony)	API auto-publikacji floty sprzedażowej
UDT	Eksport list do zgłaszania przeglądów (1× / 1–2 lata)
Outlook (desktop, NIE M365)	Łączenie wątków mailowych z kartą klienta przez forwarding na dedykowany adres
Allegro (zakup części)	BLIK-pay → przypisanie kosztów do wielu wózków

4 · Timeline (orientacyjny)

Faza	Tydz. 1–2	3–4	5–6	7–8	9–10	11–12	13–14	15–16
Setup (repo, VM, CI)
PRD v1 + makiety
Sprint 1 — Flota
Sprint 2 — Flota cz.2 + zdjęcia AI
Sprint 3 — Ofertowanie
Sprint 4 — Serwis (mobile + UDT)
Sprint 5 — CRM
Sprint 6 — Wynajem
Sprint 7 — Faktury + KSeF

Co 2 tygodnie: spotkanie review (online lub Wejherowska 87) — demo, feedback, korekta priorytetów. Każdy sprint kończy się działającą funkcją na środowisku staging (`staging.wozkownia.pl`).

Dlaczego 14–16 tygodni: 6 modułów × 2–3 tyg. wykonawstwa + bufor 2 tyg. na integracje (KSeF, SALDEO, OCR). Tempo dostosowane do równoległej obsługi przez 1 dewelopera (Maciej) + 0.5 backendu (juniorzy). Możliwe przyspieszenie do 12 tyg. przy 2 deweloperach pełnoetatowo.

5 · Wycena (widełki)

Model: fixed price per moduł (po PRD v1 — uściślimy do +/–10%). Płatności milestone'owe — po każdym sprincie zatwierdzonym przez Wozko.

Moduł	Widełki PLN netto	Sprintów
Setup + PRD v1 (repo, VM, makiety, dokumentacja)	8 000 – 12 000	0.5
1 · Flota wózków (CMDB + atrybuty + galeria z AI)	25 000 – 35 000	2
2 · Ofertowanie (generator PDF + szablony per marka)	18 000 – 25 000	2
3 · Zlecenia serwisowe (mobile + UDT compliance + alerty)	22 000 – 30 000	2
4 · CRM (karta klienta + źródła leadów + routing)	15 000 – 22 000	1.5
5 · Wynajem (kalendarz + umowy)	12 000 – 18 000	1.5
6 · Faktury i kartoteka kosztów (KSeF lub Fakturownia + OCR)	25 000 – 38 000	2
Razem MVP — wykonanie
Total widełki MVP	125 000 – 180 000 PLN netto	11.5 sp.

Utrzymanie (po MVP)

SLA Bronze — bugfixy + uptime 99% + backup PBS	800 – 1 200 PLN/mc
SLA Silver — Bronze + 8h reakcji + nowe funkcje 4h/mc	2 500 – 3 500 PLN/mc
SLA Gold — Silver + 4h reakcji + 16h/mc rozwoju + dedykowany dev	6 000 – 8 000 PLN/mc

Co nie jest wliczone: hosting OVH (~150–250 PLN/mc), abonament SALDEO (jeśli zostaje), licencje S3 storage (~50 PLN/mc), abonament Fakturownia (jeśli zostaje, ~170 PLN/mc). Razem: ok. 400–600 PLN/mc kosztów infrastrukturalnych.

Płatności milestone'owe

10% przy podpisaniu umowy + start setup (zaliczka).
15% po PRD v1 (zaakceptowanym przez Wozko).
10% × 6 modułów — po zatwierdzeniu każdego sprintu.
15% po finalnym UAT (User Acceptance Test) i go-live.

6 · Następne kroki

Kolejne spotkanie: ustalmy termin do 2026-04-30. Online lub Wejherowska 87. Pokażemy mockup karty wózka (HTML + interakcje), uściślimy zakres MVP, omówimy budżet i timing.

NDA (Non-Disclosure Agreement): przed wymianą detali technicznych (struktura kosztów, dane klientów). Przygotujemy wzór INPI — podpis Artur lub Piotr (zgodnie z reprezentacją KRS).

Materiały do wglądu: 3 przykładowe oferty obecne (najlepsza/średnia/słabsza), screenshot dashboardu Fakturowni, scan papierowej karty serwisowej. Zgoda Agnieszki uzyskana 2026-04-23.

Decyzje do uściślenia (ADR-y):

Moduł fakturowy: Fakturownia API vs własny KSeF
OCR faktur: SALDEO API vs własny (Tesseract/Vision)
AI nakładka zdjęć: Photoroom vs Pebblely vs Anthropic Vision
Podpis cyfrowy protokołów: tablet vs SMS OTP vs DocuSign
Hosting: dedykowany OVH VPS vs współdzielony INPI

7 · Już dziś dostępne dla Wozko

Niezależnie od decyzji o systemie „wozkownia", zapraszamy do portalu projekty.inpi.pl/client/wozkow — Wasz workspace z dossier firmy. Loginy do 3 osób (Agnieszka, Artur, Piotr) wygenerowaliśmy.

Pełne dane KRS / NIP / REGON / wpisy / kapitał
Wyniki finansowe 2021–2023 + statusy sprawozdań 2020 i 2024
Status 4 domen (HTTP, SSL, response time)
Notatki z discovery + analiza strony wozkow.pl
Czat (live HTMX) + galeria + dokumenty (KRS odpis JSON)

Kontakt INPI:
Maciej Pienczyn · maciej.pienczyn@inpi.pl
ul. Rogali 11, 84-200 Wejherowo · INPI sp. z o.o.
NIP: 5882465814 · członek Izby Norda

Maciej Pienczyn
INPI sp. z o.o.
data, podpis

Artur Plichta / Piotr Tchórz
Sprzedaż Wózków Sp. z o.o.
data, podpis

Dokument w wersji draft — do weryfikacji i akceptacji. Wszystkie wartości orientacyjne.
Wygenerowano: 2026-04-25 · INPI Projekty · projekty.inpi.pl