FastAPI Backend-for-Frontend (BFF) for the CELINE REC participant webapp. Deployed same-origin behind oauth2_proxy.
The participant frontend (SvelteKit) is maintained separately in celine-frontend (apps/webapp).
The webapp uses the BFF pattern:
- The frontend (SvelteKit) communicates exclusively with the BFF at
/api/* - The BFF reads the JWT from the
X-Auth-Request-Access-Tokenheader injected by oauth2_proxy - The BFF proxies authenticated requests to backend services (Digital Twin, nudging-tool, flexibility-api, rec-registry)
- No cross-origin requests from the browser
uv sync
uv run alembic upgrade head
task run
# Listens on http://localhost:8014For the participant frontend, see celine-frontend apps/webapp.
| Feature | Description |
|---|---|
| Overview | Energy consumption and production summary from Digital Twin |
| Weather | Current weather conditions for the user's community |
| Forecast | Energy production/consumption forecast from Digital Twin |
| Suggestions | Flexibility window suggestions with accept/reject/remind actions |
| Commitments | Active commitment tracking and cancellation |
| Gamification | Points, badges, and commitment history from flexibility-api |
| CO2 | Carbon emission factors and settings |
| Community | Community metadata from rec-registry |
| Notifications | User notification list, read/unread, enable/disable |
| Web Push | VAPID-based push notification subscription via nudging-tool |
| Settings | Account settings (language, units), terms acceptance |
| Feedback | User feedback submission |
| Health | Service health check |
celine-webapp-export-feedback # Export user feedback data| Document | Description |
|---|---|
| Architecture | BFF pattern, JWT flow, service dependencies, deployment model |
| API Reference | All BFF endpoints with paths and query params |
| Features | Feature details: suggestions, gamification, CO2, feedback |
| Development | Local dev setup, env vars, taskfile commands |
Apache 2.0 — Copyright © 2025 Spindox Labs