https://github.com/gloggi/qualix
Webapp zur Erfassung und Verwaltung von qualifikationsrelevanten Beobachtungen und Rückmeldungen in J+S-Ausbildungskursen der Pfadi.
https://github.com/gloggi/qualix
hacktoberfest laravel php scouts vuejs
Last synced: 5 months ago
JSON representation
Webapp zur Erfassung und Verwaltung von qualifikationsrelevanten Beobachtungen und Rückmeldungen in J+S-Ausbildungskursen der Pfadi.
- Host: GitHub
- URL: https://github.com/gloggi/qualix
- Owner: gloggi
- License: mit
- Created: 2019-03-10T13:20:32.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-08-04T04:37:47.000Z (11 months ago)
- Last Synced: 2025-08-04T07:32:58.547Z (11 months ago)
- Topics: hacktoberfest, laravel, php, scouts, vuejs
- Language: PHP
- Homepage: https://qualix.flamberg.ch
- Size: 5.58 MB
- Stars: 21
- Watchers: 5
- Forks: 5
- Open Issues: 74
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Qualix
> was gaffsch?
Webapp zur Erfassung und Verwaltung von qualifikationsrelevanten Beobachtungen und Rückmeldungen in J+S-Ausbildungskursen der Pfadi.
Eine Live-Version ist unter verfügbar.
Wir benützen [Phrase](https://phrase.com), um Qualix auch in anderen Sprachen anzubieten.
## Lokale Installation
Qualix ist ein PHP-Projekt basierend auf dem Framework Laravel. Wir verwenden [docker compose](https://docs.docker.com/compose/install/) um es lokal zur Entwicklung laufen zu lassen. Wenn du auf Linux arbeitest, musst du zuerst noch separat [Docker für Linux](https://docs.docker.com/install/#server) installieren.
Um Qualix laufen zu lassen, musst du nur den Quellcode mit Git herunterladen und die Container starten:
```
git clone https://github.com/gloggi/qualix.git
cd qualix
docker compose up
```
Wenn sich der Output beruhigt hat (wenn im Output mehrere Zeilen mit `qualix-npm` und `[emitted]` stehen), kannst du dein lokales Qualix unter und das Datenbank-Tool phpMyAdmin unter aufrufen.
Wenn du E-Mails in deiner Qualix-Kopie auslöst (zum Beispiel beim Passwort-Reset oder wenn du jemanden in einen Kurs einlädst), werden diese nicht wirklich abgesendet, sondern sie landen im Mailcatcher. Du kannst diese Mails unter ansehen.
### Composer, artisan, etc. im Container
Da alles was mit Qualix zu tun hat, inklusive PHP, Composer, artisan, etc. nur im Container läuft, musst du entsprechende Befehle auch in den Container hinein absetzen. Hier ein Paar Beispiele:
```
docker compose exec qualix composer update
docker compose exec qualix php artisan tinker
docker compose exec qualix php -v
```
### Tests laufen lassen
Für sämtliche Tests müssen zuerst die Container laufen (`docker compose up`).
#### PHP Unit Tests
Vor den Unit Tests musst du einmalig die gecachete Config löschen:
```
docker compose exec qualix php artisan config:clear --env=testing
```
Danach kannst du die Unit Tests mit PHPUnit laufen lassen:
```
# Alle Unit Tests
docker compose exec qualix vendor/bin/phpunit
# Nur Unit Tests die "Course" im Namen haben
docker compose exec qualix vendor/bin/phpunit --filter=Course
```
#### Frontend Tests
Die Frontend Tests kannst du wie folgt laufen lassen:
```
# Alle Frontend Tests
docker compose exec node npm run test
# Ein spezifischer Test
docker compose exec node npm run test -- ObservationList
```
#### End-to-end Tests
Du kannst die E2E-Tests mit Cypress headless (ohne sichtbares Browserfenster) laufen lassen:
```
docker compose run e2e run
```
Oder du kannst das grafische Tool von Cypress vom Container aus auf deinem Mac- oder Linux-Computer öffnen:
```
# Nur auf Mac OS: xhost installieren, danach den Computer neu starten
brew cask install xquartz
# Dem Container erlauben, auf dem Host Fenster zu öffnen (nur einmal pro Computer-Neustart nötig)
xhost local:root
# Cypress öffnen
docker compose run e2e open
```
## Produktive Installation
> Qualix basiert auf Laravel 11 und benötigt deshalb eine PHP Version >= 8.2.0
1. **Code herunterladen**: `git clone https://github.com/gloggi/qualix.git && cd qualix`
2. **Server-Einstellungen**: Eine Kopie von .env.example namens .env erstellen und die Angaben darin ergänzen. Zum Beispiel so (kritische Angaben sind mit `` zensiert):
```
APP_NAME=Qualix
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=https://qualix.flamberg.ch
# Set your own contact
#APP_CONTACT_LINK=mailto:info@qualix.flamberg.ch
#APP_CONTACT_TEXT="Kontaktiere Qualix"
LOG_CHANNEL=stack
DB_CONNECTION=mysql
DB_HOST=
DB_PORT=3306
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
MAIL_MAILER=smtp
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=SSL
HITOBITO_BASE_URL=https://db.scout.ch
HITOBITO_CLIENT_UID=
HITOBITO_CLIENT_SECRET=
HITOBITO_CALLBACK_URI=https://qualix.flamberg.ch/login/hitobito/callback
# Collaboration in the feedback editor via WebRTC
COLLABORATION_ENABLED=true
COLLABORATION_SIGNALING_SERVERS="wss://signaling.yjs.dev wss://y-webrtc-signaling-eu.herokuapp.com wss://y-webrtc-signaling-us.herokuapp.com"
SENTRY_LARAVEL_DSN=
SENTRY_CSP_REPORT_URI=
MIX_SENTRY_VUE_DSN=
```
> Für die `HITOBITO_*` Einstellungen, siehe weiter unten.
3. **Backend-Dependencies installieren und `APP_KEY` generieren**: `docker compose run --entrypoint "/bin/sh -c 'composer install --no-dev && php artisan key:generate'" qualix`
4. **Frontend-Code builden**: `docker compose run --entrypoint "/bin/sh -c 'npm install && npm run prod'" node`
5. **Optimierung (optional)**: `docker compose run --entrypoint "composer install --optimize-autoloader --no-dev" qualix`
Siehe [hier](https://laravel.com/docs/9.x/deployment#optimization) für weitere Erklärungen.
6. **Auf den Webhost hochladen**: Z.B. mit FTP alles (Ordner und Dateien) ausser .git, cypress, node_modules und tests hochladen
7. **Mit SSH auf den Server einloggen**, da die folgenden Befehle in der finalen Umgebung ausgeführt werden müssen
8. **Optimierung (optional)**: `php artisan config:cache && php artisan route:cache && php artisan view:cache`
Siehe [hier](https://laravel.com/docs/9.x/deployment#optimization) für weitere Erklärungen.
9. **Datenbank-Tabellen einrichten**: `php artisan migrate`
10. **Laravel Storage-Link einrichten**: `php artisan storage:link`
### Hitobito / MiData Anbindung
Um den Login via MiData (oder eine andere hitobito-Instanz) zu ermöglichen, muss man Qualix auf hitobito als erlaubte OAuth-Applikation registrieren. Dafür muss der jeweilige Dachverband kontaktiert werden. Bei der MiData stellt die PBS dafür ein [Antragsformular](https://forms.office.com/Pages/ResponsePage.aspx?id=iq6Fcs2Xq0m9ordFTZ0Fa8gnQG-i3p9KkbcKGL9nFhtUMEpMQkYwMzQxNUVEWEIxRTNWTDhPMDVEMS4u) zu Verfügung. Der Dachverband (z.B. die PBS) kann dann die Werte für die `HITOBITO_*` Variabeln in der .env-Datei liefern.