# FABRICA BIONIC - FISIER 2/2: ROADMAP (etapa cu etapa)
(Lipeste DUPA Fisierul 1. Plan de executie: faze in ordine logica, fiecare cu pasi + livrabil + test de acceptare. Lucram O faza pe rand. La final de faza: bifam + logam in /root/FACTORY_MASTER_PLAN.md + mergem mai departe.)

## CUM LUCRAM (protocol per sesiune)
1. La start: vps_health + citesc /root/FACTORY_MASTER_PLAN.md (unde am ramas).
2. Aleg faza/pasul curent. Confirm scurt cu Adrian.
3. Construiesc cu disciplina: backup -> implementez -> validez (syntax + render/health) -> ochi (critic) daca e vizual.
4. DEFINITION OF DONE: verificat de ochi sau test functional + 0 erori + persistat pe VPS + logat in plan.
5. Raportez scurt + sincer (ce merge, ce nu, scor), apoi urmatorul pas.

## ARHITECTURA (coloana pe care se conecteaza tot)
FACTORY CORE (orchestrare + stari + registru) <- OCHI (QA) + MAINI (assets) + BIBLIOTECI (UI/3D) + MOTOARE (site/app/joc/video) + MEMORIE/SKILLS + AGENTI. Totul vazut/controlat din CAMERA DE CONTROL (dashboard) si condus din Claude prin MCP.
Traseu canonic: BRIEF -> PROMPT/MOODBOARD -> DESIGN -> ASSETS -> FRONTEND -> LOGICA -> INTEGRARE -> QA(ochi) -> BUCLA CRITIC -> LIVRARE.

## FAZA 0 - FACTORY CORE (coloana / bazele)  [START AICI]
Scop: scheletul pe care se conecteaza tot; traseu mapat + stare persistenta.
Pasi:
- 0.1 INVENTAR + REGISTRU CAPABILITATI: scanez VPS-ul si catalogez fiecare serviciu PM2, port, script, conector, skill intr-un registru JSON - nume, ce face, cum se apeleaza, input/output, status. (Nu poti mapa un traseu fara sa stii ce ai.)
- 0.2 MODEL JOB: structura unui job de build (brief -> stagii -> artefacte -> status -> scoruri) ca JSON pe disc.
- 0.3 ORCHESTRATOR API: serviciu mic PM2 (sau extind orchestratorul existent) cu API: creeaza job, ruleaza stagiu, status, listeaza artefacte.
- 0.4 LOG + STARE: log central + fisiere de stare per job.
Livrabil: pot crea un job, trece prin stagii (chiar si false), statusul persista, registrul exista.
Test: creez un job demo via API, il vad miscandu-se prin stagii, interoghez statusul.

## FAZA 1 - OCHII COMPLET (poarta QA)  [partial gata]
Scop: orice URL -> raport QA complet, ca serviciu refolosibil, legat de Core.
Pasi:
- 1.1 Bucla auto (gata) -> o leg ca serviciu/CLI standard.
- 1.2 Multi-viewport: screenshot mobil (390x844) + desktop (1440).
- 1.3 Probe performanta: timp load + FPS estimat.
- 1.4 Contrast/accesibilitate de baza.
- 1.5 (optional) Diff vizual fata de imagine referinta.
- 1.6 Critic ca POARTA QA in pipeline (orice artefact trece pe aici).
Livrabil: serviciu QA -> JSON (scor, probleme, fix-uri, perf, 2 screenshot-uri).
Test: rulez QA pe 2 pagini, primesc raport complet.

## FAZA 2 - MAINI: FORJA DE ASSETS (media reala)
Scop: producem assets reale (modele 3D, imagini, text crisp, audio).
Pasi:
- 2.1 BLENDER headless: instalez (verific disk intai) + scriptare Python -> modele -> export GLB + randari Eevee/turntable + normal/roughness maps.
- 2.2 Pipeline GLB -> Three.js (GLTFLoader + DRACO) ca reteta.
- 2.3 Text crisp vector peste imagini (nume/semnaturi).
- 2.4 Serviciu imagini AI (exista) legat de Core + biblioteca de prompturi.
- 2.5 (mai tarziu) Audio: TTS narator + SFX.
Livrabil: cer "model boaba cafea" -> primesc GLB real + turntable, scor ochi >=8.
Test: boaba GLB reala intr-un hero, scor >=8 (inchide si situl de cafea ca efect secundar).
NOTA: "cel mai complex Blender" = biblioteca de generatoare parametrice + coada de randare, construita in timp.

## FAZA 3 - BIBLIOTECI & DESIGN SYSTEM (piese refolosibile)
Scop: caramizi gata-facute, premium, din care motoarele asambleaza rapid.
Pasi:
- 3.1 Biblioteca componente UI (nav, hero, carduri, sectiuni) premium, refolosibile.
- 3.2 Biblioteca RETETE 3D (turntable produs, morph particule, shader lichid, glob, vitrina) - module.
- 3.3 Tokens + presete brand per proiect.
- 3.4 Reguli calitate codificate (lint: fara Inter, fara purple, contrast, motion doar transform/opacity).
Livrabil: catalog de componente + retete 3D.
Test: asamblez o pagina din piese in cateva minute, scor ochi >=7 baseline.

## FAZA 4 - MOTOARELE DE BUILD (per livrabil)
Scop: cate un motor solid pentru fiecare tip.
Pasi:
- 4.1 SITE/LANDING (artizan: Three + GSAP + biblioteca).
- 4.2 WEB APP (Vite/React sau static + Supabase + auth + CMS).
- 4.3 JOC (Three + Rapier + ECS + input + audio + save) - stylized de top.
- 4.4 VIDEO (Remotion via chromium headless: cadre AI + capturi 3D + motion + audio -> MP4 + taietura TikTok).
Livrabil: fiecare motor scoate un artefact functional cu poarta QA.
Test: cate un flagship pe motor, fiecare trece QA.

## FAZA 5 - PIPELINE & ORCHESTRARE COMPLETA (traseul, cablat)
Scop: leg tot fluxul intr-o singura comanda/brief, cu QA + auto-reparare, resumabil.
Pasi: stagii cu owner (model/tool), input/output, poarta QA, checkpoint/resume, totul tracked in Core.
Livrabil: un brief -> sistemul produce un site care trece QA, cu interventie minima.
Test: brief -> livrare QA-pass aproape automat.

## FAZA 6 - CAMERA DE CONTROL (dashboard = podeaua fabricii)
Scop: vad/controlez tot dintr-un loc, condus din Claude prin MCP.
Pasi: pornesti proiect (brief), progres live + log, preview live + screenshot + scor critic, browser assets (imagini/GLB/video), actiuni (regenereaza/critic/deploy/itereaza), istoric/versiuni, vedere registru capabilitati.
Livrabil: podeaua fabricii, live, controland build-uri reale.
Test: pornesc + monitorizez + livrez un build complet din dashboard.

## FAZA 7 - MEMORIE, SKILLS, PLUGINS (cunoastere + extensibilitate)
Scop: sistemul refoloseste solutii trecute + incarca skill-uri relevante; tool-uri noi se conecteaza curat.
Pasi: memorie de retete/fix-uri, memorie proiect, biblioteca skills (100+) legata de orchestrator, sistem de plugin pentru capabilitati noi in registru.
Livrabil: un build refoloseste o reteta + un skill, masurabil mai rapid/bun.
Test: build nou reutilizeaza reteta + skill.

## FAZA 8 - AGENTI CAPABILI (ratiune)
Scop: intaresc echipa de agenti: roluri clare, routing model (Opus/Sonnet/Groq/local), auto-critica, planificare, consiliu de critici, error->retry->fallback, resource guard.
Livrabil: agenti care planifica, construiesc, critica, repara pe tot pipeline-ul.
Test: un build complex multi-parte dus la capat de echipa, cu auto-reparare, logat.

## FAZA 9 - REZILIENTA & SCALARE (ops)
Scop: fabrica merge nesupravegheat, isi revine din erori, livreaza sigur.
Pasi: retry/fallback, stealth+proxy pt site-uri blocate, resource guard (RAM/disk/model_check), curatare disk, logging/alertare, backup, versionare, tinte deploy (GitHub/Netlify/Vercel/export).
Livrabil: factory rezistent.
Test: induc erori -> sistemul isi revine + termina.

## FAZA 10+ - PRODUCTIE PER PROIECT
Construim flagship-uri reale la calitate mondiala, unul cate unul, cu toata fabrica. (Aici reintra si situl de cafea, refacut complet.)

## BRIEF 7 INTREBARI (inainte de orice build de produs)
1) ce face produsul (core loop)  2) user tinta  3) diferentiator  4) must-have vs nice-to-have  5) vibe design + referinte + culori  6) auth/DB/backend  7) deadline sau explorare.

## START IMEDIAT (in chatul nou)
FAZA 0, PAS 0.1 - INVENTAR + REGISTRU CAPABILITATI.
Prima comanda: scanez VPS-ul (servicii PM2, porturi, scripturi /root, conectori, skills) si scriu un registru JSON in /root/factory/registry.json cu fiecare capabilitate: nume, tip, cum se apeleaza, input/output, status. Asta devine harta traseului. Apoi 0.2 model job.
