IfRPG – Informatik-Rollenspiel

IfRPG ist eine servergestützte Plattform für browserbasierte Informatik- Rollenspiele. Die Plattform liefert Engine, Player, Aufgabenlaufzeiten einschließlich Java, H5P und SQL, serverautoritativen Fortschritt, Teaching, Authoring, Administration und eine Registry für unveränderliche Releases.

Ein Plattformrelease enthält ausschließlich:

• ifrpg/api
• ifrpg/migrate
• ifrpg/web
• das versionierte Deployment-Bundle

GamePacks, AssetPacks und PackSets werden unabhängig von ihren Autoren veröffentlicht. Sie können öffentlich oder token-geschützt über die Registry freigegeben werden. Eine neue Instanz startet absichtlich mit null Packs und null PackSets.

Die Dokumentation beschreibt den zugehörigen Quellstand, nicht automatisch einen bereits veröffentlichten Release. Für installierte Instanzen gilt die Anleitung zum eingesetzten Release.

Einstieg

• Neue Instanz installieren
• Neuen Kurs starten
• Spieler-Dokumentation
• Lehrkräfte-Dokumentation
• Autoren-Dokumentation
• Admin-Dokumentation

Plattformbestandteile

• apps/web: React/Vite-Player, Teaching-, Authoring- und Adminoberflächen
• apps/api: NestJS/Fastify-Modularmonolith
• packages/core: Contracts, Content-, Rule-, Progress- und PackSet-Domänen
• PostgreSQL: dauerhafte Identitäts-, Contentmetadaten- und Progressautorität
• Redis: Sessions und Rate-Limits, keine dauerhafte Progressautorität
• externe Content-/Authoring-/Git-Work-Pfade: niemals Bestandteil der Images
• external/java-ide: klar begrenztes Upstream-Submodul für die Java-IDE

Lokale Entwicklung

Der ressourcenschonende Standard nutzt Docker nur für PostgreSQL, Redis und MySQL für SQL-Aufgaben. API, Vite und Hilfsdienste laufen auf dem Host.

Entwicklungsablauf und aufgabenbezogene Dokumentation stehen in CONTRIBUTING.md, verbindliche Agentenregeln in AGENTS.md und die Werkzeugauswahl in AGENT_TOOLS.md.

npm ci --include=dev --ignore-scripts
npm rebuild esbuild --foreground-scripts
npm run dev

Das DB-freie Standardgate:

env -u DATABASE_URL npm run db:generate
env -u DATABASE_URL npm run verify

Integrationstests benötigen eine explizite isolierte DATABASE_URL und REDIS_URL:

npm run verify:integration

Produktionsbundles und Multi-Arch-Images werden in Forgejo CI gebaut. Normale lokale Entwicklung baut keine Produktimages.

Deployment

Das pack-neutrale Bundle unter deploy/ wird mit ifrpgctl betrieben:

cd deploy
./ifrpgctl init --origin https://ifrpg.example.org
./ifrpgctl doctor
./ifrpgctl up
./ifrpgctl bootstrap-admin

Contentpublikation ist kein Deploymentschritt. Details stehen in der Admin-Dokumentation.

Release- und Sicherheitsgrenzen

• Plattformtags veröffentlichen keine Inhalte.
• Jede Releaseabhängigkeit bleibt exakt gepinnt und hashgeprüft.
• Git-/Registry-Credentials erreichen weder Browser noch Export oder Logs.
• Datenschutz, Impressum und Über-uns-Texte bleiben als InstanceContent UI-/DB-verwaltet.
• Das Repository startet als unveröffentlichte Plattformbaseline; es gibt noch kein automatisch erzeugtes v1.0.0.