ROCKVIEW UNIVERSITY SLPS — ELECTORAL COMMISSION REGISTRATION BUILDER UPDATE

WHAT THIS UPDATE ADDS
1. An election-specific Voter Registration Form Builder inside each created election.
2. Fixed identity verification fields: student number and full name; optional email.
3. Up to 20 additional questions (short text, long answer, dropdown, date), with required settings.
4. Draft saving, publishing, a public registration URL and copy-link action.
5. A standalone public registration page styled as an official Rockview University Electoral Commission page.
6. Public registration records the student number and full name as submitted. It does not compare student numbers, names or email addresses against the university student database.
7. Successful submissions are automatically inserted into the approved voter register for that election. Duplicate registrations are rejected. Optional question answers are retained in ec_voters.registration_data.
8. Candidate profile cards redesigned with large portrait photographs, position, name, programme, biography, manifesto disclosure and status/actions. Candidate photo upload is mandatory in the staff form and the API blocks approval without a photograph.
9. Existing ordinary Data Collections and Electoral Data Collections remain separate. The new builder does not create or modify Data Collection forms.

INSTALLATION
1. BACK UP the existing SLPS files and database first.
2. Upload this ZIP to the directory that contains your existing slps folder (for example public_html), then extract it there. The archive already contains the slps/ prefix, so files will merge into slps/shared/... and slps/database/... . Do NOT extract it inside slps/ itself.
3. In phpMyAdmin, select the SLPS database and run:
   database/migrations/20261103_electoral_voter_registration_link.sql
   This creates ec_election_registration_forms and adds ec_voters.registration_data.
4. Confirm the earlier Electoral Commission migrations have already been applied:
   20261102_electoral_commission.sql
   20261103_electoral_voter_register_polling_stations.sql
   The Phase 2 migration adds source_student_id and polling-station tables.
5. After extraction, confirm that slps/shared/views/electoral_commission_workspace.php and slps/electoral-registration.php have been replaced/created. Then sign in as staff/admin, open Electoral Commission, open an election, then select Registration Form.
6. Configure the title, introduction and any additional questions. Save Draft while editing; select Publish Registration Form to activate the public link.
7. Copy the public link and share it through the university website, WhatsApp, Facebook or other channels.
8. Test with an active student account using the exact student number and full name stored in the SLPS database. Confirm the voter appears under that election's Voter Register with Approved status.

IMPORTANT SECURITY / WORKFLOW NOTES
- The public link is for voter registration only. It is not a voting or ballot link.
- Student details are collected for the election and are not checked against the existing university student database. The public form does not create a university student account.
- A student already approved for the election cannot register a second time.
- Unpublishing is done by saving the form as Draft; this disables the public link until republished.
- Candidate photographs are staff-managed. Candidates cannot be approved until a photo has been uploaded.
- The existing polling-station records are administrative setup only. This update does NOT implement station computer pairing, supervised voter verification, or the live ballot-casting workflow. Do not use this package as confirmation that end-to-end voting is ready.

DEPLOYMENT CHECKS
- PHP syntax checked for the changed API and public registration page.
- JavaScript syntax checked for the Electoral Commission workspace.
- ZIP integrity checked before distribution.
- A live database/deployment test could not be performed in this environment. Run the test procedure above on a staging copy before production use.


VISUAL REDESIGN NOTES
- The public page now uses the Rockview University logo, a white official form layout, clear labels, generous spacing, and a green submission action, following the supplied reference screenshot.
- The form is responsive for desktop and mobile screens.
- The builder preview and helper text now correctly state that student details are recorded as submitted and are not matched against university records.
- PHP syntax and JavaScript syntax were checked; ZIP integrity was checked. A live server/database test was not possible here.
