28 lines
935 B
Markdown
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.
|