# Architecture ## Runtime ```txt React web app -> Go API -> PostgreSQL -> Redis -> FlowiseAI -> Azure Speech ``` FlowiseAI runs as a Docker container on the same VPS and Docker network. The frontend never calls Flowise or Azure directly. ## Backend The Go API is the system of record. It owns auth, learner profiles, language profiles, exercises, attempts, progress, Azure calls, and Flowise calls. Important boundaries: - `httpapi`: request/response handling. - `services`: auth, Azure Speech, Flowise teacher logic. - `store`: PostgreSQL schema, seed data, repositories. - `domain`: shared API/domain structs. ## Multilingual Design The MVP enables only `en-US`, but every exercise and profile stores `target_language` and `cefr_level`. New languages are added through `language_profiles`, seed exercises, Azure voice settings, and Flowise prompt variables.