Δοκιμές¶

Η πειθαρχία δοκιμών του AdaptiveLearner επιβάλλεται από το make test σε κάθε αλλαγή. Η στρατηγική είναι πυραμίδα: unit στη βάση, integration στη μέση, E2E smoke στην κορυφή.

Αριθμός δοκιμών (v1.20.0)¶

Επίπεδο	Αριθμός	Εργαλείο
Backend unit + integration	786	pytest ^9
Plugin tests (10 plugins)	615	pytest ^9
Frontend unit + integration	1233	Vitest 4
E2E smoke	16 spec files	Playwright
Σύνολο (`make test`)	2634

Ανάλυση plugin: assessment 110 + ai-anthropic 34 + ai-openai 31 + ai-gemini 33 + session 215 + tracking 64 + tools 58 + gamification 23 + anki 20 + notebooklm 27.

Backend pytest¶

make test-backend      # 786 tests, ~35s
cd backend && poetry run pytest -k "test_session" -v
cd backend && poetry run pytest --pdb

Τα τεστ βρίσκονται στο backend/tests/. Τα fixtures στο conftest.py παρέχουν νέα in-memory SQLite DB ανά τεστ, το TestClient και έναν mocked plugin manager. Η απομόνωση τεστ είναι αυστηρή — το ADAPTIVE_LEARNER_TEST=1 ορίζεται πριν από οποιαδήποτε εισαγωγή app.*.

Plugin tests¶

Κάθε plugin έχει τον δικό του κατάλογο tests/:

make test-plugins              # όλα τα 7
make test-plugin-session       # μόνο ένα
cd plugins/adaptive-learner-plugin-session && poetry run pytest

Τα plugin tests δεν φορτώνουν την εφαρμογή FastAPI — ασκούν τα modules του plugin σε απομόνωση. Χρησιμοποίησε mock στον pluggy.PluginManager κατά τη δοκιμή εκτέλεσης hooks.

Frontend Vitest¶

make test-frontend                # 387 tests, ~2s
cd frontend && npx vitest         # watch mode
cd frontend && npx vitest run src/storage/  # ένας κατάλογος

Τα τεστ βρίσκονται δίπλα στον πηγαίο κώδικα: Component.test.tsx δίπλα στο Component.tsx. Το happy-dom είναι το περιβάλλον· React 19 + RTL.

Πρότυπα mock¶

Πάροχοι ΤΝ: mock στο global.fetch και assert στο URL, headers, body:

beforeEach(() => {
  global.fetch = vi.fn(async (input, init) => {
    calls.push({url, method, body});
    return new Response(JSON.stringify({content: [{type: "text", text: "hi"}]}), {status: 200});
  });
});

fake-indexeddb: στην κορυφή κάθε αρχείου Dexie test:

import "fake-indexeddb/auto";

beforeEach(async () => {
  await _resetDbForTests();
  const {IDBFactory} = await import("fake-indexeddb");
  (globalThis as unknown as {indexedDB: IDBFactory}).indexedDB = new IDBFactory();
});

Κάθε τεστ παίρνει φρέσκο in-memory IndexedDB — χωρίς διαρροές.

Mock api/client.ts (παλαιότερες σελίδες):

vi.mock("../api/client", async () => {
  const actual = await vi.importActual<typeof import("../api/client")>("../api/client");
  return {...actual, api: {...actual.api, users: {...actual.api.users, get: apiGetMock}}};
});

Η σελίδα εισάγει getStorage(), που αναθέτει σε ApiStorage, που αναθέτει σε api.*. Το mock κόβει στο επίπεδο api.* και εκτελείται ακόμα μέσω της στοίβας storage.

Playwright E2E¶

cd e2e && npx playwright test
cd e2e && npx playwright test --ui   # διαδραστικό
cd e2e && npx playwright test smoke/mobile-viewports.spec.ts

Τα smoke specs καλύπτουν τις κρίσιμες διαδρομές χρήστη:

Επιλογέας γλώσσας landing + φόρμα onboarding
Αξιολόγηση 12 ερωτήσεις + render radar
Εκκίνηση + τέλος + βαθμολόγηση συνεδρίας
Γλώσσα Ρυθμίσεων + API key
Δημιουργία Curriculum
Mobile viewports (iPhone SE, iPhone 14, Pixel 7, iPad)

Τα specs χρησιμοποιούν μόνο selectors data-testid — χωρίς εύθραυστα CSS selectors. Τα smoke specs ΔΕΝ βρίσκονται στη διαδρομή make test· χρειάζονται τρέχουσα εφαρμογή (make dev-bg πρώτα).

Κάλυψη¶

make test-coverage   # opt-in· αργό + θερμικά επιβαρυντικό

Η κάλυψη τρέχει στο CI για κάθε push στο main· κατέβασε τα artifacts:

gh run download --name backend-coverage
gh run download --name frontend-coverage

Στόχοι ανά .claude/rules/quality-checks.md:

Services + business logic: ελάχ. 95%
API endpoints: ελάχ. 90%
Frontend components με λογική: ελάχ. 85%
Hooks + utilities: ελάχ. 95%

Συνολικά: 85-95% σε επίπεδο έργου.

Pre-commit¶

cd backend && poetry run pre-commit install

Hooks: ruff check (auto-fix), ruff format, trailing whitespace, end-of-file fixer, check-yaml, check-merge-conflict. Μόνο backend — το frontend lint τρέχει κατά CI, όχι κατά pre-commit.

CI¶

Το .github/workflows/ci.yml τρέχει σε κάθε push στο main + κάθε PR:

Backend tests (matrix Python 3.12 + 3.13)
Plugin tests (ένα job ανά plugin· matrix-strategy)
Frontend Vitest + tsc + lint
ruff check + format-check

Το .github/workflows/release-gate.yml τρέχει σε tag pushes: επαληθεύει ότι τα version pins είναι συγχρονισμένα (χωρίς απόκλιση σε 12 αρχεία), τα lockfiles plugin ταιριάζουν, τα αναγεννώμενα artifacts είναι ενημερωμένα.