PFPrintFlow
Portal
DOKUMENTACJA PROJEKTU

CASE STUDY · PWA · PYTHON · QA

Jak powstał PrintFlow Portal

Autorski projekt portfolio łączący stronę prezentacyjną, portal klienta, panel działów oraz demonstracyjną aplikację wspierającą obsługę zleceń.

1. PROBLEM I ROZWIĄZANIE

Jedno źródło statusu dla klienta i zespołu.

Klient potrzebuje krótkiej, zrozumiałej odpowiedzi: na jakim etapie jest zlecenie, kiedy będzie gotowe i jak zostanie dostarczone. Zespół potrzebuje kolejki pracy, właściciela etapu oraz sygnałów o zaliczce, terminie i akceptacji.

Portal pokazuje oba punkty widzenia bez mieszania informacji. Strefa klienta ogranicza się do jednego zlecenia. Panel działów grupuje zlecenia według aktualnego etapu i odpowiedzialnego zespołu.

2. FUNKCJE WERSJI DEMONSTRACYJNEJ

Portal klientaWyszukiwanie syntetycznego kodu zlecenia, status, etap, planowany termin, zaliczka i sposób dostawy.
12 perspektyw dostępuKlient oraz 11 ról wewnętrznych: handel, finanse, DTP, produkcja, introligatornia, jakość, magazyn, logistyka, kadry, flota i właściciel. Publiczny przełącznik demonstruje logikę, nie zastępuje logowania.
Android i AppleInstalowalna PWA uruchamiana z ikony na Androidzie, iPhonie i iPadzie, bez Google Play i App Store.
Tryb offlineService worker przechowuje pliki aplikacji po pierwszym otwarciu, aby interfejs był dostępny również bez połączenia.

3. MODEL PROCESU

Od zapytania do zamknięcia zlecenia.

ZapytanieOfertaZaliczkaAkceptacja plikówProdukcjaWykończenieJakośćLogistykaFakturaZamknięcie

Etapy są przykładem modelu operacyjnego. W rzeczywistym wdrożeniu można je dostosować do technologii druku, typu produktu, kanału dostawy i struktury organizacji.

4. TECHNOLOGIE

WarstwaZastosowanieDlaczego
HTML i CSSSemantyczna struktura i responsywny interfejsProsty, szybki i czytelny front-end bez ciężkiego frameworka.
JavaScriptStatusy, widoki ról, filtrowanie i lokalne zmiany demoInterakcja po stronie przeglądarki bez wysyłania danych demonstracyjnych na serwer.
PWAManifest, ikona, tryb standalone i service workerInstalacja na Androidzie, iPhonie i iPadzie oraz dostęp offline po pierwszym otwarciu.
PythonLogika PrintFlow Control Center i API demonstracyjnegoStandardowa biblioteka, prosty serwer HTTP, walidacja oraz obliczenia.
SQLite / SQLModel zleceń i historia zmian statusówLekka relacyjna baza danych odpowiednia do prototypu i pracy lokalnej.
JSONKonfiguracja etapów, ról, produktów i transportuCzytelne dane konfiguracyjne oraz prosty eksport demonstracyjny.
Git i GitHub PagesWersjonowanie i publiczna publikacjaHistoria zmian, przegląd kodu i statyczny hosting bez utrzymywania własnego serwera.

5. KONTROLA JAKOŚCI

Projekt PrintFlow Control Center zawiera 20 automatycznych testów Python, 16 przypadków testowych, macierz śledzenia wymagań, checklisty smoke i regresji, raporty defektów oraz bramki GO/NO-GO.

Testy obejmują logikę procesu, API, SQLite, role, alerty, eksport i walidację danych demonstracyjnych. Kontrola automatyczna jest uruchamiana przez GitHub Actions.

Otwórz dokumentację QA na GitHubie ↗

6. INSTALACJA NA TELEFONIE

Bez sklepu z aplikacjami.

Android

  1. Otwórz PrintFlow Portal w Chrome.
  2. Wybierz menu .
  3. Wybierz „Zainstaluj aplikację” lub „Dodaj do ekranu głównego”.
  4. Uruchamiaj ją z ikony PrintFlow Portal.

iPhone i iPad

  1. Otwórz PrintFlow Portal w Safari.
  2. Wybierz przycisk „Udostępnij”.
  3. Wybierz „Do ekranu początkowego”.
  4. Potwierdź „Dodaj” i uruchamiaj z ikony.

To PWA, a nie plik APK lub aplikacja ze sklepu. Natywna aplikacja i publikacja w Google Play lub App Store są potrzebne dopiero przy wymaganiach takich jak powiadomienia push, aparat, skanowanie QR albo bardziej rozbudowana praca offline.

7. BEZPIECZEŃSTWO I ZAKRES

Wersja publiczna jest demonstracją portfolio. Korzysta wyłącznie z danych syntetycznych, nie tworzy kont, nie przetwarza płatności i nie pobiera danych osobowych. Zmiany w panelu zapisują się tylko lokalnie w przeglądarce użytkownika.

Wersja produkcyjna dla prawdziwych klientów wymagałaby bezpiecznego backendu, HTTPS, logowania, uprawnień, bazy danych, kopii zapasowych, monitoringu, historii dostępu i zgodności z RODO.