# Sistemul actual · 0.19.0

69 concepte, 106 ecrane tematice, 318 combinații ecran/context, 16 medii, 2.952 modele navigabile. Datele numerice ilustrative și limitele analogiilor sunt explicite.

## Un singur model al lecției

Starea include concept, capitol (`chapter`), context, pas, reper, selecție, experiment și cameră. `sceneFor` compune scena de bază, capitolul și experimentul. `graphFor` produce relațiile folosite de ambele reprezentări. Camera și accentele nu schimbă sensul sau rezultatul grafului.

Cele trei chei interne shop/home/office sunt poziții stabile; numele mediului vine din `contextFor`. Un capitol are aceleași trei medii ale conceptului, dar obiecte și situații proprii. Baze de date și limbaje au selecție directă de ecran. Ontologia include simultan schema și faptele concrete.

## Module

| Module | Responsabilitate |
|---|---|
| content.js, world-scenarios-data.js | Catalog, scene, stări validate și context |
| extra-concepts.js, lesson-chapters.js | 15 concepte noi și ecranele lor; corectarea retenției |
| embedding-story.js, numeric-renderer.js | Acces intuitiv înaintea calculelor numerice |
| audience.js, comparison-map.js | Profiluri, căutare numerică și 112 comparații simetrice |
| teaching-desk.js | Sertar stânga, definiții, exemple, comparații și notițe pe capitole |
| world.js, free-orbit.js | Scenă Three.js, selecție, rotire, zoom, deplasare |
| scene-framing.js | Evaluarea a 32 vederi pentru geometria scenei și raportul de aspect |
| scene-renderer.js | WebGL când este disponibil; fallback Canvas cu aceeași geometrie |
| world-environments.js | 16 decoruri geometrice, cu centru rezervat lecției |
| flow-layout.js, label-layout.js | Trasee și etichete ancorate la obiecte |
| presentation-logic.js | Relații, pași, ramuri, cicluri și alternative; focalizare progresivă |
| library-300-data.js, library-300-models.js | 300 rețete tematice de obiecte, cu geometrii distincte |
| legacy-upgrade-data.js, legacy-upgrades.js | 12 modele existente cu 36 repere explicate |
| visual-library.js, visual-models.js | Identitatea simbolului și alegerea geometriei |
| model-catalog.js, model-filter.js | Utilizări reale pe capitol, context și nod |
| asset-browser.js, asset-viewer.js | Catalog / scenă / explicație, inspecție, poziții controlate și inserare în lecție |
| studio-ui.js, studio-ui.css | Ierarhie vizuală și separator accesibil, ajustabil și persistent |
| workshop-object-data.js, workshop-objects.js | 1.000 de ansambluri cu patru repere |
| workshop-profiles.js, workshop-mechanisms.js | Explicații și geometrie fixă/mobilă pentru 47 de familii utilizate |
| detailed-model-data.js, model-inspection.js | 2.048 modele / 7.144 componente; separare și reunire |
| diagram-renderer.js, atlas-engine.js | Diagrame SVG și mecanica scenariilor |
| numeric-lessons.js | Calcule ilustrative pentru vectori, HNSW și attention |
| scripts/export-catalogs.mjs | Documentație regenerată din sursa curentă |

## Alternative 3D

`learning-object-data.js` conține 1.000 de rețete explicite, fiecare cu concept, context, capitol, nod, obiect de bază, instrument, suport contextual și trei componente explicate. `learning-objects.js` construiește geometria; `learning-instruments.js` definește instrumentele, iar `learning-context-mounts.js` suporturile fizice. `scripts/build-learning-objects.mjs` regenerează datele din instantaneul sursă și profilurile semantice, eliminând rețetele duplicate.

`workshop-object-data.js` adaugă 1.000 de rețete cu patru repere: specimen/frame/action/reference. `scripts/build-workshop-objects.mjs` le regenerează din același instantaneu semantic. `lesson-object-models.js` reunește cele două loturi în 2.000 de alternative. Cele 435 de corpuri de bază și 16 suporturi sunt reutilizate; mecanismele au elemente fixe și mobile distincte.

`applyWorkshopPose` aplică una dintre trei poziții reversibile. Fiecare mișcare este declarată pe obiect prin tip, axă și trei valori. `workshopEnvelope` unește limitele celor trei poziții și restabilește starea, astfel încât camera inspectorului să rămână stabilă. Sunt mișcări explicative, nu calcule fizice sau dovezi ale executării unui sistem. Pozițiile se aleg în inspector; lumea principală inserează poziția inițială. Separarea reperelor și pozițiile se reunesc înainte de schimbare.

`objectExample` este validat față de concept/context/capitol. `withLearningObject` schimbă numai modelul nodului indicat; nu modifică etichete, relații, calcule sau răspunsuri. `modelCatalog.usages` marchează explicit aceste utilizări cu `alternative: true` și starea necesară `objectExample`. Inserarea în aceeași scenă păstrează pasul, răspunsul, reperul explicației și modul de reprezentare. Deschiderea unei alte scene nu propagă exemplul. Original îl elimină; revenirea în istoric îl poate restaura.

În modul ghidat sunt vizibile numai etichetele legăturii curente. Detaliile mici ale unui ansamblu apar la selectare sau la explicarea obiectului. În inspector sunt disponibile întregul, componentele separate și focalizarea. Miniatura internă reprezintă configurația inițială a ecranului, nu o simulare în timp real.

## Compoziție

Camera inițială evaluează contururile obiectelor, suprapunerile, spațiul pentru etichete și podeaua. Preferă o vedere oblică pentru recunoașterea volumelor și schimbă unghiul când geometria o cere. Este o euristică, nu o garanție matematică a celui mai bun unghi pedagogic. Reset recalculează ansamblul. La schimbarea dimensiunii, încadrarea se adaptează; o cameră aleasă manual este păstrată.

Obiectele rămân stabile în timpul explicației. Săgețile sunt geometrie, vizibile discret de la început; auriul marchează ruta, turcoazul selecția. Topologiile nu primesc un sens unic artificial. Alternativele de adaptare și tipurile de componente nu sunt desenate ca un proces temporal.

Etichetele evită contururile proiectate și au linii către ancore. Mobilierul din față se estompează, iar Decor reduce suplimentar fundalul. Biblioteca separă utilizările reale de obiectele suplimentare; cele 1.000 modele noi nu sunt adăugate simultan în scene.

## Navigare și audiență

Enter deschide primul rezultat, iar redeschiderea sertarului revine la pagina conceptului curent. Căutarea numerică exactă, intervalele și lista de zece concepte înlocuiesc traversarea multor pagini. Profilurile filtrează sertarul, avansul și comparațiile. Ele sunt preferințe locale, nu permisiuni de acces. Selecția proprie necesită cel puțin un concept.

Comparația caută un mediu comun pe ambele concepte. Fără un mediu comun, denumirile contextelor rămân explicite. Definițiile sunt incluse numai în vederea explicită de comparație; în lecție se deschid la cerere. Închiderea păstrează capitolul, pasul și selecția sursei. Notele sunt locale și vizibile pe ecran când panoul lor este deschis.

## Tehnologie și limite

Fișiere statice, module ES și Three.js local; website-ul nu face cereri către modele AI sau CDN. Vite este opțional pentru dezvoltare. Hostingul publică directorul dist. Filtrele și progresul folosesc localStorage.

Rendererul software păstrează rotirea, selecția și miniaturile când WebGL este indisponibil. Proiectează fețele aceleiași geometrii în Canvas, cu iluminare și transparență aproximative. Nu reproduce complet umbrele și compoziția GPU. Browserul de QA a folosit acest fallback.

Embeddings folosește coordonate manuale; HNSW un graf fix cu căutare greedy simplificată; attention un singur cap cu Q/K de dimensiune doi și V scalare. Aceste exemple nu sunt implementări complete de producție. Cele patru arhetipuri de adoptare sunt o propunere didactică, nu o taxonomie universală. Cele 60 de planșe originale din arhiva Applied GenAI Atlas v2.5 sunt incluse în atlas-v25/, cu legături la conceptele corespunzătoare.

[Scenarii](WORLD-SCENARIOS.md) · [Bibliotecă](VISUAL-LIBRARY.md) · [Comparații](COMPARISONS.md) · [Audiențe](AUDIENCE-PROFILES.md) · [Verificare](REVIEW-0.19.md).