Przejdź do treści
Porozmawiajmy

Realizacja

Suplementy diety · produkcja kontraktowa

humavit.pl (otwiera się w nowej karcie)

System produkcji suplementów — od receptury do faktury

Humavit to rodzinny producent z Mikołowa, na rynku od 1988 roku. Dziś robi suplementy diety, kapsułki i tabletki, pod markami klientów i pod własną marką. Wycena zlecenia, zamówienia surowców, etapy produkcji i faktury nie były w jednym miejscu, a marży na poszczególnych częściach oferty nie było widać przed wysłaniem. Zbudowałem system produkcji suplementów, który liczy recepturę i marżę, prowadzi zamówienia surowców i 8 etapów produkcji, a faktury pobiera z KSeF i odczytuje z PDF-ów.

Tekst i kod: Rafał Szewcinżynier oprogramowania, RS Mobile

Branża
Suplementy diety
produkcja kontraktowa i marka własna
Zakres
System produkcji suplementów
panel wewnętrzny, Panel Kontrahenta, Panel Dostawcy, konfigurator
Technologia
Java, Spring Boot, Angular
MySQL, Docker, KSeF, OpenAI
Okres prac
styczeń–październik 2026
9 miesięcy, jeden inżynier
Status
Wdrożony, rozwijany
działa w chmurze AWS

Wcześniej

Jak wyglądała praca przed systemem?

Zlecenie produkcji kontraktowej zaczyna się od receptury, a kończy na serii i fakturze. Po drodze sporo liczb trzeba było przenosić ręcznie.

Łańcuch obliczeń przy jednej wycenie

  1. mg w kapsułce
  2. standaryzacja
  3. % zasypu
  4. kg na partię
  5. MOQ
  6. pozostanie
  7. wydatek realny
  8. cena dla klienta
  9. usługi
  10. opakowania
  11. przedpłaty
  12. oferta

  • Wycena

    Każdą substancję trzeba było przeliczyć z miligramów w kapsułce na kilogramy na partię, z MOQ i nadwyżką. Wynik trafiał ręcznie do oferty.

  • Zamówienia

    Surowce i opakowania zamawia się u wielu dostawców, także w EUR i USD. Trzeba było pilnować, co już dojechało, zanim ruszy mieszanie.

  • Zmiany

    Zmiany po akceptacji oferty, takie jak inne MOQ, inny dostawca czy inna ilość, nie miały jednego miejsca ani historii.

  • Faktury

    Kilkadziesiąt PDF-ów w różnych układach trzeba było wprowadzić i rozdzielić na sprzedażowe i zakupowe. Do tego doszedł obowiązek KSeF.

Wymaganie, na które odpowiadają Kalkulacje:

Przy każdej ofercie widzieć, ile firma zarabia na substancjach aktywnych, surowcach, usługach i pozostałych kosztach.

Z listy wymagań do systemu, w skrócie

Pierwsza wersja systemu odwzorowywała płaską kartę oferty z ok. 56 kolumnami, z polami takimi jak „Wydatek realny” czy „Pozostanie”.

Rozwiązanie

Co robi system produkcji suplementów?

W praktyce każde zlecenie idzie tą samą drogą: z oferty powstaje zamówienie surowców, z zamówienia produkcja, a faktury zakupowe system zestawia z zamówieniami. Niżej opisuję sześć głównych modułów, które zbudowałem.

Zakładka: Oferty

Oferta liczona od receptury

Kalkulator bierze substancje z katalogu surowców i liczy zawartość składników aktywnych z uwzględnieniem standaryzacji, procent zasypu kapsułki i sumę w dziennej dawce. Następnie zamienia miligramy na kilogramy na całą partię i dolicza MOQ, pozostanie i wydatek realny. Gotową ofertę generuje jako PDF w sześciu językach.

Cytrynian magnezu na całą partię

5 000 opakowań×60 kapsułek=300 000 kapsułek

300 mg×300 000÷1 000 000=90 kg

MOQ u dostawcy
100 kg
Pozostanie
10 kg
Wydatek realny
MOQ × cena zakupu
  • PL
  • EN
  • DE
  • ES
  • FR
  • IT

Tak liczy kod; wartości z receptury przykładowej powyżej, dane fikcyjne

Zakładka: Oferty → Kalkulacje

Marża widoczna, zanim oferta wyjdzie do klienta

To odpowiedź na to wymaganie. Dla każdej oferty system liczy przychód, koszt własny, zysk, marżę i narzut, osobno dla surowców, kapsułki, opakowań, dodatków i usług. W koszcie jest też nadwyżka MOQ, za którą płaci się dostawcy. Stawki usług mają daty obowiązywania. Dzięki temu podwyżka kosztów nie zmienia starych ofert. Kalkulacja zostaje w panelu firmy: nie trafia do PDF, e-maila ani panelu klienta.

Kalkulacja oferty OF/2026/231: przychód, koszt własny, zysk, marża i struktura zysku w sekcjach. Zrzut z aplikacji, dane fikcyjne. (otwórz w pełnym rozmiarze)
Kalkulacja oferty — koszt własny, zysk i struktura marżyZrzut z aplikacji, dane fikcyjne

Zakładka: Zamówienia

Zamówienia surowców z kontrolą dostaw

Zaakceptowana oferta jednym przyciskiem zamienia się w zamówienie surowców i opakowań. Każda pozycja ma swój status, a PDF zamówienia powstaje osobno dla każdego dostawcy. Przycisk „Przejdź do produkcji” pojawia się dopiero wtedy, gdy dotarły wszystkie surowce.

  • Niezamówione
  • Zamówione
  • Potwierdzona dostawa - oczekuje
  • Dostarczone
Lista zamówień surowców ze statusem każdej pozycji: niezamówione, zamówione, potwierdzona dostawa, dostarczone. Zrzut z aplikacji, dane fikcyjne. (otwórz w pełnym rozmiarze)
Zamówienia surowców — status każdego surowca i opakowaniaZrzut z aplikacji, dane fikcyjne

Zakładka: Produkcja

Produkcja w 8 etapach, po kolei

Karta zlecenia zbiera recepturę, liczbę kapsułek, zużycie surowców z MOQ i opakowania, bez cen. Etapy odhacza się po kolei, bez przeskakiwania, a na koniec wpisuje się datę i serię produkcji. Lista etapów jest wspólna dla kapsułek i tabletek, więc przy zleceniu na kapsułki etap „Tabletkowanie” zaznacza się bez pracy. Status oferty zmienia się przy tym sam: najpierw na „W produkcji”, a po zakończeniu na „Wyprodukowano”.

Karta zlecenia produkcyjnego przewinięta do zużycia surowców: receptura, ilości, MOQ z korektą i etapy produkcji. Zrzut z aplikacji, dane fikcyjne. (otwórz w pełnym rozmiarze)
Karta zlecenia produkcyjnego: zużycie surowców z korektą MOQ i etapy (Produkcja → Szczegóły produkcji)Zrzut z aplikacji, dane fikcyjne

Status produkcji · zlecenie OF/2026/231, dane fikcyjne

  • gotowe
  • następny
  • czeka
  1. 01 · gotoweSurowce zamówione
  2. 02 · gotoweOpakowania zamówione
  3. 03 · gotoweMieszanie
  4. 04 · następnyKapsułkowanie
  5. 05 · czekaTabletkowanie
  6. 06 · czekaLiczenie
  7. 07 · czekaEtykietowanie
  8. 08 · czekaZlecenie zakończone

Etapy są wspólne dla kapsułek i tabletek; przy kapsułkach etap 05 zaznacza się bez pracy.

Zakładki: Zamówienia → Korekty, Produkcja → Korekty

Korekty zamiast nadpisywania

Zmiana po fakcie nie nadpisuje dokumentu. System wystawia numerowaną korektę, KOR/ZAM dla zamówień albo KOR/PR dla produkcji, ze stanem przed i po oraz powodem, na przykład zmianą MOQ. Najnowszą korektę można poprawić albo cofnąć.

KOR/PR/2026/012 Zmiana MOQ · Ewa Nowicka
Korekta produkcji OF/2026/231
PozycjaByłoJest
L-teanina — MOQ25,00 kg30,00 kg
L-teanina — pozostanie10,00 kg15,00 kg

Korekta z karty zlecenia powyżej, dane fikcyjne

Zakładka: Faktury

Faktury z KSeF i z PDF-ów bez przepisywania

Faktury z KSeF pobierają się same co 2 godziny. Paczkę kilkudziesięciu PDF-ów, do 100 w jednym imporcie, wystarczy przeciągnąć do okna importu. Dane z plików odczytuje model OpenAI przez API. Odpowiedzi nie są zapisywane do późniejszego odczytu, a dane z API nie służą do trenowania modeli; OpenAI może je przechowywać do 30 dni na potrzeby kontroli nadużyć. Na tym rola AI się kończy: kod rozstrzyga po NIP, czy to sprzedaż, czy zakup, uzgadnia sumy i odsiewa duplikaty oraz proformy. Wątpliwe faktury czekają na człowieka w „Wymaga poprawy”.

  • Zaimportowano
  • Wymaga poprawy
  • Duplikat
  • Odrzucono

Osoba od faktur zakupowych ma osobną rolę i widzi tylko swoje zakładki.

Import faktur PDF z AI: wyniki odczytu z podziałem na sprzedażowe i zakupowe, duplikat, proforma i faktury do poprawy. Zrzut z aplikacji, dane fikcyjne. (otwórz w pełnym rozmiarze)
Import faktur PDF z AI — kilkadziesiąt plików naraz, podział na sprzedażowe i zakupoweZrzut z aplikacji, dane fikcyjne

Zakładka: Statystyki

Zamówienia surowców zestawiają się z fakturami zakupowymi z KSeF po NIP dostawcy („Zamówione vs zafakturowane”), więc widać różnice między zamówieniem a fakturą.

Architektura

Jak to działa i co stoi w chmurze?

To jeden system z czterema wejściami. Adres decyduje, który panel się otworzy, a uprawnienia o tym, co widzi konkretna osoba.

  • Panel wewnętrzny

    adres niepubliczny

    Biuro, zakupy i produkcja. Uprawnienia nadaje się osobno do każdej zakładki.

  • Panel Kontrahenta

    logowanie kontem klienta

    Klient akceptuje ofertę i klika „Zleć produkcję”. Nie widzi cen zakupu, dostawców ani notatek wewnętrznych.

  • Panel Dostawcy

    logowanie kontem dostawcy

    Dostawca wpisuje surowce, MOQ, ceny w PLN, EUR lub USD i certyfikaty. Pozycje czekają na akceptację.

  • Konfigurator

    otwórz konfigurator produkcja.humavit.pl (otwiera się w nowej karcie)

    Siedem kroków od nazwy i składu produktu do zapytania, bez cen. Z zapytania jednym kliknięciem powstaje oferta.

Jeden serwer aplikacji i jedna baza danych

Kwoty liczy serwer, tym samym kodem dla podglądu i zapisu, więc podgląd oferty i zapisany dokument się nie rozjeżdżają.

Co gdzie działa
ChmuraSystem działa w chmurze AWS we Frankfurcie, nie na serwerze w zakładzie. Kopie bazy i załączników trafiają do S3 co 2 godziny.
Usługi zewnętrzneKSeF (otwiera się w nowej karcie) (faktury co 2 godziny), NBP (kursy walut), GUS (dane firm po NIP) i sklep WooCommerce (produkty co godzinę).
OpenAIOdczyt faktur i cenników z PDF, tłumaczenie oferty i oferta z opisu produktu. Przy fakturach i cennikach model tylko odczytuje dane, a o zapisie decyduje kod albo człowiek. Moduł Social media korzysta też z OpenAI i Perplexity przy treściach postów.
Wariant lokalnyTen sam system można uruchomić na własnym serwerze (np. NAS z Dockerem) zamiast w chmurze AWS; wtedy wszystkie części działają pod jednym adresem.
Testy automatyczne 228 plików dla serwera 106 dla interfejsu ok. 60 scenariuszy w przeglądarce na pełnym systemie

Przebieg

W jakiej kolejności powstawały moduły?

System powstawał etapami: najpierw rdzeń, potem portale dla klientów i dostawców, sprzedaż, a na końcu faktury i korekty. Daty pochodzą z historii zmian w kodzie.

  1. Styczeń–marzec1/4

    Rdzeń

    • prototyp: oferty, zamówienia, produkcja
    • serwer i baza danych
    • zamówienia i produkcja powiązane z ofertą
    • kapsułka i tabletka w kalkulatorze
    • przygotowanie wdrożenia w AWS
  2. Kwiecień–maj2/4

    Portale

    • kopie zapasowe do S3
    • Panel Kontrahenta z akceptacją ofert
    • statusy ofert sprzężone z produkcją
    • Panel Dostawcy i surowce online
  3. Czerwiec–lipiec3/4

    Sprzedaż i konfigurator

    • użytkownicy i role
    • handel: potencjalni klienci i historia kontaktów
    • oferty handlowe, produkty z WooCommerce, statystyki
    • publiczny konfigurator produkcji kontraktowej
  4. Sierpień–październik4/4

    Faktury i korekty

    • faktury z KSeF
    • korekty zamówień i produkcji
    • import faktur PDF z AI, kalkulacje marży
    • ostatnia zmiana w kodzie

9 miesięcy · jeden inżynier

Efekty

Co się zmieniło w biurze i na hali?

Wypisuję tylko to, co wynika wprost z działania systemu.

  • Marżę każdej oferty widać przed wysyłką: w sekcjach, na opakowanie i na kapsułkę.
  • Braki surowców i opakowań widać w jednym widoku, a do produkcji przechodzi się dopiero, gdy dotarły wszystkie surowce.
  • Zmiany w zamówieniu i produkcji po fakcie zostają w historii jako korekty z datą i autorem.
  • Faktur nie trzeba przepisywać: te z KSeF pobierają się same, PDF-y czyta AI pod kontrolą kodu, a człowiek poprawia tylko wątpliwe.
  • Zamówienia surowców można porównać z fakturami zakupowymi z KSeF, dostawca po dostawcy.
  • Klient akceptuje ofertę w swoim panelu, a dostawca sam aktualizuje surowce i ceny.

FAQ

Pytania o system produkcji suplementów

Ile kosztuje taki system?

Dedykowany system na danych firmy kosztuje zwykle 40–120 tys. zł netto i powstaje w 2–3 miesiące. Ten system jest większy: rdzeń, czyli oferty, zamówienia surowców i produkcja, powstał w ok. 10 tygodni, a portale, sprzedaż, faktury i korekty dobudowywałem przez kolejne pół roku. Na start proponuję test na Twoich danych za 10–25 tys. zł, a utrzymanie to 1–2 tys. zł miesięcznie. Szczegóły rozpisałem we wpisie o kosztach wdrożenia AI w firmie produkcyjnej.

Jak długo trwa wdrożenie?

W tym projekcie oferty, zamówienia surowców i produkcję zbudowałem w pierwszym kwartale 2026 roku. Kolejne moduły dochodziły co kilka tygodni, aż do października. W praktyce zaczynam od testu na Twoich danych, który trwa 2–4 tygodnie, a potem wdrażam etapami.

Gdzie są nasze dane i co widzi AI?

Dane leżą w bazie na serwerze AWS we Frankfurcie, a kopie co 2 godziny trafiają do S3. Do OpenAI trafia tylko to, co użytkownik sam przekaże modelowi, na przykład faktura PDF. Przy fakturach odpowiedzi modelu nie są zapisywane do późniejszego odczytu, a dane z API nie służą do trenowania modeli (OpenAI może je trzymać do 30 dni na potrzeby kontroli nadużyć). Portale dostają tylko wybrane pola: klient nie zobaczy cen zakupu, dostawców ani marż.

Czy system połączy się z tym, czego już używamy?

Tak, jeśli Twój system ma API albo pozwala wyeksportować dane. W tym projekcie system pobiera faktury z KSeF, kursy z NBP, dane firm z GUS i produkty ze sklepu WooCommerce. W ten sam sposób podłączam Comarch ERP, SAP czy IFS: ERP zostaje na swoim miejscu, a nowe narzędzie korzysta z jego danych. Od czego zacząć, opisałem w planie wdrożenia AI w firmie produkcyjnej.

Co, jeśli zabraknie jedynego programisty?

System ma prawie 400 plików testów automatycznych: dla serwera, dla interfejsu i pełne scenariusze w przeglądarce. Uruchamia się z obrazów Docker, w chmurze AWS albo na własnym serwerze. Stos jest popularny (Java, Spring Boot, Angular), więc kod może przejąć inny zespół. Prawa do kodu, dostęp do repozytorium i zasady przekazania ustalamy w umowie przed rozpoczęciem prac.

Pokaż mi jedno zlecenie od zapytania do faktury

Wystarczy oferta, zamówienie do dostawcy i karta produkcji, nawet z arkusza. Na tej podstawie proponuję test na Twoich danych: 2–4 tygodnie, 10–25 tys. zł netto.

Zadzwoń: +48 517 297 217

Wolisz zostawić numer? Porozmawiajmy

Rafał Szewc

Rafał Szewc

Inżynier oprogramowania, 12+ lat, wcześniej SAP. Rozmawiasz wprost z osobą, która pisze kod.

O mnie
WhatsApp