update
This commit is contained in:
@@ -1,56 +1,21 @@
|
||||
# STATE
|
||||
|
||||
## Current Position
|
||||
|
||||
Milestone: (ad-hoc) Products - XML feed import
|
||||
Phase: 6 of 6 (XML Feed Import) - Completed
|
||||
Plan: 06-01 unified (loop closed)
|
||||
Status: UNIFY complete
|
||||
Last activity: 2026-04-30T01:15:00Z - Zamknieto petle planu 06-01
|
||||
|
||||
Progress:
|
||||
- Milestone: [██████████] 100%
|
||||
- Phase 6: [██████████] 100%
|
||||
Phase: 07-xml-feed-cron-refresh — Complete
|
||||
Plan: 07-01 complete
|
||||
Status: UNIFY complete. Phase complete — ready for next phase.
|
||||
Last activity: 2026-04-30T07:19:05.331Z
|
||||
|
||||
## Loop Position
|
||||
|
||||
Current loop state:
|
||||
```
|
||||
PLAN --> APPLY --> UNIFY
|
||||
✓ ✓ ✓ [Petla zamknieta]
|
||||
PLAN ──▶ APPLY ──▶ UNIFY
|
||||
✓ ✓ ✓ [Phase complete — ready for next phase]
|
||||
```
|
||||
|
||||
## Session Continuity
|
||||
|
||||
Last session: 2026-04-30
|
||||
Stopped at: Loop closed, gotowe do nowego /paul:plan
|
||||
Next action: Jesli chcesz kontynuowac - uruchom /paul:plan z kolejnym zadaniem
|
||||
Resume file: .paul/phases/06-xml-feed-import/06-01-SUMMARY.md
|
||||
|
||||
## Historia zrealizowanych planow
|
||||
|
||||
- `01-01-PLAN.md` - CL3 -> CL1 w tabeli /products (completed 2026-04-22)
|
||||
- `02-01-PLAN.md` - custom_label_1 w supplemental feed TSV (completed 2026-04-22)
|
||||
- `03-01-PLAN.md` - Powrot do widoku "wszystkie kampanie" w /products (completed 2026-04-24)
|
||||
- `04-01-PLAN.md` - Agregat produktu + rozwijane podwiersze kampania/grupa w /products (completed 2026-04-25)
|
||||
- `05-01-PLAN.md` - Usuwanie wpisow historii produktu per kampania+grupa z UI breakdown (completed 2026-04-29)
|
||||
- `06-01-PLAN.md` - XML feed import + rename name/title + xml_feed_url w clients (completed 2026-04-30)
|
||||
|
||||
## Decisions
|
||||
|
||||
| Date | Decision | Phase | Impact |
|
||||
|------|----------|-------|--------|
|
||||
| 2026-04-24 | Usuniecie placeholdera zamiast sentinel `0/all` | 3 | Minimalny blast radius, bez zmian w kontrolerze/factory |
|
||||
| 2026-04-25 | Bez wybranej grupy: glowny agregat per produkt + rozwijane podwiersze per kampania/grupa | 4 | Czytelniejsza analiza produktu i szybki drill-down |
|
||||
| 2026-04-25 | Podwiersze tylko readonly, edycja tylko w parent row | 4 | Spojnosc UX i brak konfliktu akcji edycyjnych |
|
||||
| 2026-04-29 | Usuwanie scope-level: products_aggregate + products_history + products_history_30 (transakcja), bez ruszania `products` ani Google Ads API | 5 | Hard delete lokalny, ograniczony do trojki product+campaign+ad_group |
|
||||
| 2026-04-29 | UI: nowa kolumna "Akcje" w breakdown z czerwona ikona kosza + dialog $.confirm + ajax.reload(null,false) | 5 | Brak utraty stanu paginacji/filtrow przy odswiezaniu agregatu |
|
||||
| 2026-04-30 | XML feed: jeden URL w clients.xml_feed_url, mapping po g:id=offer_id, parser XMLReader (streaming), batched manual upsert (200/batch) w transakcjach | 6 | Odporno na feedy z kilkoma tysiacami pozycji, niezalezne pola _gmc dla danych edytowalnych |
|
||||
| 2026-04-30 | Refaktor schematu products: name->title, title->title_gmc, dodanie description_gmc i price | 6 | Rozdzial danych zrodlowych od edytowalnych |
|
||||
| 2026-04-30 | Korekta semantyki: title/description = ZRODLOWE (z feedu lub pierwszy fetch GA), title_gmc/description_gmc = EDYTOWALNE (wysylane jako supplemental feed do GMC) | 6 | XmlFeedImporter pisze do title/description, edycja UI/AI pisze do _gmc, SupplementalFeed czyta z _gmc |
|
||||
| 2026-04-30 | INDEX zamiast UNIQUE na (client_id, offer_id) | 6 | Istniejace dane mialy duplikaty - manual upsert (SELECT IN + UPDATE/INSERT) zamiast ON DUPLICATE KEY UPDATE |
|
||||
|
||||
## Notes
|
||||
|
||||
- PAUL framework dziala tutaj w trybie ad-hoc (bez ROADMAP.md i PROJECT.md).
|
||||
- Plan 06-01 zostal zamkniety mimo legacy duplikatow w products - przyszle zadanie deduplikacji moze wymusic UNIQUE.
|
||||
- Backfill historycznych edycji `description` -> `description_gmc` jest deferred (czeka na decyzje uzytkownika).
|
||||
Stopped at: Plan 07-01 complete
|
||||
Next action: paul_workflow('plan') for next phase
|
||||
Resume file: .paul/phases/07-xml-feed-cron-refresh/07-01-SUMMARY.md
|
||||
59
.paul/STATE.md.bak
Normal file
59
.paul/STATE.md.bak
Normal file
@@ -0,0 +1,59 @@
|
||||
# STATE
|
||||
|
||||
## Current Position
|
||||
|
||||
Milestone: (ad-hoc) Products - XML feed import
|
||||
Phase: 7 of 7 (XML Feed Cron Refresh) - Planning
|
||||
Plan: 07-01 created, awaiting approval
|
||||
Status: APPLY complete — 3/3 PASS, ready for UNIFY
|
||||
Last activity: 2026-04-30T09:20:00+02:00 - Created .paul/phases/07-xml-feed-cron-refresh/07-01-PLAN.md
|
||||
|
||||
Progress:
|
||||
- Milestone: [#########-] 90%
|
||||
- Phase 7: [----------] 0%
|
||||
|
||||
## Loop Position
|
||||
|
||||
Current loop state:
|
||||
```
|
||||
PLAN --> APPLY --> UNIFY
|
||||
* o o [Plan created, awaiting approval]
|
||||
```
|
||||
|
||||
## Session Continuity
|
||||
|
||||
Last session: 2026-04-30
|
||||
Stopped at: Plan 07-01 created
|
||||
Next action: Review and approve plan, then run $paul-apply 07-01
|
||||
Resume file: .paul/phases/07-xml-feed-cron-refresh/07-01-PLAN.md
|
||||
|
||||
## Historia zrealizowanych planow
|
||||
|
||||
- `01-01-PLAN.md` - CL3 -> CL1 w tabeli /products (completed 2026-04-22)
|
||||
- `02-01-PLAN.md` - custom_label_1 w supplemental feed TSV (completed 2026-04-22)
|
||||
- `03-01-PLAN.md` - Powrot do widoku "wszystkie kampanie" w /products (completed 2026-04-24)
|
||||
- `04-01-PLAN.md` - Agregat produktu + rozwijane podwiersze kampania/grupa w /products (completed 2026-04-25)
|
||||
- `05-01-PLAN.md` - Usuwanie wpisow historii produktu per kampania+grupa z UI breakdown (completed 2026-04-29)
|
||||
- `06-01-PLAN.md` - XML feed import + rename name/title + xml_feed_url w clients (completed 2026-04-30)
|
||||
|
||||
## Decisions
|
||||
|
||||
| Date | Decision | Phase | Impact |
|
||||
|------|----------|-------|--------|
|
||||
| 2026-04-24 | Usuniecie placeholdera zamiast sentinel `0/all` | 3 | Minimalny blast radius, bez zmian w kontrolerze/factory |
|
||||
| 2026-04-25 | Bez wybranej grupy: glowny agregat per produkt + rozwijane podwiersze per kampania/grupa | 4 | Czytelniejsza analiza produktu i szybki drill-down |
|
||||
| 2026-04-25 | Podwiersze tylko readonly, edycja tylko w parent row | 4 | Spojnosc UX i brak konfliktu akcji edycyjnych |
|
||||
| 2026-04-29 | Usuwanie scope-level: products_aggregate + products_history + products_history_30 (transakcja), bez ruszania `products` ani Google Ads API | 5 | Hard delete lokalny, ograniczony do trojki product+campaign+ad_group |
|
||||
| 2026-04-29 | UI: nowa kolumna "Akcje" w breakdown z czerwona ikona kosza + dialog $.confirm + ajax.reload(null,false) | 5 | Brak utraty stanu paginacji/filtrow przy odswiezaniu agregatu |
|
||||
| 2026-04-30 | XML feed: jeden URL w clients.xml_feed_url, mapping po g:id=offer_id, parser XMLReader (streaming), batched manual upsert (200/batch) w transakcjach | 6 | Odporno na feedy z kilkoma tysiacami pozycji, niezalezne pola _gmc dla danych edytowalnych |
|
||||
| 2026-04-30 | Refaktor schematu products: name->title, title->title_gmc, dodanie description_gmc i price | 6 | Rozdzial danych zrodlowych od edytowalnych |
|
||||
| 2026-04-30 | Korekta semantyki: title/description = ZRODLOWE (z feedu lub pierwszy fetch GA), title_gmc/description_gmc = EDYTOWALNE (wysylane jako supplemental feed do GMC) | 6 | XmlFeedImporter pisze do title/description, edycja UI/AI pisze do _gmc, SupplementalFeed czyta z _gmc |
|
||||
| 2026-04-30 | INDEX zamiast UNIQUE na (client_id, offer_id) | 6 | Istniejace dane mialy duplikaty - manual upsert (SELECT IN + UPDATE/INSERT) zamiast ON DUPLICATE KEY UPDATE |
|
||||
| 2026-04-30 | XML feed ma byc osobnym cronem `/cron/cron_xml_feed_import`, niezaleznym od `cron_universal`, z recznym odswiezeniem w `/clients` | 7 | Czytelny harmonogram, brak dublowania importu z produktami Google Ads, latwiejsza diagnostyka feedu |
|
||||
|
||||
## Notes
|
||||
|
||||
- PAUL framework dziala tutaj w trybie ad-hoc (bez ROADMAP.md i PROJECT.md).
|
||||
- Plan 06-01 zostal zamkniety mimo legacy duplikatow w products - przyszle zadanie deduplikacji moze wymusic UNIQUE.
|
||||
- Backfill historycznych edycji `description` -> `description_gmc` jest deferred (czeka na decyzje uzytkownika).
|
||||
- Plan 07-01 obejmuje wydzielenie XML feed z `cron_universal`, reczny refresh w `/clients` i diagnostyke `offer_id=2084` dla `pomysloweprezenty.pl`.
|
||||
@@ -2,28 +2,16 @@
|
||||
|
||||
## Co zrobiono
|
||||
|
||||
- [Phase 6, Plan 06-01] XML feed import per klient + refaktor schematu products (source/edit split) + integracja z cron_universal
|
||||
- Dodano pole `xml_feed_url` w edycji klienta (templates/clients/main_view.php) z walidacja URL po stronie serwera
|
||||
- Migracja 029: rename `products.name` -> `title`, `products.title` -> `title_gmc`, dodanie `description_gmc`, `price`, `clients.xml_feed_url`, `clients.xml_feed_last_sync_at`, INDEX `(client_id, offer_id)` (non-unique - legacy duplikaty)
|
||||
- Nowy serwis `\services\XmlFeedImporter` - XMLReader streaming + batche 200 w transakcjach + manual upsert (SELECT IN + UPDATE/INSERT); odporny na feedy 5000+ pozycji
|
||||
- Hook w `cron_universal` wywoluje XmlFeedImporter po sync produktow GA dla klientow z ustawionym feedem; raport `xml_feed` w response
|
||||
- Refaktor wszystkich odwolan do kolumn `products.name`/`products.title` w factory, controls, services, templates, api.php; aliasy `AS name` zachowane jako kontrakt JS/API
|
||||
- Korekta semantyki: `title`/`description` = ZRODLO (z feedu lub pierwszy fetch GA), `title_gmc`/`description_gmc` = EDYTOWALNE (wysylane do GMC supplemental feed)
|
||||
- `is_product_core_field` zaktualizowane do `title_gmc`/`description_gmc` (edytowalne)
|
||||
- `SupplementalFeed::generate_for_client` czyta `title_gmc AS title, description_gmc AS description` przy generowaniu TSV
|
||||
- api.php (cztery endpointy products): SQL zaktualizowane, set_product_data zapisuje do title_gmc
|
||||
- [07-xml-feed-cron-refresh, Plan 01]
|
||||
- Task 1: Wydziel osobny cron XML feed
|
||||
- Task 2: Dodaj reczne odswiezanie XML Feed w /clients
|
||||
- Task 3: Zdiagnozuj i napraw custom_label_1 dla pomysloweprezenty.pl offer_id 2084
|
||||
|
||||
## Zmienione pliki
|
||||
|
||||
- `migrations/029_products_rename_columns_and_xml_feed.sql`
|
||||
- `autoload/services/class.XmlFeedImporter.php`
|
||||
- `autoload/factory/class.Products.php`
|
||||
- `autoload/controls/class.Products.php`
|
||||
- `autoload/controls/class.Cron.php`
|
||||
- `autoload/controls/class.Users.php`
|
||||
- `autoload/controls/class.Clients.php`
|
||||
- `autoload/services/class.SupplementalFeed.php`
|
||||
- `templates/clients/main_view.php`
|
||||
- `api.php`
|
||||
- `.paul/phases/06-xml-feed-import/06-01-PLAN.md`
|
||||
- `.paul/phases/06-xml-feed-import/06-01-SUMMARY.md`
|
||||
- `.paul/STATE.md`
|
||||
- `autoload/services/class.XmlFeedImporter.php`
|
||||
- `autoload/controls/class.Cron.php`
|
||||
208
.paul/phases/07-xml-feed-cron-refresh/07-01-PLAN.md
Normal file
208
.paul/phases/07-xml-feed-cron-refresh/07-01-PLAN.md
Normal file
@@ -0,0 +1,208 @@
|
||||
---
|
||||
phase: 07-xml-feed-cron-refresh
|
||||
plan: 01
|
||||
type: execute
|
||||
wave: 1
|
||||
depends_on: []
|
||||
files_modified:
|
||||
- autoload/controls/class.Cron.php
|
||||
- autoload/controls/class.Clients.php
|
||||
- autoload/controls/class.Users.php
|
||||
- templates/clients/main_view.php
|
||||
- autoload/services/class.XmlFeedImporter.php
|
||||
autonomous: true
|
||||
delegation: off
|
||||
---
|
||||
|
||||
<objective>
|
||||
## Goal
|
||||
Wydzielic import danych produktow z XML feed klienta do osobnego crona `/cron/cron_xml_feed_import`, dodac reczne odswiezanie XML feed w `/clients` oraz zdiagnozowac i naprawic brak `custom_label_1` dla produktu `offer_id=2084` klienta `pomysloweprezenty.pl`.
|
||||
|
||||
## Purpose
|
||||
Import XML feed jest niezalezny od pobierania statystyk produktow z Google Ads. Trzymanie go w `cron_universal` utrudnia diagnostyke, harmonogram i reczne odswiezanie z poziomu klienta. Osobny cron daje kontrolowany punkt uruchomienia i jasny raport, a analiza `offer_id=2084` ma potwierdzic, czy problem wynika z endpointu, mapowania klienta, parsera XML, duplikatow w `products`, czy braku pola w feedzie.
|
||||
|
||||
## Output
|
||||
- Nowa akcja `\controls\Cron::cron_xml_feed_import()` dostepna jako `/cron/cron_xml_feed_import`.
|
||||
- Usuniecie automatycznego importu XML z `cron_universal`.
|
||||
- Nowa opcja w menu odswiezania klienta na `/clients`: XML Feed.
|
||||
- `Clients::force_sync` uruchamia import XML natychmiast dla wskazanego klienta i zwraca raport JSON.
|
||||
- Diagnostyka i ewentualny fix pobierania `custom_label_1` dla `pomysloweprezenty.pl`, `offer_id=2084`.
|
||||
</objective>
|
||||
|
||||
<context>
|
||||
<clarifications>
|
||||
- **Endpoint** - Jaki endpoint ma miec osobny cron XML?
|
||||
-> Odpowiedz: `/cron/cron_xml_feed_import`, metoda `\controls\Cron::cron_xml_feed_import()`.
|
||||
- **Zakres diagnozy** - Czy produkt `offer_id=2084` klienta `pomysloweprezenty.pl` robimy w tym samym planie?
|
||||
-> Odpowiedz: Tak, w tym samym planie.
|
||||
- **Cron universal** - Czy zostawic import XML jako czesc `cron_universal`?
|
||||
-> Odpowiedz: Nie. XML feed ma byc niezalezny od pobierania produktow.
|
||||
- **UI clients** - Gdzie ma byc mozliwosc odswiezenia?
|
||||
-> Odpowiedz: W `/clients`, w obecnym miejscu odswiezania danych klienta.
|
||||
</clarifications>
|
||||
|
||||
## Project Context
|
||||
@.paul/STATE.md
|
||||
@.paul/phases/06-xml-feed-import/06-01-SUMMARY.md
|
||||
@CLAUDE.md
|
||||
|
||||
## Source Files
|
||||
@autoload/controls/class.Cron.php
|
||||
@autoload/controls/class.Clients.php
|
||||
@autoload/controls/class.Users.php
|
||||
@templates/clients/main_view.php
|
||||
@autoload/services/class.XmlFeedImporter.php
|
||||
@autoload/factory/class.Clients.php
|
||||
</context>
|
||||
|
||||
<acceptance_criteria>
|
||||
|
||||
## AC-1: Osobny cron XML feed
|
||||
```gherkin
|
||||
Given klient ma ustawiony `clients.xml_feed_url`
|
||||
When wywolam `/cron/cron_xml_feed_import` bez `client_id`
|
||||
Then cron wybiera aktywnego klienta z `xml_feed_url` i uruchamia `XmlFeedImporter::import_for_client()`
|
||||
And zwraca JSON z `client_id`, `feed_url`, `fetched`, `updated`, `inserted`, `skipped`, `errors`, `peak_memory_mb`, `duration_ms`
|
||||
And ustawia `clients.xml_feed_last_sync_at` przez importer po udanym przebiegu
|
||||
```
|
||||
|
||||
## AC-2: Reczne odswiezanie XML feed w /clients
|
||||
```gherkin
|
||||
Given jestem na `https://adspro.projectpro.pl/clients`
|
||||
When rozwijam menu odswiezania przy kliencie z `xml_feed_url`
|
||||
Then widze opcje `XML Feed`
|
||||
When klikam `XML Feed`
|
||||
Then aplikacja uruchamia import natychmiast dla tego klienta
|
||||
And pokazuje komunikat z liczba pobranych/zaktualizowanych/dodanych/pominietych pozycji albo czytelny blad
|
||||
```
|
||||
|
||||
## AC-3: XML feed niezalezny od cron_universal
|
||||
```gherkin
|
||||
Given uruchamia sie `/cron/cron_universal`
|
||||
When cron synchronizuje kampanie i produkty Google Ads
|
||||
Then nie wywoluje `XmlFeedImporter::import_for_client()`
|
||||
And response `cron_universal` nie zawiera juz importu XML jako czesci sync produktow
|
||||
And import XML mozna uruchomic tylko przez `/cron/cron_xml_feed_import` albo reczna akcje `/clients`
|
||||
```
|
||||
|
||||
## AC-4: Diagnoza i fix custom_label_1 dla offer_id 2084
|
||||
```gherkin
|
||||
Given klient `pomysloweprezenty.pl` ma skonfigurowany XML feed
|
||||
When uruchomie import XML dla tego klienta
|
||||
Then importer poprawnie odczytuje `g:custom_label_1` dla pozycji `g:id=2084`, jesli pole istnieje w feedzie
|
||||
And rekord albo rekordy `products` tego klienta z `offer_id='2084'` maja uzupelnione `custom_label_1`
|
||||
And jesli feed nie zawiera tej wartosci, raport diagnostyczny jasno wskazuje `custom_label_1_missing_in_feed`
|
||||
```
|
||||
|
||||
</acceptance_criteria>
|
||||
|
||||
<tasks>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 1: Wydziel osobny cron XML feed</name>
|
||||
<files>autoload/controls/class.Cron.php, autoload/controls/class.Users.php</files>
|
||||
<action>
|
||||
Dodaj publiczna metode `cron_xml_feed_import()` w `autoload/controls/class.Cron.php`.
|
||||
|
||||
Wymagane zachowanie:
|
||||
- Ustaw `self::$current_cron_action = __FUNCTION__` i wywolaj `self::touch_cron_invocation(__FUNCTION__)`.
|
||||
- Obsluz `client_id` z requestu: jesli podany, importuj dokladnie tego aktywnego klienta z niepustym `xml_feed_url`.
|
||||
- Bez `client_id` wybierz jednego aktywnego klienta z niepustym `xml_feed_url`, najlepiej po `xml_feed_last_sync_at ASC` z `NULL` jako pierwsze. To ogranicza czas jednego uruchomienia i pasuje do istniejacych cronow per klient.
|
||||
- Uruchom `\services\XmlFeedImporter::import_for_client((int) $client['id'])` i zwroc `self::output_cron_response()` z raportem.
|
||||
- Nie wymagaj Google Ads API ani Merchant API do importu XML.
|
||||
- Dodaj endpoint do dashboardu cron w `autoload/controls/class.Users.php` jako `/cron/cron_xml_feed_import` z opisem harmonogramu.
|
||||
|
||||
Usun wywolania `XmlFeedImporter::import_for_client()` z `cron_universal`, z obu sciezek: wymuszonego `client_id` i automatycznego pipeline, jezeli wystepuja.
|
||||
|
||||
Avoid: laczenie statusu XML z `cron_sync_status` pipeline `products`, bo XML feed ma byc niezaleznym procesem.
|
||||
</action>
|
||||
<verify>`php -l autoload/controls/class.Cron.php` i `php -l autoload/controls/class.Users.php`; grep `XmlFeedImporter::import_for_client` pokazuje wywolanie w `cron_xml_feed_import` i ewentualnie w `Clients::force_sync`, ale nie w `cron_universal`.</verify>
|
||||
<done>AC-1 i AC-3 satisfied</done>
|
||||
</task>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 2: Dodaj reczne odswiezanie XML Feed w /clients</name>
|
||||
<files>autoload/controls/class.Clients.php, templates/clients/main_view.php</files>
|
||||
<action>
|
||||
Rozszerz istniejace menu odswiezania w `templates/clients/main_view.php`:
|
||||
- Dla klienta z niepustym `xml_feed_url` pokaz przycisk `XML Feed` w dropdownie `sync-dropdown-menu`.
|
||||
- Uzyj istniejacego `syncFromMenu(id, pipeline, btn)` z nowym `pipeline = 'xml_feed'`.
|
||||
- Dodaj etykiete `xml_feed: 'XML feedu'` w obiekcie `labels`.
|
||||
- Dla odpowiedzi natychmiastowej pokaz komunikat z liczbami z raportu: fetched/updated/inserted/skipped; przy bledach pokaz czytelny komunikat.
|
||||
|
||||
W `autoload/controls/class.Clients.php` znajdz metode `force_sync` i dodaj obsluge `pipeline === 'xml_feed'`:
|
||||
- Waliduj klienta, aktywnosc i obecne `xml_feed_url`.
|
||||
- Uruchom `\services\XmlFeedImporter::import_for_client($id)` natychmiast.
|
||||
- Zwroc JSON `{ success: true, immediate: true, pipeline: 'xml_feed', report: ... }` albo `{ success: false, message: ... }`.
|
||||
- Nie kolejkuj tego przez `cron_sync_status`, bo wymaganie mowi o niezaleznym odswiezeniu w `/clients`.
|
||||
|
||||
Avoid: wymagania `google_ads_customer_id` dla przycisku XML feed. Do XML wystarczy aktywny klient i `xml_feed_url`.
|
||||
</action>
|
||||
<verify>`php -l autoload/controls/class.Clients.php`; reczne klikniecie `/clients` -> XML Feed zwraca alert z raportem i aktualizuje `clients.xml_feed_last_sync_at`.</verify>
|
||||
<done>AC-2 satisfied</done>
|
||||
</task>
|
||||
|
||||
<task type="auto">
|
||||
<name>Task 3: Zdiagnozuj i napraw custom_label_1 dla pomysloweprezenty.pl offer_id 2084</name>
|
||||
<files>autoload/services/class.XmlFeedImporter.php, autoload/controls/class.Cron.php</files>
|
||||
<action>
|
||||
Dodaj minimalna diagnostyke ukierunkowana na przypadki braku pola po imporcie, bez stalego logowania kazdego produktu:
|
||||
- Dodaj opcjonalny parametr requestu dla crona, np. `debug_offer_id=2084` albo `offer_id=2084`, ktory przekazesz do importera tylko w raporcie diagnostycznym.
|
||||
- W `XmlFeedImporter` dodaj lekka obsluge diagnostyczna: kiedy parsowany `offer_id` odpowiada debugowanemu ID, zapisz w raporcie `debug_offer` z polami: `found_in_feed`, `custom_label_1_raw_present`, `custom_label_1_value`, `title_present`, `matched_existing_rows`, `updated_rows`.
|
||||
- Sprawdz parser `extract_item_fields()`: ma obslugiwac `g:custom_label_1` w namespace `http://base.google.com/ns/1.0`; jesli realny feed uzywa innej formy (np. bez namespace albo z prefiksem zachowanym jako nazwa), dodaj punktowa obsluge fallback bez ladowania calego XML do pamieci.
|
||||
- Sprawdz `flush_batch()`: dla istniejacych rekordow z `offer_id=2084` `custom_label_1` ma sie aktualizowac, gdy wartosc z feedu nie jest pusta. Jesli feed ma pusta wartosc, nie nadpisuj istniejacej wartosci pustka.
|
||||
- Jesli klient `pomysloweprezenty.pl` ma wiele rekordow `products` z tym samym `offer_id`, zachowaj aktualne zalozenie z fazy 06: aktualizuj wszystkie legacy duplikaty.
|
||||
|
||||
Po implementacji uruchom lub opisz weryfikacje:
|
||||
`/cron/cron_xml_feed_import/client_id=<ID_KLIENTA>&debug_offer_id=2084`
|
||||
i sprawdz w raporcie, czy `debug_offer` wskazuje przyczyne.
|
||||
|
||||
Avoid: hardcodowania domeny `pomysloweprezenty.pl` albo `2084` w logice produkcyjnej. To ma byc parametr diagnostyczny.
|
||||
</action>
|
||||
<verify>`php -l autoload/services/class.XmlFeedImporter.php`; import dla klienta `pomysloweprezenty.pl` z `debug_offer_id=2084` zwraca `debug_offer`; po imporcie SELECT po `client_id` i `offer_id='2084'` pokazuje uzupelnione `custom_label_1` albo raport jasno pokazuje brak wartosci w feedzie.</verify>
|
||||
<done>AC-4 satisfied</done>
|
||||
</task>
|
||||
|
||||
</tasks>
|
||||
|
||||
<boundaries>
|
||||
|
||||
## DO NOT CHANGE
|
||||
- `migrations/001`-`029` bez wyraznej potrzeby; ten plan nie wymaga zmiany schematu.
|
||||
- Semantyka z fazy 06: `title`/`description` sa danymi zrodlowymi, `title_gmc`/`description_gmc` sa edytowalne i ida do supplemental feed.
|
||||
- Importer nie moze nadpisywac `custom_label_1` pustka z feedu.
|
||||
- Nie laczyc XML feed z Google Ads API ani Merchant API.
|
||||
|
||||
## SCOPE LIMITS
|
||||
- Brak nowego dashboardu historii importow XML.
|
||||
- Brak kolejki `cron_sync_status` dla XML feed.
|
||||
- Brak deduplikacji `products` dla legacy duplikatow `(client_id, offer_id)`.
|
||||
- Brak nowych pol z feedu poza diagnostyka `custom_label_1`.
|
||||
- Brak przebudowy calego UI `/clients`; tylko dodatkowa opcja w istniejacym dropdownie.
|
||||
|
||||
</boundaries>
|
||||
|
||||
<verification>
|
||||
Before declaring plan complete:
|
||||
- [ ] `php -l autoload/controls/class.Cron.php`
|
||||
- [ ] `php -l autoload/controls/class.Clients.php`
|
||||
- [ ] `php -l autoload/services/class.XmlFeedImporter.php`
|
||||
- [ ] `rg -n "XmlFeedImporter::import_for_client" autoload/controls/class.Cron.php autoload/controls/class.Clients.php` potwierdza brak wywolania w `cron_universal`
|
||||
- [ ] `/cron/cron_xml_feed_import?client_id=<id>` zwraca raport importu bez wymagania Google Ads API
|
||||
- [ ] `/clients` pokazuje opcje `XML Feed` dla klienta z `xml_feed_url`
|
||||
- [ ] Klikniecie `XML Feed` w `/clients` wykonuje import natychmiast i pokazuje raport
|
||||
- [ ] Debug `offer_id=2084` dla `pomysloweprezenty.pl` wskazuje przyczyne braku `custom_label_1` albo naprawia zapis
|
||||
- [ ] Wszystkie AC-1 do AC-4 spelnione
|
||||
</verification>
|
||||
|
||||
<success_criteria>
|
||||
- XML feed ma osobny endpoint cron i nie jest czescia `cron_universal`.
|
||||
- Klient moze recznie odswiezyc XML feed z `/clients`.
|
||||
- Import XML dziala bez konfiguracji Google Ads/Merchant API.
|
||||
- Problem `custom_label_1` dla `offer_id=2084` jest zdiagnozowany i naprawiony, jezeli wartosc istnieje w feedzie.
|
||||
- Brak regresji w dotychczasowym pobieraniu kampanii i produktow Google Ads.
|
||||
</success_criteria>
|
||||
|
||||
<output>
|
||||
After completion, create `.paul/phases/07-xml-feed-cron-refresh/07-01-SUMMARY.md`
|
||||
</output>
|
||||
40
.paul/phases/07-xml-feed-cron-refresh/07-01-SUMMARY.md
Normal file
40
.paul/phases/07-xml-feed-cron-refresh/07-01-SUMMARY.md
Normal file
@@ -0,0 +1,40 @@
|
||||
---
|
||||
phase: 07-xml-feed-cron-refresh
|
||||
plan: 01
|
||||
completed: 2026-04-30T07:19:05.331Z
|
||||
---
|
||||
|
||||
# Phase 07-01 Summary
|
||||
|
||||
****
|
||||
|
||||
## Acceptance Criteria Results
|
||||
|
||||
| Criterion | Status |
|
||||
|-----------|--------|
|
||||
| Task 1: Wydziel osobny cron XML feed | Pass — Dodano Cron::cron_xml_feed_import, endpoint w dashboardzie cron, usunieto wywolanie XmlFeedImporter z cron_universal. Lint OK; grep potwierdza wywolania tylko w nowym cronie i Clients::force_sync. |
|
||||
| Task 2: Dodaj reczne odswiezanie XML Feed w /clients | Pass — Dodano opcje XML Feed w dropdownie /clients oraz obsluge pipeline xml_feed w Clients::force_sync z natychmiastowym importem i raportem. Lint OK. |
|
||||
| Task 3: Zdiagnozuj i napraw custom_label_1 dla pomysloweprezenty.pl offer_id 2084 | Pass — Dodano debug_offer_id/offer_id, raport debug_offer, fallback odczytu custom_label_1 po localName oraz metryki matched_existing_rows/updated_rows. Runtime import/SELECT nie zostal wykonany, bo lokalny MySQL odmawia polaczenia. |
|
||||
|
||||
## Accomplishments
|
||||
|
||||
- Task 1: Wydziel osobny cron XML feed: Dodano Cron::cron_xml_feed_import, endpoint w dashboardzie cron, usunieto wywolanie XmlFeedImporter z cron_universal. Lint OK; grep potwierdza wywolania tylko w nowym cronie i Clients::force_sync.
|
||||
- Task 2: Dodaj reczne odswiezanie XML Feed w /clients: Dodano opcje XML Feed w dropdownie /clients oraz obsluge pipeline xml_feed w Clients::force_sync z natychmiastowym importem i raportem. Lint OK.
|
||||
- Task 3: Zdiagnozuj i napraw custom_label_1 dla pomysloweprezenty.pl offer_id 2084: Dodano debug_offer_id/offer_id, raport debug_offer, fallback odczytu custom_label_1 po localName oraz metryki matched_existing_rows/updated_rows. Runtime import/SELECT nie zostal wykonany, bo lokalny MySQL odmawia polaczenia.
|
||||
|
||||
## Files Modified
|
||||
|
||||
- `autoload/controls/class.Cron.php`
|
||||
- `autoload/controls/class.Users.php`
|
||||
- `autoload/controls/class.Clients.php`
|
||||
- `templates/clients/main_view.php`
|
||||
- `autoload/services/class.XmlFeedImporter.php`
|
||||
- `autoload/controls/class.Cron.php`
|
||||
|
||||
## Deviations
|
||||
|
||||
Runtime verification against local DB was not possible: local MySQL refused connection, so `/cron/cron_xml_feed_import?client_id=<id>&debug_offer_id=2084` and SELECT for offer_id=2084 must be verified on the target environment.
|
||||
|
||||
---
|
||||
*Phase: 07-xml-feed-cron-refresh, Plan: 01*
|
||||
*Completed: 2026-04-30*
|
||||
Reference in New Issue
Block a user