How victorbro/ft_transcendence works
ft_transcendence is an AI-driven language-learning platform. Its intended learner journey is account creation, course setup, adaptive CEFR placement, a level-specific roadmap, and AI-assisted practice; profile and two-factor settings support that journey. The API also includes session/authentication, course, question-generation, placement, and storage services. The README documents live learner chat and progress analytics, but the supplied tree and excerpts do not establish their runtime wiring. Arrows are limited to shown calls/imports or README-described capabilities; omitted implementation excerpts leave some links unverified.
Main entry points: placement.controller.ts Placement orchestration · lib Browser API clients · app.module.ts API application · prisma.service.ts Database access
Components 20
Learner experience
- Learning screens
apps/web/app/[locale]/(dashboard)/learn - Account screens
apps/web/app/[locale]/(main) - Chat and friends
apps/web/app/[locale]/(mode) - Browser API clients
apps/web/lib
Platform API
- API application
apps/api/src/app.module.ts - Authentication
apps/api/src/auth/auth.controller.ts - User profiles
apps/api/src/users/users.controller.ts
Learning services
- Course management
apps/api/src/courses/courses.controller.ts - Placement orchestration
apps/api/src/placement/placement.controller.ts - Exam sessions
apps/api/src/placement/placement-session.service.ts - Adaptive questions
apps/api/src/placement/placement-question.service.ts - Placement progress
apps/api/src/placement/placement-progress.service.ts - Question generation
apps/api/src/question-generation/question-stock.service.ts - AI provider
apps/api/src/llm/llm.provider.ts - Roadmap and AI tutor
apps/api/src - Live practice and analytics
apps/web/app/[locale]/(mode)
Shared state and contracts
- Database access
apps/api/src/prisma/prisma.service.ts - Redis state
apps/api/src/redis/redis.service.ts - Shared schemas
packages/shared/src/schemas
Other components
- Learner
Connections 25
- Learner → Account screens: signs in
- Learner → Learning screens: learns
README.md - Learner → Chat and friends: practices live
README.md - Account screens → Browser API clients: uses
- Learning screens → Browser API clients: uses
- Browser API clients → Authentication: calls auth API
apps/web/lib/auth-client.ts - Browser API clients → User profiles: calls profile API
apps/web/lib/auth-client.ts - Learning screens → Placement orchestration: starts placement
README.md - API application → Authentication: registers
apps/api/src/app.module.ts - API application → User profiles: registers
apps/api/src/app.module.ts - API application → Course management: registers
apps/api/src/app.module.ts - API application → Placement orchestration: registers
apps/api/src/app.module.ts - Authentication → Database access: queries users
- User profiles → Database access: updates users
- Course management → Database access: queries courses
- Placement orchestration → Exam sessions: manages sessions
- Placement orchestration → Adaptive questions: advances questions
- Placement orchestration → Placement progress: tracks progress
- Exam sessions → Redis state: stores sessions
apps/api/src/placement/placement-session.service.ts - Adaptive questions → Question generation: requests questions
- Question generation → AI provider: generates batches
apps/api/src/question-generation/question-stock.service.ts - Question generation → Database access: stores questions
apps/api/src/question-generation/question-stock.service.ts - Roadmap and AI tutor → Learner: teaches
README.md - Live practice and analytics → Learner: shows progress
README.md - Shared schemas → Browser API clients: validates responses