Project-Pro/aktualia.com.pl

Files

2026-04-24 18:52:49 +02:00

7.3 KiB

Raw Permalink Blame History

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, duration, started, completed

phase

plan

subsystem

Phase 1 Plan 01: Registration Form Update Summary

Updated the Aktualia registration flow so the public form, database persistence, confirmation email, and admin panel support the client-requested XXXV Konferencja fields.

Performance

Metric	Value
Duration	Same session
Started	2026-04-24
Completed	2026-04-24
Tasks	3 completed
Files modified	8 modified, 2 created

Acceptance Criteria Results

Criterion	Status	Notes
AC-1: Public Form Matches DOCX	Pass	Form includes invoice data, talk/poster data, consents, 2026 fee timing, full conference, one-day with lodging, one-day without lodging, fixed day choices, surcharges, diet preference, and price display. Two-day/three-day options were removed after clarification.
AC-2: Submitted Values Are Persisted	Pass	New fields are mapped in `MfParticipant`, assigned in `IndexController`, and covered by SQL/PHP migration.
AC-3: Pricing And Day Options Are Correct	Pass with caveat	Visible one-day/full options calculate as before; final validation still depends on live/staging submission after DB migration.
AC-4: Admin Panel Shows New Registration Data	Pass	Admin list/detail show participation type, days, diet, room surcharge, accompanying person/kierowca; `RegEditAction` supports payment status update.
AC-5: Confirmation Output Includes New Data	Pass	Confirmation/email summary includes participation labels, selected days, surcharges, diet, and final price. Technical values are mapped to Polish labels.

Accomplishments

Added persistence for participation option, selected days, lodging flag, diet/special diet, single-room surcharge, and accompanying person/kierowca.
Replaced legacy free-text day input with explicit date choices from the client document.
Added an idempotent PHP migration runner for server-side database updates.
Updated admin views so the newly collected data is visible and registration details are reachable through edytuj.

Files Created/Modified

File	Change	Purpose
`_rejestracja/sql/2026-04-24-registration-form-update.sql`	Created	Add new `mf_participant` columns.
`_rejestracja/sql/apply-2026-04-24-registration-form-update.php`	Created	Idempotent server-side migration runner.
`_rejestracja/core/model/MfParticipant.class.php`	Modified	Runtime model fields, getters, setters, DB mappings.
`_rejestracja/core/_model/MfParticipant.class.php`	Modified	Mirrored model fields for generated/model copy.
`_rejestracja/controller/IndexController.php`	Modified	Save new POST values and derive canonical participation option/days.
`_rejestracja/template/partial/Index/Index.tpl`	Modified	Public form fields, day radios, diet fields, 2026 payment date, removed obsolete options.
`_rejestracja/template/partial/Index/IndexSent.tpl`	Modified	Mail/confirmation output for new fields with Polish labels.
`_rejestracja/Admin/controller/CalcController.php`	Modified	Added `RegEditAction` and payment status update handling.
`_rejestracja/Admin/template/partial/Calc/Reg.tpl`	Modified	Admin list shows new registration fields and edit link.
`_rejestracja/Admin/template/partial/Calc/RegEdit.tpl`	Modified	Admin detail shows new registration fields.

Verification Results

Check	Status
`php -l _rejestracja/core/model/MfParticipant.class.php`	Pass
`php -l _rejestracja/core/_model/MfParticipant.class.php`	Pass
`php -l _rejestracja/controller/IndexController.php`	Pass
`php -l _rejestracja/Admin/controller/CalcController.php`	Pass
`php -l _rejestracja/sql/apply-2026-04-24-registration-form-update.php`	Pass
Search for removed options in active form	Pass

Decisions Made

Decision	Rationale	Impact
Keep canonical DB values like `one_day_no_lodging`, but map them in templates	Stable storage, readable user/admin output	Mail/admin show Polish labels instead of technical strings.
Remove visible two-day and three-day options	User clarified these are not wanted from the document	Active form only exposes full conference and one-day variants.
Replace text day input with radios	User clarified fixed choices should replace free text	Stored value comes from `participation_days`.
Add PHP migration runner	User requested DB migration via PHP script	Migration can be run by URL/CLI and skips existing columns.

Deviations from Plan

Type	Count	Impact
Scope correction	2	Removed two-day/three-day options and old text day field based on user clarification.
Runtime discovery	1	Updated `core/model` as actual autoload target, mirrored `_model`.
Tooling addition	1	Added PHP migration runner in addition to SQL file.

Issues Encountered

Issue	Resolution
Legacy encoding/mojibake in templates	Corrected newly added Polish labels to UTF-8 and avoided broad edits to older unrelated text.
Technical participation value appeared in mail	Added template mapping to Polish display labels.
Not a git repository	No phase commit could be created; documented as environment limitation.

Next Phase Readiness

Ready:

Form, persistence, confirmation output, admin display, SQL migration, and PHP migration runner are implemented.

Concerns:

Live/staging database must run the migration before new submissions can persist new columns.
This legacy codebase has duplicate model directories; keep core/model and core/_model aligned for participant changes.

Blockers:

None for this requested change after migration is applied.

Phase: 01-registration-form-update, Plan: 01 Completed: 2026-04-24

7.3 KiB Raw Permalink Blame History