r-io suiter-io suitereference docs
← Documentation home
Applications / r-io4U / In a browser

In a browser: r-io4U served by r-io suite

Every distribution of r-io suite serves the web build of r-io4U next to r-ioga: a phone opens it from a QR code, with nothing to install. The Android application stays available and keeps its own settings.

No capture of the tile interface yet: the captures of the r-io4U overview predate the redesign of November 2026 and show the former menus.

01

Built into the distribution

The Flutter module dart/frontend/gind_r_io4u is installed with Maven before the distribution (Flutter required, FLUTTER_HOME set). Its build regenerates the Dart models from the XSD, then runs flutter build web; -Drio4u.web.skip=true skips the web build. The distribution module gind-r-io-standalone adds it through the rio4u-web profile, active by default; without Flutter, build the distribution with -Dno-rio4u. The steps are in the README of the repository.

02

Opening it on a phone

The QR code is shown at the right of the Projects workspace title bar of r-ioga, and in Settings → Show the r-io4U QR code in the header of the web applications. The phone and the server on the same network, the camera of the phone reads it and opens r-io4U; the user logs in with the account of a person of the use case. Opened on the server itself (localhost), the code holds the network address of the server, the one a phone reaches; behind a proxy, it holds the address of the page.

03

The services found from the page

Served by r-io suite, r-io4U takes the address of the server from its own page, whatever is stored in its settings: straight on the server, it reads the ports of r-ioga, r-ioda and r-iose from r-ioga (generic-application/context/webApplications); behind a proxy, every service is reached on the same address, by its path. Nothing is typed. The Android application keeps Settings → Connexion: server address, ports of r-ioga, r-ioda, r-iose and a ping of the server.

04

What works over HTTP

A distribution is served over HTTP. A browser gives the location, the microphone and the camera of the device only over HTTPS or on localhost: over the network in HTTP, r-io4U says so once at login and on the dictation button of the chat. The tasks, the map, the chat and the pictures chosen from the phone work; the login itself works over HTTP. On a server, a reverse proxy on port 443 gives HTTPS on the same address; it must relay /r-ioga, /r-ioda, /r-iose and /ws/pubsub.

05

Notifications of the phone

Over HTTPS (or on localhost), r-io4U offers once after login to receive the notifications of the phone; the browser asks its permission on the tap. Settings → Functionalities → Notifications on this phone turns them on or off, and Send a test notification sends one to the browsers of the user. The system of the phone then shows, even when r-io4U is closed:

A tap opens r-io4U on the tasks, the alerts or the group of the message, after the login if needed. On an iPhone, r-io4U must first be added to the home screen (Share, Add to Home Screen) and opened from there. Over HTTP there are no notifications. Disconnecting stops the notifications of that user in this browser.

06

On the server side

r-ioga serves the REST resource /r-ioga/generic-application/push (key, subscriptions, test; see the API reference). The key pair of the server is made at the first use and kept in MongoDB, so the subscriptions stay valid across restarts. A subscription belongs to a user, its person and its use case; it is runtime state, not exported with a use case, and is removed when the push service of the browser no longer knows it. A message waits 24 hours for a phone that is off. The optional property web-push-subject of the application tells the push services who runs the server (https://r-iosuite.com by default).

r-io4U →Home →r-ioga →Configuration →
Applications / r-io4U / Dans un navigateur

Dans un navigateur : r-io4U servi par r-io suite

Chaque distribution de r-io suite sert la version web de r-io4U à côté de r-ioga : un téléphone l’ouvre depuis un QR code, sans rien installer. L’application Android reste disponible et garde ses propres réglages.

Pas encore de capture de l’interface à tuiles : les captures de la vue d’ensemble de r-io4U précèdent la refonte de novembre 2026 et montrent les anciens menus.

01

Embarqué dans la distribution

Le module Flutter dart/frontend/gind_r_io4u s’installe avec Maven avant la distribution (Flutter requis, FLUTTER_HOME défini). Sa construction régénère les modèles Dart depuis les XSD, puis lance flutter build web ; -Drio4u.web.skip=true saute la version web. Le module de distribution gind-r-io-standalone l’ajoute par le profil rio4u-web, actif par défaut ; sans Flutter, construire la distribution avec -Dno-rio4u. Les étapes sont dans le README du dépôt.

02

L’ouvrir sur un téléphone

Le QR code est affiché à droite de la barre de titre Projects workspace de r-ioga, et dans Settings → Show the r-io4U QR code de l’en-tête des applications web. Le téléphone et le serveur sur le même réseau, l’appareil photo du téléphone le lit et ouvre r-io4U ; l’utilisateur se connecte avec le compte d’une personne du cas d’usage. Ouvert sur le serveur lui-même (localhost), le code porte l’adresse réseau du serveur, celle que joint un téléphone ; derrière un proxy, il porte l’adresse de la page.

03

Les services trouvés depuis la page

Servi par r-io suite, r-io4U prend l’adresse du serveur dans sa propre page, quels que soient ses réglages enregistrés : directement sur le serveur, il lit les ports de r-ioga, r-ioda et r-iose auprès de r-ioga (generic-application/context/webApplications) ; derrière un proxy, chaque service est joint à la même adresse, par son chemin. Rien n’est saisi. L’application Android garde Settings → Connexion : adresse du serveur, ports de r-ioga, r-ioda, r-iose et ping du serveur.

04

Ce qui marche en HTTP

Une distribution est servie en HTTP. Un navigateur ne donne la position, le micro et la caméra de l’appareil qu’en HTTPS ou sur localhost : sur le réseau en HTTP, r-io4U l’annonce une fois à la connexion et sur le bouton de dictée du chat. Les tâches, la carte, le chat et les photos choisies sur le téléphone fonctionnent ; la connexion elle-même marche en HTTP. Sur un serveur, un reverse proxy sur le port 443 donne le HTTPS à la même adresse ; il doit relayer /r-ioga, /r-ioda, /r-iose et /ws/pubsub.

05

Notifications du téléphone

En HTTPS (ou sur localhost), r-io4U propose une fois après la connexion de recevoir les notifications du téléphone ; le navigateur demande son autorisation au tap. Settings → Functionalities → Notifications on this phone les active ou les coupe, et Send a test notification en envoie une aux navigateurs de l’utilisateur. Le système du téléphone montre alors, même quand r-io4U est fermé :

Un tap ouvre r-io4U sur les tâches, les alertes ou le groupe du message, après la connexion si besoin. Sur un iPhone, r-io4U doit d’abord être ajouté à l’écran d’accueil (Partager, Sur l’écran d’accueil) et ouvert depuis là. En HTTP, pas de notifications. La déconnexion arrête les notifications de cet utilisateur dans ce navigateur.

06

Côté serveur

r-ioga sert la ressource REST /r-ioga/generic-application/push (clé, abonnements, essai ; voir la référence API). La paire de clés du serveur est créée à la première utilisation et gardée dans MongoDB : les abonnements restent valables d’un redémarrage à l’autre. Un abonnement appartient à un utilisateur, à sa personne et à son cas d’usage ; c’est un état d’exécution, non exporté avec un cas d’usage, retiré quand le service push du navigateur ne le connaît plus. Un message attend 24 heures un téléphone éteint. La propriété facultative web-push-subject de l’application indique aux services push qui fait tourner le serveur (https://r-iosuite.com par défaut).

r-io4U →Accueil →r-ioga →Configuration →