diff --git a/.paul/ROADMAP.md b/.paul/ROADMAP.md index 03d4566..9b0c910 100644 --- a/.paul/ROADMAP.md +++ b/.paul/ROADMAP.md @@ -27,7 +27,8 @@ Planned: ### Phase 3: Registration Form Settings Status: Applying -Goal: Add an administrator "Ustawienia formularza" page for editable registration participation days and all prices used by the public form, mail/summary output, and server-side price calculation. +Goal: Add an administrator "Ustawienia formularza" page for editable registration participation days and all prices used by the public form, mail/summary output, and server-side price calculation. Also adds KSeF ID field to registration form and reverses admin Reg table order. Planned: - `03-01`: Applied, awaiting unify - created settings helper, admin page, deployment seed, and connected public form pricing/day options to editable settings. +- `03-02`: Planning - add KSeF ID field to form/DB/confirmations/admin, reverse Reg table order. diff --git a/.paul/STATE.md b/.paul/STATE.md index fd8fa2c..66ee251 100644 --- a/.paul/STATE.md +++ b/.paul/STATE.md @@ -2,28 +2,31 @@ Milestone: v0.1 XXXV Konferencja Registration Update Phase: 3 of 3 (Registration Form Settings) - Planning -Plan: 03-01 applied, awaiting unify -Status: APPLY complete, ready for UNIFY -Last activity: 2026-04-24 23:09:13 +02:00 - Added in-plan KSeF helper note under NIP field +Plan: 03-02 unified +Status: Loop closed — ready for next action +Last activity: 2026-04-27 — UNIFY complete for 03-02 Progress: -- Milestone: [#######---] 67% -- Phase 3: [----------] 0% +- Milestone: [########--] 80% +- Phase 3: [########--] 80% (03-01 APPLY done, UNIFY pending; 03-02 loop closed) ## Loop Position Current loop state: ```text -PLAN --> APPLY --> UNIFY - * * o [Apply complete, awaiting unify] +PLAN ──▶ APPLY ──▶ UNIFY + ✓ ✓ ✓ [Loop 03-02 complete] ``` +⚠️ Plan 03-01 APPLY was completed but UNIFY was never run — no 03-01-SUMMARY.md exists. + Phase 3 not formally closed until 03-01 is also unified. + ## Session Continuity -Last session: 2026-04-24 23:09:13 +02:00 -Stopped at: Plan 03-01 applied -Next action: Run $paul-unify `.paul/phases/03-registration-form-settings/03-01-PLAN.md` -Resume file: `.paul/phases/03-registration-form-settings/03-01-APPLY.md` +Last session: 2026-04-27 +Stopped at: UNIFY 03-02 complete +Next action: Run /paul:unify .paul/phases/03-registration-form-settings/03-01-PLAN.md to close 03-01 loop +Resume file: .paul/phases/03-registration-form-settings/03-02-SUMMARY.md ## Accumulated Context diff --git a/.paul/changelog/2026-04-27.md b/.paul/changelog/2026-04-27.md new file mode 100644 index 0000000..d130449 --- /dev/null +++ b/.paul/changelog/2026-04-27.md @@ -0,0 +1,25 @@ +# 2026-04-27 + +## Co zrobiono + +- [Faza 3, Plan 02] Dodano pole "Dodatkowe informacje" (textarea) do formularza rejestracji poniżej NIP +- Przeniesiono notę pomocniczą KSeF z wnętrza pola NIP nad nowe pole textarea +- Dodano kolumnę `additional_info` (TEXT) do tabeli `mf_participant` z bezpiecznym runnerem migracji +- Zaktualizowano model MfParticipant: właściwość `additionalInfo`, getter/setter +- Pole zapisywane w bazie przez IndexController +- Pole wyświetlane w potwierdzeniu rejestracji (IndexSent.tpl, IndexSent_good.tpl) +- Pole wyświetlane w panelu administratora (Reg.tpl) +- Odwrócono kolejność tabeli w Admin/Calc/Reg — najnowsze zgłoszenia wyświetlane na górze + +## Zmienione pliki + +- `_rejestracja/sql/2026-04-27-additional-info-field.sql` +- `_rejestracja/sql/apply-2026-04-27-additional-info-field.php` +- `_rejestracja/core/model/MfParticipant.class.php` +- `_rejestracja/controller/IndexController.php` +- `_rejestracja/template/partial/Index/Index.tpl` +- `_rejestracja/template/partial/Index/Index_good.tpl` +- `_rejestracja/template/partial/Index/IndexSent.tpl` +- `_rejestracja/template/partial/Index/IndexSent_good.tpl` +- `_rejestracja/Admin/template/partial/Calc/Reg.tpl` +- `_rejestracja/Admin/controller/CalcController.php` diff --git a/.paul/docs/API.md b/.paul/docs/API.md new file mode 100644 index 0000000..cce27e0 --- /dev/null +++ b/.paul/docs/API.md @@ -0,0 +1,3 @@ +# API + +> Endpointy, kontrakty request/response, autentykacja. diff --git a/.paul/docs/ARCHITECTURE.md b/.paul/docs/ARCHITECTURE.md new file mode 100644 index 0000000..e76060e --- /dev/null +++ b/.paul/docs/ARCHITECTURE.md @@ -0,0 +1,3 @@ +# ARCHITECTURE + +> Struktura klas, modulow, przeplywow i zaleznosci w projekcie. diff --git a/.paul/docs/DB_SCHEMA.md b/.paul/docs/DB_SCHEMA.md new file mode 100644 index 0000000..737ad36 --- /dev/null +++ b/.paul/docs/DB_SCHEMA.md @@ -0,0 +1,3 @@ +# DB_SCHEMA + +> Schemat bazy danych — tabele, kolumny, FK, indeksy. diff --git a/.paul/docs/DECISIONS.md b/.paul/docs/DECISIONS.md new file mode 100644 index 0000000..59239f4 --- /dev/null +++ b/.paul/docs/DECISIONS.md @@ -0,0 +1,3 @@ +# DECISIONS + +> Kluczowe decyzje techniczne i ich uzasadnienia. diff --git a/.paul/docs/STACK.md b/.paul/docs/STACK.md new file mode 100644 index 0000000..bad9fe6 --- /dev/null +++ b/.paul/docs/STACK.md @@ -0,0 +1,3 @@ +# STACK + +> Stack technologiczny, wersje, zaleznosci, srodowisko. diff --git a/.paul/docs/TECH_CHANGELOG.md b/.paul/docs/TECH_CHANGELOG.md new file mode 100644 index 0000000..861d346 --- /dev/null +++ b/.paul/docs/TECH_CHANGELOG.md @@ -0,0 +1,3 @@ +# TECH_CHANGELOG + +> Chronologiczny log zmian technicznych — co i dlaczego. diff --git a/.paul/docs/TODO.md b/.paul/docs/TODO.md new file mode 100644 index 0000000..e5893db --- /dev/null +++ b/.paul/docs/TODO.md @@ -0,0 +1,3 @@ +# TODO + +> Luzny parking pomyslow, rzeczy do sprawdzenia. diff --git a/.paul/governance/governance_2026-04-27.jsonl b/.paul/governance/governance_2026-04-27.jsonl new file mode 100644 index 0000000..9ccf77f --- /dev/null +++ b/.paul/governance/governance_2026-04-27.jsonl @@ -0,0 +1,23 @@ +{"ts":"2026-04-27T13:23:52Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\phases\\\\03-registration-form-settings\\\\03-02-PLAN.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:24:08Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:24:16Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\ROADMAP.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:26:30Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\phases\\\\03-registration-form-settings\\\\03-02-PLAN.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:19Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\sql\\\\2026-04-27-additional-info-field.sql","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:20Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\core\\\\model\\\\MfParticipant.class.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:23Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\core\\\\model\\\\MfParticipant.class.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:28Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\core\\\\model\\\\MfParticipant.class.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:44Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\sql\\\\apply-2026-04-27-additional-info-field.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:27:51Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\controller\\\\IndexController.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:11Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/aktualia.com.pl/_rejestracja/core/model/MfParticipant.class.php\" && php -l \"C:/visual studio code/projekty/aktualia.com.pl/_rejestracja/controller/IndexContro","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:21Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\template\\\\partial\\\\Index\\\\Index.tpl","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:33Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\template\\\\partial\\\\Index\\\\Index_good.tpl","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:40Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\template\\\\partial\\\\Index\\\\IndexSent.tpl","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:46Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\template\\\\partial\\\\Index\\\\IndexSent_good.tpl","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:50Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\Admin\\\\template\\\\partial\\\\Calc\\\\Reg.tpl","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:28:59Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\_rejestracja\\\\Admin\\\\controller\\\\CalcController.php","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:29:06Z","tool":"Bash","cmd":"php -l \"C:/visual studio code/projekty/aktualia.com.pl/_rejestracja/Admin/controller/CalcController.php\"\",\"description\":\"PHP syntax check CalcController\"},\"tool_response\":{\"stdout\":\"No syn","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:29:20Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T13:29:22Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T15:45:21Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\phases\\\\03-registration-form-settings\\\\03-02-SUMMARY.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T15:45:31Z","tool":"Write","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\changelog\\\\2026-04-27.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} +{"ts":"2026-04-27T15:45:48Z","tool":"Edit","file":"C:\\\\visual studio code\\\\projekty\\\\aktualia.com.pl\\\\.paul\\\\STATE.md","cwd":"/c/visual studio code/projekty/aktualia.com.pl"} diff --git a/.paul/phases/03-registration-form-settings/03-02-PLAN.md b/.paul/phases/03-registration-form-settings/03-02-PLAN.md new file mode 100644 index 0000000..fe74952 --- /dev/null +++ b/.paul/phases/03-registration-form-settings/03-02-PLAN.md @@ -0,0 +1,283 @@ +--- +phase: 03-registration-form-settings +plan: 02 +type: execute +wave: 1 +depends_on: [] +files_modified: + - _rejestracja/core/model/MfParticipant.class.php + - _rejestracja/controller/IndexController.php + - _rejestracja/template/partial/Index/Index.tpl + - _rejestracja/template/partial/Index/Index_good.tpl + - _rejestracja/template/partial/Index/IndexSent.tpl + - _rejestracja/template/partial/Index/IndexSent_good.tpl + - _rejestracja/Admin/template/partial/Calc/Reg.tpl + - _rejestracja/Admin/controller/CalcController.php + - _rejestracja/sql/2026-04-27-additional-info-field.sql + - _rejestracja/sql/apply-2026-04-27-additional-info-field.php +autonomous: true +delegation: off +--- + + +## Goal +Add a new optional "Dodatkowe informacje" textarea to the registration form (below NIP), with the existing KSeF helper note moved above it. Persist the value to the database, display it in the confirmation summary and admin panel, and reverse the admin Reg table so newest registrations appear first. + +## Purpose +Participants need a free-text field for supplementary information (e.g. internal KSeF identifier). The helper note currently embedded inside the NIP field guides the user to this field, so it must move above the new textarea. The table order reversal makes reviewing new sign-ups faster. + +## Output +- SQL ALTER TABLE migration and PHP runner for the new `additional_info` column (TEXT NULL). +- Updated `MfParticipant` model with `additionalInfo` property, getter, and setter. +- Updated IndexController persisting `additional_info` from POST. +- Updated public form templates: KSeF helper text moved above the new "Dodatkowe informacje" textarea. +- Updated confirmation templates (IndexSent, IndexSent_good) showing the field after NIP. +- Updated admin Reg.tpl showing the field after NIP. +- CalcController RegAction sorted descending by `id_mf_participant`. + + + +## Project Context +@.paul/PROJECT.md +@.paul/ROADMAP.md +@.paul/STATE.md + +## Prior Work +@.paul/phases/01-registration-form-update/01-01-SUMMARY.md + +## Source Files +@_rejestracja/core/model/MfParticipant.class.php +@_rejestracja/controller/IndexController.php +@_rejestracja/template/partial/Index/Index.tpl +@_rejestracja/template/partial/Index/Index_good.tpl +@_rejestracja/template/partial/Index/IndexSent.tpl +@_rejestracja/template/partial/Index/IndexSent_good.tpl +@_rejestracja/Admin/template/partial/Calc/Reg.tpl +@_rejestracja/Admin/controller/CalcController.php + + + + +## AC-1: "Dodatkowe informacje" Field in Public Form +```gherkin +Given a visitor opens the registration form at /_rejestracja/index +When the form renders below the NIP Instytucji field +Then a helper note "Do wypełnienia w przypadku posiadania identyfikatora wewnętrznego w KSEF i prośba o podanie KSeF ID wew." appears above a small textarea labelled "Dodatkowe informacje" that accepts free text and is not required +``` + +## AC-2: Value Persisted to Database +```gherkin +Given a visitor submits the registration form with text in "Dodatkowe informacje" +When the form is processed by IndexController +Then the value is stored in the additional_info column of mf_participant for that participant row +``` + +## AC-3: Field in Confirmation Summary +```gherkin +Given a registration was submitted with a value in "Dodatkowe informacje" +When the confirmation page (IndexSent.tpl / IndexSent_good.tpl) renders +Then the institution data section shows "Dodatkowe informacje: " after NIP Instytucji +``` + +## AC-4: Field in Admin Panel +```gherkin +Given an administrator opens /_rejestracja/Admin/Calc/Reg +When the registration list renders +Then each participant row shows the additional_info value (or empty) in the institution data cell after NIP Instytucji +``` + +## AC-5: Admin Reg Table Reversed Order +```gherkin +Given registrations exist in the mf_participant table +When an administrator opens /_rejestracja/Admin/Calc/Reg +Then the table displays registrations in descending order by id_mf_participant (newest first) +``` + +## AC-6: Deployment Migration +```gherkin +Given the production database does not yet have the additional_info column +When the PHP migration runner is executed +Then ALTER TABLE adds additional_info TEXT NULL DEFAULT NULL without affecting existing rows +``` + + + + + + + Task 1: Add additional_info Column, Model, and Controller Persistence + + _rejestracja/sql/2026-04-27-additional-info-field.sql, + _rejestracja/sql/apply-2026-04-27-additional-info-field.php, + _rejestracja/core/model/MfParticipant.class.php, + _rejestracja/controller/IndexController.php + + + **SQL migration** (`2026-04-27-additional-info-field.sql`): + ```sql + ALTER TABLE `mf_participant` ADD COLUMN `additional_info` TEXT NULL DEFAULT NULL AFTER `nip`; + ``` + Use TEXT (not VARCHAR) to accommodate longer free-text input. + + **PHP runner** (`apply-2026-04-27-additional-info-field.php`): + Follow the same pattern as `apply-2026-04-24-registration-form-settings.php`: + - Require `?run=20260427` query param guard. + - Check INFORMATION_SCHEMA whether `additional_info` column already exists in `mf_participant`. + - Run the ALTER only if missing; print success or skip message either way. + + **MfParticipant.class.php** (`core/model/` only — do NOT edit `core/_model/`): + - Add `'additional_info' => 'additionalInfo'` to `static $fields` array after the `'nip'` entry. + - Add `private $additionalInfo;` property after `$nip`. + - Add `$additionalInfo = null` parameter to `__construct` signature after `$nip`, before `$phone`. + - Assign `$this->additionalInfo = $additionalInfo;` in constructor body. + - Add getter and setter after the existing getNip/setNip block: + ```php + public function getAdditionalInfo() { return $this->additionalInfo; } + public function setAdditionalInfo($additionalInfo) { $this->additionalInfo = $additionalInfo; } + ``` + + **IndexController.php**: + After `$objParticipant->setNip(Request::GetPost('nip'));` add: + ```php + $objParticipant->setAdditionalInfo(Request::GetPost('additional_info')); + ``` + Do not touch any other part of IndexController. + + + - `php -l _rejestracja/core/model/MfParticipant.class.php` — no syntax errors + - `php -l _rejestracja/controller/IndexController.php` — no syntax errors + - `php -l _rejestracja/sql/apply-2026-04-27-additional-info-field.php` — no syntax errors + - Confirm `getAdditionalInfo` and `setAdditionalInfo` methods and `'additional_info' => 'additionalInfo'` in `$fields` exist. + + AC-2 and AC-6 satisfied: additional_info column migration ready, model maps it, controller persists from POST. + + + + Task 2: Public Form — Move Helper Text, Add "Dodatkowe informacje" Textarea + + _rejestracja/template/partial/Index/Index.tpl, + _rejestracja/template/partial/Index/Index_good.tpl + + + **Index.tpl** — current NIP block (lines ~74–79) looks like: + ```html +
+
{translate word='NIP Instytucji'}:
+
+ {formField name="nip" type="text" errorClass="warning"} +
{translate word='Do wypełnienia w przypadku posiadania identyfikatora wewnętrznego w KSEF i prośba o podanie KSeF ID wew.'}
+
+
+ ``` + Replace with two blocks: + 1. NIP entry with helper `
` removed — NIP value div contains only the formField. + 2. New entry immediately after NIP: + ```html +
+
Dodatkowe informacje:
+
+
{translate word='Do wypełnienia w przypadku posiadania identyfikatora wewnętrznego w KSEF i prośba o podanie KSeF ID wew.'}
+ +
+
+ ``` + Use a raw ` +
+
{translate word='registration_submit_talk'}
diff --git a/_rejestracja/template/partial/Index/IndexSent.tpl b/_rejestracja/template/partial/Index/IndexSent.tpl index 20fcf2c..bb7f652 100644 --- a/_rejestracja/template/partial/Index/IndexSent.tpl +++ b/_rejestracja/template/partial/Index/IndexSent.tpl @@ -38,6 +38,7 @@ Kod pocztowy: {$objParticipant->getPostCode()|default:$registrationMissing}
Miejscowość: {$objParticipant->getCity()|default:$registrationMissing}
NIP Instytucji: {$objParticipant->getNip()|default:$registrationMissing}
+ Dodatkowe informacje: {$objParticipant->getAdditionalInfo()|default:$registrationMissing}
diff --git a/_rejestracja/template/partial/Index/IndexSent_good.tpl b/_rejestracja/template/partial/Index/IndexSent_good.tpl index d77f100..5e8d0ee 100644 --- a/_rejestracja/template/partial/Index/IndexSent_good.tpl +++ b/_rejestracja/template/partial/Index/IndexSent_good.tpl @@ -30,6 +30,7 @@ Kod pocztowy: {$objParticipant->getPostCode()|default:'brak'}
Miejscowość: {$objParticipant->getCity()|default:'brak'}
NIP Instytucji: {$objParticipant->getNip()|default:'brak'}
+ Dodatkowe informacje: {$objParticipant->getAdditionalInfo()|default:'brak'}
diff --git a/_rejestracja/template/partial/Index/Index_good.tpl b/_rejestracja/template/partial/Index/Index_good.tpl index 261b6c2..b42eeee 100644 --- a/_rejestracja/template/partial/Index/Index_good.tpl +++ b/_rejestracja/template/partial/Index/Index_good.tpl @@ -73,7 +73,14 @@
{translate word='NIP Instytucji'}:
{formField name="nip" type="text" errorClass="warning"}
-
+ +
+
Dodatkowe informacje:
+
+
{translate word='Do wypełnienia w przypadku posiadania identyfikatora wewnętrznego w KSEF i prośba o podanie KSeF ID wew.'}
+ +
+
Zgłaszam referat