Project-Pro/aktualia.com.pl
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
aktualia.com.pl/.paul/phases/03-registration-form-settings/03-01-SUMMARY.md
Jacek Pyziak 508623c642 feat(03-registration-form-settings): editable form settings, additional info field, codebase map 
Phase 3 complete (2 plans):

- 03-01: RegistrationFormSettings helper + admin Ustawienia formularza page; public form and server-side pricing driven by wp_setup/mf_parameters settings; SQL seed + PHP runner for production deployment
- 03-02: Dodatkowe informacje textarea field added to form/DB/confirmations/admin; admin Reg table reversed; codebase map written to .paul/codebase/ (8 docs)

Milestone v0.1 XXXV Konferencja Registration Update — complete.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-27 18:00:34 +02:00

6.7 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 tags requires provides affects tech-stack key-files key-decisions patterns-established duration started completed
03-registration-form-settings 01 ui
php
smarty
wp_setup
mf_parameters
admin
registration
pricing
phase provides
02-registration-dictionary-phrases dictionary-backed phrase system for registration text
RegistrationFormSettings helper (centralized editable day/price values)
Admin "Ustawienia formularza" page with full CRUD for days and prices
Public registration form reading all values from settings (no hardcoded prices)
SQL + PHP deployment seed for new wp_setup variables
any future phase touching registration pricing or public form flow
added patterns
wp_setup as key-value store for scalar/list settings
mf_parameters for price rows
created modified
_rejestracja/core/class/RegistrationFormSettings.class.php
_rejestracja/Admin/controller/FormSettingsController.php
_rejestracja/Admin/template/partial/FormSettings/Index.tpl
_rejestracja/sql/2026-04-24-registration-form-settings.sql
_rejestracja/sql/apply-2026-04-24-registration-form-settings.php
_rejestracja/Admin/controller/DictionaryController.php
_rejestracja/Admin/controller/SetupController.php
_rejestracja/controller/IndexController.php
_rejestracja/template/partial/Index/Index.tpl
Day labels stored as newline-separated text in wp_setup — avoids schema changes
One-day prices stored in wp_setup; full conf/surcharge prices kept in mf_parameters rows (IDs 1–5)
Gross price in JS computed as net * VAT multiplier — not hardcoded
wp_setup used for new scalar/list settings with registration_form_ prefix
mf_parameters rows referenced by stable IDs 1–5 for existing calculator prices
~2h 2026-04-24T21:00:00Z 2026-04-24T23:04:32Z

Phase 3 Plan 01: Registration Form Settings Summary

Admin "Ustawienia formularza" page built with RegistrationFormSettings helper; public form and server-side pricing fully driven by configurable values from wp_setup and mf_parameters.

Performance

Metric Value
Duration ~2h
Started 2026-04-24T21:00:00Z
Completed 2026-04-24T23:04:32Z
Tasks 3 completed
Files modified 9

Acceptance Criteria Results

Criterion Status Notes
AC-1: Admin Menu Entry Pass "Ustawienia formularza" added to Dictionary, Setup, and FormSettings controllers
AC-2: Editable Participation Days Pass Day labels from wp_setup drive Smarty loops in Index.tpl
AC-3: Editable Calculation Prices Pass JS calculatePrice and server-side saved price use configured values
AC-4: Deployment Seed Pass SQL + PHP runner inserts defaults only when missing (idempotent)

Accomplishments

  • Created RegistrationFormSettings (211 lines) centralizing day lists, VAT multiplier, one-day prices, and mf_parameters price rows
  • Built admin FormSettingsController + Index.tpl grouped by participation days, main prices, surcharges, one-day prices, VAT
  • Replaced all hardcoded day labels and prices in public Index.tpl and IndexController.php with settings-driven values
  • Added SQL seed + guarded PHP runner for production deployment

Task Commits

Task Commit Type Description
Task 1: Shared Settings Helper ed2f895 feat RegistrationFormSettings + SQL seed files
Task 2: Admin Form Settings Page ed2f895 feat FormSettingsController, Index.tpl, menu links
Task 3: Public Form Settings Use ed2f895 feat IndexController + Index.tpl using settings

All three tasks landed in single commit ed2f895 (committed together as part of manual apply session).

Files Created/Modified

File Change Purpose
_rejestracja/core/class/RegistrationFormSettings.class.php Created (211 lines) Centralized read/write helper for all editable form values
_rejestracja/Admin/controller/FormSettingsController.php Created (61 lines) GET/POST handler for the new admin settings page
_rejestracja/Admin/template/partial/FormSettings/Index.tpl Created (72 lines) Admin form UI grouped by value category
_rejestracja/sql/2026-04-24-registration-form-settings.sql Created (22 lines) Raw SQL seed for wp_setup variables
_rejestracja/sql/apply-2026-04-24-registration-form-settings.php Created (145 lines) Guarded PHP runner for production deployment
_rejestracja/Admin/controller/DictionaryController.php Modified Added "Ustawienia formularza" menu entry
_rejestracja/Admin/controller/SetupController.php Modified Added "Ustawienia formularza" menu entry
_rejestracja/controller/IndexController.php Modified Loads settings, passes to Smarty/JS, saves one-day price from settings
_rejestracja/template/partial/Index/Index.tpl Modified Smarty foreach loops for day options; JS prices from settings

Decisions Made

Decision Rationale Impact
Day labels as newline-separated text in wp_setup Avoids schema changes while supporting list values Admin edits plain text area; split on render
Keep IDs 1–5 in mf_parameters for full conf/surcharge prices Preserves compatibility with existing calculator/admin No migration needed for prices already stored
Gross = net × VAT multiplier (computed) VAT multiplier now configurable; no hardcoded gross values Changing VAT multiplier updates JS preview automatically

Deviations from Plan

Summary

Type Count Impact
Auto-fixed 0 —
Scope additions 1 Minor — KSeF ID helper note added under NIP field
Deferred 0 —

Total impact: Minimal — single cosmetic addition, no scope creep on core functionality.

Scope Addition

KSeF NIP helper note (in-plan follow-up noted in APPLY.md)

  • A small informational note was added under the public NIP field
  • Did not change field names or form behavior
  • Committed as part of Task 3

Issues Encountered

None — plan executed cleanly.

Next Phase Readiness

Ready:

  • All four ACs satisfied; admin page fully functional
  • SQL seed and PHP runner ready for production deployment (_rejestracja/sql/apply-2026-04-24-registration-form-settings.php?run=20260424)
  • Public form completely decoupled from hardcoded day/price values
  • Phase 3 plan 01 complete; plan 02 (codebase map) also complete

Concerns:

  • Production must apply the seed runner before new wp_setup settings are visible/editable

Blockers:

  • None (same production note applies as Phase 2)

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

Reference in New Issue View Git Blame Copy Permalink