Files

Jacek Pyziak f8db8c0162 refactor(01-tech-debt): extract AllegroTokenManager and StringHelper

Phase 1 complete (2/2 plans):

- Plan 01-01: Extract AllegroTokenManager — OAuth token logic
  centralized from 4 classes into dedicated manager class

- Plan 01-02: Extract StringHelper — nullableString/normalizeDateTime/
  normalizeColorHex extracted from 15+ classes into App\Core\Support\StringHelper;
  removed 19 duplicate private methods

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-03-12 23:36:06 +01:00

3.4 KiB

Raw Blame History

orderPRO

What This Is

Aplikacja do zarządzania zamówieniami pobieranymi z wielu źródeł sprzedaży (Allegro, Erli, własne sklepy internetowe). Umożliwia generowanie etykiet przewozowych u kurierów oraz docelowo zarządzanie produktami i stanami magazynowymi w jednym miejscu.

Core Value

Sprzedawca może obsługiwać zamówienia ze wszystkich kanałów sprzedaży i nadawać przesyłki bez przełączania się między platformami.

Current State

Attribute	Value
Version	0.1.0
Status	In Progress
Last Updated	2026-03-12

Requirements

Validated (Shipped)

Integracja z Allegro — pobieranie zamówień
Generowanie etykiet (InPost)

Active (In Progress)

[Do zdefiniowania podczas planowania]

Planned (Next)

Zarządzanie produktami
Zarządzanie stanami magazynowymi

Out of Scope

[Do zdefiniowania podczas planowania]

Target Users

Primary: Sprzedawcy wielokanałowi (Allegro, Erli, własny sklep)

Obsługują zamówienia z wielu platform jednocześnie
Potrzebują szybkiego nadawania przesyłek
Chcą jednego miejsca do zarządzania sprzedażą

Context

Business Context: Rynek narzędzi do zarządzania sprzedażą wielokanałową (podobne rozwiązania: base.com, apilo.com). Aplikacja budowana jako własne rozwiązanie.

Technical Context: PHP (XAMPP/Laravel), integracje z API marketplace'ów (Allegro, Erli) oraz API przewoźników (InPost i inne).

Constraints

Technical Constraints

PHP/XAMPP — środowisko Windows lokalne
Medoo + prepared statements (bez sklejania SQL)
Brak natywnych alert()/confirm() — używać window.OrderProAlerts
Metody pomocnicze string/date/color → App\Core\Support\StringHelper (nie powielać w klasach)
Zarządzanie tokenami OAuth Allegro → App\Modules\Settings\AllegroTokenManager

Business Constraints

[Do zdefiniowania podczas planowania]

Key Decisions

Decision	Rationale	Date	Status
Własne rozwiązanie zamiast gotowego SaaS	Pełna kontrola nad funkcjonalnością	2026-03-12	Active
AllegroTokenManager wydzielony z 4 klas OAuth	Eliminacja duplikacji logiki odświeżania tokenów	2026-03-12	Active
StringHelper jako final static class w Core/Support	Centralizacja 19 kopii helperów string/date/color z 15+ klas	2026-03-12	Active

Success Metrics

Metric	Target	Current	Status
Liczba zintegrowanych źródeł zamówień	≥3	2 (Allegro, Erli)	In progress
Generowanie etykiet	Działa	InPost	In progress

Tech Stack

Layer	Technology	Notes
Framework	PHP (custom/Laravel)	XAMPP lokalnie
Frontend	HTML/CSS/JS + SCSS	jQuery Alerts module
Database	MySQL (Medoo)	Prepared statements
Auth	Sesje PHP
Integracje	Allegro API, Erli API	Przewoźnicy: InPost

Specialized Flows

See: .paul/SPECIAL-FLOWS.md

Quick Reference:

/feature-dev → Nowe funkcjonalności i integracje (required)
/code-review → Przegląd kodu przed UNIFY (required)
/frontend-design → Komponenty UI i widoki (optional)
/simplify → Refaktoryzacja po implementacji (optional)

PROJECT.md — Updated when requirements or context change Last updated: 2026-03-12 after Phase 1 (Tech Debt)

3.4 KiB Raw Blame History