KISSJ - Keep It Simple Stupid for Jamborees!

kissj is scouts registration system for national and international Scout Jamborees with simple idea - it has to be stupidly simple!

Core features:

get information from participants as easy as possible
administrator one-click approving with automatic payment generation
one-click exporting health, logistic and full information for later usage
currently supporting roles:
- IST (International Service Team)
- Patrol (Patrol Leader + number of Participants, registered by Patrol Leader)
- guests
backend full administration for event registration team - access to participants data with edit possibility
no use of unsafe or forgettable passwords in process of registration - you need just an email!

KISSJ is not:

User Event Management system
System for food distribution, health information or safety incidents repository
system for program choosing or different event talk lines chooser
accountancy software
bloatware

Useful links

main page: https://kissj.net/
analytics: https://plausible.io/kissj.net
monitoring/uptime: https://uptime.mareshq.com/status
sentry: https://sentry.mareshq.com/organizations/skautdevs/

Local setup with PostgreSQL

Prerequisites

Installed docker
Installed docker-compose
Installed make

Setup

clone this repository: git clone https://github.com/SkautDevs/kissj.git
Run the make target, so you don't have to do everything manually: make local-dev-postgresql
Open http://localhost:8080/v2/event/test-event-slug/ in your browser

Devstack

Slim framework 4 - handles routing and middleware
LeanMapper as ORM
SQLite3 as database
php-di for dependency injection
& more in composer.json

Backlog

Backlog is in project github issues

Standards

PSR-3 for logging
PSR-4 for autoloading
PSR-7 for HTTP requests/responses
PSR-15 for middlewares
directories honoring Separation of Concerns
KISS + YAGNI

Possible problems & fixies

Database could not be read

databasefile db.sqlite and its directory must be writable by execution program

Random errors on DB

make sure you have all PHP extensions by running composer update

STMP connection error

if TLS is not working correctly, try set 'SMTPAuth' => false and/or 'disable_tls' => true

Local mail service at Linux/Mac

using https://gist.github.com/raelgc/6031274 and on Linux Mint works like a charm!
on others:
- https://serverfault.com/questions/184138/quick-linux-mail-server-setup-for-programming
  - good to setup the aliases, so that the mail falls into your account's mailbox
  - installing procmail fixed it for me (instead of postfix)
- easier than setting up thinderbird is just typing mail in commandline