Skip to content
All projects
LiveAI

TEF/TCF Evaluator

AI feedback for the French TEF and TCF exams, mapped to CEFR levels A1 to C2. Live.

Role
Founder, architect and full-stack developer
Open the live app

Source is in a private repository.

Illustration of a French speech bubble beside a CEFR level ladder from A1 to C2

What it is

The same evaluation platform rebuilt for French: TEF and TCF writing and speaking tasks are scored criterion by criterion, mapped to a CEFR level, and tracked over time with charts.

The problem

Candidates preparing for Canadian immigration and French-language exams need frequent, structured feedback. The product also had to support two payment providers, promotions and a free trial without hand-run admin work.

Architecture

Requests flow left to right. Hover a component for its role.

TEF/TCF Evaluator architecturesign-inenqueueCEFR resultwebhooks, capturesReact web app: TypeScript, Tailwind, NivoReact web appGoogle OAuthGoogle OAuthDjango REST API: SimpleJWT, creditsDjango REST APIStripe and PayPalStripe and PayPalPostgreSQLPostgreSQLRedis: brokerRedisCelery workers: async evaluationCelery workersGPT-4 and WhisperGPT-4 and Whisper
Solid line: synchronous callDashed line: through a queueDashed box: external or infrastructure
  • React web app client, TypeScript, Tailwind, Nivo
  • Google OAuth external
  • Django REST API service, SimpleJWT, credits
  • Stripe and PayPal external
  • PostgreSQL data
  • Redis queue, broker
  • Celery workers worker, async evaluation
  • GPT-4 and Whisper ai

Key decisions

  • A product line, not a copy

    The IELTS architecture was generalised so the exam, criteria and level mapping are configuration. TEF/TCF adds CEFR mapping and a second payment provider on the same skeleton.

  • Practice mode costs nothing

    Tests can be taken without AI evaluation and without spending credits, which keeps casual practice cheap to serve.

Highlights

  • Listening, reading, writing and speaking practice, with admin tools for each question bank.
  • Speaking tasks recorded in the browser, transcribed with Whisper and scored with GPT-4.
  • Reports with Nivo charts, criterion-level feedback and CEFR level mapping.
  • Credits with 1, 3, 6 and 12-month plans, a 7-day trial with 5 credits a day, and promo codes with usage limits.
  • Admin panel for questions, users, bulk credit adjustments and settings.

Stack

Django 5Django REST FrameworkCeleryRedisPostgreSQLOpenAI GPT-4WhisperReact 18TypeScriptTailwind CSSNivoStripePayPal