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:
113
.paul/phases/89-allegro-info-page/89-01-SUMMARY.md
Normal file
113
.paul/phases/89-allegro-info-page/89-01-SUMMARY.md
Normal 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*
|
||||
Reference in New Issue
Block a user