PreRegister

Laravel 11 app for festival ticket pre-registration: branded public landing pages, local subscriber storage, and optional sync to Mailwizz (API key per page, encrypted at rest).

Tech stack

Layer	Choice
Backend	PHP 8.2+, Laravel 11, MySQL 8
Frontend (public + admin)	Blade, Tailwind CSS 3, Alpine.js 3
Auth	Laravel Breeze (Blade stack)
Queue	Database driver; Mailwizz sync on `mailwizz` queue

Not used: React, Vue, Livewire, or Inertia.

Requirements

PHP ≥ 8.2 (extensions: mbstring, xml, curl, pdo_mysql, gd)
Composer ≥ 2.7
Node.js ≥ 20 (for Vite / Tailwind)
MySQL 8 (local or Docker)

Local setup

Clone and install PHP dependencies
```
composer install
```

Environment

cp .env.example .env
php artisan key:generate

Configure database (example for Docker MySQL on localhost):

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=preregister
DB_USERNAME=preregister
DB_PASSWORD=preregister

QUEUE_CONNECTION=database

Mailwizz API keys are not in .env; they are stored per pre-registration page in the database (encrypted).

Docker (optional)

From the project root:
```
make up
# or: docker compose up -d
```
See documentation/Setup.md for MySQL, Mailpit, and phpMyAdmin ports.
Database
```
php artisan migrate --seed
```
Storage link (uploads)
```
php artisan storage:link
```

Frontend build

npm install
npm run build
# or during development: npm run dev

Run the app
```
php artisan serve
```
Admin UI lives under /admin (after login). Public pre-registration URLs are /r/{uuid-slug}.
Queue worker (Mailwizz sync)
```
php artisan queue:work --queue=mailwizz
```
Use Supervisor or your host’s process manager in production.

php artisan db:seed creates a superadmin (via SuperadminSeeder):

Email: admin@preregister.app
Password: changeme123!

Change this password immediately in any shared or production environment. Additional users are created by a superadmin in Admin → Users. Sign in at /login.

Deployment notes

Run php artisan migrate (and --seed only on first deploy if you rely on seed data).
Run php artisan storage:link so public/storage serves uploaded backgrounds and logos.
Run a queue worker on the mailwizz queue (or queue:work without --queue if you only use the default queue and push jobs there consistently).
Set APP_KEY, use HTTPS behind a reverse proxy, and configure APP_URL correctly.
Optional: cron for * * * * * php /path/to/artisan schedule:run if you add scheduled tasks.

More detail: documentation/DEPLOYMENT-STRATEGY.md.

Product specification

Full functional spec and development sequence: documentation/Pregister-Development-Prompt.md.

Security

Public subscribe endpoint is rate limited (throttle:10,1).
CSRF on web forms; policies for admin resources.
Never expose Mailwizz API keys in responses, logs, or the browser.

License

Application code follows your project’s license. Laravel is open source under the MIT license.

3.5 KiB Raw Blame History Unescape Escape