feat: Add User-Agent header to Allegro API requests

- Implemented buildUserAgent() method in AllegroApiClient, AllegroOAuthClient, and AllegroTrackingService to include User-Agent header in all HTTP requests to Allegro API.
- Updated .env.example to include APP_VERSION and ALLEGRO_USER_AGENT_URL for configuration.
- Created public /info page to provide application details required by Allegro, including app name, version, description, and contact information.
- Added minimalist layout for public pages to ensure a professional appearance.
- Ensured all changes comply with Allegro's API requirements for User-Agent header.
This commit is contained in:
2026-04-08 20:59:55 +02:00
parent 0f7742f10d
commit c5b2885b44
21 changed files with 827 additions and 22 deletions

View File

@@ -0,0 +1,113 @@
---
phase: 89-allegro-info-page
plan: 01
subsystem: ui
tags: [allegro, info-page, public-route]
requires:
- phase: 88-allegro-user-agent
provides: User-Agent header with URL pointing to this page
provides:
- Public /info page for Allegro User-Agent URL
affects: []
tech-stack:
added: []
patterns: [public layout without app chrome]
key-files:
created:
- src/Modules/Info/InfoController.php
- resources/views/info/allegro.php
- resources/views/layouts/public.php
modified:
- routes/web.php
key-decisions:
- "Osobny layout public.php zamiast reuse auth.php — brak orbow/loginu w tle"
- "Inline style w layoutcie i widoku — brak potrzeby budowania SCSS dla jednej strony"
patterns-established:
- "layouts/public.php dla stron publicznych bez elementow aplikacji"
duration: ~5min
started: 2026-04-08T00:10:00Z
completed: 2026-04-08T00:15:00Z
---
# Phase 89 Plan 01: Allegro Info Page Summary
**Publiczna strona /info z opisem aplikacji orderPRO — wymagana przez Allegro w naglowku User-Agent**
## Performance
| Metric | Value |
|--------|-------|
| Duration | ~5min |
| Tasks | 3 completed (2 auto + 1 checkpoint) |
| Files created | 3 |
| Files modified | 1 |
## Acceptance Criteria Results
| Criterion | Status | Notes |
|-----------|--------|-------|
| AC-1: Strona /info dostepna publicznie | Pass | Route bez authMiddleware, brak przekierowania na login |
| AC-2: Tresc zgodna z wymaganiami Allegro | Pass | Nazwa, wersja, opis, integracja z Allegro API, kontakt |
| AC-3: Profesjonalny wyglad | Pass | Minimalistyczny layout, responsywny, bez elementow aplikacji |
## Accomplishments
- Utworzono publiczna strone /info dostepna bez logowania
- Nowy layout `layouts/public.php` do stron publicznych (bez sidebara/nawigacji)
- Tresc informacyjna: opis wewnetrznej aplikacji Project PRO, zakres integracji z Allegro API, dane kontaktowe
## Files Created/Modified
| File | Change | Purpose |
|------|--------|---------|
| `src/Modules/Info/InfoController.php` | Created | Kontroler strony /info |
| `resources/views/layouts/public.php` | Created | Minimalistyczny layout publiczny |
| `resources/views/info/allegro.php` | Created | Widok strony informacyjnej |
| `routes/web.php` | Modified | Route GET /info bez middleware |
## Decisions Made
| Decision | Rationale | Impact |
|----------|-----------|--------|
| Osobny layout public.php | Auth layout ma orby i styl loginu — nieodpowiedni dla strony info | Reusable layout dla przyszlych stron publicznych |
| Inline CSS zamiast SCSS | Jedna prosta strona, nie warto budowac SCSS | Brak zaleznosci od build pipeline |
## Deviations from Plan
### Auto-fixed Issues
**1. Bledny namespace Template**
- **Found during:** Checkpoint (human-verify)
- **Issue:** `App\Core\Template\Template` nie istnieje — poprawny to `App\Core\View\Template`
- **Fix:** Zmiana use statement w InfoController
- **Verification:** Strona /info laduje sie poprawnie
**2. Zmiana tresci na wewnetrzna aplikacje**
- **Found during:** Checkpoint (human-verify)
- **Issue:** Opis sugerowol aplikacje publiczna/SaaS
- **Fix:** Zmieniono na "wewnetrzna aplikacja firmy Project PRO, nieudostepniana publicznie"
- **Verification:** Tresc zgodna z rzeczywistym przeznaczeniem
## Issues Encountered
None beyond auto-fixed deviations.
## Next Phase Readiness
**Ready:**
- Strona /info dostepna pod URL z User-Agent (https://orderpro.pl/info)
- Pelna zgodnosc z wymaganiami Allegro art. 3.4.c (deadline 30.06.2026)
**Concerns:** None
**Blockers:** None
---
*Phase: 89-allegro-info-page, Plan: 01*
*Completed: 2026-04-08*