arie378/tokoflow-portal repository overview

⁠tokoflow-portal

Web front-end host for the Tokoflow back-office. A Helidon SE 4 (virtual-thread) replacement for nginx, shipped as a GraalVM native-image binary.

⁠What it does

• Serves the Vite-built React SPA from a bundled classpath webroot/.
• Reverse-proxies /api/* to tokoflow-gateway (gzip-enabled), so the browser talks to a single origin.
• SPA-fallback routing for client-side routes.

⁠Architecture

The public-facing HTTP tier (behind nginx/Cloudflare in production). The SPA it serves is the Tokoflow tenant back-office; all data calls flow through it to the gateway and on to tokoflow-api.

⁠Image

• Native binary · entrypoint id.tokoflow.portal.FrontendPortalMain
• Exposes 8080 (HTTP)

⁠Key environment

• Upstream gateway URL for the /api reverse proxy
• OTEL_* (OpenTelemetry → OpenObserve)