151 lines
6.7 KiB
Markdown
151 lines
6.7 KiB
Markdown
---
|
|
phase: 74-reverse-status-mapping
|
|
plan: 01
|
|
subsystem: settings
|
|
tags: [status-mapping, integrations, shoppro, allegro, ui]
|
|
|
|
requires:
|
|
- phase: none
|
|
provides: none
|
|
provides:
|
|
- Reversed status mapping UI (orderPRO statuses as rows, external as dropdown)
|
|
- DB unique key on orderpro_status_code instead of external code
|
|
- New repository methods for external status listing and reverse maps
|
|
affects: [status-sync, order-import]
|
|
|
|
tech-stack:
|
|
added: []
|
|
patterns: [mapping-index pattern for reversed UI, external status options builder]
|
|
|
|
key-files:
|
|
created:
|
|
- database/migrations/20260407_000078_reverse_status_mapping_keys.sql
|
|
modified:
|
|
- src/Modules/Settings/ShopproStatusMappingRepository.php
|
|
- src/Modules/Settings/AllegroStatusMappingRepository.php
|
|
- src/Modules/Settings/ShopproIntegrationsController.php
|
|
- src/Modules/Settings/AllegroStatusMappingController.php
|
|
- src/Modules/Settings/AllegroIntegrationController.php
|
|
- src/Modules/Settings/ShopproOrdersSyncService.php
|
|
- resources/views/settings/shoppro.php
|
|
- resources/views/settings/allegro.php
|
|
- resources/lang/pl.php
|
|
|
|
key-decisions:
|
|
- "Kolumny DB bez zmian nazw — zmiana tylko unique key direction"
|
|
- "Discovered statuses z Flash + existing mappings jako dropdown options"
|
|
- "Allegro: replaceAllMappings() zamiast per-row upsert dla bulk save"
|
|
- "upsertDiscoveredStatus() zachowany jako check-then-insert (bez ON DUPLICATE KEY po zmianie unique)"
|
|
|
|
patterns-established:
|
|
- "buildMappingIndex(): orderpro_code => external_info map for pre-filling UI"
|
|
- "buildExternalStatusOptions(): merge DB + Flash discovered for dropdown"
|
|
|
|
duration: ~30min
|
|
started: 2026-04-07T00:00:00Z
|
|
completed: 2026-04-07T00:30:00Z
|
|
---
|
|
|
|
# Phase 74 Plan 01: Reverse Status Mapping Summary
|
|
|
|
**Odwrocenie mapowania statusow w shopPRO i Allegro — UI pokazuje statusy orderPRO po lewej, dropdown z zewnetrznymi po prawej. Migracja DB zmienia unique key na orderpro_status_code.**
|
|
|
|
## Performance
|
|
|
|
| Metric | Value |
|
|
|--------|-------|
|
|
| Duration | ~30min |
|
|
| Tasks | 2 completed |
|
|
| Files modified | 11 |
|
|
|
|
## Acceptance Criteria Results
|
|
|
|
| Criterion | Status | Notes |
|
|
|-----------|--------|-------|
|
|
| AC-1: UI shopPRO — orderPRO po lewej, shopPRO po prawej | Pass | Tabela iteruje orderproStatuses, dropdown z shopproStatuses |
|
|
| AC-2: UI Allegro — orderPRO po lewej, Allegro po prawej | Pass | Analogicznie, usuniety single-add form |
|
|
| AC-3: Sync dziala w obu kierunkach | Pass | buildStatusMap() i buildReverseStatusMap() nadal zwracaja poprawne mapy |
|
|
| AC-4: Sync pobiera statusy do dropdown | Pass | Flash + listExternalStatuses() merge |
|
|
| AC-5: Migracja DB zmienia unique constraint | Pass | SQL przygotowany, deduplikacja przed zmiana |
|
|
|
|
## Accomplishments
|
|
|
|
- Odwrocony UI mapowania w obu integracjach (shopPRO i Allegro) — orderPRO statusy jako wiersze
|
|
- Migracja DB: unique key z external_code na orderpro_status_code w obu tabelach
|
|
- Nowe metody: listExternalStatuses(), buildAllegroToOrderproMap(), replaceAllMappings()
|
|
- JS synchronizacja hidden input shoppro_status_name/allegro_status_name przy zmianie dropdown
|
|
|
|
## Files Created/Modified
|
|
|
|
| File | Change | Purpose |
|
|
|------|--------|---------|
|
|
| `database/migrations/20260407_000078_reverse_status_mapping_keys.sql` | Created | Migracja unique key + deduplikacja |
|
|
| `src/Modules/Settings/ShopproStatusMappingRepository.php` | Modified | replaceForIntegration() key na orderpro, +listExternalStatuses() |
|
|
| `src/Modules/Settings/AllegroStatusMappingRepository.php` | Modified | upsertMapping() key na orderpro, +listExternalStatuses(), +buildAllegroToOrderproMap(), +replaceAllMappings(), upsertDiscoveredStatus() check-then-insert |
|
|
| `src/Modules/Settings/ShopproOrdersSyncService.php` | Modified | buildStatusMap() komentarz + guard na duplikaty |
|
|
| `src/Modules/Settings/ShopproIntegrationsController.php` | Modified | buildMappingIndex() + buildExternalStatusOptions() zamiast buildStatusRows(), saveStatusMappings() odwrocony |
|
|
| `src/Modules/Settings/AllegroStatusMappingController.php` | Modified | saveStatusMappingsBulk() odwrocony, saveStatusMapping() stub redirect |
|
|
| `src/Modules/Settings/AllegroIntegrationController.php` | Modified | +allegroStatuses w danych widoku |
|
|
| `resources/views/settings/shoppro.php` | Modified | Odwrocona tabela + JS name sync |
|
|
| `resources/views/settings/allegro.php` | Modified | Odwrocona tabela, usuniety single-add form, +JS name sync |
|
|
| `resources/lang/pl.php` | Modified | Nowe klucze: shoppro_status, allegro_status, no_orderpro_statuses, zmienione opisy |
|
|
|
|
## Decisions Made
|
|
|
|
| Decision | Rationale | Impact |
|
|
|----------|-----------|--------|
|
|
| Zachowanie nazw kolumn DB | Minimalizacja ryzyka — zmiana tylko unique key, nie schemat | Zero zmian w logice sync pull/push |
|
|
| Discovered statuses z Flash + DB merge | Brak nowej tabeli, proste rozwiazanie | Dropdown opcje znikaja po sesji jesli nie zapisane w mapowaniu |
|
|
| upsertDiscoveredStatus() jako check-then-insert | Po zmianie unique na orderpro_status_code, ON DUPLICATE KEY nie dziala na allegro_status_code | Allegro discovery nadal dziala poprawnie |
|
|
| Usuniety single-add form w Allegro | Zbedny — wiersze to orderPRO statusy, nie trzeba dodawac recznie | Czystszy UI |
|
|
|
|
## Deviations from Plan
|
|
|
|
### Summary
|
|
|
|
| Type | Count | Impact |
|
|
|------|-------|--------|
|
|
| Auto-fixed | 2 | Konieczne dostosowania |
|
|
| Deferred | 1 | Migracja do uruchomienia na serwerze |
|
|
|
|
### Auto-fixed Issues
|
|
|
|
**1. Nazwa pliku migracji**
|
|
- **Found during:** Task 1
|
|
- **Issue:** Plan mial nazwe `20260407_000074_...` ale kolejny numer to 078
|
|
- **Fix:** Plik nazwany `20260407_000078_reverse_status_mapping_keys.sql`
|
|
|
|
**2. upsertDiscoveredStatus() w AllegroStatusMappingRepository**
|
|
- **Found during:** Task 1
|
|
- **Issue:** Po zmianie unique key na orderpro_status_code, ON DUPLICATE KEY UPDATE nie moze kluczowac na allegro_status_code
|
|
- **Fix:** Zamieniono na check-then-insert (SELECT + INSERT/UPDATE)
|
|
|
|
### Deferred Items
|
|
|
|
- Migracja SQL wymaga uruchomienia na serwerze (lokalna baza niedostepna — XAMPP wylaczony)
|
|
|
|
## Issues Encountered
|
|
|
|
| Issue | Resolution |
|
|
|-------|------------|
|
|
| Lokalna baza danych niedostepna | Migracja przygotowana do uruchomienia na serwerze |
|
|
| saveStatusMapping() route nadal istnieje | Dodany stub redirect w kontrolerze |
|
|
|
|
## Next Phase Readiness
|
|
|
|
**Ready:**
|
|
- Kod w pelni przygotowany i zweryfikowany syntaktycznie
|
|
- Migracja SQL gotowa do uruchomienia
|
|
- Dokumentacja zaktualizowana (DB_SCHEMA, ARCHITECTURE, TECH_CHANGELOG)
|
|
|
|
**Concerns:**
|
|
- Migracja musi byc uruchomiona na serwerze przed deploy
|
|
- Istniejace mapowania z duplikatami orderpro_status_code zostana zdeduplikowane (zachowany najnowszy)
|
|
|
|
**Blockers:**
|
|
- None (po uruchomieniu migracji)
|
|
|
|
---
|
|
*Phase: 74-reverse-status-mapping, Plan: 01*
|
|
*Completed: 2026-04-07*
|