Initial commit

This commit is contained in:
Eugenius Naumenko
2026-06-07 22:20:57 +00:00
commit a7d8f72129
357 changed files with 168337 additions and 0 deletions
+27
View File
@@ -0,0 +1,27 @@
# 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.