- Kotlin 40.5%
- PHP 39.3%
- Vue 15.6%
- JavaScript 2.3%
- Shell 1.8%
- Other 0.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .forgejo/workflows | ||
| android | ||
| ci | ||
| docs/superpowers/specs | ||
| scripts | ||
| server | ||
| specs | ||
| .gitignore | ||
| .ignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| README.md | ||
Wishlist
Wunschlisten für die Familie — eine eigene Nextcloud-App plus ein Android-Client. Die Söhne browsen auf Tablets und Handys, teilen einen Link über die System-Share-Sheet und landen mit Produktbild in ihrer Liste. Die Eltern lesen dieselben Listen, um Geschenke zu kaufen.
Kein Fork, kein Fremdcode. Von Grund auf gebaut.
Aufbau
server/ Nextcloud-App `wishlist` (PHP, OCS-API) + Weboberfläche (Vue, Vite)
android/ Android-Client (Kotlin, Jetpack Compose)
docs/ Design-Spezifikation
specs/ Spec-/Plan-/Task-Artefakte
.forgejo/ Release-Workflow
Die Weboberfläche liegt als Quelle in server/src/ und wird nach server/js/
gebaut (cd server && npm ci && npm run build). Ins Paket wandert nur das
Gebaute: src/, package.json, package-lock.json, vite.config.js und
node_modules/ schließen .nextcloudignore und die handkopierte Liste im
Workflow aus, js/ nicht. Beide Listen muss man zusammen halten —
ci/integration/build-tarball.sh prüft das anhand des fertigen Tarballs.
Das Design steht in
docs/superpowers/specs/2026-10-05-wishlist-design.md
(freigegeben 2026-10-05). Es ist die verbindliche Referenz für Datenmodell, API,
Fehlerverhalten und Umfang — insbesondere für die bewusst ausgesparten Teile in §2.
Nextcloud-App installieren
wishlist.tar.gzvom jeweiligen Forgejo-Release laden- Nach
apps/entpacken, damitapps/wishlist/appinfo/info.xmlexistiert occ app:enable wishlist
appstoreenabled und apps.nextcloud.com werden nicht gebraucht.
Android-App installieren
wishlist.apk vom Forgejo-Release laden und installieren. Für die Quelle
„Unbekannte Quellen" erlauben.
Release erzeugen
Ein Tag genügt:
git tag -a v0.1.0 -m "Erste Version"
git push origin v0.1.0
Der Workflow prüft, dass Tag, server/appinfo/info.xml und versionName in
android/app/build.gradle.kts übereinstimmen, baut APK und Tarball und legt ein
Release mit beiden Artefakten an.
Die CI läuft auf einem eigenen Forgejo-Runner mit dem Label android. Der
Job-Container kommt aus ci/android-builder/Dockerfile und bringt JDK 17,
Android SDK 36 (inkl. build-tools), PHP 8.2, Composer 2 und Node 20 mit —
ohne Node im Container scheitert schon checkout, deshalb gehört es ins Image.
Node wird zusätzlich für den Paketbau gebraucht: der Schritt Nextcloud-Paket
bauen führt vor dem Kopieren nach staging npm ci && npm run build in
server/ aus und bricht ab, wenn dabei kein server/js/ entsteht. Ohne diesen
Schritt entstünde ein Tarball ohne Weboberfläche, bei dem alle PHP-Tests grün
blieben — genau das fängt die Assertion in ci/integration/build-tarball.sh ab.
ANDROID_HOME ist gesetzt, local.properties ist überflüssig.
Angelegt ist der Runner als Compose-Service wishlist-runner in
/home/chris/git/gitea/docker-compose.yml, die Config liegt unter
/home/chris/git/wishlist-runner/. Er ist repo-scoped auf dieses Repository
registriert. Der Job hängt am Netz gitea_gitea, nicht an host — sonst
erreicht checkout den internen Clone-URL http://gitea:3000 nicht.
Zum Prüfen ohne Release: .forgejo/workflows/smoke.yml, manuell auslösbar über
Actions → Smoke → Run workflow.
Für ein Release braucht es zusätzlich die Repo-Secrets KEYSTORE_BASE64,
KEYSTORE_PASSWORD, KEY_ALIAS. KEY_PASSWORD gibt es bewusst nicht: der
Keystore ist PKCS12 und kennt nur ein Passwort, das oben als
KEYSTORE_PASSWORD gesetzt wird. Ein zweiter, abweichender Wert ließe die
Signatur fehlschlagen (Given final block not properly padded), obwohl
Keystore und Passwort stimmen.
Keystore erzeugen (einmalig)
Das Signierungsschlüsselpaar gehört dir und nur dir. Es liegt nirgends außer auf deinem Rechner — wer es verliert, kann den installierten Geräten keine Updates mehr liefern, weil die Signatur nicht mehr übereinstimmt. Anlegen, Sicherungskopie, dann Passwörter in einem Passwortmanager:
# PKCS12 (ab JDK 9 ohnehin Vorgabe) kennt nur EIN Passwort. keytool fragt
# zwar einmal "Enter key password for <alias>" und meint damit dann den
# Keystore-Passwort; ein abweichender -keypass wird still verworfen.
keytool -genkeypair -v \
-storetype PKCS12 \
-keystore release.jks \
-alias wl1523 \
-keyalg RSA -keysize 4096 -validity 10000
# base64 für das Secret KEYSTORE_BASE64 (Linux):
base64 -w0 release.jks
Die drei Repo-Secrets unter Settings → Secrets and Variables → Actions
eintragen: KEYSTORE_BASE64, KEYSTORE_PASSWORD, KEY_ALIAS (z. B. wl1523
— der Alias muss dem entsprechen, den keytool beim Anlegen nannte).
release.jks ist über .gitignore ausgeschlossen.
Lizenz
AGPL-3.0