No description
  • Kotlin 40.5%
  • PHP 39.3%
  • Vue 15.6%
  • JavaScript 2.3%
  • Shell 1.8%
  • Other 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Christian Wiwie 56b35f11f4
All checks were successful
Release / release (push) Successful in 3m40s
Smoke / toolchain (push) Successful in 2s
release: Version 0.4.61 in info.xml und versionName
2026-11-09 22:55:44 +01:00
.forgejo/workflows ci: Gradle-Distribution in das Builder-Image backen 2026-11-08 11:07:11 +01:00
android release: Version 0.4.61 in info.xml und versionName 2026-11-09 22:55:44 +01:00
ci ci: Wrapper-Hash-Verzeichnis korrigiert (Base36 des MD5, nicht Hex) 2026-11-08 11:17:41 +01:00
docs/superpowers/specs spec: Supplementary Links (mehrere Links pro Wunsch, alle Plattformen) 2026-11-09 21:36:21 +01:00
scripts feat(ci): Install-Script für Forgejo-Releases 2026-10-10 14:01:24 +02:00
server release: Version 0.4.61 in info.xml und versionName 2026-11-09 22:55:44 +01:00
specs feat(server): Karten-Flächen, Link-Vorschau und Dialog-Fix (Spec 003) 2026-10-10 01:23:19 +02:00
.gitignore chore: Agent-Workflow über Git-Worktrees dokumentieren 2026-10-13 16:21:59 +02:00
.ignore chore: Agent-Workflow über Git-Worktrees dokumentieren 2026-10-13 16:21:59 +02:00
AGENTS.md chore: Agent-Workflow über Git-Worktrees dokumentieren 2026-10-13 16:21:59 +02:00
CHANGELOG.md release: Version 0.4.61 in info.xml und versionName 2026-11-09 22:55:44 +01:00
README.md feat(server): Weboberfläche in der Nextcloud-App (Spez 002) 2026-10-08 08:17:49 +02:00

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

  1. wishlist.tar.gz vom jeweiligen Forgejo-Release laden
  2. Nach apps/ entpacken, damit apps/wishlist/appinfo/info.xml existiert
  3. 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