935 B
935 B
Architecture
Runtime
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.