Files
Speech/docs/architecture.md
T
2026-06-07 22:20:57 +00:00

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.