Skip to content

Architecture

GIRAF is a multi-app platform for children with autism. A shared Core service handles identity, organizations, and shared resources. Each app has its own backend that stores only domain-specific data and validates Core-issued JWTs.

Ecosystem

graph TD Core["giraf-core<br/>Django + Ninja<br/>:8000"] CoreDB[(PostgreSQL 16)] Core --- CoreDB WP["weekplanner<br/>.NET 8 + Expo/RN<br/>:5171"] WPDB[(PostgreSQL 15)] WP --- WPDB WP -->|JWT validation<br/>citizen/grade/pictogram lookup| Core VTA_API["VTA API<br/>.NET 8<br/>:5192"] VTA_Sync["VTA SyncService<br/>SignalR<br/>:5002"] VTADB[(MySQL 8)] VTA_API --- VTADB VTA_Sync --- VTA_API VTA_API -->|JWT validation| Core AI["giraf-ai<br/>FastAPI<br/>"] AI -->|JWT validation| Core FP["foodplanner<br/>Flutter + .NET"] FPDB[(PostgreSQL + MinIO)] FP --- FPDB FP -->|JWT validation| Core

Systems

System Port Tech Stack Database Default Branch Repo
giraf-core 8000 Django + Ninja PostgreSQL 16 main giraf-core
weekplanner 5171 .NET 8 + Expo/RN PostgreSQL 15 main weekplanner
VTA API 5192 .NET 8 MySQL 8 dev-main visual-tangible-artefacts
VTA SyncService 5002 .NET 8 + SignalR — dev-main (same repo)
giraf-ai — FastAPI (Python) — main giraf-ai
foodplanner — Flutter + .NET PostgreSQL + MinIO staging foodplanner / foodplanner-api

Shared JWT Auth

Core issues JWTs (HS256) containing an org_roles claim that maps organization IDs to roles:

{"org_roles": {"1": "owner", "5": "member"}}

Role hierarchy: owner > admin > member.

All backends validate tokens locally using a shared JWT_SECRET. No network call to Core is needed for authorization. See ADR-0001.

Repository Map

Repository Description
giraf-core Shared identity and resource service
weekplanner Week planner app (backend + frontend)
visual-tangible-artefacts VTA app, API, SyncService, admin dashboard
giraf-ai AI image generation + TTS
foodplanner Food planner Flutter frontend
foodplanner-api Food planner .NET backend
wiki This documentation site
deploy Docker Compose deployment for Core + Weekplanner

Further Reading