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

28 lines
935 B
Markdown

# 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.