LinguFlow 1.0.0 — Official release
Release version: v1.0.0
Status: Official (not pre-release)
GitHub Release: https://github.com/newtc22222/lingu-flow/releases/tag/v1.0.0
Previous: v0.1.0
This is the first official production release after the Horizon A (secure & correct) and Horizon B (fast & operable) programs. The product brand is LinguFlow — the browser title no longer says “MVP”.
Product highlights
| Area | What’s in 1.0.0 |
|---|---|
| Flashcards | SM-2 spaced repetition, decks, Learn / Match modes, keyboard-first arcade UI |
| Exams | Certification simulator (TOEIC, IELTS, HSK, JLPT), shared question bank, timed sessions, results review |
| Accounts | Register / login, Google OAuth, guest sessions with lifecycle cleanup, user settings |
| Media | Cloudflare R2 presigned upload/download |
| Deploy | Production: Vercel (SPA) + Railway (FastAPI + Postgres) + R2 · Local: docker compose |
New since v0.1.0 — Security & correctness (Horizon A)
These closed the trust boundaries before treating the app as production-official:
- JWT production guard — production never boots with a weak or missing secret from
.envalone. - Exam visibility — private templates resolve only for public or owner; strangers get 404 (not 403).
- Answer keys — session details reveal keys/explanations only when the session is completed.
- Transaction ownership — HTTP requests commit only in
get_db(); servicesflush, they do not dual-commit mid-request. - Postgres integrity harness —
@pytest.mark.postgrescascade/transaction tests in CI. - Seed ownership — built-in exams seed from
entrypointafter migrate, withpg_advisory_lock; not on every API worker lifespan. - SSE removal — unused
/api/eventsJWT-in-query path removed (no frontend consumer).
New since v0.1.0 — Performance & operations (Horizon B)
- Dashboard scale — progress uses SQL aggregates / column projections (no full-card ORM load for XP, readiness, worlds).
- UTC streaks — consecutive study days use UTC calendar boundaries.
- Server exam timer — wall-clock limit + 30s grace; post-expiry answers rejected; finish remains allowed and idempotent.
- Health — Postgres
healthcheckin compose; backend waits until healthy;GET /api/health/readyprobes the DB;GET /api/healthstays pure liveness. - Auth rate limits — login / register / guest throttled per IP (in-process; 429 +
Retry-After). - Observability — structured request logs (
method,path,status,latency_ms); optionalSENTRY_DSN. - Config honesty —
REDIS_URLand AI API keys marked reserved until Phase 2 (not wired as live features). - Frontend quality — data-access convention documented (
apiFetch+ Pinia / featureapi.ts); Vitest + CI for pure helpers and critical store paths.
Branding
- Browser document title:
LinguFlow(MVP label removed in this release).
Quality gates (as of release)
| Suite | Notes |
|---|---|
| Backend pytest | SQLite default suite + Postgres integrity job on CI |
| Frontend | vue-tsc + Vite build, ESLint, stylelint, Prettier, npm test (Vitest) |
What is not in 1.0.0 (planned later)
Next: v1.1.1 — TOEIC Listening (manual track) and exam-integrity sitting lock.
Phase 2+ product work remains open (analytics, community, writing modes, AI generate/TTS for listening). Redis and multi-replica rate limits wait for measured scale triggers.
See also: Architecture & Database Schema, Deployment Guide, API Documentation.