# BIONIC CREATIVE FACTORY — PLAN MASTER
Owner: Adrian Moldovan · Scop: fabrica unde construim SITE-uri / APP-uri / JOCURI / VIDEO la calitate de premiu, totul conectat, cu traseu clar: IDEE -> PROMPT -> DESIGN -> ASSETS -> FRONTEND -> LOGICA -> TEST -> CRITIC -> LIVRARE.
Principiu: complexitatea NU = capacitate. Construim o coloana (ochi+maini+pipeline) si tot se conecteaza pe ea. Fiecare piesa, facuta foarte bine, in sesiuni separate.

## STARE ACTUALA (ce exista deja)
- VPS Hetzner CPX62 (16 core, 32GB, fara GPU), ~37 servicii PM2, Caddy preview live (preview.bionicsovereign.dev/<slug>/), dashboard.
- media-service (3031): imagini AI reale 8K (Flux/Leonardo).
- model_router.py (subscription Opus 4.8 via CLI + Groq/Gemini/Ollama fallback), pipeline 8 agenti, materialize, critic Opus, checkpoint.
- Design system OKLCH (Clash Display + Satoshi), memorie/vault, skills.
- API Anthropic (cu credit) + abonament Max.
- CONSTRUIT AZI: render headless (chromium) pe VPS + critic vizual pe API (vede screenshot, da nota + fix-uri) + analiza culoare Python. = primii OCHI.

## LAYER 1 — OCHI (perceptie + QA)  [pornit azi]
- [x] Render headless chromium pe pagina live
- [x] Critic vizual API (nota /10 + probleme + fix-uri concrete)
- [x] Metrici culoare/luminanta (alb-spalat %, ton)
- [ ] BUCLA AUTOMATA: genereaza -> screenshot -> critic -> daca nota<8 aplica fix -> repeta
- [ ] Detectie canvas negru/blank (WebGL fail) + captura erori console/network
- [ ] Screenshot multi-viewport (mobil 390x844 + desktop 1440)
- [ ] Diff vizual fata de o imagine referinta
- [ ] Probe performanta (FPS estimat, timp load) + contrast/accesibilitate

## LAYER 2 — MAINI / FORJA DE ASSETS (media reala, nu plastic)
- [x] Imagini AI (Flux/Leonardo) prin media-service
- [ ] BLENDER headless pe VPS: modele sculptate (boaba/punga/rasnita/cana/props joc) -> export GLB; Eevee renders/turntables; normal/roughness maps; scene scriptate in Python. (Limita: CPU only -> Eevee rapid, Cycles fotoreal lent)
- [ ] Pipeline GLB -> Three.js (GLTFLoader + DRACO)
- [ ] Overlay TEXT crisp peste imagini (AI nu scrie litere corect -> nume/semnatura le pun eu vector)
- [ ] Biblioteca de materiale PBR + texturi
- [ ] (optional) Audio: TTS narator + SFX pentru video/jocuri

## LAYER 3 — MOTOARE DE BUILD (pe tip de livrabil)
- [ ] SITE/LANDING: artizan (Three.js + GSAP + design system), self-contained. [in lucru: Aurora]
- [ ] WEB APP: framework (Vite/React sau static), state, Supabase, auth, CMS
- [ ] JOCURI: Three.js + fizica (Rapier/Cannon) + arhitectura ECS + input + audio + save. Stacheta reala: WebGL stylized de top (NU AAA fotoreal in browser)
- [ ] VIDEO: Remotion (compune cadre AI + capturi 3D + motion + audio -> MP4) prin chromium headless
- [ ] Pipeline 8 agenti: repozitionat pentru "schelet de app rapid", nu pentru 3D de premiu (ala e artizan)

## LAYER 4 — DESIGN SYSTEM + STANDARD CREATIV
- [x] Tokens OKLCH, fonturi, easing, ritm 8px
- [ ] Biblioteca componente premium (nav, butoane, carduri, sectiuni) reutilizabile
- [ ] Biblioteca RETETE 3D: module scena reutilizabile (turntable produs, morph particule, shader lichid, glob, abur) — ca sa nu reconstruim de la zero
- [ ] Preset brand per proiect + regulile NEVER/ALWAYS (fara Inter, fara purple, etc.)

## LAYER 5 — PIPELINE / ORCHESTRARE (traseul clar)
- [ ] Stagii cu poarta de QA: BRIEF(7 intrebari) -> MOODBOARD/PROMPT -> DESIGN -> ASSETS(Blender/AI) -> FRONTEND -> LOGICA/BACKEND -> INTEGRARE -> TEST(ochi) -> BUCLA CRITIC -> LIVRARE
- [ ] Fiecare stagiu: input / owner (model+tool) / output / poarta QA
- [ ] Checkpoint + resume, tracking status per build

## LAYER 6 — CAMERA DE CONTROL (site-ul de care esti legat permanent) = PODEAUA FABRICII
- [ ] Dashboard web pe VPS unde:
  - pornesti proiect (formular brief)
  - vezi progres live (stagii + log-uri)
  - vezi PREVIEW live (iframe build) + screenshot-urile headless + NOTA criticului
  - rasfoiesti assets generate (imagini, GLB, video)
  - actiuni: regenereaza / ruleaza critic / deploy / itereaza
  - istoric proiecte + versiuni
- Backend = layerul de orchestrare + API-uri

## LAYER 7 — LIVRARE
- [x] Preview URL
- [ ] GitHub push, Netlify, export (zip / MP4 / GLB), versionare

## LAYER 8 — REZILIENTA / OPS (cand ne blocheaza ceva)
- [x] Detectie erori JS (headless)
- [ ] Auto-retry + fallback model + checkpoint/resume
- [ ] Headless stealth + proxy pentru site-uri care blocheaza
- [ ] Resource guard (RAM/disk/model_check) + curatare disk
- [ ] Logging + alertare

## LAYER 9 — MEMORIE / CUNOASTERE
- [x] Vault, note proiect, skills
- [ ] Memorie de "retete" (solutii reutilizabile) + fix-uri invatate

## TRASEUL PE SESIUNI (fiecare livreaza ceva concret, pas cu pas, calitate)
- SESIUNEA 1 (urmatoarea): OCHI complet — bucla automata critic + multi-viewport + detectie blank. Proba: duc boaba Aurora la 8/10 SINGUR.
- SESIUNEA 2: FORJA ASSETS — instalez Blender headless + pipeline GLB->Three + overlay text crisp. Refac heroul cu boaba GLB reala -> critic >=8.
- SESIUNEA 3: BIBLIOTECA RETETE 3D + finalizez Aurora — module reutilizabile + secventa cinematica completa (boaba -> spargere -> punga cu nume+semnatura -> toarna -> rasnita -> extractie -> cana) cu assets+cadre reale. Aurora = primul flagship livrat.
- SESIUNEA 4: CAMERA DE CONTROL v1 — dashboard (pornire proiect, preview live, screenshot, nota critic, assets, actiuni).
- SESIUNEA 5: PIPELINE wiring — leg brief->design->assets->frontend->logica->test->critic->livrare ca un flux orchestrat, cu checkpoint, afisat in camera de control.
- SESIUNEA 6: VIDEO — pipeline Remotion (brand/build -> MP4 cinematic + taietura TikTok).
- SESIUNEA 7: MOTOR DE JOC — Three.js + Rapier + ECS + input/audio/save; o felie verticala de joc stylized lustruita.
- SESIUNEA 8+: Hardening (rezilienta, stealth, performanta, scalare) + lucru per proiect.

## FAPTE TEHNICE CHEIE (pentru sesiuni noi)
- Build-uri: /root/builds/<slug>/ -> https://preview.bionicsovereign.dev/<slug>/ (Caddy, live imediat)
- Imagini: POST localhost:3031/generate {"prompt":...} -> URL /media/<f>.png
- Headless shot: /root/shots/shot.js (puppeteer-core, chrome 148, flags swiftshader) -> PNG in /root/builds/media/
- Critic vizual: /root/shots/vision_critic.py <png> "<brief>" (model claude-sonnet-4-6, cheia din /root/.env)
- Analiza culoare: PIL pe screenshot (luminanta/ton/alb%)
- Generare cod premium: claude CLI cu abonament Max: env -u ANTHROPIC_API_KEY ... claude -p "<prompt>" --model claude-opus-4-8 --output-format text --append-system-prompt "<sys>" --disallowedTools Bash Edit Write Read NotebookEdit Glob Grep WebFetch WebSearch Task TodoWrite < /dev/null   (output buffered, scrie la final)
- Modele API: claude-opus-4-8 (top), claude-sonnet-4-6 (critic/ieftin), claude-haiku-4-5 (rapid)
- Editare fisiere: backup .bak + inlocuire literala + node --check / py_compile + verificare. NICIODATA base64 pe o linie; heredoc 'EOF' quoted.
- bash_exec timeout ~60s -> joburi lungi in nohup + poll.

## PROIECT ACTIV: AURORA (cafea de specialitate, Gent BE, tema zorile)
- Hero 3D la /aurora-hero/ (boaba reala 3D + dust + bloom). Critic actual: 3/10 -> tinta 8+.
- Fix-uri de aplicat (din critic): material lucios/oily (roughness 0.05-0.15 + clearcoat), baza #1A0A00-#3D1C00, crapatura pronuntata, rimlight #FF6B1A din spate, particule #FFD700 cu bokeh. Ideal: boaba GLB din Blender.
- Secventa cinematica tinta: boaba -> spargere praf cosmic -> readunare -> punga neagra pro cu AURORA + Adrian Moldovan + semnatura -> toarna boabe -> rasnita -> extractie/apa -> cana. Obiecte reale (GLB/cadre 8K), tranzitii din particule.
- Pagina veche /aurora/ (42KB, generica) = de inlocuit.