# Bacalaurescu AI API - Changelog

> Lista modificarilor recente pentru a urmari noile endpoint-uri si schimbarile de schema.

## v2026.1.0 (22 mai 2026)

### Adaugat

- **/api/v1/ai/opere/{slug}/model-essay?score=15|25|30** - Eseuri model generate dinamic din DB pentru toate 17 opere, cu 3 nivele de calitate (15/25/30). Disclaimer clar despre necesitatea adaptarii la propria voce.
- **/api/v1/ai/review** - Spaced repetition algoritm SM-2 simplificat. POST cu progresul, primesti plan pentru azi/maine/saptamana.
- **/api/v1/ai/session-template** - Template JSON pentru a stoca progresul intr-o sesiune ChatGPT.
- **/api/v1/ai/session-summary** - POST cu input session, primesti analiza + recomandari.
- **/api/v1/ai/opere/{slug}/lesson?style=calm|motivational|strict|exam-focused** - Stil de comunicare adaptabil pentru lectie.
- **/api/v1/ai/opere/{slug}/explain-audio-script?style=...** - Style param pe audio script.
- **/api/v1/ai/simulation?seed=42** - Simulare reproducibila prin seed.
- **/api/v1/ai/changelog** - Acest changelog public.
- **/api/v1/ai/test-cases** - Golden test cases pentru verificare integritate API.
- **/chatgpt-workflows.md** - 8 workflow-uri concrete pentru folosire cu ChatGPT.

### Schimbat

- **meta** acum include: `confidence` (0-1), `sourceBasis`, `reviewStatus` (verified|auto-generated|wip|algorithm-based) pentru transparenta.
- **/api/v1/ai/opere/{slug}/istoric** - Adaugat `probability_disclaimer` clar despre limitele estimarii.
- **OpenAPI examples** - Examples complete in `/openapi.json` pentru `/context` si alte endpoints majore.

### Fixed

- Toate endpoint-urile noi au schema standardizata `{data, meta, links, suggestedNext}`.

## v1.0.0 (anterior, multiple sesiuni)

### Endpoints principale

- /api/v1/ai/exec (GET + POST) - universal command executor
- /api/v1/ai/opere, /autori, /personaje + sub-endpoints
- /api/v1/ai/opere/{slug}/context (compact|exam|teacher)
- /api/v1/ai/opere/{slug}/schema-eseu (5 tipuri)
- /api/v1/ai/opere/{slug}/exercitii (3 niveluri)
- /api/v1/ai/opere/{slug}/greseli-frecvente
- /api/v1/ai/opere/{slug}/flashcards
- /api/v1/ai/opere/{slug}/citate?mode=exam-safe
- /api/v1/ai/opere/{slug}/checklist
- /api/v1/ai/opere/{slug}/teacher-notes
- /api/v1/ai/opere/{slug}/istoric (granular)
- /api/v1/ai/opere/{slug}/lesson
- /api/v1/ai/opere/{slug}/explain-audio-script
- /api/v1/ai/learning-path
- /api/v1/ai/diagnostic/romana
- /api/v1/ai/next
- /api/v1/ai/compare
- /api/v1/ai/confusions
- /api/v1/ai/subiectul-i, /subiectul-ii (+sub)
- /api/v1/ai/subiecte/{subiect}/greseli-frecvente
- /api/v1/ai/rubric/{subiect}
- /api/v1/ai/simulation
- /api/v1/ai/priorities
- /api/v1/ai/repair
- /api/v1/ai/vocab
- /api/v1/ai/status
- /api/v1/ai/capabilities

### Filtre universale

- ?level, ?length, ?profile, ?explain, ?mode, ?include, ?exclude, ?format

### WIP endpoints (placeholders cu alternativa)

- POST /api/v1/ai/evaluate-essay (necesita LLM API key extern)

## Roadmap viitor

- Evaluare automata eseu (cand vom integra LLM API key)
- Check-answer endpoint
- Detect-misconceptions endpoint

## Stabilitate API

**Backwards compatibility**: garantata pentru toate endpoint-urile GET. POST requestelor pot avea schimbari minore in body schema dar raspunsul ramane compatibil.

**Versionare**: `meta.contentVersion` se incrementeaza la modificari semnificative ale continutului din DB.

Pentru ultima versiune live: `GET /api/v1/ai/status`