feat(#86): IMP-86 u1~u5 placeholder zones_data + invariant guard

Mapper FitError handler now appends a __empty__ placeholder to zones_data
and a matching debug_zone so the surviving cardinality stays in sync with
the active layout preset's grid rows. A pre-build_layout_css invariant
guard fails fast with preset/positions/count diagnostics if drift recurs.
Per-record telemetry (adapter_needed, mapper_fit_error, provisional) is
exposed on both placeholder records; authoritative slide_status.adapter_
needed_units schema is unchanged.

Closes mdx03 reject override regression: Step 12 AI router now reachable
without heights_px ValueError; default-path behavior unaffected.

u1 — FitError placeholder zones_data + debug_zone (src/phase_z2_pipeline.py)
u2 — pre-build_layout_css invariant guard (src/phase_z2_pipeline.py)
u3 — horizontal-2 normal+placeholder helper unit (test_compute_per_zone_geometry.py)
u4 — mdx03 reject override → Step 12 integration + default regression
u5 — placeholder telemetry surface (adapter_needed/mapper_fit_error/provisional)

Tests:
- u3 helper: 7 passed (0.06s)
- u4+u5 integration: 2 passed (7.87s)
- Phase Z2 + AI fallback regression: 544 passed (66.28s)
- Broader sweep (excl. matching/pipeline heavy): 1066 passed (96.12s)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.claude/settings.json

@@ -0,0 +1,415 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cmd /c \"npx -y figma-developer-mcp --help\")",
+      "Bash(npx -y figma-developer-mcp --version)",
+      "mcp__Framelink_Figma_MCP__get_figma_data",
+      "mcp__Framelink_Figma_MCP__download_figma_images",
+      "Bash(start \"\" \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/prerequisites-3col.html\")",
+      "Bash(python -c \"from selenium import webdriver; print\\('selenium OK'\\)\")",
+      "Bash(python -c ':*)",
+      "Bash(python)",
+      "Bash(start \"\" \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/bim-goal-circles.html\")",
+      "Bash(start \"\" \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/bg-shapes-only.html\")",
+      "Bash(start \"\" \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/bim-figma-devmode.html\")",
+      "Bash(claude mcp:*)",
+      "Bash(curl -sS -o /dev/null -w \"mcp endpoint: HTTP %{http_code}\\\\n\" http://127.0.0.1:3845/mcp)",
+      "Bash(curl -sS -o /dev/null -w \"sse endpoint: HTTP %{http_code}\\\\n\" http://127.0.0.1:3845/sse)",
+      "Bash(curl -sS -o /dev/null -w \"root: HTTP %{http_code}\\\\n\" http://127.0.0.1:3845/)",
+      "Bash(curl -s -o NUL -w \"%{http_code}\" http://127.0.0.1:3845/mcp)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://127.0.0.1:3845/sse --max-time 3)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://127.0.0.1:3845/mcp --max-time 3)",
+      "Bash(curl -s -X POST http://127.0.0.1:3845/mcp -H \"Content-Type: application/json\" -H \"Accept: application/json, text/event-stream\" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}}' --max-time 5)",
+      "Bash(curl -v http://127.0.0.1:3845/mcp)",
+      "Bash(curl -s -m 3 http://127.0.0.1:3845/sse)",
+      "Bash(curl -s -m 3 -o /dev/null -w \"%{http_code}\\\\n\" http://127.0.0.1:3845/sse)",
+      "mcp__figma-desktop__get_metadata",
+      "mcp__figma-desktop__get_screenshot",
+      "mcp__figma-desktop__get_design_context",
+      "Bash(curl -sSo bg_texture.png \"http://localhost:3845/assets/849658071be46a26936e8666e3722b2dd548aee7.png\")",
+      "Bash(curl -sSo arc_top.png \"http://localhost:3845/assets/f05ebf15a1125b6c5809f9ffa35b4e4e750687d3.png\")",
+      "Bash(curl -sSo arc_side.png \"http://localhost:3845/assets/2f0f17507c681b7bc2fb109f3d4fafb9ff2f7ce0.png\")",
+      "Bash(curl -sSo big_fill_productivity.svg \"http://localhost:3845/assets/21a89b8138bd47debcc6f12bb140ee63bbd9fdf2.svg\")",
+      "Bash(curl -sSo big_ring_productivity.svg \"http://localhost:3845/assets/fbe84134d2e14bbf84b2c42516e9b85ffe6f7c1e.svg\")",
+      "Bash(curl -sSo big_fill_safety.svg \"http://localhost:3845/assets/1f24875931dc3c36e2c841eaf5b94466fa035a48.svg\")",
+      "Bash(curl -sSo big_ring_safety.svg \"http://localhost:3845/assets/c5aeccdfc884051848fc60f04abf2a9d367dd731.svg\")",
+      "Bash(curl -sSo big_fill_trust.svg \"http://localhost:3845/assets/67ef527c29921d401d31032c02d6b3a0ae1d3050.svg\")",
+      "Bash(curl -sSo acc_outer_speed.svg \"http://localhost:3845/assets/1391787caa4cb8241a1adadbb2c70aed3625e1b8.svg\")",
+      "Bash(curl -sSo acc_inner_speed.svg \"http://localhost:3845/assets/eeb8e9bf8b1841215ae0253017512a7e4a6d5a95.svg\")",
+      "Bash(curl -sSo acc_inner_profit.svg \"http://localhost:3845/assets/4885055cba20f72e83401be371fe74b9b43ec869.svg\")",
+      "Bash(curl -sSo acc_outer_safety.svg \"http://localhost:3845/assets/688b5af1d813b16cd6410453e3d4d1f79c084222.svg\")",
+      "Bash(curl -sSo acc_inner_safety.svg \"http://localhost:3845/assets/2fab268821fc763dbdff12e1dd65820dfa9b628e.svg\")",
+      "Bash(ls block-tests/*.html block-tests/*.md)",
+      "Bash(python scripts/gradient_math.py --test)",
+      "Bash(python scripts/gradient_math.py --w 350 --h 350 --x1 110.833 --y1 18.2292 --x2 219.479 --y2 175 --stops \"0:#FDC69E,1:#E0782C\")",
+      "Bash(python -c \"from scripts.gradient_math import svg_to_css; print\\(svg_to_css\\(W=350,H=350,x1=110.833,y1=18.2292,x2=219.479,y2=175,stops=[\\(0,'#FDC69E'\\),\\(1,'#E0782C'\\)]\\)\\)\")",
+      "Bash(python render.py cards-3col-persona example)",
+      "Bash(python render.py cards-3col-persona example-no-photos)",
+      "Bash(python render.py cycle-3way-intersect example)",
+      "WebFetch(domain:claude.com)",
+      "WebFetch(domain:help.figma.com)",
+      "Bash(curl -sSo \"527bd7809f4b2e5f3cd42f2e713ccbfb37537d82.png\" \"http://localhost:3845/assets/527bd7809f4b2e5f3cd42f2e713ccbfb37537d82.png\")",
+      "Bash(ls \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/_renders/pill_flex_\"*)",
+      "Bash(awk '/visual_diff:/{found=1} found && /^- id:/{print NR\": \"$0; found=0}' \"d:/ad-hoc/kei/design_agent/templates/catalog.yaml\")",
+      "Bash(curl -s -o \"bg_slide_texture.png\" \"http://localhost:3845/assets/16a1b2ea5b64663a3ee44bfad24671a612952c29.png\")",
+      "Bash(curl -s -o \"line_divider.svg\" \"http://localhost:3845/assets/01731a60f7d9d35816932c019149e301a3aae1a7.svg\")",
+      "Bash(head -20 /d/ad-hoc/kei/design_agent/samples/mdx/01*.mdx)",
+      "Bash(head -20 /d/ad-hoc/kei/design_agent/samples/mdx/02*.mdx)",
+      "Bash(head -20 /d/ad-hoc/kei/design_agent/samples/mdx/03*.mdx)",
+      "Bash(ls -la /d/ad-hoc/kei/design_agent/data/runs/20260413_*/)",
+      "Bash(python -c \"from src.config import settings; print\\(f'API configured: {bool\\(settings.anthropic_api_key\\)}'\\)\")",
+      "Bash(python run_test.py)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://localhost:8000/health)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://localhost:8000/)",
+      "Read(//d/ad-hoc/kei/**)",
+      "Bash(curl -s http://localhost:8000/docs)",
+      "Bash(taskkill //F //IM python.exe)",
+      "Bash(python assemble_mdx02_test.py)",
+      "Bash(wc -c data/runs/20260407_*/final.html)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://localhost:8000/docs)",
+      "Bash(curl -s http://localhost:8080/docs -o /dev/null -w \"%{http_code}\")",
+      "Bash(curl -s http://localhost:8001/docs -o /dev/null -w \"%{http_code}\")",
+      "Bash(curl -s http://localhost:3000/ -o /dev/null -w \"%{http_code}\")",
+      "Bash(python assemble_mdx02_v3.py)",
+      "Bash(python assemble_mdx02_v4.py)",
+      "Bash(python assemble_mdx02_v5.py)",
+      "Bash(python assemble_mdx02_v6.py)",
+      "Bash(python assemble_mdx02_v7.py)",
+      "Bash(python assemble_mdx02_v8_3plans.py)",
+      "Bash(python assemble_mdx02_v9.py)",
+      "Bash(python build_plan1.py)",
+      "Bash(python build_plan2.py)",
+      "Bash(python build_plan3.py)",
+      "Bash(python build_plan1_v2.py)",
+      "Bash(python build_4plans_final.py)",
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" http://127.0.0.1:8000/docs)",
+      "Bash(uvicorn backend.main:app --port 8000)",
+      "Bash(python final_plan1.py)",
+      "Bash(python final_plan2.py)",
+      "Bash(python build_all_4plans.py)",
+      "Bash(python build_plan3_kei.py)",
+      "Bash(python build_plan4_kei.py)",
+      "Bash(python make_4plans.py)",
+      "Bash(ls -la \"d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/html_render_final\"*)",
+      "Bash(taskkill //PID 48540 //F)",
+      "Bash(python make_mdx03.py)",
+      "Bash(python run_mdx03_pipeline.py)",
+      "Bash(powershell -Command \"Get-Process python -ErrorAction SilentlyContinue | Select-Object Id,StartTime\")",
+      "Bash(grep \"class FontHierarchy\" src/*.py)",
+      "Bash(ls -ltr /d/ad-hoc/kei/design_agent/data/runs/*/step_*_context.json)",
+      "Bash(awk '{print $2}')",
+      "Bash(stat /d/ad-hoc/kei/design_agent/data/runs/20260414_120225/stage_*_context.json)",
+      "Bash(ls -la /d/ad-hoc/kei/design_agent/data/runs/20260414_120225/stage_*_context.json)",
+      "Bash(awk '{print $6, $7, $8, $9}')",
+      "Bash(ls -lt data/runs/20260414_120225/*_context.json)",
+      "Bash(awk '{print $6,$7,$8,$9}')",
+      "Bash(python -c \" import yaml with open\\('catalog.yaml'\\) as f: data = yaml.safe_load\\(f\\) blocks = data.get\\('blocks', []\\) for b in blocks: print\\(f\\\\\"{b['id']} | {b.get\\('category',''\\)} | items:{b.get\\('min_items','?'\\)}-{b.get\\('max_items','?'\\)}\\\\\"\\) \")",
+      "Bash(python add_tags.py)",
+      "Bash(python -c \"import src.block_reference; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.block_assembler; print\\('OK'\\)\")",
+      "Bash(ls -t d:/ad-hoc/kei/design_agent/docs/history/PHASE-*.md d:/ad-hoc/kei/design_agent/docs/history/IMPROVEMENT-PHASE-*.md)",
+      "Bash(python -c \"import src.pipeline_context; import src.kei_client; import src.pipeline; print\\('모든 import OK'\\)\")",
+      "Bash(python -c \"import src.step_visualizer; import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.block_assembler; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.block_assembler; import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.kei_client; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.block_assembler; import src.pipeline_context; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.validators; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.validators; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.validators; import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.section_parser; import src.block_assembler; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.block_assembler; import src.section_parser; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.pipeline; import src.block_assembler; import src.space_allocator; import src.pipeline_context; print\\('OK'\\)\")",
+      "Bash(grep -l \"pp2-grid-wrap\\\\|pp2\" templates/blocks/**/*.html)",
+      "Bash(echo file:///D:/ad-hoc/kei/design_agent/data/runs/20260415_110323/final.html)",
+      "Bash(python -c \"import src.block_reference; import src.section_parser; import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.block_assembler; import src.section_parser; import src.pipeline; print\\('OK'\\)\")",
+      "Bash(python -c \"import src.block_reference; import src.pipeline; import src.block_assembler; print\\('OK'\\)\")",
+      "Bash(ls d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/*.html)",
+      "Bash(ls d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/*_flat.md)",
+      "Bash(ls d:/ad-hoc/kei/design_agent/figma_to_html_agent/*.md d:/ad-hoc/kei/design_agent/figma_to_html_agent/*.json d:/ad-hoc/kei/design_agent/figma_to_html_agent/*.faiss)",
+      "Bash(ls d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/*.html d:/ad-hoc/kei/design_agent/figma_to_html_agent/block-tests/*.md)",
+      "Bash(python -c ' *)",
+      "Bash(ls d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281189/assets/*.svg)",
+      "Bash(ls -d d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/*/)",
+      "Bash(sort -t'\"' -k4)",
+      "Bash(awk -F: '{print $1}')",
+      "Bash(curl -sS -o fdcafc1b6ab639b9a4c75ce36014f3b16ea0fbc1.png \"http://localhost:3845/assets/fdcafc1b6ab639b9a4c75ce36014f3b16ea0fbc1.png\")",
+      "Bash(curl -sS -o 922ee6f4bea1434652ffc08f962086052286b6c5.png \"http://localhost:3845/assets/922ee6f4bea1434652ffc08f962086052286b6c5.png\")",
+      "Bash(curl -sS -o 5d27ecb194e670c9af26e98d11075b86c40efffa.svg \"http://localhost:3845/assets/5d27ecb194e670c9af26e98d11075b86c40efffa.svg\")",
+      "Bash(curl -sS -o 6d311a18898deded5376b25996a13757e8c42d17.svg \"http://localhost:3845/assets/6d311a18898deded5376b25996a13757e8c42d17.svg\")",
+      "Bash(curl -sS -o cab8c8284090fb4893d7f584cc6081370b115b11.svg \"http://localhost:3845/assets/cab8c8284090fb4893d7f584cc6081370b115b11.svg\")",
+      "Bash(curl -sS -o b0e9fad5b03f4d9e368524976c20c9886392e17b.png \"http://localhost:3845/assets/b0e9fad5b03f4d9e368524976c20c9886392e17b.png\")",
+      "Bash(curl -sS -o 7713e15d6eaebd868c6ea632c1199b94603af2fd.svg \"http://localhost:3845/assets/7713e15d6eaebd868c6ea632c1199b94603af2fd.svg\")",
+      "Bash(curl -sS -o bf1755273910e17f7a012ce2d269a93cca9483ac.svg \"http://localhost:3845/assets/bf1755273910e17f7a012ce2d269a93cca9483ac.svg\")",
+      "Bash(curl -sS -o b47d2977a36ab6a0c180d8f090afff798c44ed27.png \"http://localhost:3845/assets/b47d2977a36ab6a0c180d8f090afff798c44ed27.png\")",
+      "Bash(curl -sS -o b614390a7ec2f351fc8290d640bcd3e6b237bfb2.svg \"http://localhost:3845/assets/b614390a7ec2f351fc8290d640bcd3e6b237bfb2.svg\")",
+      "Bash(curl -sS -o ff649c28fd98518d6b48b9e5451fe1da4c1e95d5.svg \"http://localhost:3845/assets/ff649c28fd98518d6b48b9e5451fe1da4c1e95d5.svg\")",
+      "Bash(curl -sS -o 29c778b566aca6778f505874f21670de129351f8.svg \"http://localhost:3845/assets/29c778b566aca6778f505874f21670de129351f8.svg\")",
+      "Bash(curl -sS -o f808a8c71388afbadc21c5c4b4bbe76bcd73d420.png \"http://localhost:3845/assets/f808a8c71388afbadc21c5c4b4bbe76bcd73d420.png\")",
+      "Bash(curl -sS -o 855b9d71b1cce30bcd89b214265fa8b6de58968f.png \"http://localhost:3845/assets/855b9d71b1cce30bcd89b214265fa8b6de58968f.png\")",
+      "Bash(curl -sS -o 9de5354619ad8ba9f47efd104df0f388c6778cc1.png \"http://localhost:3845/assets/9de5354619ad8ba9f47efd104df0f388c6778cc1.png\")",
+      "Bash(curl -sS -o 461a9f67c756d5057df3efbe01c515beb0a07a59.png \"http://localhost:3845/assets/461a9f67c756d5057df3efbe01c515beb0a07a59.png\")",
+      "Bash(curl -sS -o 5a11195e0df9ff8292d56ab0c0bd78a31e95e2ba.png \"http://localhost:3845/assets/5a11195e0df9ff8292d56ab0c0bd78a31e95e2ba.png\")",
+      "Bash(curl -sS -o 62d8e408b8381ece554ed55d20d3b54e375f92cb.svg \"http://localhost:3845/assets/62d8e408b8381ece554ed55d20d3b54e375f92cb.svg\")",
+      "Bash(ls \"d:/ad-hoc/kei/design_agent\\(원본\\)/figma_to_html_agent/block-tests/\"*.html)",
+      "Bash(python scripts/eval_block_matcher.py)",
+      "Bash(python scripts/run_pipeline_v2.py)",
+      "Bash(python \"C:\\\\Users\\\\User\\\\.claude\\\\projects\\\\d--ad-hoc-kei-design-agent\\\\58697289-9e64-4f6b-955d-8f289d7ea0d1\\\\tool-results\\\\mcp-figma-desktop-get_metadata-1776417198239.txt\")",
+      "Bash(where python *)",
+      "Skill(update-config)",
+      "Skill(update-config:*)",
+      "Bash('C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe' -c ' *)",
+      "Bash(curl -s -o /dev/null -w \"HTTP %{http_code}\\\\n\" -m 3 http://127.0.0.1:3845/mcp)",
+      "Bash(curl -s -o /dev/null -w \"HTTP %{http_code}\\\\n\" -m 3 http://127.0.0.1:3845/sse)",
+      "Bash(curl -s -X POST http://127.0.0.1:3845/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}}' --max-time 5)",
+      "Bash(env)",
+      "Bash(curl -s -X POST http://127.0.0.1:3845/mcp -H \"Content-Type: application/json\" -H \"Accept: application/json, text/event-stream\" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0\"}}}')",
+      "Bash(python figma_to_html_agent/scripts/fetch_figma_screenshots.py)",
+      "Bash(xargs -I {} echo \"blocks/{}\")",
+      "Bash(python scripts/match_mdx_to_frames_tfidf.py)",
+      "WebSearch",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import bm25s; print\\('bm25s:', bm25s.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import kiwipiepy; print\\('kiwipiepy:', kiwipiepy.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -m pip install bm25s)",
+      "Bash(python scripts/fetch_all_frame_screenshots.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/run_all.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/by_section.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/matrix_simple.py)",
+      "Bash(python scripts/match_mdx_strict.py)",
+      "Bash(python scripts/match_17_units_my_matcher.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/extract_units.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/matrix_17.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/compare_hybrids.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/test_mdx03_1_depth.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/matrix_cases.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import markdown; print\\(markdown.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/md_to_html.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/case3.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" \"d:/ad-hoc/kei/design_agent/tests/matching/md_to_html.py\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/extract_rare_keywords.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/idf_only_test.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/case1_only.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/keyword_report.py)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import gensim; print\\('gensim:', gensim.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import sentence_transformers; print\\('sentence-transformers:', sentence_transformers.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -c \"import torch; print\\('torch:', torch.__version__\\)\")",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" -m pip install gensim)",
+      "Bash(\"C:\\\\Users\\\\User\\\\AppData\\\\Local\\\\Programs\\\\Python\\\\Python313\\\\python.exe\" tests/matching/phase2.py)",
+      "Bash(python tests/matching/phase2.py)",
+      "Bash(python tests/matching/md_to_html.py)",
+      "Bash(python tests/matching/phase3.py)",
+      "Bash(python tests/matching/phase4.py)",
+      "Bash(tasklist)",
+      "Bash(python tests/matching/phase4_1st.py)",
+      "Bash(python tests/matching/phase5.py)",
+      "Bash(python tests/matching/phase6.py)",
+      "Bash(python tests/matching/phase7.py)",
+      "Bash(python tests/matching/phase8.py)",
+      "Bash(python tests/matching/phase9.py)",
+      "Bash(python tests/matching/phase10.py)",
+      "Bash(python tests/matching/phase11.py)",
+      "Bash(python tests/matching/phase12.py)",
+      "Bash(python tests/matching/phase13.py)",
+      "Bash(python tests/matching/phase14.py)",
+      "Bash(python tests/matching/phase14_sample.py)",
+      "Bash(python tests/matching/phase15.py)",
+      "Bash(gh repo *)",
+      "Read(//d/for python//**)",
+      "Bash(git -C '/d/for python/__TRACKED_VAR__' remote -v)",
+      "Read(//d/for python/**)",
+      "Bash(git -C \"/d/for python/geulbeot-light/upload/\" remote -v)",
+      "Bash(git -C \"/d/for python/geulbeot-light/upload/\" log --oneline -5)",
+      "WebFetch(domain:github.com)",
+      "Bash(git -C /d/tmp/geulbeot-check log --oneline -10)",
+      "Bash(python -m py_compile domain_api.py converters/pipeline/step8_content.py)",
+      "Bash(node -c \"/d/for python/geulbeot-light/upload/static/js/generator.js\")",
+      "Bash(node --check \"/d/for python/geulbeot-light/upload/static/js/generator.js\")",
+      "Bash(python -m py_compile converters/pipeline/step8_content.py)",
+      "Bash(python tests/matching/phase16.py)",
+      "Bash(git -C figma_to_html_agent status --short)",
+      "Bash(xargs -I {} dirname {})",
+      "Bash(python tests/matching/phase17.py)",
+      "Bash(python tests/matching/phase18_21.py)",
+      "Bash(python tests/matching/phase22.py)",
+      "Bash(python tests/matching/synonyms_report.py)",
+      "Bash(python tests/matching/figma_audit.py)",
+      "Bash(sed -n '30,80p' figma_to_html_agent/blocks/1171281171/texts.md)",
+      "Bash(sed -n '500,540p' figma_to_html_agent/blocks/1171281171/texts.md)",
+      "Bash(python tests/matching/synonym_mine.py)",
+      "Bash(python tests/matching/phase23.py)",
+      "Bash(python tests/matching/domain_terms_report.py)",
+      "Bash(python tests/matching/phase23b.py)",
+      "Bash(python tests/matching/build_structure_ontology.py)",
+      "Bash(python tests/matching/phase21b.py)",
+      "Bash(python tests/matching/template_fit.py)",
+      "Bash(python template_fit.py)",
+      "Bash(awk '/^━━ MDX01-2/,/^━━ MDX02/')",
+      "Bash(awk '/^━━ MDX02/,/^━━ MDX03-1/')",
+      "Bash(awk '/^━━ MDX/ || /construction_goals/ || /policy_goals/ || /policy_achievement/ || /=== Result/ || /^✓/ || /^⚠/')",
+      "Bash(awk '/━━ MDX02/,/━━ MDX03-1/')",
+      "Bash(awk '/━━ MDX03-1/,/━━ MDX03-2/')",
+      "Bash(awk '/^━━/ || /sw_development_cycle_six/ || /domestic_bim_actor/ || /compensation_complaint/ || /field_effectiveness/ || /model_specialized/ || /=== Result/ || /^✓/ || /^⚠/')",
+      "Bash(git mv *)",
+      "Bash(mv phase23.py phase_domain_terms.py)",
+      "Bash(mv phase23b.py phase_domain_terms_v2.py)",
+      "Bash(python phase23.py)",
+      "Bash(python phase24.py)",
+      "Bash(python phase25.py)",
+      "Bash(python phase26.py)",
+      "Bash(python phase22.py)",
+      "Bash(python md_to_html.py)",
+      "Bash(python inspect_keywords.py)",
+      "Bash(python keyword_refinement.py)",
+      "Bash(python build_keyword_base.py)",
+      "Bash(python -c \"import yaml; d=yaml.safe_load\\(open\\('keyword_base.yaml',encoding='utf-8'\\)\\); print\\('keywords:', len\\(d['keywords']\\)\\); print\\('excluded:', len\\(d['excluded']\\)\\)\")",
+      "Bash(python clean_anchor_sets.py)",
+      "Bash(python sync_analysis_from_ontology.py)",
+      "Bash(awk '/^## 1. TARGET별/,/^## 2\\\\./' MATRIX_PHASE23.md)",
+      "Bash(python _rename_phase_refs.py)",
+      "Bash(python _fix_self_refs.py)",
+      "Bash(python _add_structure_intent.py)",
+      "Bash(python intent_diagnostic.py)",
+      "Bash(awk '/^## 1. TARGET/,/^## 2\\\\./' MATRIX_PHASE25.md)",
+      "Bash(python build_beps_summary.py)",
+      "Bash(python text_pipeline.py)",
+      "Bash(python tests/matching/pipeline_01_extract_nodes.py)",
+      "Bash(python tests/matching/pipeline_02_tokenize.py)",
+      "Bash(python tests/matching/pipeline_02_5_special_forms.py)",
+      "Bash(python tests/matching/pipeline_04a_smoke_test.py)",
+      "Bash(python tests/matching/pipeline_04_normalize.py)",
+      "Bash(python -c \"import markdown; print\\(markdown.__version__\\)\")",
+      "Bash(python tests/matching/generate_inventory_report.py)",
+      "Bash(python tests/matching/pipeline_05_anchor_candidates.py)",
+      "Bash(python tests/matching/pipeline_06_anchor_sets.py)",
+      "Bash(python tests/matching/pipeline_06_2_mdx_matching.py)",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_01_extract_nodes.py\")",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_02_tokenize.py\")",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_02_5_special_forms.py\")",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_04_normalize.py\")",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/generate_inventory_report.py\")",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_06_2_mdx_matching.py\")",
+      "Bash(python -c \"import paddleocr; print\\('paddleocr OK', paddleocr.__version__\\)\")",
+      "Bash(python -c \"import easyocr; print\\('easyocr OK', easyocr.__version__\\)\")",
+      "Bash(tesseract --version)",
+      "Bash(python -c \"import pytesseract; print\\('pytesseract OK'\\)\")",
+      "Bash(pip install *)",
+      "Bash(python -c \"import easyocr; print\\('OK', easyocr.__version__\\)\")",
+      "Bash(python scripts/ocr_augment_texts.py --only 1171281172)",
+      "Bash(python scripts/ocr_augment_texts.py)",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/pipeline_07_auto_anchor_candidates.py\")",
+      "Bash(cp anchor_sets_input.yaml anchor_sets_input.ai_curated_legacy.yaml)",
+      "Bash(cat)",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/generate_frame_keyword_review.py\")",
+      "Bash(mkdir -p _archive)",
+      "Bash(mv NORMALIZED_TOKEN_INVENTORY.html NORMALIZED_TOKEN_INVENTORY.md NORMALIZED_TOKEN_INVENTORY.before_plain_line.html _archive/)",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/generate_keyword_inventory.py\")",
+      "Bash(mv -f mdx_matching_report.html mdx_matching_report.md _archive/)",
+      "Bash(python pipeline_06_2_mdx_matching.py)",
+      "Bash(python \"d:/ad-hoc/kei/design_agent/tests/matching/generate_filter_candidates.py\")",
+      "Bash(python pipeline_04_normalize.py)",
+      "Bash(python pipeline_07_auto_anchor_candidates.py)",
+      "Bash(python generate_keyword_inventory.py)",
+      "Bash(python generate_frame_keyword_review.py)",
+      "Bash(python generate_filter_candidates.py)",
+      "Bash(python pipeline_01_extract_nodes.py)",
+      "Bash(python pipeline_02_tokenize.py)",
+      "Bash(awk '{print $6,$7,$8,$NF}')",
+      "Bash(python pipeline_08_v3_structure_rerank.py)",
+      "Bash(python pipeline_08_v4_template_fit_judgment.py)",
+      "Bash(python pipeline_08_5_matching_report.py)",
+      "Bash(awk '{print $5, $NF}')",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(python pipeline_09_v2_diagnosis.py)",
+      "Bash(python pipeline_10_holdout_labeling_prep.py)",
+      "Bash(python pipeline_10_5_holdout_eval.py)",
+      "Bash(python pipeline_11_templates_v1_audit.py)",
+      "Bash(python pipeline_12_generate_templates_v2.py)",
+      "Bash(python pipeline_12_r2_generate_templates_v2.py)",
+      "Bash(python pipeline_12_r3_generate_templates_v2.py)",
+      "Bash(python pipeline_12_finalize_v2.py)",
+      "Bash(python pipeline_08_v3_r2_structure_rerank.py)",
+      "Bash(python pipeline_08_v3_r3_structure_rerank.py)",
+      "Bash(python pipeline_08_v3_r4_structure_rerank.py)",
+      "Bash(python pipeline_12_promote_frame13.py)",
+      "Bash(python pipeline_08_v3_r5_structure_rerank.py)",
+      "Bash(python pipeline_08_v4_r2_template_fit_judgment.py)",
+      "Bash(python pipeline_08_5_r2_matching_report.py)",
+      "Bash(python pipeline_13_generate_meeting_samples.py)",
+      "Bash(python pipeline_13_r2_meeting_docs.py)",
+      "Bash(python pipeline_14_single_sample.py)",
+      "Bash(python pipeline_15_idf_comparison.py)",
+      "Bash(python pipeline_15_bm25_comparison.py)",
+      "Bash(python pipeline_15_bm25_with_sets.py)",
+      "Bash(python -c \"import sklearn; print\\(sklearn.__version__\\)\")",
+      "Bash(python pipeline_15_logistic_regression.py)",
+      "Bash(python pipeline_16_deck_4pages.py)",
+      "Bash(python pipeline_17_v4_full32.py)",
+      "Bash(python tests/matching/pipeline_16_deck_4pages.py)",
+      "Bash(python pipeline_18_slot_axis_ablation.py)",
+      "Bash(python tests/matching/pipeline_18_slot_axis_ablation.py)",
+      "Bash(cp tests/matching/pipeline_01_extract_nodes.py tests/pipeline/code/)",
+      "Bash(cp tests/matching/pipeline_02_tokenize.py tests/pipeline/code/)",
+      "Bash(cp tests/matching/pipeline_02_5_special_forms.py tests/pipeline/code/)",
+      "Bash(cp tests/matching/pipeline_04_normalize.py tests/pipeline/code/)",
+      "Bash(cp tests/matching/pipeline_05_anchor_candidates.py tests/pipeline/code/)",
+      "Bash(python _tmp_inject.py)",
+      "Bash(python _tmp_inject2.py)",
+      "Bash(python _tmp_fix.py)",
+      "Bash(python _tmp_fix2.py)",
+      "Bash(grep -n \"^---$\" tests/PIPELINE.md)",
+      "Bash(python _tmp_replace_col.py)",
+      "Bash(python3)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1_test1)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1_test2)",
+      "Bash(awk '/data-template-id=\"process_product_two_way\"/,/<\\\\/div>/' d:/ad-hoc/kei/design_agent/data/runs/mvp1_test2/phase_z2/final.html)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1_test3)",
+      "Bash(awk '/data-template-id=\"process_product_two_way\"/,/<\\\\/div>$/' d:/ad-hoc/kei/design_agent/data/runs/mvp1_test3/phase_z2/final.html)",
+      "Bash(awk '/data-col=\"process\"/,/data-col=\"product\"/' d:/ad-hoc/kei/design_agent/data/runs/mvp1_test3/phase_z2/final.html)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1_test4)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1_test5)",
+      "Bash(curl -sS -o /dev/null -w \"HTTP %{http_code}\\\\n\" http://127.0.0.1:3845/sse --max-time 3)",
+      "Bash(mkdir -p d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281210/assets d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281210/_renders)",
+      "Bash(curl -sSo arrow.png \"http://localhost:3845/assets/0ad6379ae47598a529dba23bbc5730ba1da7117f.png\")",
+      "Bash(curl -sSo body_bg.svg \"http://localhost:3845/assets/7e328327e3e54e3989e2c6b76545de69fbc6f327.svg\")",
+      "Bash(curl -sSo header_left_bg.svg \"http://localhost:3845/assets/80402d8da588fab7aa4c209de37e71f9b22c4d47.svg\")",
+      "Bash(curl -sSo header_right_bg.svg \"http://localhost:3845/assets/a7d2b0029efb030aaac60ec160ba5a5b39a3b17a.svg\")",
+      "Bash(python blocks/1171281210/_render.py)",
+      "Bash(python -c \"from PIL import Image; im=Image.open\\('blocks/1171281210/_renders/slide.png'\\); im2=im.resize\\(\\(im.size[0]*2, im.size[1]*2\\), Image.LANCZOS\\); im2.save\\('blocks/1171281210/_renders/slide_2x.png'\\); print\\(im.size, '->', im2.size\\)\")",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5_test1)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5_test2)",
+      "Bash(mkdir -p d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281174/assets d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281174/_renders)",
+      "Bash(curl -sSo header_pill.png \"http://localhost:3845/assets/acafc8a08706fff6b50942c715048b6720570afd.png\")",
+      "Bash(curl -sSo pin_icon.png \"http://localhost:3845/assets/0ecfd235666abd5299c05395f02fdc7add6085b9.png\")",
+      "Bash(curl -sSo text_bubble.png \"http://localhost:3845/assets/944d66dab1fd437246764c06e3b4264dcee933a9.png\")",
+      "Bash(curl -sSo badge_01.png \"http://localhost:3845/assets/42dca7c1ca42ba8520aa274fd4471bd054dfe36b.png\")",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5_test3)",
+      "Bash(python blocks/1171281174/_render.py)",
+      "Bash(python -c \"from PIL import Image; im=Image.open\\('blocks/1171281174/_renders/block.png'\\); im2=im.resize\\(\\(im.size[0]*2, im.size[1]*2\\), Image.LANCZOS\\); im2.save\\('blocks/1171281174/_renders/block_2x.png'\\); print\\('size:', im.size, '->', im2.size\\)\")",
+      "Bash(mkdir -p d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281179/assets d:/ad-hoc/kei/design_agent/figma_to_html_agent/blocks/1171281179/_renders)",
+      "Bash(curl -sSo title_icon.png \"http://localhost:3845/assets/b0e9fad5b03f4d9e368524976c20c9886392e17b.png\")",
+      "Bash(curl -sSo card_decor.png \"http://localhost:3845/assets/69b6281daa6320fdc36d844cfcfb086fcb102123.png\")",
+      "Bash(python blocks/1171281179/_render.py)",
+      "Bash(python -c \"from PIL import Image; im=Image.open\\('blocks/1171281179/_renders/slide.png'\\); im2=im.resize\\(\\(im.size[0]*2, im.size[1]*2\\), Image.LANCZOS\\); im2.save\\('blocks/1171281179/_renders/slide_2x.png'\\); print\\(im.size, '->', im2.size\\)\")",
+      "Bash(python -c \"from PIL import Image; im=Image.open\\('blocks/1171281179/_renders/slide.png'\\); im.resize\\(\\(im.size[0]*2, im.size[1]*2\\), Image.LANCZOS\\).save\\('blocks/1171281179/_renders/slide_2x.png'\\)\")",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5a_test1)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test1)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test2)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test4)",
+      "Read(//tmp/**)",
+      "Read(//d/tmp/**)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test5)",
+      "Bash(python run_mdx03_pipeline.py --phase-z2 --run-id mvp1.5b_test7)"
+    ],
+    "additionalDirectories": [
+      "d:\\ad-hoc\\kei\\design_agent\\templates\\blocks\\new",
+      "d:\\ad-hoc\\kei\\design_agent\\figma_to_html_agent\\blocks",
+      "d:\\ad-hoc\\kei\\design_agent\\figma_to_html_agent\\blocks\\1171281193\\assets",
+      "D:\\"
+    ]
+  },
+  "enabledMcpjsonServers": [
+    "figma-desktop"
+  ]
+}

.gitignore

@@ -8,4 +8,11 @@ dist/
 build/
 .venv/
 node_modules/
-data/
+data/*
+# IMP-46 u6 — track only the frame_cache directory marker; cached payloads stay ignored.
+!data/frame_cache/
+data/frame_cache/*
+!data/frame_cache/.gitkeep
+
+# session workspace (push X — 작업 흐름 trace, 사용자 결정 2026-05-08)
+forex/

.mcp.json

@@ -1,15 +1,8 @@
 {
   "mcpServers": {
-    "Framelink Figma MCP": {
-      "command": "cmd",
-      "args": [
-        "/c",
-        "npx",
-        "-y",
-        "figma-developer-mcp",
-        "--figma-api-key=figd_s23TfSDL0hS97DIialy0R2P6QsoZQHfuGx1l_t-k",
-        "--stdio"
-      ]
+    "figma-desktop": {
+      "type": "http",
+      "url": "http://127.0.0.1:3845/mcp"
     }
   }
 }

ARCHITECTURE_OVERVIEW.md

@@ -1,4 +1,12 @@
-# Design Agent 전체 구조 파악 리포트
+# ⚠ DEPRECATED — 이 문서는 2026-03-27 기준 스냅샷입니다
+
+> **최신 파이프라인 문서는 [`PIPELINE.md`](PIPELINE.md)를 참조하세요.**
+> 이 문서는 Type A/B 분기, B'/B'' 변형, Stage 1.7/1.8 등 현재 구조를 반영하지 않습니다.
+> 히스토리 참고용으로만 유지합니다.
+
+---
+
+# Design Agent 전체 구조 파악 리포트 (archived)
 
 **작성일:** 2026-03-27  
 **목표:** design_agent의 아키텍처, 파이프라인, 코드 구조를 체계적으로 이해

CLAUDE.md

@@ -12,10 +12,89 @@
 
 ---
 
-## 아키텍처 (Phase Q 파이프라인)
+## 위계 + 용어 (Phase Z 정리, 2026-04-28)
+
+> 매칭 시스템 (V1~V4) 통합 설계 시 정리. 상세는 [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md) 4 장 참조.
+>
+> Phase Z 사전 작업 — Frame Zone 적용 분류 [`docs/architecture/FRAME-INTEGRATION-MAP.md`](docs/architecture/FRAME-INTEGRATION-MAP.md), Frame / Style / Token 인벤토리 [`docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md`](docs/architecture/PHASE-Z-FRAME-STYLE-INVENTORY.md).
+
+### 슬라이드 위계
+
+```
+[ slide ] 1280×720 (전체 슬라이드)
+   │
+   ├─ slide-title           ← MDX 대목차 제목 (자동 매핑)
+   ├─ slide-divider         (고정)
+   │
+   ├─ slide-body ≈ 1200×590 (콘텐츠 영역 — `templates/blocks/slide-base.html`)
+   │     │
+   │     └─ 레이아웃 (8-preset layout vocabulary; legacy hint = Type A/B/B'/B'')
+   │           │
+   │           └─ Zone (top / bottom_l / bottom_r 등)
+   │                 │
+   │                 └─ 프레임 (Figma 디자인 단위)
+   │
+   └─ slide-footer          ← MDX 대목차 결론 (자동 매핑)
+```
+
+### 용어
+
+| 용어 | 의미 |
+|---|---|
+| **슬라이드** | 1280×720 한 장 |
+| **slide-base** | 모든 슬라이드 공통 그릇 (배경 + 제목 + 구분선 + 결론 pill) — `templates/blocks/slide-base.html` |
+| **slide-body** | 본문 가용 영역 (≈ 1200×590) |
+| **레이아웃 (Layout)** | 8-preset layout vocabulary — slide-body 안 zone 분배 형태 (legacy hint = Type A/B/B'/B'') |
+| **Zone (영역)** | 레이아웃이 결정한 콘텐츠 구역 |
+| **Internal Region** | Zone 안의 placement / planning unit (Layer A) — content_object 를 배치하는 내부 영역 (SPEC v1 §2) |
+| **컨테이너 (Container)** | zone 의 px 명세 (코드 레벨) |
+| **프레임 (Frame)** | Figma 디자인 단위 (= 기존 "블록") — zone 안 |
+| **Frame Slot** | Frame 안의 declared placement slot (Layer B) — frame contract 가 선언하는 콘텐츠 placement target (SPEC v1 §3) |
+| **Layer A** | composition planning 의 zone-내 layer — content_object 를 Internal Region 으로 배치하는 단위 (SPEC v1 §1~§2) |
+| **Layer B** | frame contract 기반 frame-내 layer — 콘텐츠 매핑 대상인 Frame Slot 구조를 선언하는 단위 (SPEC v1 §3) |
+
+### MDX → 슬라이드 매핑
+
+| MDX 위치 | 슬라이드 위치 |
+|---|---|
+| `# 대목차 제목` | `slide-title` |
+| 본문 (`##` / `###`) | `slide-body` 안 (레이아웃 + zone + 프레임) |
+| `# 대목차 결론` | `slide-footer` |
+| `<details>` 팝업 | 슬라이드 위 별도 레이어 |
+
+Layer A planning telemetry is active in trace-only mode; render path activation remains the next axis.
+
+---
+
+## 아키텍처 — Phase Z 흐름 (5 단계)
+
+> 상세는 [`IMPROVEMENT-REDESIGN.md`](IMPROVEMENT-REDESIGN.md) 5 장 참조.
+
+```
+STAGE 1) MDX 분석 + 레이아웃 매칭 (8-preset layout vocabulary; legacy = Type A/B/B'/B'')
+STAGE 2) Zone 별 텍스트 1차 배치
+STAGE 3) Zone 별 프레임 매칭 (V1~V4; B4 frame_selection evidence integration pending)
+            ├ 매칭 완벽   → 텍스트 업데이트
+            ├ 매칭 어정쩡 → 디자인 참고 재구성
+            └ 매칭 안 됨  → 디자인 컨셉 바탕 재구성
+STAGE 4) 프레임 검토 + 컨테이너 조정 (5 차 Fallback)
+STAGE 5) HTML 조립 + 검증 + 출력
+```
+
+핵심 원칙 :
+- **MDX 1 파일 = 슬라이드 1 장** (절대 분할 X)
+- **텍스트 원문 무손실 보존** (본문 미리보기 + 팝업 원문)
+- **자유 디자인 금지** (항상 Figma 프레임 DB 참고)
+- **불일치 시 레이아웃 회귀** (콘텐츠 줄이지 않고 그릇 변경)
+
+---
+
+## 아키텍처 (Phase Q 파이프라인 — 기존)
 
 > Phase P(다후보 렌더링 비교) 실행 결과 20/100점. 업계 조사(Beautiful.ai, Napkin.ai, VASCAR 등) 기반으로 Phase Q에서 재설계.
 > 핵심 전환: "계산 먼저, AI 판단 나중에, 렌더링은 검증만"
+>
+> ⚠️ Phase Z (매칭 시스템 통합) 진행 후 이 섹션의 일부는 새 흐름으로 대체될 예정.
 
 ```
 [1단계] Kei 실장 (Opus) — AI 사고
@@ -65,30 +144,48 @@ reference 꼭지 있음 → sidebar-right
 나머지 → single-column
 ```
 
-### 역할 분리 (Phase R')
+### 역할 분리 (Phase Z)
+
+> ⚠️ Phase R' 의 역할 분리 (AI 가 HTML 구조 직접 생성) 는 **Phase Z 에서 폐기**. 아래는 Phase Z 기준.
 
 | 역할 | 담당 | 방식 | 하는 일 | 하지 않는 일 |
 |------|------|------|---------|------------|
-| Kei 실장 | Opus (Kei API) | AI | 꼭지 추출, 비중 판단, relation_type + expression_hint 부여, 최종 검수 | HTML 생성, 레이아웃 계산 |
-| 컨테이너 계산 | 코드 | 결정론적 | Kei 비중 → 역할별 컨테이너 px 확정 | AI 판단 불필요 |
-| 프리셋 선택 | 코드 | 규칙 | 실장의 role에 따라 프리셋 자동 선택 | AI 판단 불필요 |
-| **HTML 생성** | **AI (Kei API)** | **AI** | **콘텐츠 전달 의도에 맞는 HTML 구조를 직접 생성. 블록 CSS를 참고하되 구조는 AI가 결정.** | 블록 "선택" 안 함. 슬롯 "채우기" 안 함. |
-| 검증 | 코드 + AI | Selenium + 비전 모델 | overflow 측정, 시각 품질 평가 | |
+| Kei 실장 | Opus (Kei API) | AI | MDX 본문 분석 보조, 최종 검수 | HTML 생성, 레이아웃 계산 |
+| 레이아웃 결정 | 코드 | 룰 매칭 | MDX 콘텐츠 → 8-preset layout vocabulary 기반 slide/zone topology 선택 (legacy hint = Type A/B/B'/B'') | — |
+| 컨테이너 계산 | 코드 | 결정론적 | zone 별 px 확정 (`space_allocator`) | — |
+| 프레임 매칭 | 코드 (V1~V4; B4 frame_selection evidence integration pending) | 결정론적 | zone ↔ Figma 프레임 매칭 | — |
+| **콘텐츠 매핑** | **코드 + AI** | **하이브리드** | **zone 안 콘텐츠 / 텍스트를 프레임 슬롯에 배치 / 다듬기 / 변형** | **HTML 구조 생성 X** |
+| HTML 조립 | 코드 (Jinja2) | 결정론적 | `slide-base` + 프레임 + 슬롯 콘텐츠 합쳐서 final.html | AI 호출 X |
+| 검증 | 코드 + AI | Selenium + Vision | overflow 측정, 시각 품질 평가 | — |
 
-### HTML 생성 원칙 (Phase R')
+### HTML 생성 원칙 (Phase Z)
 
 ```
-블록이 구조를 결정 (P=Q=R, 실패) → 콘텐츠가 구조를 결정 (R', 접근 C)
+블록이 구조를 결정 (P=Q=R, 실패)
+콘텐츠가 구조를 결정 (R', 폐기 — AI 가 HTML 직접 생성하면 회귀 가능성 큼)
+→ slide-base + 프레임 DB 가 구조를 결정, AI 는 zone 안 콘텐츠만 (Phase Z)
 ```
 
-- AI가 콘텐츠 전달 의도(expression_hint)에 맞는 HTML 구조를 직접 생성
-- 기존 38개 블록의 CSS(색상, 폰트, 배경, radius)를 **스타일 참고**로 활용
-- 블록을 **"선택"하지 않음**. topic 합침/분리, 포함 관계, 핵심 메시지 분리 가능
-- 디자인 토큰(CSS 변수)으로 품질 제약 + Selenium 측정 + 비전 모델 검증
+**Phase Z 의 핵심 원칙**:
+- **HTML 구조** = `slide-base.html` + 코드 (Jinja2) 가 결정 (절대 AI 가 생성 X)
+- **AI 의 역할** = zone 안 콘텐츠 매핑 / 텍스트 다듬기 / 디자인 변형 (콘텐츠 단위)
+- **프레임 DB 참고 필수** — 자유 디자인 금지
+- **MDX 원문 무손실 보존** (본문 preview, 팝업에 원문)
+
+⚠️ **Phase R' 회귀 방지**: AI 한테 "HTML 구조 만들어줘" 같은 호출 절대 X. AI 호출은 zone 안 콘텐츠 단위로만.
 
 ---
 
-## 핵심 프로세스
+## 핵심 프로세스 (구 Phase Q 기준 — Phase Z 에서 대체됨)
+
+> ⚠️ **아래 흐름은 구 Phase Q 기준의 5 단계 (Kei 실장 → 디자인 팀장 → 텍스트 편집자 → 디자인 실무자 → 재검토). Phase Z 에서 대체됨.**
+>
+> **신규 흐름은 위 "아키텍처 — Phase Z 흐름 (5 단계)" 섹션 또는 [IMPROVEMENT-REDESIGN.md](IMPROVEMENT-REDESIGN.md) 5 장 따름.**
+>
+> ⚠️ **특히 Phase Z 와 충돌하므로 무시할 것**:
+> - "페이지 분리" → Phase Z: MDX 1 파일 = 슬라이드 1 장 (절대 분할 X)
+> - "텍스트 압축 / 요약" → Phase Z: MDX 원문 무손실 보존 (본문 preview, 팝업 원문)
+> - "AI 5 단계" → Phase Z: AI 호출은 zone 안 콘텐츠 단위로만 (HTML 구조 / 레이아웃 / 프리셋 결정 X)
 
 ```
 사용자 콘텐츠 입력 (텍스트/MDX 붙여넣기 또는 파일 업로드)

Front/.gitignore

@@ -0,0 +1,115 @@
+# Dependencies
+**/node_modules
+.pnpm-store/
+
+# Build outputs
+dist/
+build/
+*.dist
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Dependency directories
+jspm_packages/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+
+# Gatsby files
+.cache/
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Webdev artifacts (checkpoint zips, migrations, etc.)
+.webdev/
+
+# Manus version file (auto-generated, not part of source)
+client/public/__manus__/version.json
+
+# Manus dev tooling (browser console / network logs)
+.manus-logs/

Front/.prettierignore

@@ -0,0 +1,5 @@
+dist
+node_modules
+.git
+*.min.js
+*.min.css

Front/.prettierrc

@@ -0,0 +1,15 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": false,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "proseWrap": "preserve"
+}

Front/8_body_layouts_final.html

@@ -0,0 +1,269 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <title>8 Body Layouts for slide-base.html</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@500;700;900&display=swap" rel="stylesheet">
+    <style>
+        body { font-family: 'Noto Sans KR', sans-serif; background: #e8ecf0; padding: 20px; }
+        .preview-section { margin-bottom: 50px; border: 2px solid #cbd5e1; padding: 20px; background: #f1f5f9; }
+        .layout-title { font-size: 18px; font-weight: 900; margin-bottom: 10px; color: #475569; }
+        
+        /* ── slide-base.html의 slide-body 제약 사항 ── */
+        .slide-body-mock {
+            width: 1200px; /* calc(1280 - 80) */
+            height: 590px;
+            background: #fff;
+            position: relative;
+            overflow: hidden;
+            /* 실제 템플릿의 slide-body는 부모(slide)에 대해 absolute이지만, 
+               여기서는 레이아웃 자체를 확인하기 위해 고정 크기로 둡니다. */
+        }
+
+        /* ── 하드코딩된 스타일 가이드 ── */
+        .h2-title { font-size: 38px; font-weight: 900; line-height: 1.2; color: #0f172a; }
+        .p-content { font-size: 22px; font-weight: 500; line-height: 1.6; color: #334155; }
+        .card-title { font-size: 24px; font-weight: 900; color: #1e293b; }
+        .card-p { font-size: 16px; font-weight: 700; color: #64748b; }
+    </style>
+</head>
+<body>
+
+    <!-- 01. Focus Split (Single) -->
+    <div class="preview-section">
+        <div class="layout-title">01. Focus Split (65:35 Ratio)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex items-center px-12 gap-16">
+                <div class="flex-[6.5] space-y-6">
+                    <div class="w-16 h-2 bg-emerald-600 rounded-full"></div>
+                    <h2 class="h2-title">DX 역량 내재화 및 추진 체계 고도화</h2>
+                    <p class="p-content">
+                        단순 기술 도입을 넘어 조직 전반의 데이터 리터러시를 확보하고, 전담 조직 구성을 통해 실행력을 극대화해야 합니다.
+                    </p>
+                </div>
+                <div class="flex-[3.5] h-[450px] bg-slate-50 rounded-[40px] border-2 border-slate-100 flex flex-col items-center justify-center p-10 text-center relative shadow-inner">
+                    <div class="w-24 h-24 bg-white rounded-3xl shadow-xl flex items-center justify-center mb-8 border border-slate-50">
+                        <div class="w-10 h-10 bg-emerald-600 rounded-xl"></div>
+                    </div>
+                    <h3 class="card-title mb-4">Strategic Goal</h3>
+                    <p class="card-p">데이터 기반 의사결정 체계 구축을 통한 효율성 40% 향상</p>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 02. Quadrant Grid (2x2) -->
+    <div class="preview-section">
+        <div class="layout-title">02. Quadrant Grid (Equal 4 Sectors)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full grid grid-cols-2 grid-rows-2 gap-8 p-12">
+                <div class="bg-slate-50 rounded-[32px] border-2 border-slate-100 p-8 flex flex-col justify-between">
+                    <div class="flex items-center gap-4">
+                        <span class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-900 text-white font-black text-sm">01</span>
+                        <h3 class="card-title">Strategy</h3>
+                    </div>
+                    <p class="card-p pl-14">전사적 DX 비전 수립 및 세부 로드맵 도출</p>
+                    <div class="pl-14"><div class="w-full h-2 bg-emerald-600 rounded-full"></div></div>
+                </div>
+                <div class="bg-slate-50 rounded-[32px] border-2 border-slate-100 p-8 flex flex-col justify-between">
+                    <div class="flex items-center gap-4">
+                        <span class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-900 text-white font-black text-sm">02</span>
+                        <h3 class="card-title">Data</h3>
+                    </div>
+                    <p class="card-p pl-14">통합 데이터 댐 구축 및 거버넌스 체계 강화</p>
+                    <div class="pl-14"><div class="w-full h-2 bg-emerald-200 rounded-full"></div></div>
+                </div>
+                <div class="bg-slate-50 rounded-[32px] border-2 border-slate-100 p-8 flex flex-col justify-between">
+                    <div class="flex items-center gap-4">
+                        <span class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-900 text-white font-black text-sm">03</span>
+                        <h3 class="card-title">AI Tech</h3>
+                    </div>
+                    <p class="card-p pl-14">LLM 기반 비즈니스 자동화 모델 현장 적용</p>
+                    <div class="pl-14"><div class="w-full h-2 bg-emerald-200 rounded-full"></div></div>
+                </div>
+                <div class="bg-slate-50 rounded-[32px] border-2 border-slate-100 p-8 flex flex-col justify-between">
+                    <div class="flex items-center gap-4">
+                        <span class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-900 text-white font-black text-sm">04</span>
+                        <h3 class="card-title">Agile</h3>
+                    </div>
+                    <p class="card-p pl-14">도메인 전문가 육성 및 애자일 문화 확산</p>
+                    <div class="pl-14"><div class="w-full h-2 bg-emerald-200 rounded-full"></div></div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 03. Three Column (1:1:1) -->
+    <div class="preview-section">
+        <div class="layout-title">03. Triple Pillars (Horizontal Comparison)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex gap-6 p-10">
+                <div class="flex-1 bg-white border-t-8 border-emerald-600 shadow-lg rounded-b-3xl p-8 flex flex-col">
+                    <h3 class="card-title mb-6">Phase 01</h3>
+                    <p class="card-p mb-auto">인프라 현대화 및 클라우드 네이티브 전환</p>
+                    <div class="mt-8 text-emerald-600 font-black text-sm uppercase tracking-tighter">Foundation</div>
+                </div>
+                <div class="flex-1 bg-white border-t-8 border-blue-600 shadow-lg rounded-b-3xl p-8 flex flex-col">
+                    <h3 class="card-title mb-6">Phase 02</h3>
+                    <p class="card-p mb-auto">데이터 통합 및 AI 서비스 파일럿 실행</p>
+                    <div class="mt-8 text-blue-600 font-black text-sm uppercase tracking-tighter">Integration</div>
+                </div>
+                <div class="flex-1 bg-white border-t-8 border-indigo-600 shadow-lg rounded-b-3xl p-8 flex flex-col">
+                    <h3 class="card-title mb-6">Phase 03</h3>
+                    <p class="card-p mb-auto">전사 확산 및 지속 가능한 AI 운영(MLOps)</p>
+                    <div class="mt-8 text-indigo-600 font-black text-sm uppercase tracking-tighter">Optimization</div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 04. Vertical List (Left Icon + Text) -->
+    <div class="preview-section">
+        <div class="layout-title">04. Vertical Stack (Step-by-step)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex flex-col justify-center px-24 space-y-8">
+                <div class="flex items-center gap-10 group">
+                    <div class="w-20 h-20 bg-emerald-50 rounded-2xl flex items-center justify-center text-emerald-600 font-black text-2xl border border-emerald-100 shadow-sm">01</div>
+                    <div class="space-y-1">
+                        <h3 class="card-title">데이터 기반 의사결정 문화 정착</h3>
+                        <p class="card-p">정량적 데이터 분석 결과에 근거한 객관적 판단 프로세스 구축</p>
+                    </div>
+                </div>
+                <div class="w-full h-px bg-slate-100 ml-30"></div>
+                <div class="flex items-center gap-10 group">
+                    <div class="w-20 h-20 bg-blue-50 rounded-2xl flex items-center justify-center text-blue-600 font-black text-2xl border border-blue-100 shadow-sm">02</div>
+                    <div class="space-y-1">
+                        <h3 class="card-title">AI 기술 리터러시 전사 확산</h3>
+                        <p class="card-p">생성형 AI 등 최신 기술 활용 역량 강화를 위한 단계별 교육 지원</p>
+                    </div>
+                </div>
+                <div class="w-full h-px bg-slate-100 ml-30"></div>
+                <div class="flex items-center gap-10 group">
+                    <div class="w-20 h-20 bg-indigo-50 rounded-2xl flex items-center justify-center text-indigo-600 font-black text-2xl border border-indigo-100 shadow-sm">03</div>
+                    <div class="space-y-1">
+                        <h3 class="card-title">디지털 기술을 통한 업무 혁신</h3>
+                        <p class="card-p">단순 반복 업무의 자동화를 통해 고부가가치 창의적 업무 집중 환경 조성</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 05. Key Number (Center Emphasis) -->
+    <div class="preview-section">
+        <div class="layout-title">05. Key Metric Emphasis</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex items-center p-12 gap-12">
+                <div class="flex-1 space-y-6">
+                    <h2 class="h2-title">DX 추진 성과 가시화</h2>
+                    <p class="p-content">지난 1년간의 디지털 전환 노력을 통해 달성한 핵심 지표입니다.</p>
+                </div>
+                <div class="flex-1 grid grid-cols-2 gap-6">
+                    <div class="bg-white p-8 rounded-[30px] shadow-xl border border-slate-50 text-center">
+                        <div class="text-[48px] font-black text-emerald-600 leading-none mb-2">35%</div>
+                        <div class="card-p">비용 절감 효과</div>
+                    </div>
+                    <div class="bg-white p-8 rounded-[30px] shadow-xl border border-slate-50 text-center">
+                        <div class="text-[48px] font-black text-blue-600 leading-none mb-2">2.4x</div>
+                        <div class="card-p">업무 속도 향상</div>
+                    </div>
+                    <div class="bg-white p-8 rounded-[30px] shadow-xl border border-slate-50 text-center">
+                        <div class="text-[48px] font-black text-indigo-600 leading-none mb-2">92%</div>
+                        <div class="card-p">직원 만족도</div>
+                    </div>
+                    <div class="bg-white p-8 rounded-[30px] shadow-xl border border-slate-50 text-center">
+                        <div class="text-[48px] font-black text-rose-600 leading-none mb-2">0건</div>
+                        <div class="card-p">보안 사고 발생</div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 06. Comparison (Before & After) -->
+    <div class="preview-section">
+        <div class="layout-title">06. Comparison Table (As-Is vs To-Be)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex flex-col p-12">
+                <div class="flex gap-6 mb-6">
+                    <div class="flex-1 py-4 bg-slate-900 text-white rounded-2xl text-center font-black text-xl">AS-IS</div>
+                    <div class="flex-1 py-4 bg-emerald-600 text-white rounded-2xl text-center font-black text-xl">TO-BE</div>
+                </div>
+                <div class="flex-1 space-y-4">
+                    <div class="flex gap-6">
+                        <div class="flex-1 p-6 bg-slate-100 rounded-2xl card-p">수작업 기반의 비정형 데이터 관리 및 보고</div>
+                        <div class="flex-1 p-6 bg-emerald-50 rounded-2xl card-title" style="font-size: 18px;">실시간 데이터 대시보드 및 자동 리포팅</div>
+                    </div>
+                    <div class="flex gap-6">
+                        <div class="flex-1 p-6 bg-slate-100 rounded-2xl card-p">파편화된 시스템으로 인한 업무 단절 발생</div>
+                        <div class="flex-1 p-6 bg-emerald-50 rounded-2xl card-title" style="font-size: 18px;">클라우드 기반의 통합 협업 플랫폼 운영</div>
+                    </div>
+                    <div class="flex gap-6">
+                        <div class="flex-1 p-6 bg-slate-100 rounded-2xl card-p">단기적 성과 위주의 산발적 과제 추진</div>
+                        <div class="flex-1 p-6 bg-emerald-50 rounded-2xl card-title" style="font-size: 18px;">중장기 로드맵 기반의 체계적 가치 창출</div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 07. Top Hero (Top Text + Bottom Cards) -->
+    <div class="preview-section">
+        <div class="layout-title">07. Hero Statement (Top Focus + Details)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex flex-col p-12">
+                <div class="flex-1 flex flex-col justify-center items-center text-center space-y-4 mb-8">
+                    <h2 class="h2-title" style="font-size: 42px;">미래 경쟁력 확보를 위한 AI 혁신</h2>
+                    <div class="w-20 h-1.5 bg-indigo-600 rounded-full"></div>
+                </div>
+                <div class="flex-[1.5] grid grid-cols-3 gap-8">
+                    <div class="border-2 border-slate-100 rounded-[30px] p-8 space-y-4">
+                        <div class="text-indigo-600 font-black text-lg">Infrastructure</div>
+                        <p class="card-p">GPU 서버 확보 및 데이터 레이크 고도화</p>
+                    </div>
+                    <div class="border-2 border-slate-100 rounded-[30px] p-8 space-y-4">
+                        <div class="text-indigo-600 font-black text-lg">Application</div>
+                        <p class="card-p">워크플로우 내 생성형 AI 에이전트 통합</p>
+                    </div>
+                    <div class="border-2 border-slate-100 rounded-[30px] p-8 space-y-4">
+                        <div class="text-indigo-600 font-black text-lg">Capability</div>
+                        <p class="card-p">AI 특화 인재 채용 및 리터러시 교육 프로그램</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- 08. Asymmetric Content (Left Detail + Right Small List) -->
+    <div class="preview-section">
+        <div class="layout-title">08. Asymmetric (Detailed View)</div>
+        <div class="slide-body-mock">
+            <div class="w-full h-full flex p-12 gap-16">
+                <div class="flex-[6] space-y-8">
+                    <div class="space-y-4">
+                        <span class="px-4 py-1.5 bg-slate-900 text-white text-[12px] font-black rounded-lg uppercase">Core Highlight</span>
+                        <h2 class="h2-title">지능형 운영 체계로의 전환</h2>
+                    </div>
+                    <p class="p-content">기존의 수동적인 운영 방식에서 벗어나, AI가 실시간으로 이상 징후를 감지하고 최적의 대응 방안을 제안하는 능동형 체계로 진화합니다.</p>
+                </div>
+                <div class="flex-[4] space-y-4">
+                    <div class="p-6 bg-slate-50 border border-slate-100 rounded-[24px]">
+                        <h4 class="font-black text-slate-800 mb-2">Real-time Analysis</h4>
+                        <p class="text-sm text-slate-500 font-bold">전 공정 데이터의 초단위 수집 및 분석</p>
+                    </div>
+                    <div class="p-6 bg-slate-50 border border-slate-100 rounded-[24px]">
+                        <h4 class="font-black text-slate-800 mb-2">Predictive Maint.</h4>
+                        <p class="text-sm text-slate-500 font-bold">장애 발생 전 사전 알림 및 조치 가이드</p>
+                    </div>
+                    <div class="p-6 bg-slate-50 border border-slate-100 rounded-[24px]">
+                        <h4 class="font-black text-slate-800 mb-2">Auto Optimization</h4>
+                        <p class="text-sm text-slate-500 font-bold">수요 예측 기반 생산량 자동 최적화</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+</body>
+</html>

Front/PLAN.md

@@ -0,0 +1,33 @@
+# Design Agent Frontend MVP Implementation Plan
+
+이 문서는 프론트엔드 MVP 개발 계획 및 Phase Z 시뮬레이션 구현 로드맵입니다.
+
+## 📅 로드맵
+
+### Phase 1: 동적 분석 시뮬레이션 (완료)
+- [x] MDX 파일 텍스트 분석 로직 구현 (`STAGE 1`)
+- [x] 섹션 개수에 따른 자동 레이아웃 및 존 매핑 로직 구현 (`STAGE 2`)
+- [x] 분석 결과에 따른 캔버스 동적 렌더링 연결
+
+### Phase 2: 사용자 인터랙션 강화 (진행 중)
+- [ ] 레이아웃 프리셋 변경 시 캔버스 즉시 갱신
+- [ ] 프레임 선택 시 캔버스 내 카드 스타일 변경 시뮬레이션
+- [ ] Zone/Region 선택 상태에 따른 시각적 피드백 정교화
+
+### Phase 3: 콘텐츠 상세화 및 팝업 시뮬레이션
+- [ ] MDX 원문 무손실 보존을 위한 팝업 UI 구현
+- [ ] `display_strategy` (Preview vs Full) 시뮬레이션 로직 추가
+- [ ] 최종 결과물 데이터 구조(JSON) 내보내기 기능
+
+## 📐 핵심 설계 원칙 (Phase Z 준수)
+
+1. **Deterministic Mapping:** 동일한 MDX 입력에 대해 항상 동일한 초기 레이아웃과 프레임이 제안되어야 함.
+2. **User Override Priority:** 사용자의 수동 선택은 시스템 추천보다 우선하며, 명시적으로 `overrides` 객체에 저장됨.
+3. **No-Loss Principle:** 슬라이드 캔버스 공간 부족으로 생략된 텍스트는 반드시 팝업을 통해 전체 확인이 가능해야 함.
+
+## 🔗 STAGE별 연결 지점
+
+- **STAGE 1 & 2:** `designAgentApi.ts`의 `parseMdxFile`, `generateSlidePlan`
+- **STAGE 3:** `FramePanel.tsx`의 `candidates` 매핑
+- **STAGE 4:** `Home.tsx`의 `handleLayoutSelect`, `handleFrameSelect`
+- **STAGE 5:** `Home.tsx`의 `Finalize Slide` 버튼 핸들러

Front/PROCESS.md

@@ -0,0 +1,54 @@
+# Design Agent Frontend MVP - Phase Z Simulation
+
+이 문서는 `design-agent` 프론트엔드 프로젝트가 백엔드 파이프라인(Phase Z)의 각 단계와 어떻게 연결되는지 설명합니다.
+
+---
+
+## 📋 STAGE-to-CODE 매핑 가이드
+
+본 MVP는 백엔드 없이도 파이프라인의 흐름을 시뮬레이션할 수 있도록 설계되었습니다.
+
+### STAGE 1: MDX 분석 (Normalization)
+- **백엔드 로직:** `section_parser.py` (H2, H3 태그 및 텍스트 블록 추출)
+- **프론트엔드 시뮬레이션:** `designAgentApi.ts` 내 `parseMdxFile()`
+  - 파일의 텍스트를 읽어 실제 `#`, `##`, `###` 패턴을 분석합니다.
+  - 결과를 `NormalizedContent` 객체로 변환합니다.
+
+### STAGE 2: 레이아웃 매칭 (Zone Mapping)
+- **백엔드 로직:** `layout_selector.py` (섹션 개수/성격에 따른 8개 프리셋 선택)
+- **프론트엔드 시뮬레이션:** `designAgentApi.ts` 내 `generateSlidePlan()`
+  - 분석된 섹션 개수에 따라 `single`, `horizontal-2`, `grid-2x2` 등을 자동으로 결정합니다.
+  - 각 섹션을 1280x720 캔버스의 특정 `Zone`에 할당합니다.
+
+### STAGE 3: 프레임 매칭 (V1~V4)
+- **백엔드 로직:** `block_reference.py` (Figma 프레임 DB와 콘텐츠 매칭)
+- **프론트엔드 시뮬레이션:** `mockDesignAgentData.ts` 및 `FramePanel.tsx`
+  - 각 Zone(또는 Region)에 대해 V4 매칭 점수가 높은 Top-3 프레임을 제안합니다.
+
+### STAGE 4: 사용자 조정 (Override)
+- **백엔드 로직:** `pipeline.py` (사용자 수동 선택값 반영)
+- **프론트엔드 구현:** `Home.tsx` 및 `slidePlanUtils.ts`
+  - 사용자가 선택한 Layout이나 Frame 정보를 `UserSelection.overrides`에 저장합니다.
+  - `applyLayout`, `applyFrame` 함수가 이 상태 변화를 관리합니다.
+
+### STAGE 5: 최종 조립 및 검증
+- **백엔드 로직:** `block_assembler.py` (Jinja2 템플릿 조립 및 Selenium 검증)
+- **프론트엔드 구현:** 하단 액션 바의 **Finalize Slide** 버튼
+  - 현재 구성된 플랜 데이터를 서버로 전송할 준비가 된 지점입니다.
+
+---
+
+## 🛠️ 핵심 파일 구조
+
+- `client/src/services/designAgentApi.ts`: 파이프라인 단계별 로직 시뮬레이션 핵심.
+- `client/src/types/designAgent.ts`: Phase Z 위계(Slide > Zone > Region > Frame) 정의.
+- `client/src/components/SlideCanvas.tsx`: 16:9 비율 및 레이아웃 프리셋 시각화.
+- `client/src/utils/slidePlanUtils.ts`: 사용자 선택 및 데이터 가공 유틸리티.
+
+---
+
+## 🚀 향후 통합 계획
+
+1. **API 교체:** `designAgentApi.ts`의 시뮬레이션 함수들을 실제 백엔드 엔드포인트 호출로 교체합니다.
+2. **실시간 프리뷰:** 백엔드에서 생성된 `final.html`을 캔버스 내 `iframe` 등으로 직접 렌더링하도록 확장합니다.
+3. **팝업 연동:** `display_strategy`에 따른 상세 원문 보기 기능을 실제 MDX 원문과 연결합니다.

Front/README.md

@@ -0,0 +1,44 @@
+# Design Agent Frontend
+
+React + Vite + TypeScript frontend.
+
+## 위치
+
+- `Front/` — 이 폴더
+- 원본 작업 위치 = `D:\ad-hoc\kei\design_agent_front\design-agent\` (로컬 dev)
+
+## 실행
+
+```
+cd Front/
+pnpm install
+pnpm dev
+```
+
+http://localhost:3000 에서 확인. `DESIGN_AGENT_ROOT` env 로 backend 경로 지정 가능.
+
+## 구조
+
+```
+Front/
+├── client/                React frontend (Vite root)
+│   └── src/
+│       ├── pages/
+│       ├── components/
+│       ├── services/
+│       └── ...
+├── server/                production express
+├── vite.config.ts         dev plugin + backend 연결
+└── ...
+```
+
+## Backend 연결 (vite.config.ts)
+
+Vite dev plugin 이 다음 endpoint 등록 :
+
+| Endpoint | 동작 |
+|---|---|
+| `POST /api/run` | MDX + overrides → backend pipeline spawn → run_id 반환 |
+| `GET /api/sample-mdx?mdx=...` | sample MDX serve |
+| `GET /frame-preview/{n}` | frame thumbnail |
+| `GET /data/runs/{run_id}/{path}` | pipeline 산출물 serve |

Front/client/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="ko">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1" />
+    <title>Design Agent - MDX Slide Planner</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans+KR:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

Front/client/public/__manus__/debug-collector.js

@@ -0,0 +1,821 @@
+/**
+ * Manus Debug Collector (agent-friendly)
+ *
+ * Captures:
+ * 1) Console logs
+ * 2) Network requests (fetch + XHR)
+ * 3) User interactions (semantic uiEvents: click/type/submit/nav/scroll/etc.)
+ *
+ * Data is periodically sent to /__manus__/logs
+ * Note: uiEvents are mirrored to sessionEvents for sessionReplay.log
+ */
+(function () {
+  "use strict";
+
+  // Prevent double initialization
+  if (window.__MANUS_DEBUG_COLLECTOR__) return;
+
+  // ==========================================================================
+  // Configuration
+  // ==========================================================================
+  const CONFIG = {
+    reportEndpoint: "/__manus__/logs",
+    bufferSize: {
+      console: 500,
+      network: 200,
+      // semantic, agent-friendly UI events
+      ui: 500,
+    },
+    reportInterval: 2000,
+    sensitiveFields: [
+      "password",
+      "token",
+      "secret",
+      "key",
+      "authorization",
+      "cookie",
+      "session",
+    ],
+    maxBodyLength: 10240,
+    // UI event logging privacy policy:
+    // - inputs matching sensitiveFields or type=password are masked by default
+    // - non-sensitive inputs log up to 200 chars
+    uiInputMaxLen: 200,
+    uiTextMaxLen: 80,
+    // Scroll throttling: minimum ms between scroll events
+    scrollThrottleMs: 500,
+  };
+
+  // ==========================================================================
+  // Storage
+  // ==========================================================================
+  const store = {
+    consoleLogs: [],
+    networkRequests: [],
+    uiEvents: [],
+    lastReportTime: Date.now(),
+    lastScrollTime: 0,
+  };
+
+  // ==========================================================================
+  // Utility Functions
+  // ==========================================================================
+
+  function sanitizeValue(value, depth) {
+    if (depth === void 0) depth = 0;
+    if (depth > 5) return "[Max Depth]";
+    if (value === null) return null;
+    if (value === undefined) return undefined;
+
+    if (typeof value === "string") {
+      return value.length > 1000 ? value.slice(0, 1000) + "...[truncated]" : value;
+    }
+
+    if (typeof value !== "object") return value;
+
+    if (Array.isArray(value)) {
+      return value.slice(0, 100).map(function (v) {
+        return sanitizeValue(v, depth + 1);
+      });
+    }
+
+    var sanitized = {};
+    for (var k in value) {
+      if (Object.prototype.hasOwnProperty.call(value, k)) {
+        var isSensitive = CONFIG.sensitiveFields.some(function (f) {
+          return k.toLowerCase().indexOf(f) !== -1;
+        });
+        if (isSensitive) {
+          sanitized[k] = "[REDACTED]";
+        } else {
+          sanitized[k] = sanitizeValue(value[k], depth + 1);
+        }
+      }
+    }
+    return sanitized;
+  }
+
+  function formatArg(arg) {
+    try {
+      if (arg instanceof Error) {
+        return { type: "Error", message: arg.message, stack: arg.stack };
+      }
+      if (typeof arg === "object") return sanitizeValue(arg);
+      return String(arg);
+    } catch (e) {
+      return "[Unserializable]";
+    }
+  }
+
+  function formatArgs(args) {
+    var result = [];
+    for (var i = 0; i < args.length; i++) result.push(formatArg(args[i]));
+    return result;
+  }
+
+  function pruneBuffer(buffer, maxSize) {
+    if (buffer.length > maxSize) buffer.splice(0, buffer.length - maxSize);
+  }
+
+  function tryParseJson(str) {
+    if (typeof str !== "string") return str;
+    try {
+      return JSON.parse(str);
+    } catch (e) {
+      return str;
+    }
+  }
+
+  // ==========================================================================
+  // Semantic UI Event Logging (agent-friendly)
+  // ==========================================================================
+
+  function shouldIgnoreTarget(target) {
+    try {
+      if (!target || !(target instanceof Element)) return false;
+      return !!target.closest(".manus-no-record");
+    } catch (e) {
+      return false;
+    }
+  }
+
+  function compactText(s, maxLen) {
+    try {
+      var t = (s || "").trim().replace(/\s+/g, " ");
+      if (!t) return "";
+      return t.length > maxLen ? t.slice(0, maxLen) + "…" : t;
+    } catch (e) {
+      return "";
+    }
+  }
+
+  function elText(el) {
+    try {
+      var t = el.innerText || el.textContent || "";
+      return compactText(t, CONFIG.uiTextMaxLen);
+    } catch (e) {
+      return "";
+    }
+  }
+
+  function describeElement(el) {
+    if (!el || !(el instanceof Element)) return null;
+
+    var getAttr = function (name) {
+      return el.getAttribute(name);
+    };
+
+    var tag = el.tagName ? el.tagName.toLowerCase() : null;
+    var id = el.id || null;
+    var name = getAttr("name") || null;
+    var role = getAttr("role") || null;
+    var ariaLabel = getAttr("aria-label") || null;
+
+    var dataLoc = getAttr("data-loc") || null;
+    var testId =
+      getAttr("data-testid") ||
+      getAttr("data-test-id") ||
+      getAttr("data-test") ||
+      null;
+
+    var type = tag === "input" ? (getAttr("type") || "text") : null;
+    var href = tag === "a" ? getAttr("href") || null : null;
+
+    // a small, stable hint for agents (avoid building full CSS paths)
+    var selectorHint = null;
+    if (testId) selectorHint = '[data-testid="' + testId + '"]';
+    else if (dataLoc) selectorHint = '[data-loc="' + dataLoc + '"]';
+    else if (id) selectorHint = "#" + id;
+    else selectorHint = tag || "unknown";
+
+    return {
+      tag: tag,
+      id: id,
+      name: name,
+      type: type,
+      role: role,
+      ariaLabel: ariaLabel,
+      testId: testId,
+      dataLoc: dataLoc,
+      href: href,
+      text: elText(el),
+      selectorHint: selectorHint,
+    };
+  }
+
+  function isSensitiveField(el) {
+    if (!el || !(el instanceof Element)) return false;
+    var tag = el.tagName ? el.tagName.toLowerCase() : "";
+    if (tag !== "input" && tag !== "textarea") return false;
+
+    var type = (el.getAttribute("type") || "").toLowerCase();
+    if (type === "password") return true;
+
+    var name = (el.getAttribute("name") || "").toLowerCase();
+    var id = (el.id || "").toLowerCase();
+
+    return CONFIG.sensitiveFields.some(function (f) {
+      return name.indexOf(f) !== -1 || id.indexOf(f) !== -1;
+    });
+  }
+
+  function getInputValueSafe(el) {
+    if (!el || !(el instanceof Element)) return null;
+    var tag = el.tagName ? el.tagName.toLowerCase() : "";
+    if (tag !== "input" && tag !== "textarea" && tag !== "select") return null;
+
+    var v = "";
+    try {
+      v = el.value != null ? String(el.value) : "";
+    } catch (e) {
+      v = "";
+    }
+
+    if (isSensitiveField(el)) return { masked: true, length: v.length };
+
+    if (v.length > CONFIG.uiInputMaxLen) v = v.slice(0, CONFIG.uiInputMaxLen) + "…";
+    return v;
+  }
+
+  function logUiEvent(kind, payload) {
+    var entry = {
+      timestamp: Date.now(),
+      kind: kind,
+      url: location.href,
+      viewport: { width: window.innerWidth, height: window.innerHeight },
+      payload: sanitizeValue(payload),
+    };
+    store.uiEvents.push(entry);
+    pruneBuffer(store.uiEvents, CONFIG.bufferSize.ui);
+  }
+
+  function installUiEventListeners() {
+    // Clicks
+    document.addEventListener(
+      "click",
+      function (e) {
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("click", {
+          target: describeElement(t),
+          x: e.clientX,
+          y: e.clientY,
+        });
+      },
+      true
+    );
+
+    // Typing "commit" events
+    document.addEventListener(
+      "change",
+      function (e) {
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("change", {
+          target: describeElement(t),
+          value: getInputValueSafe(t),
+        });
+      },
+      true
+    );
+
+    document.addEventListener(
+      "focusin",
+      function (e) {
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("focusin", { target: describeElement(t) });
+      },
+      true
+    );
+
+    document.addEventListener(
+      "focusout",
+      function (e) {
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("focusout", {
+          target: describeElement(t),
+          value: getInputValueSafe(t),
+        });
+      },
+      true
+    );
+
+    // Enter/Escape are useful for form flows & modals
+    document.addEventListener(
+      "keydown",
+      function (e) {
+        if (e.key !== "Enter" && e.key !== "Escape") return;
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("keydown", { key: e.key, target: describeElement(t) });
+      },
+      true
+    );
+
+    // Form submissions
+    document.addEventListener(
+      "submit",
+      function (e) {
+        var t = e.target;
+        if (shouldIgnoreTarget(t)) return;
+        logUiEvent("submit", { target: describeElement(t) });
+      },
+      true
+    );
+
+    // Throttled scroll events
+    window.addEventListener(
+      "scroll",
+      function () {
+        var now = Date.now();
+        if (now - store.lastScrollTime < CONFIG.scrollThrottleMs) return;
+        store.lastScrollTime = now;
+
+        logUiEvent("scroll", {
+          scrollX: window.scrollX,
+          scrollY: window.scrollY,
+          documentHeight: document.documentElement.scrollHeight,
+          viewportHeight: window.innerHeight,
+        });
+      },
+      { passive: true }
+    );
+
+    // Navigation tracking for SPAs
+    function nav(reason) {
+      logUiEvent("navigate", { reason: reason });
+    }
+
+    var origPush = history.pushState;
+    history.pushState = function () {
+      origPush.apply(this, arguments);
+      nav("pushState");
+    };
+
+    var origReplace = history.replaceState;
+    history.replaceState = function () {
+      origReplace.apply(this, arguments);
+      nav("replaceState");
+    };
+
+    window.addEventListener("popstate", function () {
+      nav("popstate");
+    });
+    window.addEventListener("hashchange", function () {
+      nav("hashchange");
+    });
+  }
+
+  // ==========================================================================
+  // Console Interception
+  // ==========================================================================
+
+  var originalConsole = {
+    log: console.log.bind(console),
+    debug: console.debug.bind(console),
+    info: console.info.bind(console),
+    warn: console.warn.bind(console),
+    error: console.error.bind(console),
+  };
+
+  ["log", "debug", "info", "warn", "error"].forEach(function (method) {
+    console[method] = function () {
+      var args = Array.prototype.slice.call(arguments);
+
+      var entry = {
+        timestamp: Date.now(),
+        level: method.toUpperCase(),
+        args: formatArgs(args),
+        stack: method === "error" ? new Error().stack : null,
+      };
+
+      store.consoleLogs.push(entry);
+      pruneBuffer(store.consoleLogs, CONFIG.bufferSize.console);
+
+      originalConsole[method].apply(console, args);
+    };
+  });
+
+  window.addEventListener("error", function (event) {
+    store.consoleLogs.push({
+      timestamp: Date.now(),
+      level: "ERROR",
+      args: [
+        {
+          type: "UncaughtError",
+          message: event.message,
+          filename: event.filename,
+          lineno: event.lineno,
+          colno: event.colno,
+          stack: event.error ? event.error.stack : null,
+        },
+      ],
+      stack: event.error ? event.error.stack : null,
+    });
+    pruneBuffer(store.consoleLogs, CONFIG.bufferSize.console);
+
+    // Mark an error moment in UI event stream for agents
+    logUiEvent("error", {
+      message: event.message,
+      filename: event.filename,
+      lineno: event.lineno,
+      colno: event.colno,
+    });
+  });
+
+  window.addEventListener("unhandledrejection", function (event) {
+    var reason = event.reason;
+    store.consoleLogs.push({
+      timestamp: Date.now(),
+      level: "ERROR",
+      args: [
+        {
+          type: "UnhandledRejection",
+          reason: reason && reason.message ? reason.message : String(reason),
+          stack: reason && reason.stack ? reason.stack : null,
+        },
+      ],
+      stack: reason && reason.stack ? reason.stack : null,
+    });
+    pruneBuffer(store.consoleLogs, CONFIG.bufferSize.console);
+
+    logUiEvent("unhandledrejection", {
+      reason: reason && reason.message ? reason.message : String(reason),
+    });
+  });
+
+  // ==========================================================================
+  // Fetch Interception
+  // ==========================================================================
+
+  var originalFetch = window.fetch.bind(window);
+
+  window.fetch = function (input, init) {
+    init = init || {};
+    var startTime = Date.now();
+    // Handle string, Request object, or URL object
+    var url = typeof input === "string"
+      ? input
+      : (input && (input.url || input.href || String(input))) || "";
+    var method = init.method || (input && input.method) || "GET";
+
+    // Don't intercept internal requests
+    if (url.indexOf("/__manus__/") === 0) {
+      return originalFetch(input, init);
+    }
+
+    // Safely parse headers (avoid breaking if headers format is invalid)
+    var requestHeaders = {};
+    try {
+      if (init.headers) {
+        requestHeaders = Object.fromEntries(new Headers(init.headers).entries());
+      }
+    } catch (e) {
+      requestHeaders = { _parseError: true };
+    }
+
+    var entry = {
+      timestamp: startTime,
+      type: "fetch",
+      method: method.toUpperCase(),
+      url: url,
+      request: {
+        headers: requestHeaders,
+        body: init.body ? sanitizeValue(tryParseJson(init.body)) : null,
+      },
+      response: null,
+      duration: null,
+      error: null,
+    };
+
+    return originalFetch(input, init)
+      .then(function (response) {
+        entry.duration = Date.now() - startTime;
+
+        var contentType = (response.headers.get("content-type") || "").toLowerCase();
+        var contentLength = response.headers.get("content-length");
+
+        entry.response = {
+          status: response.status,
+          statusText: response.statusText,
+          headers: Object.fromEntries(response.headers.entries()),
+          body: null,
+        };
+
+        // Semantic network hint for agents on failures (sync, no need to wait for body)
+        if (response.status >= 400) {
+          logUiEvent("network_error", {
+            kind: "fetch",
+            method: entry.method,
+            url: entry.url,
+            status: response.status,
+            statusText: response.statusText,
+          });
+        }
+
+        // Skip body capture for streaming responses (SSE, etc.) to avoid memory leaks
+        var isStreaming = contentType.indexOf("text/event-stream") !== -1 ||
+                          contentType.indexOf("application/stream") !== -1 ||
+                          contentType.indexOf("application/x-ndjson") !== -1;
+        if (isStreaming) {
+          entry.response.body = "[Streaming response - not captured]";
+          store.networkRequests.push(entry);
+          pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+          return response;
+        }
+
+        // Skip body capture for large responses to avoid memory issues
+        if (contentLength && parseInt(contentLength, 10) > CONFIG.maxBodyLength) {
+          entry.response.body = "[Response too large: " + contentLength + " bytes]";
+          store.networkRequests.push(entry);
+          pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+          return response;
+        }
+
+        // Skip body capture for binary content types
+        var isBinary = contentType.indexOf("image/") !== -1 ||
+                       contentType.indexOf("video/") !== -1 ||
+                       contentType.indexOf("audio/") !== -1 ||
+                       contentType.indexOf("application/octet-stream") !== -1 ||
+                       contentType.indexOf("application/pdf") !== -1 ||
+                       contentType.indexOf("application/zip") !== -1;
+        if (isBinary) {
+          entry.response.body = "[Binary content: " + contentType + "]";
+          store.networkRequests.push(entry);
+          pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+          return response;
+        }
+
+        // For text responses, clone and read body in background
+        var clonedResponse = response.clone();
+
+        // Async: read body in background, don't block the response
+        clonedResponse
+          .text()
+          .then(function (text) {
+            if (text.length <= CONFIG.maxBodyLength) {
+              entry.response.body = sanitizeValue(tryParseJson(text));
+            } else {
+              entry.response.body = text.slice(0, CONFIG.maxBodyLength) + "...[truncated]";
+            }
+          })
+          .catch(function () {
+            entry.response.body = "[Unable to read body]";
+          })
+          .finally(function () {
+            store.networkRequests.push(entry);
+            pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+          });
+
+        // Return response immediately, don't wait for body reading
+        return response;
+      })
+      .catch(function (error) {
+        entry.duration = Date.now() - startTime;
+        entry.error = { message: error.message, stack: error.stack };
+
+        store.networkRequests.push(entry);
+        pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+
+        logUiEvent("network_error", {
+          kind: "fetch",
+          method: entry.method,
+          url: entry.url,
+          message: error.message,
+        });
+
+        throw error;
+      });
+  };
+
+  // ==========================================================================
+  // XHR Interception
+  // ==========================================================================
+
+  var originalXHROpen = XMLHttpRequest.prototype.open;
+  var originalXHRSend = XMLHttpRequest.prototype.send;
+
+  XMLHttpRequest.prototype.open = function (method, url) {
+    this._manusData = {
+      method: (method || "GET").toUpperCase(),
+      url: url,
+      startTime: null,
+    };
+    return originalXHROpen.apply(this, arguments);
+  };
+
+  XMLHttpRequest.prototype.send = function (body) {
+    var xhr = this;
+
+    if (
+      xhr._manusData &&
+      xhr._manusData.url &&
+      xhr._manusData.url.indexOf("/__manus__/") !== 0
+    ) {
+      xhr._manusData.startTime = Date.now();
+      xhr._manusData.requestBody = body ? sanitizeValue(tryParseJson(body)) : null;
+
+      xhr.addEventListener("load", function () {
+        var contentType = (xhr.getResponseHeader("content-type") || "").toLowerCase();
+        var responseBody = null;
+
+        // Skip body capture for streaming responses
+        var isStreaming = contentType.indexOf("text/event-stream") !== -1 ||
+                          contentType.indexOf("application/stream") !== -1 ||
+                          contentType.indexOf("application/x-ndjson") !== -1;
+
+        // Skip body capture for binary content types
+        var isBinary = contentType.indexOf("image/") !== -1 ||
+                       contentType.indexOf("video/") !== -1 ||
+                       contentType.indexOf("audio/") !== -1 ||
+                       contentType.indexOf("application/octet-stream") !== -1 ||
+                       contentType.indexOf("application/pdf") !== -1 ||
+                       contentType.indexOf("application/zip") !== -1;
+
+        if (isStreaming) {
+          responseBody = "[Streaming response - not captured]";
+        } else if (isBinary) {
+          responseBody = "[Binary content: " + contentType + "]";
+        } else {
+          // Safe to read responseText for text responses
+          try {
+            var text = xhr.responseText || "";
+            if (text.length > CONFIG.maxBodyLength) {
+              responseBody = text.slice(0, CONFIG.maxBodyLength) + "...[truncated]";
+            } else {
+              responseBody = sanitizeValue(tryParseJson(text));
+            }
+          } catch (e) {
+            // responseText may throw for non-text responses
+            responseBody = "[Unable to read response: " + e.message + "]";
+          }
+        }
+
+        var entry = {
+          timestamp: xhr._manusData.startTime,
+          type: "xhr",
+          method: xhr._manusData.method,
+          url: xhr._manusData.url,
+          request: { body: xhr._manusData.requestBody },
+          response: {
+            status: xhr.status,
+            statusText: xhr.statusText,
+            body: responseBody,
+          },
+          duration: Date.now() - xhr._manusData.startTime,
+          error: null,
+        };
+
+        store.networkRequests.push(entry);
+        pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+
+        if (entry.response && entry.response.status >= 400) {
+          logUiEvent("network_error", {
+            kind: "xhr",
+            method: entry.method,
+            url: entry.url,
+            status: entry.response.status,
+            statusText: entry.response.statusText,
+          });
+        }
+      });
+
+      xhr.addEventListener("error", function () {
+        var entry = {
+          timestamp: xhr._manusData.startTime,
+          type: "xhr",
+          method: xhr._manusData.method,
+          url: xhr._manusData.url,
+          request: { body: xhr._manusData.requestBody },
+          response: null,
+          duration: Date.now() - xhr._manusData.startTime,
+          error: { message: "Network error" },
+        };
+
+        store.networkRequests.push(entry);
+        pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+
+        logUiEvent("network_error", {
+          kind: "xhr",
+          method: entry.method,
+          url: entry.url,
+          message: "Network error",
+        });
+      });
+    }
+
+    return originalXHRSend.apply(this, arguments);
+  };
+
+  // ==========================================================================
+  // Data Reporting
+  // ==========================================================================
+
+  function reportLogs() {
+    var consoleLogs = store.consoleLogs.splice(0);
+    var networkRequests = store.networkRequests.splice(0);
+    var uiEvents = store.uiEvents.splice(0);
+
+    // Skip if no new data
+    if (
+      consoleLogs.length === 0 &&
+      networkRequests.length === 0 &&
+      uiEvents.length === 0
+    ) {
+      return Promise.resolve();
+    }
+
+    var payload = {
+      timestamp: Date.now(),
+      consoleLogs: consoleLogs,
+      networkRequests: networkRequests,
+      // Mirror uiEvents to sessionEvents for sessionReplay.log
+      sessionEvents: uiEvents,
+      // agent-friendly semantic events
+      uiEvents: uiEvents,
+    };
+
+    return originalFetch(CONFIG.reportEndpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    }).catch(function () {
+      // Put data back on failure (but respect limits)
+      store.consoleLogs = consoleLogs.concat(store.consoleLogs);
+      store.networkRequests = networkRequests.concat(store.networkRequests);
+      store.uiEvents = uiEvents.concat(store.uiEvents);
+
+      pruneBuffer(store.consoleLogs, CONFIG.bufferSize.console);
+      pruneBuffer(store.networkRequests, CONFIG.bufferSize.network);
+      pruneBuffer(store.uiEvents, CONFIG.bufferSize.ui);
+    });
+  }
+
+  // Periodic reporting
+  setInterval(reportLogs, CONFIG.reportInterval);
+
+  // Report on page unload
+  window.addEventListener("beforeunload", function () {
+    var consoleLogs = store.consoleLogs;
+    var networkRequests = store.networkRequests;
+    var uiEvents = store.uiEvents;
+
+    if (
+      consoleLogs.length === 0 &&
+      networkRequests.length === 0 &&
+      uiEvents.length === 0
+    ) {
+      return;
+    }
+
+    var payload = {
+      timestamp: Date.now(),
+      consoleLogs: consoleLogs,
+      networkRequests: networkRequests,
+      // Mirror uiEvents to sessionEvents for sessionReplay.log
+      sessionEvents: uiEvents,
+      uiEvents: uiEvents,
+    };
+
+    if (navigator.sendBeacon) {
+      var payloadStr = JSON.stringify(payload);
+      // sendBeacon has ~64KB limit, truncate if too large
+      var MAX_BEACON_SIZE = 60000; // Leave some margin
+      if (payloadStr.length > MAX_BEACON_SIZE) {
+        // Prioritize: keep recent events, drop older logs
+        var truncatedPayload = {
+          timestamp: Date.now(),
+          consoleLogs: consoleLogs.slice(-50),
+          networkRequests: networkRequests.slice(-20),
+          sessionEvents: uiEvents.slice(-100),
+          uiEvents: uiEvents.slice(-100),
+          _truncated: true,
+        };
+        payloadStr = JSON.stringify(truncatedPayload);
+      }
+      navigator.sendBeacon(CONFIG.reportEndpoint, payloadStr);
+    }
+  });
+
+  // ==========================================================================
+  // Initialization
+  // ==========================================================================
+
+  // Install semantic UI listeners ASAP
+  try {
+    installUiEventListeners();
+  } catch (e) {
+    console.warn("[Manus] Failed to install UI listeners:", e);
+  }
+
+  // Mark as initialized
+  window.__MANUS_DEBUG_COLLECTOR__ = {
+    version: "2.0-no-rrweb",
+    store: store,
+    forceReport: reportLogs,
+  };
+
+  console.debug("[Manus] Debug collector initialized (no rrweb, UI events only)");
+})();

Front/client/src/App.tsx

@@ -0,0 +1,30 @@
+import { TooltipProvider } from "@/components/ui/tooltip";
+import NotFound from "@/pages/NotFound";
+import { Route, Switch } from "wouter";
+import ErrorBoundary from "./components/ErrorBoundary";
+import { ThemeProvider } from "./contexts/ThemeContext";
+import Home from "./pages/Home";
+
+function Router() {
+  return (
+    <Switch>
+      <Route path={"/"} component={Home} />
+      <Route path={"/404"} component={NotFound} />
+      <Route component={NotFound} />
+    </Switch>
+  );
+}
+
+function App() {
+  return (
+    <ErrorBoundary>
+      <ThemeProvider defaultTheme="light">
+        <TooltipProvider>
+          <Router />
+        </TooltipProvider>
+      </ThemeProvider>
+    </ErrorBoundary>
+  );
+}
+
+export default App;

Front/client/src/components/BottomActions.tsx

@@ -0,0 +1,101 @@
+/**
+ * BottomActions - 하단 액션 버튼 영역
+ *
+ * 생성하기, 다운로드, 연동하기 버튼 컴포넌트
+ */
+
+import { Sparkles, Download, Link2, Loader2 } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { toast } from "sonner";
+import type { SlidePlan, UserSelection } from "../types/designAgent";
+import { serializeSlidePlan } from "../utils/slidePlanUtils";
+
+interface BottomActionsProps {
+  slidePlan: SlidePlan | null;
+  userSelection: UserSelection;
+  isLoading: boolean;
+  onGenerate: () => void;
+}
+
+export default function BottomActions({
+  slidePlan,
+  userSelection,
+  isLoading,
+  onGenerate,
+}: BottomActionsProps) {
+  const handleDownload = () => {
+    if (!slidePlan) {
+      toast.error("슬라이드 플랜이 없습니다. 먼저 생성하기를 눌러주세요.");
+      return;
+    }
+
+    const json = serializeSlidePlan(slidePlan, userSelection);
+    console.log("[Download] SlidePlan JSON:", json);
+
+    // JSON 파일 다운로드
+    const blob = new Blob([json], { type: "application/json" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = `slide-plan-${Date.now()}.json`;
+    a.click();
+    URL.revokeObjectURL(url);
+
+    toast.success("SlidePlan JSON이 다운로드되었습니다.");
+  };
+
+  const handleConnect = () => {
+    toast.info("연동하기 기능은 파이프라인 연결 후 활성화됩니다.");
+  };
+
+  return (
+    <div className="flex items-center justify-center gap-3 px-6 py-3 bg-white border-t border-slate-200">
+      <div className="flex items-center gap-1.5 mr-2">
+        <span className="w-5 h-5 rounded-full bg-blue-600 text-white text-xs flex items-center justify-center font-bold">4</span>
+        <span className="text-xs text-slate-500 font-medium">액션</span>
+      </div>
+      {/* 생성하기 */}
+      <Button
+        onClick={onGenerate}
+        disabled={isLoading}
+        className="gap-2 min-w-[120px]"
+        size="default"
+      >
+        {isLoading ? (
+          <>
+            <Loader2 className="w-4 h-4 animate-spin" />
+            생성 중...
+          </>
+        ) : (
+          <>
+            <Sparkles className="w-4 h-4" />
+            생성하기
+          </>
+        )}
+      </Button>
+
+      {/* 다운로드 */}
+      <Button
+        variant="outline"
+        onClick={handleDownload}
+        disabled={!slidePlan || isLoading}
+        className="gap-2 min-w-[120px]"
+        size="default"
+      >
+        <Download className="w-4 h-4" />
+        다운로드
+      </Button>
+
+      {/* 연동하기 */}
+      <Button
+        variant="outline"
+        onClick={handleConnect}
+        className="gap-2 min-w-[120px] text-slate-500"
+        size="default"
+      >
+        <Link2 className="w-4 h-4" />
+        연동하기
+      </Button>
+    </div>
+  );
+}

Front/client/src/components/ErrorBoundary.tsx

@@ -0,0 +1,62 @@
+import { cn } from "@/lib/utils";
+import { AlertTriangle, RotateCcw } from "lucide-react";
+import { Component, ReactNode } from "react";
+
+interface Props {
+  children: ReactNode;
+}
+
+interface State {
+  hasError: boolean;
+  error: Error | null;
+}
+
+class ErrorBoundary extends Component<Props, State> {
+  constructor(props: Props) {
+    super(props);
+    this.state = { hasError: false, error: null };
+  }
+
+  static getDerivedStateFromError(error: Error): State {
+    return { hasError: true, error };
+  }
+
+  render() {
+    if (this.state.hasError) {
+      return (
+        <div className="flex items-center justify-center min-h-screen p-8 bg-background">
+          <div className="flex flex-col items-center w-full max-w-2xl p-8">
+            <AlertTriangle
+              size={48}
+              className="text-destructive mb-6 flex-shrink-0"
+            />
+
+            <h2 className="text-xl mb-4">An unexpected error occurred.</h2>
+
+            <div className="p-4 w-full rounded bg-muted overflow-auto mb-6">
+              <pre className="text-sm text-muted-foreground whitespace-break-spaces">
+                {this.state.error?.stack}
+              </pre>
+            </div>
+
+            <button
+              onClick={() => window.location.reload()}
+              className={cn(
+                "flex items-center gap-2 px-4 py-2 rounded-lg",
+                "bg-primary text-primary-foreground",
+                "hover:opacity-90 cursor-pointer"
+              )}
+            >
+              <RotateCcw size={16} />
+              Reload Page
+            </button>
+          </div>
+        </div>
+      );
+    }
+
+    return this.props.children;
+  }
+}
+
+export default ErrorBoundary;

Front/client/src/components/FramePanel.tsx

@@ -0,0 +1,353 @@
+import React from 'react';
+import { 
+  Check, 
+  Zap,
+  Layout,
+  Trophy
+} from 'lucide-react';
+import { Badge } from '@/components/ui/badge';
+import { motion } from 'framer-motion';
+import type { Zone, InternalRegion, UserSelection, FrameCandidate, SlidePlan } from '../types/designAgent';
+import { getSectionsForZone } from '../utils/slidePlanUtils';
+import { buildBadgeTitle } from '../services/applicationMode';
+
+interface FramePanelProps {
+  slidePlan: SlidePlan | null;
+  selectedZone: Zone | null;
+  selectedRegion: InternalRegion | null;
+  userSelection: UserSelection;
+  onFrameSelect: (frameId: string) => void;
+  onNoDesignToggle: () => void;
+}
+
+export default function FramePanel({
+  slidePlan,
+  selectedZone,
+  selectedRegion,
+  userSelection,
+  onFrameSelect,
+}: FramePanelProps) {
+  
+  // Zone 중심 컨셉: 선택된 존에 할당된 섹션들의 프레임 후보들을 수집
+  const assignedSectionIds = selectedZone ? getSectionsForZone(selectedZone, userSelection) : [];
+  
+  // 해당 섹션들이 포함된 원본 리전들에서 후보군 추출
+  const candidates: FrameCandidate[] = React.useMemo(() => {
+    if (!slidePlan || !selectedZone) return [];
+    
+    // 단순화: 선택된 존의 첫 번째 리전의 후보군을 우선 사용 (Phase Z MVP1 기준)
+    // 실제로는 할당된 섹션에 따라 동적으로 필터링된 후보군이 필요함
+    const targetRegion = selectedRegion || selectedZone.internal_regions[0];
+    return targetRegion?.frame_candidates || [];
+  }, [slidePlan, selectedZone, selectedRegion]);
+
+  const currentFrameId = React.useMemo(() => {
+    const targetRegion = selectedRegion || selectedZone?.internal_regions[0];
+    if (!targetRegion) return null;
+    return userSelection.overrides.zone_frames[targetRegion.id] || targetRegion.frame_match_strategy.frame_id;
+  }, [selectedZone, selectedRegion, userSelection.overrides.zone_frames]);
+
+  const handleFrameSelect = React.useCallback(
+    (candidate: FrameCandidate) => {
+      const isReject = candidate.label === "reject";
+      const alreadyApplied = currentFrameId === candidate.id;
+      if (isReject && !alreadyApplied) {
+        const ok = window.confirm(
+          `"${candidate.name}" 은 V4 reject 라벨입니다.\n선택 시 frame 은 유지되고 AI 가 콘텐츠를 frame 구조에 맞게 재구성합니다.\n계속하시겠습니까?`,
+        );
+        if (!ok) return;
+      }
+      onFrameSelect(candidate.id);
+    },
+    [currentFrameId, onFrameSelect],
+  );
+
+  if (!selectedZone) {
+    return (
+      <div className="h-full flex flex-col items-center justify-center bg-slate-50 p-8 text-center text-slate-400">
+        <Layout className="w-12 h-12 mb-4 opacity-10" />
+        <p className="text-xs font-bold uppercase tracking-[0.2em]">Select a Zone<br />to View Designs</p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="h-full flex flex-col bg-white">
+      {/* Header */}
+      <div className="p-5 border-b border-slate-100">
+        <div className="flex items-center justify-between mb-2">
+          <h3 className="text-[10px] font-black text-slate-400 uppercase tracking-widest flex items-center gap-2">
+            <Zap className="w-3.5 h-3.5 fill-blue-500 text-blue-500" />
+            Design Wheel
+          </h3>
+          <Badge variant="outline" className="text-[9px] font-black border-slate-200 text-slate-400">
+            TOP {candidates.length}
+          </Badge>
+        </div>
+        <p className="text-[11px] text-slate-500 font-medium leading-tight">
+           현재 구역의 섹션({assignedSectionIds.join(', ')})에 최적화된 추천 디자인입니다.
+        </p>
+      </div>
+
+      {/* Vertical Wheel List */}
+      <div className="flex-1 overflow-y-auto p-4 space-y-5">
+        {candidates.length === 0 ? (
+          <div className="py-20 text-center border-2 border-dashed border-slate-50 rounded-2xl">
+             <p className="text-[10px] font-bold text-slate-300 uppercase">No Candidates Available</p>
+          </div>
+        ) : (
+          candidates.map((candidate, index) => {
+            const isSelected = currentFrameId === candidate.id;
+
+            const isReject = candidate.label === "reject";
+            // catalog 미등록 = backend Step 7-A 가 override 시도해도 skip.
+            // catalogRegistered === false 만 체크 (undefined = 정보 없음, 일반 처리).
+            const isCatalogMissing = candidate.catalogRegistered === false;
+
+            // ─── IMP-29 u3 — IMP-05 L2 candidate_evidence surface ───────────
+            // All evidence fields optional; silent degradation when undefined
+            // (pre-IMP-05 fixtures fall back to label/catalogRegistered only).
+            const isFilteredDirect = candidate.filteredForDirectExecution === true;
+            const hasDecision = candidate.decision === "selected" || candidate.decision === "skipped";
+            const isSkipped = candidate.decision === "skipped";
+            const isSelectedDecision = candidate.decision === "selected";
+            const showRouteChip =
+              candidate.routeHint && candidate.routeHint !== "direct_render";
+            const showStatusChip =
+              candidate.phaseZStatus && candidate.phaseZStatus !== "auto_renderable";
+            const hasCapacityFit =
+              candidate.capacityFit && candidate.capacityFit.fit_status;
+            const capacityMismatch =
+              hasCapacityFit && candidate.capacityFit!.fit_status !== "ok";
+
+            // Compose evidence tooltip lines (only when at least one signal present).
+            const evidenceLines: string[] = [];
+            if (candidate.decision) evidenceLines.push(`decision: ${candidate.decision}`);
+            if (candidate.reason) evidenceLines.push(`reason: ${candidate.reason}`);
+            if (candidate.routeHint) evidenceLines.push(`route: ${candidate.routeHint}`);
+            if (candidate.phaseZStatus)
+              evidenceLines.push(`phase_z_status: ${candidate.phaseZStatus}`);
+            if (hasCapacityFit) {
+              const cf = candidate.capacityFit!;
+              const capacityLine =
+                cf.fit_status === "ok"
+                  ? `capacity: ok${
+                      typeof cf.item_count === "number"
+                        ? ` (items=${cf.item_count})`
+                        : ""
+                    }`
+                  : `capacity: ${cf.fit_status}${
+                      cf.mismatch_reason ? ` — ${cf.mismatch_reason}` : ""
+                    }`;
+              evidenceLines.push(capacityLine);
+            }
+            const evidenceTooltip =
+              evidenceLines.length > 0 ? evidenceLines.join("\n") : undefined;
+
+            // Compose final tooltip: existing catalog/reject reasons first, then
+            // evidence detail (preserves Phase Q tooltip semantics).
+            const tooltipParts = [
+              isCatalogMissing
+                ? "⚠ catalog 미등록 — render path 에서 적용 안 됨 (선택해도 backend 가 skip)"
+                : null,
+              isFilteredDirect
+                ? "⚠ filtered_for_direct_execution — MVP1 직접 렌더 경로 제외"
+                : null,
+              isReject ? "V4 reject — render path 비추천" : null,
+              evidenceTooltip,
+            ].filter((s): s is string => Boolean(s));
+            const composedTitle =
+              tooltipParts.length > 0 ? tooltipParts.join("\n\n") : undefined;
+
+            return (
+              <motion.div
+                key={candidate.id}
+                whileHover={{ y: -2 }}
+                whileTap={{ scale: 0.98 }}
+                className="w-full"
+              >
+                <button
+                  onClick={() => handleFrameSelect(candidate)}
+                  draggable
+                  onDragStart={(e) => {
+                    e.dataTransfer.setData("frameId", candidate.id);
+                  }}
+                  className={`w-full text-left rounded-3xl border-2 transition-all overflow-hidden group relative flex flex-col ${
+                    isSelected
+                      ? 'border-blue-500 bg-white shadow-xl shadow-blue-500/10'
+                      : isCatalogMissing
+                      ? 'border-slate-100 bg-slate-50/40 opacity-60 hover:opacity-90 hover:border-amber-200'
+                      : isFilteredDirect
+                      ? 'border-slate-100 bg-slate-50/30 opacity-50 hover:opacity-90 hover:border-amber-200'
+                      : isReject
+                      ? 'border-slate-100 bg-slate-50/30 opacity-50 hover:opacity-90 hover:border-slate-200'
+                      : 'border-slate-100 bg-slate-50/50 hover:border-slate-200 hover:bg-white'
+                  }`}
+                  title={composedTitle}
+                >
+                  {/* Rank Badge */}
+                  <div className="absolute top-3 left-3 z-10">
+                    <div className={`px-2 py-0.5 rounded-full text-[8px] font-black uppercase tracking-tighter flex items-center gap-1 shadow-sm ${
+                      index === 0 ? 'bg-orange-500 text-white' : 'bg-slate-900 text-white'
+                    }`}>
+                      {index === 0 && <Trophy className="w-2 h-2" />}
+                      Rank {index + 1}
+                    </div>
+                  </div>
+
+                  {/* Preview Image */}
+                  <div className="h-36 bg-slate-200 relative overflow-hidden">
+                    {candidate.thumbnailUrl ? (
+                      <img
+                        src={candidate.thumbnailUrl}
+                        alt={candidate.name}
+                        className={`w-full h-full object-contain bg-white transition-transform duration-500 ${isSelected ? 'scale-105' : 'group-hover:scale-105'}`}
+                        onError={(e) => {
+                          // preview.png 없는 frame — placeholder 로 swap.
+                          const img = e.currentTarget;
+                          img.style.display = "none";
+                          const parent = img.parentElement;
+                          if (parent && !parent.querySelector(".frame-fallback")) {
+                            const ph = document.createElement("div");
+                            ph.className = "frame-fallback w-full h-full flex flex-col items-center justify-center bg-slate-100 text-slate-400";
+                            ph.innerHTML = `
+                              <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" class="w-8 h-8 mb-1">
+                                <rect x="3" y="3" width="18" height="18" rx="2"/>
+                                <line x1="3" y1="9" x2="21" y2="9"/>
+                              </svg>
+                              <span style="font-size:9px; font-weight:700; letter-spacing:0.05em; text-transform:uppercase;">no preview</span>
+                            `;
+                            parent.appendChild(ph);
+                          }
+                        }}
+                      />
+                    ) : (
+                      <div className="w-full h-full flex items-center justify-center">
+                        <Layout className="w-10 h-10 text-slate-300" />
+                      </div>
+                    )}
+                    
+                    {/* Confidence Score Overlay */}
+                    <div className="absolute bottom-3 right-3 px-2 py-1 rounded-lg bg-blue-600/90 backdrop-blur text-white text-[10px] font-black shadow-lg">
+                      {(candidate.score * 100).toFixed(0)}% Match
+                    </div>
+                  </div>
+
+                  {/* Info Footer */}
+                  <div className="p-4 bg-white">
+                    <span className={`text-[11px] font-black uppercase tracking-tight block truncate mb-1 ${isSelected ? 'text-blue-700' : 'text-slate-800'}`}>
+                      {candidate.name}
+                    </span>
+                    <div className="flex items-center justify-between gap-2">
+                       <span className="text-[9px] font-bold text-slate-400 uppercase tracking-widest truncate">{candidate.id}</span>
+                       <div className="flex items-center gap-1.5 shrink-0">
+                         {/* catalog 미등록 배지 — backend render path 미연결 명시 */}
+                         {isCatalogMissing && (
+                           <span
+                             className="text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded bg-slate-200 text-slate-600"
+                             title="catalog 미등록 — backend 적용 X"
+                           >
+                             no catalog
+                           </span>
+                         )}
+                         {/* V4 label badge */}
+                         {/* IMP-41 u5 — tooltip delegated to pure helper
+                             `buildBadgeTitle` (services/applicationMode.ts).
+                             applicationMode is forwarded by designAgentApi.ts
+                             (u4) from Step 9 unit.application_candidates[];
+                             helper falls back to the raw V4 label when the
+                             mode is undefined or unknown. Badge color mapping
+                             is intentionally untouched per Stage 2 scope. */}
+                         {candidate.label && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               candidate.label === "use_as_is"
+                                 ? "bg-emerald-100 text-emerald-700"
+                                 : candidate.label === "light_edit"
+                                 ? "bg-blue-100 text-blue-700"
+                                 : candidate.label === "restructure"
+                                 ? "bg-amber-100 text-amber-700"
+                                 : "bg-red-100 text-red-700"
+                             }`}
+                             title={buildBadgeTitle(candidate.label, candidate.applicationMode)}
+                           >
+                             {candidate.label}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — route hint chip (skip when direct_render = default). */}
+                         {showRouteChip && (
+                           <span
+                             className="text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded bg-slate-100 text-slate-600"
+                             title={`route_hint: ${candidate.routeHint}`}
+                           >
+                             {candidate.routeHint === "deterministic_minor_adjustment"
+                               ? "adapt"
+                               : candidate.routeHint === "ai_adaptation_required"
+                               ? "ai req"
+                               : candidate.routeHint === "design_reference_only"
+                               ? "ref"
+                               : candidate.routeHint}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — phase_z status warning chip (skip when auto_renderable). */}
+                         {showStatusChip && (
+                           <span
+                             className="text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded bg-amber-50 text-amber-700"
+                             title={`phase_z_status: ${candidate.phaseZStatus}`}
+                           >
+                             {candidate.phaseZStatus!.replace(/_/g, " ")}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — capacity_fit indicator (ok = subtle, mismatch = warning). */}
+                         {hasCapacityFit && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               capacityMismatch
+                                 ? "bg-amber-100 text-amber-700"
+                                 : "bg-slate-100 text-slate-500"
+                             }`}
+                             title={`capacity_fit: ${candidate.capacityFit!.fit_status}${
+                               candidate.capacityFit!.mismatch_reason
+                                 ? ` — ${candidate.capacityFit!.mismatch_reason}`
+                                 : ""
+                             }`}
+                           >
+                             {capacityMismatch
+                               ? `fit: ${candidate.capacityFit!.fit_status}`
+                               : "fit ok"}
+                           </span>
+                         )}
+                         {/* IMP-29 u3 — decision badge (Stage 2 contract: surface both selected & skipped). */}
+                         {hasDecision && (
+                           <span
+                             className={`text-[8px] font-black uppercase tracking-tight px-1.5 py-0.5 rounded ${
+                               isSelectedDecision
+                                 ? "bg-emerald-50 text-emerald-700"
+                                 : "bg-red-50 text-red-600"
+                             }`}
+                             title={`decision: ${candidate.decision}${
+                               candidate.reason ? ` — ${candidate.reason}` : ""
+                             }`}
+                           >
+                             {isSkipped ? "skip" : "sel"}
+                           </span>
+                         )}
+                         {isSelected && (
+                           <div className="flex items-center gap-1 text-[8px] font-black text-emerald-500 uppercase">
+                             <Check className="w-2.5 h-2.5 stroke-[4]" />
+                             Applied
+                           </div>
+                         )}
+                       </div>
+                    </div>
+                  </div>
+                </button>
+              </motion.div>
+            );
+          })
+        )}
+        <div className="h-4" />
+      </div>
+    </div>
+  );
+}

Front/client/src/components/LayoutPanel.tsx

@@ -0,0 +1,244 @@
+/**
+ * LayoutPanel - 우측 레이아웃 패널
+ *
+ * Zone 내부 배치 구조를 선택하는 패널
+ * 목표 이미지 기준: 8개 레이아웃 썸네일 (3×3 그리드)
+ */
+
+import type { LayoutCandidate, Zone, UserSelection, LayoutPresetId } from "../types/designAgent";
+import { getEffectiveLayoutId } from "../utils/slidePlanUtils";
+import { MOCK_LAYOUT_CANDIDATES } from "../data/mockDesignAgentData";
+
+interface LayoutPanelProps {
+  selectedZone: Zone | null;
+  userSelection: UserSelection;
+  onLayoutSelect: (layoutId: string) => void;
+  /** Phase 2 : 카드 별 "적용하기" 버튼 → 빈 layout 모드로 전환. */
+  onApplyLayout?: (layoutId: LayoutPresetId) => void;
+  /**
+   * step07_layout.json `data.layout_candidates` (Phase Z 가 zone topology + unit_count
+   * 로 추려낸 가능한 preset list). 비어있거나 undefined 면 모든 8 preset 표시.
+   */
+  availableLayoutIds?: string[];
+  /** step07_layout.json `data.layout_preset` (Phase Z 가 default 로 결정한 preset). */
+  pipelineSelectedLayoutId?: string;
+  /** Phase 2 : 현재 적용 중인 pending layout. 그 카드에는 "적용 중" 표시. */
+  pendingLayoutId?: LayoutPresetId | null;
+}
+
+// 레이아웃 타입별 SVG 썸네일
+function LayoutThumb({ type, id }: { type: LayoutCandidate["type"]; id: string }) {
+  switch (id) {
+    case "single":
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="8" rx="1" fill="#3b82f6" />
+          <rect x="5" y="15" width="46" height="7" rx="1" fill="#dbeafe" />
+          <rect x="5" y="24" width="46" height="7" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    case "horizontal-2":
+      // backend: rows topology = 위/아래 2 zone (top, bottom)
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="46" height="9" rx="1" fill="#dbeafe" />
+          <rect x="5" y="23" width="46" height="9" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    case "vertical-2":
+      // backend: cols topology = 좌/우 2 zone (left, right)
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="22" height="20" rx="1" fill="#dbeafe" />
+          <rect x="29" y="12" width="22" height="20" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    case "top-1-bottom-2":
+      // backend: T topology = 위 1 zone + 아래 좌/우 2 zone
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="46" height="9" rx="1" fill="#3b82f6" opacity="0.7" />
+          <rect x="5" y="23" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="29" y="23" width="22" height="9" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    case "top-2-bottom-1":
+      // backend: inverted-T topology = 위 좌/우 2 zone + 아래 1 zone
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="29" y="12" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="5" y="23" width="46" height="9" rx="1" fill="#3b82f6" opacity="0.7" />
+        </svg>
+      );
+    case "left-1-right-2":
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="16" height="20" rx="1" fill="#dbeafe" />
+          <rect x="23" y="12" width="28" height="20" rx="1" fill="#3b82f6" opacity="0.7" />
+        </svg>
+      );
+    case "left-2-right-1":
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="28" height="20" rx="1" fill="#3b82f6" opacity="0.7" />
+          <rect x="35" y="12" width="16" height="20" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    case "grid-2x2":
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" stroke="#e2e8f0" strokeWidth="0.5" />
+          <rect x="5" y="5" width="46" height="5" rx="1" fill="#3b82f6" />
+          <rect x="5" y="12" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="29" y="12" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="5" y="23" width="22" height="9" rx="1" fill="#dbeafe" />
+          <rect x="29" y="23" width="22" height="9" rx="1" fill="#dbeafe" />
+        </svg>
+      );
+    default:
+      return (
+        <svg viewBox="0 0 56 38" className="w-full h-full">
+          <rect x="2" y="2" width="52" height="34" rx="2" fill="#f1f5f9" />
+        </svg>
+      );
+  }
+}
+
+export default function LayoutPanel({
+  selectedZone,
+  userSelection,
+  onLayoutSelect,
+  onApplyLayout,
+  availableLayoutIds,
+  pipelineSelectedLayoutId,
+  pendingLayoutId,
+}: LayoutPanelProps) {
+  // Layout 패널은 항상 8 preset 전체 표시 (사용자 lock 2026-05-08).
+  // step07 의 layout_candidates 는 *호환성 표시용* 으로만 사용 — 호환 안 되는 preset
+  // 은 회색 / opacity 낮춤 / tooltip 으로 차별. 클릭 자체는 가능 (강제 적용 가능).
+  const candidates = MOCK_LAYOUT_CANDIDATES;
+  const compatibleSet = new Set(
+    availableLayoutIds && availableLayoutIds.length > 0
+      ? availableLayoutIds
+      : candidates.map((c) => c.id)
+  );
+
+  const effectiveLayoutId =
+    userSelection.overrides.layout_preset ||
+    pipelineSelectedLayoutId ||
+    "horizontal-2";
+
+  return (
+    <div className="h-full flex flex-col">
+      {/* 헤더 */}
+      <div className="px-4 py-3 border-b border-slate-200 bg-slate-50/50">
+        <p className="text-[10px] font-black text-slate-400 uppercase tracking-widest">
+          Slide Layout Presets
+        </p>
+      </div>
+
+      {/* 레이아웃 그리드 */}
+      <div className="flex-1 overflow-y-auto p-3">
+        {selectedZone && (
+            <div className="mb-4 p-2 bg-blue-50 rounded-lg border border-blue-100 flex items-center gap-2">
+                <div className="w-1.5 h-1.5 rounded-full bg-blue-500 animate-pulse" />
+                <span className="text-[10px] font-bold text-blue-700 uppercase">Editing Zone: {selectedZone.zone_id}</span>
+            </div>
+        )}
+        <div className="grid grid-cols-3 gap-2">
+          {candidates.map((candidate) => {
+            const isActive = effectiveLayoutId === candidate.id;
+            const isCompatible = compatibleSet.has(candidate.id);
+            const isPendingActive = pendingLayoutId === candidate.id;
+            return (
+              <div
+                key={candidate.id}
+                className={`relative flex flex-col items-center gap-1 p-1.5 rounded-lg border-2 transition-all duration-150 ${
+                  isPendingActive
+                    ? "border-amber-500 bg-amber-50 ring-2 ring-amber-200"
+                    : isActive
+                    ? "border-blue-500 bg-blue-50"
+                    : isCompatible
+                    ? "border-slate-200 bg-white hover:border-blue-300 hover:bg-blue-50/40"
+                    : "border-dashed border-slate-200 bg-slate-50/40 opacity-50 hover:opacity-80 hover:border-amber-300"
+                }`}
+                onClick={() => onLayoutSelect(candidate.id)}
+                title={
+                  isCompatible
+                    ? candidate.description
+                    : `${candidate.description}\n\n⚠ 현재 unit_count 와 호환 안 됨 — 강제 적용 시 zone 매핑 fail 가능`
+                }
+              >
+                {/* 썸네일 */}
+                <div className="w-full aspect-[56/38] overflow-hidden rounded">
+                  <LayoutThumb type={candidate.type} id={candidate.id} />
+                </div>
+                {/* 이름 */}
+                <span
+                  className={`text-xs font-medium leading-tight text-center ${
+                    isActive
+                      ? "text-blue-700"
+                      : isCompatible
+                      ? "text-slate-600"
+                      : "text-slate-400"
+                  }`}
+                  style={{ fontSize: 10 }}
+                >
+                  {candidate.name}
+                </span>
+                {/* 선택 체크 */}
+                {isActive && (
+                  <div className="absolute top-1 right-1 w-3.5 h-3.5 bg-blue-500 rounded-full flex items-center justify-center">
+                    <svg viewBox="0 0 8 8" className="w-2 h-2">
+                      <path d="M1.5 4L3.5 6L6.5 2" stroke="white" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" fill="none" />
+                    </svg>
+                  </div>
+                )}
+                {/* 호환 안 됨 배지 */}
+                {!isCompatible && !isActive && !isPendingActive && (
+                  <div className="absolute top-1 right-1 text-[8px] font-black bg-amber-100 text-amber-700 px-1 rounded">
+                    !
+                  </div>
+                )}
+                {/* Pending 적용 배지 */}
+                {isPendingActive && (
+                  <div className="absolute top-1 right-1 text-[8px] font-black bg-amber-500 text-white px-1.5 py-0.5 rounded shadow">
+                    적용중
+                  </div>
+                )}
+
+                {/* "적용하기" 버튼 — 현재 적용된 layout 이 아니고 onApplyLayout 핸들러
+                    있을 때 표시. 클릭 시 빈 layout 모드 진입 (이중 액션). */}
+                {!isActive && !isPendingActive && onApplyLayout && (
+                  <button
+                    onClick={(e) => {
+                      e.stopPropagation();
+                      onApplyLayout(candidate.id as LayoutPresetId);
+                    }}
+                    className="w-full mt-1 text-[9px] font-black uppercase tracking-tighter py-1 rounded bg-amber-500 text-white hover:bg-amber-600 transition"
+                  >
+                    적용하기
+                  </button>
+                )}
+              </div>
+            );
+          })}
+        </div>
+      </div>
+    </div>
+  );
+}

Front/client/src/components/LeftMdxPanel.tsx

@@ -0,0 +1,344 @@
+/**
+ * LeftMdxPanel - 좌측 MDX 구조 탐색기
+ * 
+ * 기능:
+ * - MDX 파일 업로드 버튼
+ * - 추출된 섹션들의 계층 구조(Level 1~3) 표시
+ * - 섹션 클릭 시 중앙 캔버스의 해당 구역 하이라이트
+ */
+
+import React from 'react';
+import {
+  FileText,
+  ChevronRight,
+  Upload,
+  Zap,
+  Layers,
+  List,
+} from 'lucide-react';
+import { Button } from '@/components/ui/button';
+import { ScrollArea } from '@/components/ui/scroll-area';
+import { Progress } from '@/components/ui/progress';
+import { toast } from 'sonner';
+import type { NormalizedContent } from '../types/designAgent';
+
+interface LeftMdxPanelProps {
+  normalizedContent: NormalizedContent | null;
+  uploadedFile: File | null;
+  isLoading: boolean;
+  selectedSectionId: string | null;
+  hasSlidePlan: boolean;
+  /** 사용자가 frame / section / layout / zone 등 override 를 변경했을 때 true.
+   *  하단 버튼이 "선택대로 재생성하기" 강조 버튼으로 전환. */
+  hasPendingChanges?: boolean;
+  onFileUpload: (file: File) => void;
+  onGenerate: () => void;
+  onSectionClick: (sectionId: string) => void;
+  /** 사용자 lock 2026-05-14 — 좌측 패널에 03/04/05 fix 고정 list. 클릭 시 callback. */
+  onSelectSample?: (which: "03" | "04" | "05") => void;
+  selectedSample?: "03" | "04" | "05" | null;
+}
+
+const SAMPLE_MDX_LIST: { key: "03" | "04" | "05"; label: string; subtitle: string }[] = [
+  { key: "03", label: "03. DX 시행을 위한 필수 요건", subtitle: "필수 요건 + Process/Product 혁신" },
+  { key: "04", label: "04. DX 지연 요인", subtitle: "DX 인식 + 정책/조직 실태" },
+  { key: "05", label: "05. 설계 방식의 왜곡", subtitle: "설계 자동화 오용 + S/W 한계" },
+];
+
+export default function LeftMdxPanel({
+  normalizedContent,
+  uploadedFile,
+  isLoading,
+  selectedSectionId,
+  hasSlidePlan,
+  hasPendingChanges = false,
+  onFileUpload,
+  onGenerate,
+  onSectionClick,
+  onSelectSample,
+  selectedSample = null,
+}: LeftMdxPanelProps) {
+  const fileInputRef = React.useRef<HTMLInputElement>(null);
+
+  const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0];
+    if (file) onFileUpload(file);
+  };
+
+  return (
+    <div className="h-full flex flex-col bg-slate-50">
+      {/* ── 헤더: 문서 정보 ── */}
+      <div className="p-4 border-b border-slate-200 bg-white">
+        <h2 className="text-xs font-bold text-slate-400 uppercase tracking-wider mb-3 flex items-center gap-1.5">
+          <FileText className="w-3.5 h-3.5" />
+          MDX Source
+        </h2>
+
+        {/* 2026-05-14 — 03/04/05 fix 고정 list. 클릭 시 해당 mdx 자동 fetch + 분석.
+            frame/layout override 는 분석 후 우측 패널에서 가능. */}
+        {onSelectSample && (
+          <div className="space-y-1 mb-3">
+            {SAMPLE_MDX_LIST.map((s) => {
+              const isActive = selectedSample === s.key;
+              return (
+                <button
+                  key={s.key}
+                  onClick={() => onSelectSample(s.key)}
+                  disabled={isLoading}
+                  className={`w-full text-left p-2 rounded-md border transition-all ${
+                    isActive
+                      ? "bg-blue-50 border-blue-300 ring-1 ring-blue-200"
+                      : "bg-white border-slate-200 hover:bg-slate-50 hover:border-slate-300"
+                  } ${isLoading ? "opacity-50 cursor-not-allowed" : "cursor-pointer"}`}
+                  title={`${s.label} — 클릭하여 슬라이드 생성`}
+                >
+                  <div className="flex items-center gap-2">
+                    <div className={`w-7 h-7 rounded flex items-center justify-center shrink-0 ${
+                      isActive ? "bg-blue-200 text-blue-700" : "bg-slate-100 text-slate-500"
+                    }`}>
+                      <FileText className="w-3.5 h-3.5" />
+                    </div>
+                    <div className="flex-1 min-w-0">
+                      <p className={`text-[11px] font-bold truncate ${
+                        isActive ? "text-blue-700" : "text-slate-700"
+                      }`}>{s.label}</p>
+                      <p className="text-[10px] text-slate-400 truncate">{s.subtitle}</p>
+                    </div>
+                    {isActive && <div className="w-1.5 h-1.5 rounded-full bg-blue-500 shrink-0" />}
+                  </div>
+                </button>
+              );
+            })}
+          </div>
+        )}
+
+        {uploadedFile ? (
+          <div className="flex items-center gap-2 p-2 rounded-md bg-slate-50 border border-slate-200">
+            <div className="w-8 h-8 rounded bg-blue-100 flex items-center justify-center text-blue-600">
+              <FileText className="w-4 h-4" />
+            </div>
+            <div className="flex-1 min-w-0">
+              <p className="text-xs font-semibold text-slate-700 truncate">{uploadedFile.name}</p>
+              <p className="text-[10px] text-slate-400">{(uploadedFile.size / 1024).toFixed(1)} KB</p>
+            </div>
+            {!hasSlidePlan && (
+              <button
+                className="p-1.5 text-slate-400 hover:text-red-500 transition-colors"
+                onClick={() => window.location.reload()}
+              >
+                <Layers className="w-4 h-4 rotate-45" />
+              </button>
+            )}
+          </div>
+        ) : (
+          <Button
+            variant="outline"
+            className="w-full h-12 border-dashed border-2 flex items-center justify-center gap-2 text-slate-500 hover:text-blue-600 hover:border-blue-300 hover:bg-blue-50"
+            onClick={() => fileInputRef.current?.click()}
+          >
+            <Upload className="w-4 h-4" />
+            <span className="text-[11px] font-medium">또는 직접 업로드</span>
+            <input
+              type="file"
+              ref={fileInputRef}
+              className="hidden"
+              accept=".mdx,.md"
+              onChange={handleFileChange}
+            />
+          </Button>
+        )}
+      </div>
+
+      {/* ── 분석 진행 상태 (로딩 시) ── */}
+      {isLoading && (
+        <div className="p-4 border-b border-slate-200 bg-white">
+          <div className="flex items-center justify-between mb-1.5">
+            <span className="text-[10px] font-semibold text-blue-600">콘텐츠 분석 중...</span>
+            <span className="text-[10px] text-slate-400">STAGE 1</span>
+          </div>
+          <Progress value={45} className="h-1" />
+        </div>
+      )}
+
+      {/* ── 섹션 트리 리스트 ── */}
+      <ScrollArea className="flex-1 p-2">
+        {!normalizedContent ? (
+          <div className="py-20 text-center px-4">
+            <List className="w-8 h-8 text-slate-200 mx-auto mb-2" />
+            <p className="text-[11px] text-slate-400">파일을 업로드하면<br />문서 구조가 표시됩니다.</p>
+          </div>
+        ) : (
+          <div className="space-y-1">
+            {/* 문서 제목 (Level 1) */}
+            <div className="px-2 py-1.5 mb-2">
+              <h1 className="text-sm font-bold text-slate-800 leading-tight">
+                {normalizedContent.title}
+              </h1>
+            </div>
+
+            {/* 섹션들 (Level 2+) — native HTML5 drag (framer-motion drag 와 충돌
+                있어서 native 만 사용). dataTransfer 에 sectionId / section-id /
+                text/plain 다 set 해서 SlideCanvas drop 이 어떤 키로든 받게. */}
+            {normalizedContent.sections.map((section) => {
+              const isSelected = selectedSectionId === section.id;
+              const subSections = section.sub_sections ?? [];
+
+              return (
+                <div key={section.id} className="space-y-0.5">
+                  {/* 중목차 (S1, S2 ...) */}
+                  <button
+                    draggable
+                    onDragStart={(e) => {
+                      e.dataTransfer.effectAllowed = "move";
+                      e.dataTransfer.setData("sectionId", section.id);
+                      e.dataTransfer.setData("section-id", section.id);
+                      e.dataTransfer.setData("text/plain", section.id);
+                    }}
+                    className={`w-full text-left p-2 rounded-md transition-all group relative cursor-grab active:cursor-grabbing ${
+                      isSelected
+                        ? 'bg-blue-50 text-blue-700 shadow-sm ring-1 ring-blue-100'
+                        : 'hover:bg-slate-100 text-slate-600'
+                    }`}
+                    onClick={() => onSectionClick(section.id)}
+                    title={`S${section.index} — 드래그하여 zone 에 배정`}
+                  >
+                    <div className="flex items-start gap-2">
+                      <ChevronRight className={`w-3 h-3 mt-1 shrink-0 transition-transform ${subSections.length > 0 ? 'rotate-90' : ''} ${isSelected ? 'text-blue-500' : 'text-slate-300'}`} />
+                      <div className="flex-1 min-w-0">
+                        <div className="flex items-center gap-1.5 mb-0.5">
+                          <span className={`text-[10px] font-bold px-1 rounded ${isSelected ? 'bg-blue-200/50 text-blue-600' : 'bg-slate-200 text-slate-500'}`}>
+                            S{section.index}
+                          </span>
+                          <span className="text-[11px] font-bold truncate">
+                            {section.title}
+                          </span>
+                        </div>
+                        <p className={`text-[10px] line-clamp-2 leading-relaxed ${isSelected ? 'text-blue-600/70' : 'text-slate-400'}`}>
+                          {section.content_objects?.[0]?.raw_payload || (subSections.length > 0 ? `소목차 ${subSections.length} 개` : "내용 없음")}
+                        </p>
+                      </div>
+                    </div>
+
+                    {isSelected && (
+                      <div className="absolute left-0 top-1 bottom-1 w-0.5 bg-blue-500 rounded-full" />
+                    )}
+                  </button>
+
+                  {/* 소목차 (S1.1, S1.2 ...) — 펼친 상태로 indent 표시. 각자 draggable. */}
+                  {subSections.length > 0 && (
+                    <div className="ml-4 pl-2 border-l border-slate-200 space-y-0.5">
+                      {subSections.map((sub) => {
+                        const isSubSelected = selectedSectionId === sub.id;
+                        return (
+                          <button
+                            key={sub.id}
+                            draggable
+                            onDragStart={(e) => {
+                              e.dataTransfer.effectAllowed = "move";
+                              e.dataTransfer.setData("sectionId", sub.id);
+                              e.dataTransfer.setData("section-id", sub.id);
+                              e.dataTransfer.setData("text/plain", sub.id);
+                            }}
+                            className={`w-full text-left p-1.5 rounded-md transition-all relative cursor-grab active:cursor-grabbing ${
+                              isSubSelected
+                                ? 'bg-blue-50 text-blue-700 ring-1 ring-blue-100'
+                                : 'hover:bg-slate-100 text-slate-500'
+                            }`}
+                            onClick={() => onSectionClick(sub.id)}
+                            title={`S${section.index}.${sub.index} — 드래그하여 zone 에 배정`}
+                          >
+                            <div className="flex items-center gap-1.5">
+                              <span className={`text-[9px] font-bold px-1 rounded shrink-0 ${isSubSelected ? 'bg-blue-200/50 text-blue-600' : 'bg-slate-100 text-slate-400'}`}>
+                                S{section.index}.{sub.index}
+                              </span>
+                              <span className="text-[10px] font-medium truncate">
+                                {sub.title}
+                              </span>
+                            </div>
+                          </button>
+                        );
+                      })}
+                    </div>
+                  )}
+                </div>
+              );
+            })}
+          </div>
+        )}
+      </ScrollArea>
+
+      {/* ── 하단 분석 버튼 ── */}
+      <div className="p-3 border-t border-slate-200 bg-white">
+        {!normalizedContent ? (
+          <div className="text-center py-2">
+            <p className="text-[10px] text-slate-400 mb-2 font-medium uppercase tracking-tight">MDX 분석 대기 중</p>
+            <Button 
+              className="w-full h-10 border-slate-200 text-slate-400" 
+              variant="outline"
+              disabled
+            >
+              슬라이드 생성하기
+            </Button>
+          </div>
+        ) : (
+          <div className="flex flex-col gap-2">
+            {!hasSlidePlan ? (
+              <Button
+                className="w-full gap-2 bg-blue-600 hover:bg-blue-700 h-10 shadow-lg shadow-blue-500/20"
+                onClick={onGenerate}
+                disabled={isLoading}
+              >
+                <Zap className="w-3.5 h-3.5 fill-current" />
+                슬라이드 플랜 생성하기
+              </Button>
+            ) : hasPendingChanges ? (
+              // override 변경 있음 — 강조 "선택대로 재생성하기" 버튼
+              <div className="flex flex-col gap-2">
+                <div className="flex items-center gap-1.5 px-1">
+                  <div className="w-1.5 h-1.5 rounded-full bg-amber-500 animate-pulse" />
+                  <span className="text-[10px] font-black text-amber-700 uppercase tracking-tighter">
+                    Pending Changes
+                  </span>
+                </div>
+                <Button
+                  className="w-full gap-2 bg-amber-500 hover:bg-amber-600 h-11 shadow-lg shadow-amber-500/30 text-white font-bold"
+                  onClick={onGenerate}
+                  disabled={isLoading}
+                >
+                  <Zap className="w-4 h-4 fill-current" />
+                  선택대로 재생성하기
+                </Button>
+                <p className="text-[10px] text-slate-500 leading-tight px-1">
+                  레이아웃 / 프레임 / 섹션 변경을 backend 에 적용해 새 final.html 을
+                  생성합니다. (※ Step D backend forwarding 연결 후 활성)
+                </p>
+              </div>
+            ) : (
+              <div className="flex flex-col gap-2">
+                <div className="flex items-center justify-between px-1">
+                  <span className="text-[10px] font-bold text-emerald-600 flex items-center gap-1">
+                    <Zap className="w-3 h-3 fill-current" />
+                    플랜 생성 완료
+                  </span>
+                  <button
+                    className="text-[10px] text-blue-600 font-bold hover:underline"
+                    onClick={onGenerate}
+                  >
+                    재생성
+                  </button>
+                </div>
+                <Button
+                  variant="outline"
+                  className="w-full h-8 text-[11px] border-slate-200 bg-slate-50"
+                  onClick={() => toast.info("MDX 원문 편집 기능은 준비 중입니다.")}
+                >
+                  MDX 소스 보기
+                </Button>
+              </div>
+            )}
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}

Front/client/src/components/ManusDialog.tsx

@@ -0,0 +1,85 @@
+import { useEffect, useState } from "react";
+
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogTitle,
+} from "@/components/ui/dialog";
+
+interface ManusDialogProps {
+  title?: string;
+  logo?: string;
+  open?: boolean;
+  onLogin: () => void;
+  onOpenChange?: (open: boolean) => void;
+  onClose?: () => void;
+}
+
+export function ManusDialog({
+  title,
+  logo,
+  open = false,
+  onLogin,
+  onOpenChange,
+  onClose,
+}: ManusDialogProps) {
+  const [internalOpen, setInternalOpen] = useState(open);
+
+  useEffect(() => {
+    if (!onOpenChange) {
+      setInternalOpen(open);
+    }
+  }, [open, onOpenChange]);
+
+  const handleOpenChange = (nextOpen: boolean) => {
+    if (onOpenChange) {
+      onOpenChange(nextOpen);
+    } else {
+      setInternalOpen(nextOpen);
+    }
+
+    if (!nextOpen) {
+      onClose?.();
+    }
+  };
+
+  return (
+    <Dialog
+      open={onOpenChange ? open : internalOpen}
+      onOpenChange={handleOpenChange}
+    >
+      <DialogContent className="py-5 bg-[#f8f8f7] rounded-[20px] w-[400px] shadow-[0px_4px_11px_0px_rgba(0,0,0,0.08)] border border-[rgba(0,0,0,0.08)] backdrop-blur-2xl p-0 gap-0 text-center">
+        <div className="flex flex-col items-center gap-2 p-5 pt-12">
+          {logo ? (
+            <div className="w-16 h-16 bg-white rounded-xl border border-[rgba(0,0,0,0.08)] flex items-center justify-center">
+              <img src={logo} alt="Dialog graphic" className="w-10 h-10 rounded-md" />
+            </div>
+          ) : null}
+
+          {/* Title and subtitle */}
+          {title ? (
+            <DialogTitle className="text-xl font-semibold text-[#34322d] leading-[26px] tracking-[-0.44px]">
+              {title}
+            </DialogTitle>
+          ) : null}
+          <DialogDescription className="text-sm text-[#858481] leading-5 tracking-[-0.154px]">
+            Please login with Manus to continue
+          </DialogDescription>
+        </div>
+
+        <DialogFooter className="px-5 py-5">
+          {/* Login button */}
+          <Button
+            onClick={onLogin}
+            className="w-full h-10 bg-[#1a1a19] hover:bg-[#1a1a19]/90 text-white rounded-[10px] text-sm font-medium leading-5 tracking-[-0.154px]"
+          >
+            Login with Manus
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}

Front/client/src/components/Map.tsx

@@ -0,0 +1,155 @@
+/**
+ * GOOGLE MAPS FRONTEND INTEGRATION - ESSENTIAL GUIDE
+ *
+ * USAGE FROM PARENT COMPONENT:
+ * ======
+ *
+ * const mapRef = useRef<google.maps.Map | null>(null);
+ *
+ * <MapView
+ *   initialCenter={{ lat: 40.7128, lng: -74.0060 }}
+ *   initialZoom={15}
+ *   onMapReady={(map) => {
+ *     mapRef.current = map; // Store to control map from parent anytime, google map itself is in charge of the re-rendering, not react state.
+ * </MapView>
+ *
+ * ======
+ * Available Libraries and Core Features:
+ * -------------------------------
+ * 📍 MARKER (from `marker` library)
+ * - Attaches to map using { map, position }
+ * new google.maps.marker.AdvancedMarkerElement({
+ *   map,
+ *   position: { lat: 37.7749, lng: -122.4194 },
+ *   title: "San Francisco",
+ * });
+ *
+ * -------------------------------
+ * 🏢 PLACES (from `places` library)
+ * - Does not attach directly to map; use data with your map manually.
+ * const place = new google.maps.places.Place({ id: PLACE_ID });
+ * await place.fetchFields({ fields: ["displayName", "location"] });
+ * map.setCenter(place.location);
+ * new google.maps.marker.AdvancedMarkerElement({ map, position: place.location });
+ *
+ * -------------------------------
+ * 🧭 GEOCODER (from `geocoding` library)
+ * - Standalone service; manually apply results to map.
+ * const geocoder = new google.maps.Geocoder();
+ * geocoder.geocode({ address: "New York" }, (results, status) => {
+ *   if (status === "OK" && results[0]) {
+ *     map.setCenter(results[0].geometry.location);
+ *     new google.maps.marker.AdvancedMarkerElement({
+ *       map,
+ *       position: results[0].geometry.location,
+ *     });
+ *   }
+ * });
+ *
+ * -------------------------------
+ * 📐 GEOMETRY (from `geometry` library)
+ * - Pure utility functions; not attached to map.
+ * const dist = google.maps.geometry.spherical.computeDistanceBetween(p1, p2);
+ *
+ * -------------------------------
+ * 🛣️ ROUTES (from `routes` library)
+ * - Combines DirectionsService (standalone) + DirectionsRenderer (map-attached)
+ * const directionsService = new google.maps.DirectionsService();
+ * const directionsRenderer = new google.maps.DirectionsRenderer({ map });
+ * directionsService.route(
+ *   { origin, destination, travelMode: "DRIVING" },
+ *   (res, status) => status === "OK" && directionsRenderer.setDirections(res)
+ * );
+ *
+ * -------------------------------
+ * 🌦️ MAP LAYERS (attach directly to map)
+ * - new google.maps.TrafficLayer().setMap(map);
+ * - new google.maps.TransitLayer().setMap(map);
+ * - new google.maps.BicyclingLayer().setMap(map);
+ *
+ * -------------------------------
+ * ✅ SUMMARY
+ * - “map-attached” → AdvancedMarkerElement, DirectionsRenderer, Layers.
+ * - “standalone” → Geocoder, DirectionsService, DistanceMatrixService, ElevationService.
+ * - “data-only” → Place, Geometry utilities.
+ */
+
+/// <reference types="@types/google.maps" />
+
+import { useEffect, useRef } from "react";
+import { usePersistFn } from "@/hooks/usePersistFn";
+import { cn } from "@/lib/utils";
+
+declare global {
+  interface Window {
+    google?: typeof google;
+  }
+}
+
+const API_KEY = import.meta.env.VITE_FRONTEND_FORGE_API_KEY;
+const FORGE_BASE_URL =
+  import.meta.env.VITE_FRONTEND_FORGE_API_URL ||
+  "https://forge.butterfly-effect.dev";
+const MAPS_PROXY_URL = `${FORGE_BASE_URL}/v1/maps/proxy`;
+
+function loadMapScript() {
+  return new Promise(resolve => {
+    const script = document.createElement("script");
+    script.src = `${MAPS_PROXY_URL}/maps/api/js?key=${API_KEY}&v=weekly&libraries=marker,places,geocoding,geometry`;
+    script.async = true;
+    script.crossOrigin = "anonymous";
+    script.onload = () => {
+      resolve(null);
+      script.remove(); // Clean up immediately
+    };
+    script.onerror = () => {
+      console.error("Failed to load Google Maps script");
+    };
+    document.head.appendChild(script);
+  });
+}
+
+interface MapViewProps {
+  className?: string;
+  initialCenter?: google.maps.LatLngLiteral;
+  initialZoom?: number;
+  onMapReady?: (map: google.maps.Map) => void;
+}
+
+export function MapView({
+  className,
+  initialCenter = { lat: 37.7749, lng: -122.4194 },
+  initialZoom = 12,
+  onMapReady,
+}: MapViewProps) {
+  const mapContainer = useRef<HTMLDivElement>(null);
+  const map = useRef<google.maps.Map | null>(null);
+
+  const init = usePersistFn(async () => {
+    await loadMapScript();
+    if (!mapContainer.current) {
+      console.error("Map container not found");
+      return;
+    }
+    map.current = new window.google.maps.Map(mapContainer.current, {
+      zoom: initialZoom,
+      center: initialCenter,
+      mapTypeControl: true,
+      fullscreenControl: true,
+      zoomControl: true,
+      streetViewControl: true,
+      mapId: "DEMO_MAP_ID",
+    });
+    if (onMapReady) {
+      onMapReady(map.current);
+    }
+  });
+
+  useEffect(() => {
+    init();
+  }, [init]);
+
+  return (
+    <div ref={mapContainer} className={cn("w-full h-[500px]", className)} />
+  );
+}

Front/client/src/components/layouts/LayoutTemplates.tsx

@@ -0,0 +1,104 @@
+import React from 'react';
+
+/**
+ * Step 22를 위한 16:9 베이스 슬라이드 본문 레이아웃 템플릿
+ * 8종 중 우선 2종 샘플 구현
+ */
+
+interface LayoutProps {
+  title?: string;
+  sections?: {
+    id: string;
+    title: string;
+    content: string;
+    type?: 'text' | 'image' | 'chart';
+  }[];
+}
+
+/**
+ * Layout 1: Focus Split (좌측 텍스트 / 우측 강조형)
+ * 가장 범용적인 슬라이드 레이아웃
+ */
+export const FocusSplitLayout: React.FC<LayoutProps> = ({ sections = [] }) => {
+  const mainSection = sections[0] || { title: 'Main Point', content: '핵심 내용을 이곳에 작성합니다.' };
+  const subSection = sections[1] || { title: 'Supporting Detail', content: '보조 설명이나 이미지가 들어갑니다.' };
+
+  return (
+    <div className="w-full h-full flex gap-8 p-6 bg-white animate-in fade-in duration-500">
+      {/* 좌측 메인 영역 (60%) */}
+      <div className="flex-[3] flex flex-col justify-center space-y-6">
+        <div className="space-y-2">
+          <div className="w-12 h-1 bg-blue-600 rounded-full" />
+          <h2 className="text-4xl font-black text-slate-900 leading-tight">
+            {mainSection.title}
+          </h2>
+        </div>
+        <p className="text-xl text-slate-600 leading-relaxed font-medium">
+          {mainSection.content}
+        </p>
+        <div className="flex gap-4 pt-4">
+          <div className="px-4 py-2 bg-slate-50 border border-slate-100 rounded-xl text-sm font-bold text-slate-400 uppercase tracking-widest">
+            Key Insight
+          </div>
+        </div>
+      </div>
+
+      {/* 우측 강조 영역 (40%) */}
+      <div className="flex-[2] relative">
+        <div className="absolute inset-0 bg-gradient-to-br from-blue-50 to-indigo-50 rounded-[2rem] border-2 border-white shadow-inner flex flex-col items-center justify-center p-8 text-center overflow-hidden">
+          <div className="absolute top-0 right-0 w-32 h-32 bg-blue-500/5 rounded-full -mr-16 -mt-16" />
+          <div className="w-16 h-16 bg-white rounded-2xl shadow-lg flex items-center justify-center mb-6">
+            <div className="w-8 h-8 bg-blue-600 rounded-lg animate-pulse" />
+          </div>
+          <h3 className="text-2xl font-bold text-slate-800 mb-3">{subSection.title}</h3>
+          <p className="text-sm text-slate-500 font-medium leading-normal">
+            {subSection.content}
+          </p>
+        </div>
+      </div>
+    </div>
+  );
+};
+
+/**
+ * Layout 2: Quadrant Grid (2x2 그리드 핵심 요약형)
+ * 여러 요소를 병렬로 보여줄 때 최적
+ */
+export const QuadrantGridLayout: React.FC<LayoutProps> = ({ sections = [] }) => {
+  const items = sections.length >= 4 ? sections.slice(0, 4) : [
+    { title: 'Strategy', content: '장기적 목표 및 실행 계획 수립' },
+    { title: 'Operations', content: '효율적인 자원 배분 및 프로세스 최적화' },
+    { title: 'Technology', content: '디지털 전환을 위한 기술 스택 도입' },
+    { title: 'Growth', content: '지속 가능한 성장 동력 확보' },
+  ];
+
+  return (
+    <div className="w-full h-full grid grid-cols-2 grid-rows-2 gap-6 p-6 bg-white animate-in zoom-in-95 duration-500">
+      {items.map((item, i) => (
+        <div 
+          key={i} 
+          className="group p-6 rounded-[1.5rem] border-2 border-slate-50 bg-slate-50/30 hover:bg-white hover:border-blue-100 hover:shadow-xl hover:shadow-blue-500/5 transition-all duration-300 flex flex-col justify-between"
+        >
+          <div className="space-y-3">
+            <div className="flex items-center gap-3">
+              <span className="flex items-center justify-center w-8 h-8 rounded-full bg-slate-900 text-white text-xs font-black">
+                0{i + 1}
+              </span>
+              <h3 className="text-xl font-black text-slate-800 group-hover:text-blue-600 transition-colors">
+                {item.title}
+              </h3>
+            </div>
+            <p className="text-sm text-slate-500 leading-relaxed font-medium pl-11">
+              {item.content}
+            </p>
+          </div>
+          <div className="pl-11 pt-4">
+             <div className="w-full h-1 bg-slate-100 rounded-full overflow-hidden">
+                <div className="w-1/3 h-full bg-blue-500 rounded-full group-hover:w-full transition-all duration-700" />
+             </div>
+          </div>
+        </div>
+      ))}
+    </div>
+  );
+};

Front/client/src/components/slideCanvasDragMath.test.ts

@@ -0,0 +1,225 @@
+// IMP-54 u4 — vitest coverage for the pure drag-math helpers extracted in u3
+// (`Front/client/src/components/slideCanvasDragMath.ts`).
+//
+// Stage 2 contract (`Stage 2 Exit Report → implementation_units → u4`):
+//   • Threshold pass/fail at 5 px (strict `Math.hypot > 5`).
+//   • Clamp negative delta to 0 on both axes.
+//   • Clamp max-edge delta to `1 - startGeom.w` (x) and `1 - startGeom.h` (y).
+//
+// The helpers are pure (no React, no DOM) so we drive them directly with
+// numeric inputs — no fake timers, no fetch stubs, no component mount.
+
+import { describe, expect, it } from "vitest";
+
+import {
+  DRAG_THRESHOLD_PX,
+  IMAGE_RESIZE_MIN_SIZE_PERCENT,
+  clampImagePercentGeometry,
+  clampZoneMove,
+  crossedDragThreshold,
+  type ImagePercentGeom,
+  type ZoneFracGeom,
+} from "./slideCanvasDragMath";
+
+describe("DRAG_THRESHOLD_PX", () => {
+  it("is 5", () => {
+    expect(DRAG_THRESHOLD_PX).toBe(5);
+  });
+});
+
+describe("crossedDragThreshold", () => {
+  it("returns false for zero movement (still a click)", () => {
+    expect(crossedDragThreshold(0, 0)).toBe(false);
+  });
+
+  it("returns false just below threshold — 3,4 → hypot 5 with strict >", () => {
+    expect(crossedDragThreshold(3, 4)).toBe(false);
+  });
+
+  it("returns false at exactly the threshold along each axis", () => {
+    // strict inequality: Math.hypot(5, 0) === 5, not > 5
+    expect(crossedDragThreshold(5, 0)).toBe(false);
+    expect(crossedDragThreshold(0, 5)).toBe(false);
+  });
+
+  it("returns true once distance exceeds threshold", () => {
+    expect(crossedDragThreshold(4, 4)).toBe(true); // hypot ≈ 5.6568
+    expect(crossedDragThreshold(6, 0)).toBe(true);
+    expect(crossedDragThreshold(0, 6)).toBe(true);
+  });
+
+  it("treats negative deltas symmetrically (Euclidean distance)", () => {
+    expect(crossedDragThreshold(-3, -4)).toBe(false);
+    expect(crossedDragThreshold(-4, -4)).toBe(true);
+    expect(crossedDragThreshold(-6, 0)).toBe(true);
+  });
+});
+
+describe("clampZoneMove", () => {
+  // 1000 × 1000 slide body so 1 px == 0.001 frac — keeps the arithmetic
+  // exact and the boundary deltas (1000 px) round-trip back to `1 - w/h`.
+  const W = 1000;
+  const H = 1000;
+  const baseGeom: ZoneFracGeom = { x: 0.1, y: 0.2, w: 0.3, h: 0.4 };
+
+  it("applies in-bounds delta as startGeom + (dPx / slideBodySize)", () => {
+    expect(clampZoneMove(baseGeom, 100, 50, W, H)).toEqual({
+      x: 0.2,
+      y: 0.25,
+    });
+  });
+
+  it("clamps negative delta to 0 on both axes", () => {
+    expect(clampZoneMove(baseGeom, -1000, -1000, W, H)).toEqual({
+      x: 0,
+      y: 0,
+    });
+  });
+
+  it("clamps max-edge delta to (1 - w) on x and (1 - h) on y", () => {
+    expect(clampZoneMove(baseGeom, 1000, 1000, W, H)).toEqual({
+      x: 1 - baseGeom.w, // 0.7
+      y: 1 - baseGeom.h, // 0.6
+    });
+  });
+
+  it("clamps the two axes independently (negative x, in-bounds y)", () => {
+    expect(clampZoneMove(baseGeom, -1000, 50, W, H)).toEqual({
+      x: 0,
+      y: 0.25,
+    });
+  });
+
+  it("honours non-square slide bodies via per-axis division", () => {
+    // dxPx 100 / 500 = 0.2 fr; dyPx 100 / 250 = 0.4 fr (hits the y boundary).
+    // x is checked with toBeCloseTo because 0.1 + 0.2 is the canonical IEEE-754
+    // floating-point trap (0.30000000000000004) — the clamp logic is correct,
+    // it just inherits JS number precision. y stays exact since it clamps to
+    // the boundary `1 - h`.
+    const result = clampZoneMove(baseGeom, 100, 100, 500, 250);
+    expect(result.x).toBeCloseTo(0.3, 10);
+    expect(result.y).toBe(1 - baseGeom.h); // 0.6
+  });
+
+  it("returns only { x, y } — width / height are preserved by the caller", () => {
+    const out = clampZoneMove(baseGeom, 0, 0, W, H);
+    expect(out).toEqual({ x: 0.1, y: 0.2 });
+    expect("w" in out).toBe(false);
+    expect("h" in out).toBe(false);
+  });
+});
+
+// IMP-51 (#79) u9 — image overlay resize / move math.
+// Boundary contract (must match the inline u8 math Codex #16 verified):
+// • slide-bound invariant — x+w ≤ 100 ∧ y+h ≤ 100 for ALL valid inputs,
+//   including small-near-edge geoms where the existing minSize floor
+//   would otherwise have pushed past the slide bound.
+// • aspect-locked corner — baseAspect = startGeom.w / startGeom.h is
+//   preserved exactly; the wFloor uses `min(minSize, maxW, maxH*baseAspect)`
+//   so a floor application never violates either axis.
+// The two concrete Codex #15 reproductions are encoded explicitly below
+// so a future regression on the boundary math fails this suite directly.
+describe("IMAGE_RESIZE_MIN_SIZE_PERCENT", () => {
+  it("is 2 (percent of slide bbox)", () => {
+    expect(IMAGE_RESIZE_MIN_SIZE_PERCENT).toBe(2);
+  });
+});
+
+describe("clampImagePercentGeometry", () => {
+  const baseGeom: ImagePercentGeom = { x: 10, y: 10, w: 20, h: 10 };
+
+  describe("direction = 'move'", () => {
+    it("translates and clamps both axes; preserves w/h", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, 5, 7, "move", false),
+      ).toEqual({ x: 15, y: 17, w: 20, h: 10 });
+    });
+
+    it("clamps negative deltas to (0, 0)", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, -1000, -1000, "move", false),
+      ).toEqual({ x: 0, y: 0, w: 20, h: 10 });
+    });
+
+    it("clamps max-edge deltas to (100 - w, 100 - h)", () => {
+      expect(
+        clampImagePercentGeometry(baseGeom, 1000, 1000, "move", false),
+      ).toEqual({ x: 80, y: 90, w: 20, h: 10 });
+    });
+  });
+
+  describe("edge resize — independent per-axis clamp", () => {
+    it("right edge clamps width to 100 - startGeom.x", () => {
+      const out = clampImagePercentGeometry(baseGeom, 1000, 0, "right", false);
+      expect(out).toEqual({ x: 10, y: 10, w: 90, h: 10 });
+      expect(out.x + out.w).toBeLessThanOrEqual(100);
+    });
+
+    it("left drag dx=-100 emits {x:0,y:10,w:30,h:10} (Codex regression)", () => {
+      // From Codex #15 / #16 verification — ordinary left drag past the
+      // slide edge should pin x at 0 and grow w by the original x amount.
+      expect(
+        clampImagePercentGeometry(baseGeom, -100, 0, "left", false),
+      ).toEqual({ x: 0, y: 10, w: 30, h: 10 });
+    });
+
+    it("near-edge right resize keeps x + w ≤ 100 (Codex #15 reproduction)", () => {
+      // Pre-fix: minSize=2 floor applied AFTER span clamp would emit
+      // {x:99, w:2} so x+w=101. Post-fix: floor caps at maxW=1.
+      const start: ImagePercentGeom = { x: 99, y: 10, w: 0.5, h: 10 };
+      const out = clampImagePercentGeometry(start, 1, 0, "right", false);
+      expect(out).toEqual({ x: 99, y: 10, w: 1, h: 10 });
+      expect(out.x + out.w).toBe(100);
+    });
+
+    it("top/bottom edges are symmetric to left/right", () => {
+      const bottom = clampImagePercentGeometry(baseGeom, 0, 1000, "bottom", false);
+      expect(bottom).toEqual({ x: 10, y: 10, w: 20, h: 90 });
+      const top = clampImagePercentGeometry(baseGeom, 0, -100, "top", false);
+      expect(top).toEqual({ x: 10, y: 0, w: 20, h: 20 });
+    });
+  });
+
+  describe("corner resize — aspect locked (default Shift-off)", () => {
+    it("NW drag dx=-100,dy=-100 emits {x:0,y:5,w:30,h:15} (Codex regression)", () => {
+      // From Codex #16 verification — aspect-locked NW past the slide
+      // edge: rightEdge=30, bottomEdge=20, baseAspect=2. Independent
+      // clamps give x=0,w=30,y=0,h=20. Aspect block then picks the
+      // limiting axis: newH = 30/2 = 15 (≤20). Re-anchor: y = 20 - 15 = 5.
+      expect(
+        clampImagePercentGeometry(baseGeom, -100, -100, "nw", true),
+      ).toEqual({ x: 0, y: 5, w: 30, h: 15 });
+    });
+
+    it("tiny near-corner NE resize stays within bounds (Codex #15 reproduction)", () => {
+      // Pre-fix: dual-axis minSize floor would emit w=2, h=2 with
+      // re-anchor pushing x+w past 100. Post-fix: wFloor caps at
+      // min(2, maxW=1, maxH*baseAspect=1) = 1, so newW=1, newH=1.
+      const start: ImagePercentGeom = { x: 99, y: 99, w: 0.5, h: 0.5 };
+      const out = clampImagePercentGeometry(start, 1, -1, "ne", true);
+      expect(out).toEqual({ x: 99, y: 98.5, w: 1, h: 1 });
+      expect(out.x + out.w).toBeLessThanOrEqual(100);
+      expect(out.y + out.h).toBeLessThanOrEqual(100);
+    });
+
+    it("preserves baseAspect exactly when the floor is hit", () => {
+      // 2:1 aspect ratio (w=20, h=10); large negative drag past edges
+      // hits wFloor. newW/newH ratio must equal baseAspect.
+      const out = clampImagePercentGeometry(
+        baseGeom, -1000, -1000, "nw", true,
+      );
+      expect(out.w / out.h).toBeCloseTo(baseGeom.w / baseGeom.h, 10);
+    });
+  });
+
+  describe("corner resize — Shift unlock (independent edges)", () => {
+    it("SE without aspect lock degenerates to right + bottom edges", () => {
+      const corner = clampImagePercentGeometry(baseGeom, 1000, 1000, "se", false);
+      const sides = clampImagePercentGeometry(
+        clampImagePercentGeometry(baseGeom, 1000, 0, "right", false),
+        0, 1000, "bottom", false,
+      );
+      expect(corner).toEqual(sides);
+    });
+  });
+});

Front/client/src/components/slideCanvasDragMath.ts

@@ -0,0 +1,201 @@
+// IMP-54 u3 — pure drag math extracted from SlideCanvas.tsx
+// `handleZoneMouseDown` (`Front/client/src/components/SlideCanvas.tsx:537-598`).
+//
+// Resize math (`makeResizeHandler` at SlideCanvas.tsx:465-523) is intentionally
+// NOT touched — it has its own independent geometry model (per-side
+// `affectsLeft/Right/Top/Bottom`, `minSize`, `1 - startGeom.x/y` cap) that
+// must not regress.
+//
+// Two responsibilities live here:
+//
+//   1. Drag-vs-click classification — a pointer must travel more than
+//      `DRAG_THRESHOLD_PX` (Euclidean distance from the mousedown origin)
+//      before mousedown→mousemove is treated as a drag. Below the
+//      threshold the gesture stays a click, which the caller surfaces as
+//      `onZoneClick(zone.id)` in `onUp`.
+//
+//   2. Pixel-delta → slide-body fraction conversion plus clamp to keep the
+//      moved zone fully inside the slide body. Width/height are preserved
+//      verbatim by this helper — only `x` and `y` move.
+//
+// Both helpers are pure (no React, no DOM, no side effects) so vitest can
+// drive them directly. The numeric contract is the inline behavior that
+// existed before the extraction; this file is a relocation, not a behavior
+// change.
+
+export const DRAG_THRESHOLD_PX = 5;
+
+// IMP-51 (#79) u9 — image overlay resize / move math extracted from
+// SlideCanvas.tsx `beginDrag` onMove (lines 1092–1219 of the u8 patch).
+// Slide-absolute percent coordinate space (0–100 on both axes), matching
+// the persisted `image_overrides` axis (`src/user_overrides_io.py` u1
+// KNOWN_AXES) and the typed client `ImageOverride` shape (`userOverridesApi.ts`
+// u3). The math is the contract Codex #16 verified post-u8 — this file
+// is a relocation, not a behavior change. SlideCanvas calls it from a
+// single hook so future tweaks need to update one place + the vitest
+// suite alongside.
+export const IMAGE_RESIZE_MIN_SIZE_PERCENT = 2;
+
+/** Image overlay geometry in slide-absolute percent (each component ∈ [0, 100]).
+ *  Mirrors `ImageOverride` from `services/userOverridesApi.ts` (u3) so this
+ *  shape moves end-to-end through stamper → overlay → persisted axis. */
+export interface ImagePercentGeom {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+
+export type ImageDragDirection =
+  | "move"
+  | "left"
+  | "right"
+  | "top"
+  | "bottom"
+  | "nw"
+  | "ne"
+  | "sw"
+  | "se";
+
+/** Apply a percent-space drag delta to `startGeom` per `direction` and clamp.
+ *
+ *  Contract (must match the inline u8 math Codex #16 verified):
+ *    • `direction === "move"` → translate only; w/h preserved verbatim;
+ *      x/y clamped to `[0, 100 - w]` and `[0, 100 - h]`.
+ *    • Edge handle (`left|right|top|bottom`) → one axis only; opposite
+ *      edge pinned so x+w ≤ 100 and y+h ≤ 100 hold.
+ *    • Corner handle (`nw|ne|sw|se`) with `aspectLocked=false` → two
+ *      independent edges (same per-edge clamp as above).
+ *    • Corner handle with `aspectLocked=true` → preserves
+ *      `baseAspect = startGeom.w / startGeom.h`; the pinned-opposite-corner
+ *      stays fixed; the floored axis is `w` and `h` is re-derived so the
+ *      aspect ratio is exact even at the minSize floor.
+ *
+ *  `minSize` is best-effort: when the available span (e.g. `100 - startGeom.x`
+ *  for `affectsRight`) is below `minSize`, the floor caps at the span itself
+ *  so the slide-bound invariant (x+w ≤ 100 ∧ y+h ≤ 100) is never violated.
+ *  Pure / deterministic / no DOM access — vitest drives it directly. */
+export function clampImagePercentGeometry(
+  startGeom: ImagePercentGeom,
+  dxPercent: number,
+  dyPercent: number,
+  direction: ImageDragDirection,
+  aspectLocked: boolean,
+  minSize: number = IMAGE_RESIZE_MIN_SIZE_PERCENT,
+): ImagePercentGeom {
+  if (direction === "move") {
+    const x = Math.max(0, Math.min(100 - startGeom.w, startGeom.x + dxPercent));
+    const y = Math.max(0, Math.min(100 - startGeom.h, startGeom.y + dyPercent));
+    return { x, y, w: startGeom.w, h: startGeom.h };
+  }
+
+  const affectsLeft =
+    direction === "left" || direction === "nw" || direction === "sw";
+  const affectsRight =
+    direction === "right" || direction === "ne" || direction === "se";
+  const affectsTop =
+    direction === "top" || direction === "nw" || direction === "ne";
+  const affectsBottom =
+    direction === "bottom" || direction === "sw" || direction === "se";
+  const isCorner =
+    direction === "nw" ||
+    direction === "ne" ||
+    direction === "sw" ||
+    direction === "se";
+
+  const rightEdge = startGeom.x + startGeom.w;
+  const bottomEdge = startGeom.y + startGeom.h;
+  let x = startGeom.x;
+  let y = startGeom.y;
+  let w = startGeom.w;
+  let h = startGeom.h;
+
+  if (affectsRight) {
+    const maxW = 100 - startGeom.x;
+    const floor = Math.min(minSize, maxW);
+    w = Math.max(floor, Math.min(maxW, startGeom.w + dxPercent));
+  }
+  if (affectsBottom) {
+    const maxH = 100 - startGeom.y;
+    const floor = Math.min(minSize, maxH);
+    h = Math.max(floor, Math.min(maxH, startGeom.h + dyPercent));
+  }
+  if (affectsLeft) {
+    const floor = Math.min(minSize, rightEdge);
+    x = Math.max(0, Math.min(rightEdge - floor, startGeom.x + dxPercent));
+    w = rightEdge - x;
+  }
+  if (affectsTop) {
+    const floor = Math.min(minSize, bottomEdge);
+    y = Math.max(0, Math.min(bottomEdge - floor, startGeom.y + dyPercent));
+    h = bottomEdge - y;
+  }
+
+  if (isCorner && aspectLocked) {
+    const baseAspect =
+      startGeom.w > 0 && startGeom.h > 0 ? startGeom.w / startGeom.h : 1;
+    if (baseAspect > 0) {
+      const maxW = affectsLeft ? rightEdge : 100 - startGeom.x;
+      const maxH = affectsTop ? bottomEdge : 100 - startGeom.y;
+      let newW = w;
+      let newH = newW / baseAspect;
+      if (newH > maxH) {
+        newH = maxH;
+        newW = newH * baseAspect;
+      }
+      if (newW > maxW) {
+        newW = maxW;
+        newH = newW / baseAspect;
+      }
+      const wFloor = Math.min(minSize, maxW, maxH * baseAspect);
+      if (newW < wFloor) {
+        newW = wFloor;
+        newH = newW / baseAspect;
+      }
+      w = newW;
+      h = newH;
+      x = affectsLeft ? rightEdge - w : startGeom.x;
+      y = affectsTop ? bottomEdge - h : startGeom.y;
+    }
+  }
+
+  return { x, y, w, h };
+}
+
+/** Returns true once the pointer has travelled far enough from the mousedown
+ *  origin to be treated as a drag rather than a click. */
+export function crossedDragThreshold(dxPx: number, dyPx: number): boolean {
+  return Math.hypot(dxPx, dyPx) > DRAG_THRESHOLD_PX;
+}
+
+/** Zone geometry in slide-body fraction space (each component ∈ [0, 1]).
+ *  Mirrors the shape the SlideCanvas pipeline already uses for
+ *  `localGeom` / `overrideGeom` / `onZoneResize` payloads. */
+export interface ZoneFracGeom {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+
+/** Convert a pixel-space drag delta into a slide-body fraction delta, apply
+ *  it to `startGeom.{x, y}`, and clamp so the zone never escapes the slide
+ *  body (`x ∈ [0, 1 - w]`, `y ∈ [0, 1 - h]`). `w` and `h` are not modified.
+ *
+ *  The caller (`SlideCanvas.tsx` `handleZoneMouseDown` onMove) guarantees
+ *  `slideBodyWidthPx > 0` and `slideBodyHeightPx > 0` via the
+ *  `measuredSlideBody` precondition, so this helper does not re-guard
+ *  divide-by-zero. */
+export function clampZoneMove(
+  startGeom: ZoneFracGeom,
+  dxPx: number,
+  dyPx: number,
+  slideBodyWidthPx: number,
+  slideBodyHeightPx: number,
+): { x: number; y: number } {
+  const dx = dxPx / slideBodyWidthPx;
+  const dy = dyPx / slideBodyHeightPx;
+  const x = Math.max(0, Math.min(1 - startGeom.w, startGeom.x + dx));
+  const y = Math.max(0, Math.min(1 - startGeom.h, startGeom.y + dy));
+  return { x, y };
+}

Front/client/src/components/ui/accordion.tsx

@@ -0,0 +1,64 @@
+import * as React from "react";
+import * as AccordionPrimitive from "@radix-ui/react-accordion";
+import { ChevronDownIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Accordion({
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Root>) {
+  return <AccordionPrimitive.Root data-slot="accordion" {...props} />;
+}
+
+function AccordionItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
+  return (
+    <AccordionPrimitive.Item
+      data-slot="accordion-item"
+      className={cn("border-b last:border-b-0", className)}
+      {...props}
+    />
+  );
+}
+
+function AccordionTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
+  return (
+    <AccordionPrimitive.Header className="flex">
+      <AccordionPrimitive.Trigger
+        data-slot="accordion-trigger"
+        className={cn(
+          "focus-visible:border-ring focus-visible:ring-ring/50 flex flex-1 items-start justify-between gap-4 rounded-md py-4 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&[data-state=open]>svg]:rotate-180",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <ChevronDownIcon className="text-muted-foreground pointer-events-none size-4 shrink-0 translate-y-0.5 transition-transform duration-200" />
+      </AccordionPrimitive.Trigger>
+    </AccordionPrimitive.Header>
+  );
+}
+
+function AccordionContent({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
+  return (
+    <AccordionPrimitive.Content
+      data-slot="accordion-content"
+      className="data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down overflow-hidden text-sm"
+      {...props}
+    >
+      <div className={cn("pt-0 pb-4", className)}>{children}</div>
+    </AccordionPrimitive.Content>
+  );
+}
+
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent };

Front/client/src/components/ui/alert-dialog.tsx

@@ -0,0 +1,155 @@
+import * as React from "react";
+import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
+
+import { cn } from "@/lib/utils";
+import { buttonVariants } from "@/components/ui/button";
+
+function AlertDialog({
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Root>) {
+  return <AlertDialogPrimitive.Root data-slot="alert-dialog" {...props} />;
+}
+
+function AlertDialogTrigger({
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Trigger>) {
+  return (
+    <AlertDialogPrimitive.Trigger data-slot="alert-dialog-trigger" {...props} />
+  );
+}
+
+function AlertDialogPortal({
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Portal>) {
+  return (
+    <AlertDialogPrimitive.Portal data-slot="alert-dialog-portal" {...props} />
+  );
+}
+
+function AlertDialogOverlay({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Overlay>) {
+  return (
+    <AlertDialogPrimitive.Overlay
+      data-slot="alert-dialog-overlay"
+      className={cn(
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Content>) {
+  return (
+    <AlertDialogPortal>
+      <AlertDialogOverlay />
+      <AlertDialogPrimitive.Content
+        data-slot="alert-dialog-content"
+        className={cn(
+          "bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-lg border p-6 shadow-lg duration-200 sm:max-w-lg",
+          className
+        )}
+        {...props}
+      />
+    </AlertDialogPortal>
+  );
+}
+
+function AlertDialogHeader({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="alert-dialog-header"
+      className={cn("flex flex-col gap-2 text-center sm:text-left", className)}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogFooter({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="alert-dialog-footer"
+      className={cn(
+        "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogTitle({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Title>) {
+  return (
+    <AlertDialogPrimitive.Title
+      data-slot="alert-dialog-title"
+      className={cn("text-lg font-semibold", className)}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogDescription({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Description>) {
+  return (
+    <AlertDialogPrimitive.Description
+      data-slot="alert-dialog-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogAction({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Action>) {
+  return (
+    <AlertDialogPrimitive.Action
+      className={cn(buttonVariants(), className)}
+      {...props}
+    />
+  );
+}
+
+function AlertDialogCancel({
+  className,
+  ...props
+}: React.ComponentProps<typeof AlertDialogPrimitive.Cancel>) {
+  return (
+    <AlertDialogPrimitive.Cancel
+      className={cn(buttonVariants({ variant: "outline" }), className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  AlertDialog,
+  AlertDialogPortal,
+  AlertDialogOverlay,
+  AlertDialogTrigger,
+  AlertDialogContent,
+  AlertDialogHeader,
+  AlertDialogFooter,
+  AlertDialogTitle,
+  AlertDialogDescription,
+  AlertDialogAction,
+  AlertDialogCancel,
+};

Front/client/src/components/ui/alert.tsx

@@ -0,0 +1,66 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const alertVariants = cva(
+  "relative w-full rounded-lg border px-4 py-3 text-sm grid has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] grid-cols-[0_1fr] has-[>svg]:gap-x-3 gap-y-0.5 items-start [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
+  {
+    variants: {
+      variant: {
+        default: "bg-card text-card-foreground",
+        destructive:
+          "text-destructive bg-card [&>svg]:text-current *:data-[slot=alert-description]:text-destructive/90",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+function Alert({
+  className,
+  variant,
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>) {
+  return (
+    <div
+      data-slot="alert"
+      role="alert"
+      className={cn(alertVariants({ variant }), className)}
+      {...props}
+    />
+  );
+}
+
+function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="alert-title"
+      className={cn(
+        "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function AlertDescription({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="alert-description"
+      className={cn(
+        "text-muted-foreground col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Alert, AlertTitle, AlertDescription };

Front/client/src/components/ui/aspect-ratio.tsx

@@ -0,0 +1,9 @@
+import * as AspectRatioPrimitive from "@radix-ui/react-aspect-ratio";
+
+function AspectRatio({
+  ...props
+}: React.ComponentProps<typeof AspectRatioPrimitive.Root>) {
+  return <AspectRatioPrimitive.Root data-slot="aspect-ratio" {...props} />;
+}
+
+export { AspectRatio };

Front/client/src/components/ui/avatar.tsx

@@ -0,0 +1,51 @@
+import * as React from "react";
+import * as AvatarPrimitive from "@radix-ui/react-avatar";
+
+import { cn } from "@/lib/utils";
+
+function Avatar({
+  className,
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Root>) {
+  return (
+    <AvatarPrimitive.Root
+      data-slot="avatar"
+      className={cn(
+        "relative flex size-8 shrink-0 overflow-hidden rounded-full",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function AvatarImage({
+  className,
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Image>) {
+  return (
+    <AvatarPrimitive.Image
+      data-slot="avatar-image"
+      className={cn("aspect-square size-full", className)}
+      {...props}
+    />
+  );
+}
+
+function AvatarFallback({
+  className,
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Fallback>) {
+  return (
+    <AvatarPrimitive.Fallback
+      data-slot="avatar-fallback"
+      className={cn(
+        "bg-muted flex size-full items-center justify-center rounded-full",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Avatar, AvatarImage, AvatarFallback };

Front/client/src/components/ui/badge.tsx

@@ -0,0 +1,46 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const badgeVariants = cva(
+  "inline-flex items-center justify-center rounded-md border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground [a&]:hover:bg-primary/90",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/90",
+        destructive:
+          "border-transparent bg-destructive text-white [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "text-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+function Badge({
+  className,
+  variant,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"span"> &
+  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot : "span";
+
+  return (
+    <Comp
+      data-slot="badge"
+      className={cn(badgeVariants({ variant }), className)}
+      {...props}
+    />
+  );
+}
+
+export { Badge, badgeVariants };

Front/client/src/components/ui/breadcrumb.tsx

@@ -0,0 +1,109 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { ChevronRight, MoreHorizontal } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Breadcrumb({ ...props }: React.ComponentProps<"nav">) {
+  return <nav aria-label="breadcrumb" data-slot="breadcrumb" {...props} />;
+}
+
+function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">) {
+  return (
+    <ol
+      data-slot="breadcrumb-list"
+      className={cn(
+        "text-muted-foreground flex flex-wrap items-center gap-1.5 text-sm break-words sm:gap-2.5",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">) {
+  return (
+    <li
+      data-slot="breadcrumb-item"
+      className={cn("inline-flex items-center gap-1.5", className)}
+      {...props}
+    />
+  );
+}
+
+function BreadcrumbLink({
+  asChild,
+  className,
+  ...props
+}: React.ComponentProps<"a"> & {
+  asChild?: boolean;
+}) {
+  const Comp = asChild ? Slot : "a";
+
+  return (
+    <Comp
+      data-slot="breadcrumb-link"
+      className={cn("hover:text-foreground transition-colors", className)}
+      {...props}
+    />
+  );
+}
+
+function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="breadcrumb-page"
+      role="link"
+      aria-disabled="true"
+      aria-current="page"
+      className={cn("text-foreground font-normal", className)}
+      {...props}
+    />
+  );
+}
+
+function BreadcrumbSeparator({
+  children,
+  className,
+  ...props
+}: React.ComponentProps<"li">) {
+  return (
+    <li
+      data-slot="breadcrumb-separator"
+      role="presentation"
+      aria-hidden="true"
+      className={cn("[&>svg]:size-3.5", className)}
+      {...props}
+    >
+      {children ?? <ChevronRight />}
+    </li>
+  );
+}
+
+function BreadcrumbEllipsis({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="breadcrumb-ellipsis"
+      role="presentation"
+      aria-hidden="true"
+      className={cn("flex size-9 items-center justify-center", className)}
+      {...props}
+    >
+      <MoreHorizontal className="size-4" />
+      <span className="sr-only">More</span>
+    </span>
+  );
+}
+
+export {
+  Breadcrumb,
+  BreadcrumbList,
+  BreadcrumbItem,
+  BreadcrumbLink,
+  BreadcrumbPage,
+  BreadcrumbSeparator,
+  BreadcrumbEllipsis,
+};

Front/client/src/components/ui/button-group.tsx

@@ -0,0 +1,83 @@
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { Separator } from "@/components/ui/separator";
+
+const buttonGroupVariants = cva(
+  "flex w-fit items-stretch [&>*]:focus-visible:z-10 [&>*]:focus-visible:relative [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-md has-[>[data-slot=button-group]]:gap-2",
+  {
+    variants: {
+      orientation: {
+        horizontal:
+          "[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none",
+        vertical:
+          "flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none",
+      },
+    },
+    defaultVariants: {
+      orientation: "horizontal",
+    },
+  }
+);
+
+function ButtonGroup({
+  className,
+  orientation,
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>) {
+  return (
+    <div
+      role="group"
+      data-slot="button-group"
+      data-orientation={orientation}
+      className={cn(buttonGroupVariants({ orientation }), className)}
+      {...props}
+    />
+  );
+}
+
+function ButtonGroupText({
+  className,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"div"> & {
+  asChild?: boolean;
+}) {
+  const Comp = asChild ? Slot : "div";
+
+  return (
+    <Comp
+      className={cn(
+        "bg-muted flex items-center gap-2 rounded-md border px-4 text-sm font-medium shadow-xs [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ButtonGroupSeparator({
+  className,
+  orientation = "vertical",
+  ...props
+}: React.ComponentProps<typeof Separator>) {
+  return (
+    <Separator
+      data-slot="button-group-separator"
+      orientation={orientation}
+      className={cn(
+        "bg-input relative !m-0 self-stretch data-[orientation=vertical]:h-auto",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  ButtonGroup,
+  ButtonGroupSeparator,
+  ButtonGroupText,
+  buttonGroupVariants,
+};

Front/client/src/components/ui/button.tsx

@@ -0,0 +1,60 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "border bg-transparent shadow-xs hover:bg-accent dark:bg-transparent dark:border-input dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+        "icon-sm": "size-8",
+        "icon-lg": "size-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+  }) {
+  const Comp = asChild ? Slot : "button";
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Button, buttonVariants };

Front/client/src/components/ui/calendar.tsx

@@ -0,0 +1,211 @@
+import * as React from "react";
+import {
+  ChevronDownIcon,
+  ChevronLeftIcon,
+  ChevronRightIcon,
+} from "lucide-react";
+import { DayButton, DayPicker, getDefaultClassNames } from "react-day-picker";
+
+import { cn } from "@/lib/utils";
+import { Button, buttonVariants } from "@/components/ui/button";
+
+function Calendar({
+  className,
+  classNames,
+  showOutsideDays = true,
+  captionLayout = "label",
+  buttonVariant = "ghost",
+  formatters,
+  components,
+  ...props
+}: React.ComponentProps<typeof DayPicker> & {
+  buttonVariant?: React.ComponentProps<typeof Button>["variant"];
+}) {
+  const defaultClassNames = getDefaultClassNames();
+
+  return (
+    <DayPicker
+      showOutsideDays={showOutsideDays}
+      className={cn(
+        "bg-background group/calendar p-3 [--cell-size:--spacing(8)] [[data-slot=card-content]_&]:bg-transparent [[data-slot=popover-content]_&]:bg-transparent",
+        String.raw`rtl:**:[.rdp-button\_next>svg]:rotate-180`,
+        String.raw`rtl:**:[.rdp-button\_previous>svg]:rotate-180`,
+        className
+      )}
+      captionLayout={captionLayout}
+      formatters={{
+        formatMonthDropdown: date =>
+          date.toLocaleString("default", { month: "short" }),
+        ...formatters,
+      }}
+      classNames={{
+        root: cn("w-fit", defaultClassNames.root),
+        months: cn(
+          "flex gap-4 flex-col md:flex-row relative",
+          defaultClassNames.months
+        ),
+        month: cn("flex flex-col w-full gap-4", defaultClassNames.month),
+        nav: cn(
+          "flex items-center gap-1 w-full absolute top-0 inset-x-0 justify-between",
+          defaultClassNames.nav
+        ),
+        button_previous: cn(
+          buttonVariants({ variant: buttonVariant }),
+          "size-(--cell-size) aria-disabled:opacity-50 p-0 select-none",
+          defaultClassNames.button_previous
+        ),
+        button_next: cn(
+          buttonVariants({ variant: buttonVariant }),
+          "size-(--cell-size) aria-disabled:opacity-50 p-0 select-none",
+          defaultClassNames.button_next
+        ),
+        month_caption: cn(
+          "flex items-center justify-center h-(--cell-size) w-full px-(--cell-size)",
+          defaultClassNames.month_caption
+        ),
+        dropdowns: cn(
+          "w-full flex items-center text-sm font-medium justify-center h-(--cell-size) gap-1.5",
+          defaultClassNames.dropdowns
+        ),
+        dropdown_root: cn(
+          "relative has-focus:border-ring border border-input shadow-xs has-focus:ring-ring/50 has-focus:ring-[3px] rounded-md",
+          defaultClassNames.dropdown_root
+        ),
+        dropdown: cn(
+          "absolute bg-popover inset-0 opacity-0",
+          defaultClassNames.dropdown
+        ),
+        caption_label: cn(
+          "select-none font-medium",
+          captionLayout === "label"
+            ? "text-sm"
+            : "rounded-md pl-2 pr-1 flex items-center gap-1 text-sm h-8 [&>svg]:text-muted-foreground [&>svg]:size-3.5",
+          defaultClassNames.caption_label
+        ),
+        table: "w-full border-collapse",
+        weekdays: cn("flex", defaultClassNames.weekdays),
+        weekday: cn(
+          "text-muted-foreground rounded-md flex-1 font-normal text-[0.8rem] select-none",
+          defaultClassNames.weekday
+        ),
+        week: cn("flex w-full mt-2", defaultClassNames.week),
+        week_number_header: cn(
+          "select-none w-(--cell-size)",
+          defaultClassNames.week_number_header
+        ),
+        week_number: cn(
+          "text-[0.8rem] select-none text-muted-foreground",
+          defaultClassNames.week_number
+        ),
+        day: cn(
+          "relative w-full h-full p-0 text-center [&:first-child[data-selected=true]_button]:rounded-l-md [&:last-child[data-selected=true]_button]:rounded-r-md group/day aspect-square select-none",
+          defaultClassNames.day
+        ),
+        range_start: cn(
+          "rounded-l-md bg-accent",
+          defaultClassNames.range_start
+        ),
+        range_middle: cn("rounded-none", defaultClassNames.range_middle),
+        range_end: cn("rounded-r-md bg-accent", defaultClassNames.range_end),
+        today: cn(
+          "bg-accent text-accent-foreground rounded-md data-[selected=true]:rounded-none",
+          defaultClassNames.today
+        ),
+        outside: cn(
+          "text-muted-foreground aria-selected:text-muted-foreground",
+          defaultClassNames.outside
+        ),
+        disabled: cn(
+          "text-muted-foreground opacity-50",
+          defaultClassNames.disabled
+        ),
+        hidden: cn("invisible", defaultClassNames.hidden),
+        ...classNames,
+      }}
+      components={{
+        Root: ({ className, rootRef, ...props }) => {
+          return (
+            <div
+              data-slot="calendar"
+              ref={rootRef}
+              className={cn(className)}
+              {...props}
+            />
+          );
+        },
+        Chevron: ({ className, orientation, ...props }) => {
+          if (orientation === "left") {
+            return (
+              <ChevronLeftIcon className={cn("size-4", className)} {...props} />
+            );
+          }
+
+          if (orientation === "right") {
+            return (
+              <ChevronRightIcon
+                className={cn("size-4", className)}
+                {...props}
+              />
+            );
+          }
+
+          return (
+            <ChevronDownIcon className={cn("size-4", className)} {...props} />
+          );
+        },
+        DayButton: CalendarDayButton,
+        WeekNumber: ({ children, ...props }) => {
+          return (
+            <td {...props}>
+              <div className="flex size-(--cell-size) items-center justify-center text-center">
+                {children}
+              </div>
+            </td>
+          );
+        },
+        ...components,
+      }}
+      {...props}
+    />
+  );
+}
+
+function CalendarDayButton({
+  className,
+  day,
+  modifiers,
+  ...props
+}: React.ComponentProps<typeof DayButton>) {
+  const defaultClassNames = getDefaultClassNames();
+
+  const ref = React.useRef<HTMLButtonElement>(null);
+  React.useEffect(() => {
+    if (modifiers.focused) ref.current?.focus();
+  }, [modifiers.focused]);
+
+  return (
+    <Button
+      ref={ref}
+      variant="ghost"
+      size="icon"
+      data-day={day.date.toLocaleDateString()}
+      data-selected-single={
+        modifiers.selected &&
+        !modifiers.range_start &&
+        !modifiers.range_end &&
+        !modifiers.range_middle
+      }
+      data-range-start={modifiers.range_start}
+      data-range-end={modifiers.range_end}
+      data-range-middle={modifiers.range_middle}
+      className={cn(
+        "data-[selected-single=true]:bg-primary data-[selected-single=true]:text-primary-foreground data-[range-middle=true]:bg-accent data-[range-middle=true]:text-accent-foreground data-[range-start=true]:bg-primary data-[range-start=true]:text-primary-foreground data-[range-end=true]:bg-primary data-[range-end=true]:text-primary-foreground group-data-[focused=true]/day:border-ring group-data-[focused=true]/day:ring-ring/50 dark:hover:text-accent-foreground flex aspect-square size-auto w-full min-w-(--cell-size) flex-col gap-1 leading-none font-normal group-data-[focused=true]/day:relative group-data-[focused=true]/day:z-10 group-data-[focused=true]/day:ring-[3px] data-[range-end=true]:rounded-md data-[range-end=true]:rounded-r-md data-[range-middle=true]:rounded-none data-[range-start=true]:rounded-md data-[range-start=true]:rounded-l-md [&>span]:text-xs [&>span]:opacity-70",
+        defaultClassNames.day,
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Calendar, CalendarDayButton };

Front/client/src/components/ui/card.tsx

@@ -0,0 +1,92 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card"
+      className={cn(
+        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("leading-none font-semibold", className)}
+      {...props}
+    />
+  );
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn(
+        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-6", className)}
+      {...props}
+    />
+  );
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
+};

Front/client/src/components/ui/carousel.tsx

@@ -0,0 +1,239 @@
+import * as React from "react";
+import useEmblaCarousel, {
+  type UseEmblaCarouselType,
+} from "embla-carousel-react";
+import { ArrowLeft, ArrowRight } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+import { Button } from "@/components/ui/button";
+
+type CarouselApi = UseEmblaCarouselType[1];
+type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
+type CarouselOptions = UseCarouselParameters[0];
+type CarouselPlugin = UseCarouselParameters[1];
+
+type CarouselProps = {
+  opts?: CarouselOptions;
+  plugins?: CarouselPlugin;
+  orientation?: "horizontal" | "vertical";
+  setApi?: (api: CarouselApi) => void;
+};
+
+type CarouselContextProps = {
+  carouselRef: ReturnType<typeof useEmblaCarousel>[0];
+  api: ReturnType<typeof useEmblaCarousel>[1];
+  scrollPrev: () => void;
+  scrollNext: () => void;
+  canScrollPrev: boolean;
+  canScrollNext: boolean;
+} & CarouselProps;
+
+const CarouselContext = React.createContext<CarouselContextProps | null>(null);
+
+function useCarousel() {
+  const context = React.useContext(CarouselContext);
+
+  if (!context) {
+    throw new Error("useCarousel must be used within a <Carousel />");
+  }
+
+  return context;
+}
+
+function Carousel({
+  orientation = "horizontal",
+  opts,
+  setApi,
+  plugins,
+  className,
+  children,
+  ...props
+}: React.ComponentProps<"div"> & CarouselProps) {
+  const [carouselRef, api] = useEmblaCarousel(
+    {
+      ...opts,
+      axis: orientation === "horizontal" ? "x" : "y",
+    },
+    plugins
+  );
+  const [canScrollPrev, setCanScrollPrev] = React.useState(false);
+  const [canScrollNext, setCanScrollNext] = React.useState(false);
+
+  const onSelect = React.useCallback((api: CarouselApi) => {
+    if (!api) return;
+    setCanScrollPrev(api.canScrollPrev());
+    setCanScrollNext(api.canScrollNext());
+  }, []);
+
+  const scrollPrev = React.useCallback(() => {
+    api?.scrollPrev();
+  }, [api]);
+
+  const scrollNext = React.useCallback(() => {
+    api?.scrollNext();
+  }, [api]);
+
+  const handleKeyDown = React.useCallback(
+    (event: React.KeyboardEvent<HTMLDivElement>) => {
+      if (event.key === "ArrowLeft") {
+        event.preventDefault();
+        scrollPrev();
+      } else if (event.key === "ArrowRight") {
+        event.preventDefault();
+        scrollNext();
+      }
+    },
+    [scrollPrev, scrollNext]
+  );
+
+  React.useEffect(() => {
+    if (!api || !setApi) return;
+    setApi(api);
+  }, [api, setApi]);
+
+  React.useEffect(() => {
+    if (!api) return;
+    onSelect(api);
+    api.on("reInit", onSelect);
+    api.on("select", onSelect);
+
+    return () => {
+      api?.off("select", onSelect);
+    };
+  }, [api, onSelect]);
+
+  return (
+    <CarouselContext.Provider
+      value={{
+        carouselRef,
+        api: api,
+        opts,
+        orientation:
+          orientation || (opts?.axis === "y" ? "vertical" : "horizontal"),
+        scrollPrev,
+        scrollNext,
+        canScrollPrev,
+        canScrollNext,
+      }}
+    >
+      <div
+        onKeyDownCapture={handleKeyDown}
+        className={cn("relative", className)}
+        role="region"
+        aria-roledescription="carousel"
+        data-slot="carousel"
+        {...props}
+      >
+        {children}
+      </div>
+    </CarouselContext.Provider>
+  );
+}
+
+function CarouselContent({ className, ...props }: React.ComponentProps<"div">) {
+  const { carouselRef, orientation } = useCarousel();
+
+  return (
+    <div
+      ref={carouselRef}
+      className="overflow-hidden"
+      data-slot="carousel-content"
+    >
+      <div
+        className={cn(
+          "flex",
+          orientation === "horizontal" ? "-ml-4" : "-mt-4 flex-col",
+          className
+        )}
+        {...props}
+      />
+    </div>
+  );
+}
+
+function CarouselItem({ className, ...props }: React.ComponentProps<"div">) {
+  const { orientation } = useCarousel();
+
+  return (
+    <div
+      role="group"
+      aria-roledescription="slide"
+      data-slot="carousel-item"
+      className={cn(
+        "min-w-0 shrink-0 grow-0 basis-full",
+        orientation === "horizontal" ? "pl-4" : "pt-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CarouselPrevious({
+  className,
+  variant = "outline",
+  size = "icon",
+  ...props
+}: React.ComponentProps<typeof Button>) {
+  const { orientation, scrollPrev, canScrollPrev } = useCarousel();
+
+  return (
+    <Button
+      data-slot="carousel-previous"
+      variant={variant}
+      size={size}
+      className={cn(
+        "absolute size-8 rounded-full",
+        orientation === "horizontal"
+          ? "top-1/2 -left-12 -translate-y-1/2"
+          : "-top-12 left-1/2 -translate-x-1/2 rotate-90",
+        className
+      )}
+      disabled={!canScrollPrev}
+      onClick={scrollPrev}
+      {...props}
+    >
+      <ArrowLeft />
+      <span className="sr-only">Previous slide</span>
+    </Button>
+  );
+}
+
+function CarouselNext({
+  className,
+  variant = "outline",
+  size = "icon",
+  ...props
+}: React.ComponentProps<typeof Button>) {
+  const { orientation, scrollNext, canScrollNext } = useCarousel();
+
+  return (
+    <Button
+      data-slot="carousel-next"
+      variant={variant}
+      size={size}
+      className={cn(
+        "absolute size-8 rounded-full",
+        orientation === "horizontal"
+          ? "top-1/2 -right-12 -translate-y-1/2"
+          : "-bottom-12 left-1/2 -translate-x-1/2 rotate-90",
+        className
+      )}
+      disabled={!canScrollNext}
+      onClick={scrollNext}
+      {...props}
+    >
+      <ArrowRight />
+      <span className="sr-only">Next slide</span>
+    </Button>
+  );
+}
+
+export {
+  type CarouselApi,
+  Carousel,
+  CarouselContent,
+  CarouselItem,
+  CarouselPrevious,
+  CarouselNext,
+};

Front/client/src/components/ui/chart.tsx

@@ -0,0 +1,355 @@
+import * as React from "react";
+import * as RechartsPrimitive from "recharts";
+
+import { cn } from "@/lib/utils";
+
+// Format: { THEME_NAME: CSS_SELECTOR }
+const THEMES = { light: "", dark: ".dark" } as const;
+
+export type ChartConfig = {
+  [k in string]: {
+    label?: React.ReactNode;
+    icon?: React.ComponentType;
+  } & (
+    | { color?: string; theme?: never }
+    | { color?: never; theme: Record<keyof typeof THEMES, string> }
+  );
+};
+
+type ChartContextProps = {
+  config: ChartConfig;
+};
+
+const ChartContext = React.createContext<ChartContextProps | null>(null);
+
+function useChart() {
+  const context = React.useContext(ChartContext);
+
+  if (!context) {
+    throw new Error("useChart must be used within a <ChartContainer />");
+  }
+
+  return context;
+}
+
+function ChartContainer({
+  id,
+  className,
+  children,
+  config,
+  ...props
+}: React.ComponentProps<"div"> & {
+  config: ChartConfig;
+  children: React.ComponentProps<
+    typeof RechartsPrimitive.ResponsiveContainer
+  >["children"];
+}) {
+  const uniqueId = React.useId();
+  const chartId = `chart-${id || uniqueId.replace(/:/g, "")}`;
+
+  return (
+    <ChartContext.Provider value={{ config }}>
+      <div
+        data-slot="chart"
+        data-chart={chartId}
+        className={cn(
+          "[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-muted [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border flex aspect-video justify-center text-xs [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-surface]:outline-hidden",
+          className
+        )}
+        {...props}
+      >
+        <ChartStyle id={chartId} config={config} />
+        <RechartsPrimitive.ResponsiveContainer>
+          {children}
+        </RechartsPrimitive.ResponsiveContainer>
+      </div>
+    </ChartContext.Provider>
+  );
+}
+
+const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
+  const colorConfig = Object.entries(config).filter(
+    ([, config]) => config.theme || config.color
+  );
+
+  if (!colorConfig.length) {
+    return null;
+  }
+
+  return (
+    <style
+      dangerouslySetInnerHTML={{
+        __html: Object.entries(THEMES)
+          .map(
+            ([theme, prefix]) => `
+${prefix} [data-chart=${id}] {
+${colorConfig
+  .map(([key, itemConfig]) => {
+    const color =
+      itemConfig.theme?.[theme as keyof typeof itemConfig.theme] ||
+      itemConfig.color;
+    return color ? `  --color-${key}: ${color};` : null;
+  })
+  .join("\n")}
+}
+`
+          )
+          .join("\n"),
+      }}
+    />
+  );
+};
+
+const ChartTooltip = RechartsPrimitive.Tooltip;
+
+function ChartTooltipContent({
+  active,
+  payload,
+  className,
+  indicator = "dot",
+  hideLabel = false,
+  hideIndicator = false,
+  label,
+  labelFormatter,
+  labelClassName,
+  formatter,
+  color,
+  nameKey,
+  labelKey,
+}: React.ComponentProps<typeof RechartsPrimitive.Tooltip> &
+  React.ComponentProps<"div"> & {
+    hideLabel?: boolean;
+    hideIndicator?: boolean;
+    indicator?: "line" | "dot" | "dashed";
+    nameKey?: string;
+    labelKey?: string;
+  }) {
+  const { config } = useChart();
+
+  const tooltipLabel = React.useMemo(() => {
+    if (hideLabel || !payload?.length) {
+      return null;
+    }
+
+    const [item] = payload;
+    const key = `${labelKey || item?.dataKey || item?.name || "value"}`;
+    const itemConfig = getPayloadConfigFromPayload(config, item, key);
+    const value =
+      !labelKey && typeof label === "string"
+        ? config[label as keyof typeof config]?.label || label
+        : itemConfig?.label;
+
+    if (labelFormatter) {
+      return (
+        <div className={cn("font-medium", labelClassName)}>
+          {labelFormatter(value, payload)}
+        </div>
+      );
+    }
+
+    if (!value) {
+      return null;
+    }
+
+    return <div className={cn("font-medium", labelClassName)}>{value}</div>;
+  }, [
+    label,
+    labelFormatter,
+    payload,
+    hideLabel,
+    labelClassName,
+    config,
+    labelKey,
+  ]);
+
+  if (!active || !payload?.length) {
+    return null;
+  }
+
+  const nestLabel = payload.length === 1 && indicator !== "dot";
+
+  return (
+    <div
+      className={cn(
+        "border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-xl",
+        className
+      )}
+    >
+      {!nestLabel ? tooltipLabel : null}
+      <div className="grid gap-1.5">
+        {payload
+          .filter(item => item.type !== "none")
+          .map((item, index) => {
+            const key = `${nameKey || item.name || item.dataKey || "value"}`;
+            const itemConfig = getPayloadConfigFromPayload(config, item, key);
+            const indicatorColor = color || item.payload.fill || item.color;
+
+            return (
+              <div
+                key={item.dataKey}
+                className={cn(
+                  "[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5",
+                  indicator === "dot" && "items-center"
+                )}
+              >
+                {formatter && item?.value !== undefined && item.name ? (
+                  formatter(item.value, item.name, item, index, item.payload)
+                ) : (
+                  <>
+                    {itemConfig?.icon ? (
+                      <itemConfig.icon />
+                    ) : (
+                      !hideIndicator && (
+                        <div
+                          className={cn(
+                            "shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)",
+                            {
+                              "h-2.5 w-2.5": indicator === "dot",
+                              "w-1": indicator === "line",
+                              "w-0 border-[1.5px] border-dashed bg-transparent":
+                                indicator === "dashed",
+                              "my-0.5": nestLabel && indicator === "dashed",
+                            }
+                          )}
+                          style={
+                            {
+                              "--color-bg": indicatorColor,
+                              "--color-border": indicatorColor,
+                            } as React.CSSProperties
+                          }
+                        />
+                      )
+                    )}
+                    <div
+                      className={cn(
+                        "flex flex-1 justify-between leading-none",
+                        nestLabel ? "items-end" : "items-center"
+                      )}
+                    >
+                      <div className="grid gap-1.5">
+                        {nestLabel ? tooltipLabel : null}
+                        <span className="text-muted-foreground">
+                          {itemConfig?.label || item.name}
+                        </span>
+                      </div>
+                      {item.value && (
+                        <span className="text-foreground font-mono font-medium tabular-nums">
+                          {item.value.toLocaleString()}
+                        </span>
+                      )}
+                    </div>
+                  </>
+                )}
+              </div>
+            );
+          })}
+      </div>
+    </div>
+  );
+}
+
+const ChartLegend = RechartsPrimitive.Legend;
+
+function ChartLegendContent({
+  className,
+  hideIcon = false,
+  payload,
+  verticalAlign = "bottom",
+  nameKey,
+}: React.ComponentProps<"div"> &
+  Pick<RechartsPrimitive.LegendProps, "payload" | "verticalAlign"> & {
+    hideIcon?: boolean;
+    nameKey?: string;
+  }) {
+  const { config } = useChart();
+
+  if (!payload?.length) {
+    return null;
+  }
+
+  return (
+    <div
+      className={cn(
+        "flex items-center justify-center gap-4",
+        verticalAlign === "top" ? "pb-3" : "pt-3",
+        className
+      )}
+    >
+      {payload
+        .filter(item => item.type !== "none")
+        .map(item => {
+          const key = `${nameKey || item.dataKey || "value"}`;
+          const itemConfig = getPayloadConfigFromPayload(config, item, key);
+
+          return (
+            <div
+              key={item.value}
+              className={cn(
+                "[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3"
+              )}
+            >
+              {itemConfig?.icon && !hideIcon ? (
+                <itemConfig.icon />
+              ) : (
+                <div
+                  className="h-2 w-2 shrink-0 rounded-[2px]"
+                  style={{
+                    backgroundColor: item.color,
+                  }}
+                />
+              )}
+              {itemConfig?.label}
+            </div>
+          );
+        })}
+    </div>
+  );
+}
+
+// Helper to extract item config from a payload.
+function getPayloadConfigFromPayload(
+  config: ChartConfig,
+  payload: unknown,
+  key: string
+) {
+  if (typeof payload !== "object" || payload === null) {
+    return undefined;
+  }
+
+  const payloadPayload =
+    "payload" in payload &&
+    typeof payload.payload === "object" &&
+    payload.payload !== null
+      ? payload.payload
+      : undefined;
+
+  let configLabelKey: string = key;
+
+  if (
+    key in payload &&
+    typeof payload[key as keyof typeof payload] === "string"
+  ) {
+    configLabelKey = payload[key as keyof typeof payload] as string;
+  } else if (
+    payloadPayload &&
+    key in payloadPayload &&
+    typeof payloadPayload[key as keyof typeof payloadPayload] === "string"
+  ) {
+    configLabelKey = payloadPayload[
+      key as keyof typeof payloadPayload
+    ] as string;
+  }
+
+  return configLabelKey in config
+    ? config[configLabelKey]
+    : config[key as keyof typeof config];
+}
+
+export {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  ChartLegend,
+  ChartLegendContent,
+  ChartStyle,
+};

Front/client/src/components/ui/checkbox.tsx

@@ -0,0 +1,30 @@
+import * as React from "react";
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
+import { CheckIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Checkbox({
+  className,
+  ...props
+}: React.ComponentProps<typeof CheckboxPrimitive.Root>) {
+  return (
+    <CheckboxPrimitive.Root
+      data-slot="checkbox"
+      className={cn(
+        "peer border-input dark:bg-input/30 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground dark:data-[state=checked]:bg-primary data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive size-4 shrink-0 rounded-[4px] border shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <CheckboxPrimitive.Indicator
+        data-slot="checkbox-indicator"
+        className="flex items-center justify-center text-current transition-none"
+      >
+        <CheckIcon className="size-3.5" />
+      </CheckboxPrimitive.Indicator>
+    </CheckboxPrimitive.Root>
+  );
+}
+
+export { Checkbox };

Front/client/src/components/ui/collapsible.tsx

@@ -0,0 +1,31 @@
+import * as CollapsiblePrimitive from "@radix-ui/react-collapsible";
+
+function Collapsible({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.Root>) {
+  return <CollapsiblePrimitive.Root data-slot="collapsible" {...props} />;
+}
+
+function CollapsibleTrigger({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>) {
+  return (
+    <CollapsiblePrimitive.CollapsibleTrigger
+      data-slot="collapsible-trigger"
+      {...props}
+    />
+  );
+}
+
+function CollapsibleContent({
+  ...props
+}: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>) {
+  return (
+    <CollapsiblePrimitive.CollapsibleContent
+      data-slot="collapsible-content"
+      {...props}
+    />
+  );
+}
+
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };

Front/client/src/components/ui/command.tsx

@@ -0,0 +1,184 @@
+"use client";
+
+import * as React from "react";
+import { Command as CommandPrimitive } from "cmdk";
+import { SearchIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+
+function Command({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive>) {
+  return (
+    <CommandPrimitive
+      data-slot="command"
+      className={cn(
+        "bg-popover text-popover-foreground flex h-full w-full flex-col overflow-hidden rounded-md",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CommandDialog({
+  title = "Command Palette",
+  description = "Search for a command to run...",
+  children,
+  className,
+  showCloseButton = true,
+  ...props
+}: React.ComponentProps<typeof Dialog> & {
+  title?: string;
+  description?: string;
+  className?: string;
+  showCloseButton?: boolean;
+}) {
+  return (
+    <Dialog {...props}>
+      <DialogHeader className="sr-only">
+        <DialogTitle>{title}</DialogTitle>
+        <DialogDescription>{description}</DialogDescription>
+      </DialogHeader>
+      <DialogContent
+        className={cn("overflow-hidden p-0", className)}
+        showCloseButton={showCloseButton}
+      >
+        <Command className="[&_[cmdk-group-heading]]:text-muted-foreground **:data-[slot=command-input-wrapper]:h-12 [&_[cmdk-group-heading]]:px-2 [&_[cmdk-group-heading]]:font-medium [&_[cmdk-group]]:px-2 [&_[cmdk-group]:not([hidden])_~[cmdk-group]]:pt-0 [&_[cmdk-input-wrapper]_svg]:h-5 [&_[cmdk-input-wrapper]_svg]:w-5 [&_[cmdk-input]]:h-12 [&_[cmdk-item]]:px-2 [&_[cmdk-item]]:py-3 [&_[cmdk-item]_svg]:h-5 [&_[cmdk-item]_svg]:w-5">
+          {children}
+        </Command>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+function CommandInput({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.Input>) {
+  return (
+    <div
+      data-slot="command-input-wrapper"
+      className="flex h-9 items-center gap-2 border-b px-3"
+    >
+      <SearchIcon className="size-4 shrink-0 opacity-50" />
+      <CommandPrimitive.Input
+        data-slot="command-input"
+        className={cn(
+          "placeholder:text-muted-foreground flex h-10 w-full rounded-md bg-transparent py-3 text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        )}
+        {...props}
+      />
+    </div>
+  );
+}
+
+function CommandList({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.List>) {
+  return (
+    <CommandPrimitive.List
+      data-slot="command-list"
+      className={cn(
+        "max-h-[300px] scroll-py-1 overflow-x-hidden overflow-y-auto",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CommandEmpty({
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.Empty>) {
+  return (
+    <CommandPrimitive.Empty
+      data-slot="command-empty"
+      className="py-6 text-center text-sm"
+      {...props}
+    />
+  );
+}
+
+function CommandGroup({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.Group>) {
+  return (
+    <CommandPrimitive.Group
+      data-slot="command-group"
+      className={cn(
+        "text-foreground [&_[cmdk-group-heading]]:text-muted-foreground overflow-hidden p-1 [&_[cmdk-group-heading]]:px-2 [&_[cmdk-group-heading]]:py-1.5 [&_[cmdk-group-heading]]:text-xs [&_[cmdk-group-heading]]:font-medium",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CommandSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.Separator>) {
+  return (
+    <CommandPrimitive.Separator
+      data-slot="command-separator"
+      className={cn("bg-border -mx-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function CommandItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof CommandPrimitive.Item>) {
+  return (
+    <CommandPrimitive.Item
+      data-slot="command-item"
+      className={cn(
+        "data-[selected=true]:bg-accent data-[selected=true]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function CommandShortcut({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="command-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  Command,
+  CommandDialog,
+  CommandInput,
+  CommandList,
+  CommandEmpty,
+  CommandGroup,
+  CommandItem,
+  CommandShortcut,
+  CommandSeparator,
+};

Front/client/src/components/ui/context-menu.tsx

@@ -0,0 +1,250 @@
+import * as React from "react";
+import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
+import { CheckIcon, ChevronRightIcon, CircleIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function ContextMenu({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Root>) {
+  return <ContextMenuPrimitive.Root data-slot="context-menu" {...props} />;
+}
+
+function ContextMenuTrigger({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Trigger>) {
+  return (
+    <ContextMenuPrimitive.Trigger data-slot="context-menu-trigger" {...props} />
+  );
+}
+
+function ContextMenuGroup({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Group>) {
+  return (
+    <ContextMenuPrimitive.Group data-slot="context-menu-group" {...props} />
+  );
+}
+
+function ContextMenuPortal({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Portal>) {
+  return (
+    <ContextMenuPrimitive.Portal data-slot="context-menu-portal" {...props} />
+  );
+}
+
+function ContextMenuSub({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Sub>) {
+  return <ContextMenuPrimitive.Sub data-slot="context-menu-sub" {...props} />;
+}
+
+function ContextMenuRadioGroup({
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.RadioGroup>) {
+  return (
+    <ContextMenuPrimitive.RadioGroup
+      data-slot="context-menu-radio-group"
+      {...props}
+    />
+  );
+}
+
+function ContextMenuSubTrigger({
+  className,
+  inset,
+  children,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.SubTrigger> & {
+  inset?: boolean;
+}) {
+  return (
+    <ContextMenuPrimitive.SubTrigger
+      data-slot="context-menu-sub-trigger"
+      data-inset={inset}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronRightIcon className="ml-auto" />
+    </ContextMenuPrimitive.SubTrigger>
+  );
+}
+
+function ContextMenuSubContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.SubContent>) {
+  return (
+    <ContextMenuPrimitive.SubContent
+      data-slot="context-menu-sub-content"
+      className={cn(
+        "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-context-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ContextMenuContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Content>) {
+  return (
+    <ContextMenuPrimitive.Portal>
+      <ContextMenuPrimitive.Content
+        data-slot="context-menu-content"
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-context-menu-content-available-height) min-w-[8rem] origin-(--radix-context-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
+          className
+        )}
+        {...props}
+      />
+    </ContextMenuPrimitive.Portal>
+  );
+}
+
+function ContextMenuItem({
+  className,
+  inset,
+  variant = "default",
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Item> & {
+  inset?: boolean;
+  variant?: "default" | "destructive";
+}) {
+  return (
+    <ContextMenuPrimitive.Item
+      data-slot="context-menu-item"
+      data-inset={inset}
+      data-variant={variant}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ContextMenuCheckboxItem({
+  className,
+  children,
+  checked,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.CheckboxItem>) {
+  return (
+    <ContextMenuPrimitive.CheckboxItem
+      data-slot="context-menu-checkbox-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      checked={checked}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <ContextMenuPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </ContextMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </ContextMenuPrimitive.CheckboxItem>
+  );
+}
+
+function ContextMenuRadioItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.RadioItem>) {
+  return (
+    <ContextMenuPrimitive.RadioItem
+      data-slot="context-menu-radio-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <ContextMenuPrimitive.ItemIndicator>
+          <CircleIcon className="size-2 fill-current" />
+        </ContextMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </ContextMenuPrimitive.RadioItem>
+  );
+}
+
+function ContextMenuLabel({
+  className,
+  inset,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Label> & {
+  inset?: boolean;
+}) {
+  return (
+    <ContextMenuPrimitive.Label
+      data-slot="context-menu-label"
+      data-inset={inset}
+      className={cn(
+        "text-foreground px-2 py-1.5 text-sm font-medium data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ContextMenuSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof ContextMenuPrimitive.Separator>) {
+  return (
+    <ContextMenuPrimitive.Separator
+      data-slot="context-menu-separator"
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function ContextMenuShortcut({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="context-menu-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  ContextMenu,
+  ContextMenuTrigger,
+  ContextMenuContent,
+  ContextMenuItem,
+  ContextMenuCheckboxItem,
+  ContextMenuRadioItem,
+  ContextMenuLabel,
+  ContextMenuSeparator,
+  ContextMenuShortcut,
+  ContextMenuGroup,
+  ContextMenuPortal,
+  ContextMenuSub,
+  ContextMenuSubContent,
+  ContextMenuSubTrigger,
+  ContextMenuRadioGroup,
+};

Front/client/src/components/ui/dialog.tsx

@@ -0,0 +1,209 @@
+import { cn } from "@/lib/utils";
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+import { XIcon } from "lucide-react";
+import * as React from "react";
+
+// Context to track composition state across dialog children
+const DialogCompositionContext = React.createContext<{
+  isComposing: () => boolean;
+  setComposing: (composing: boolean) => void;
+  justEndedComposing: () => boolean;
+  markCompositionEnd: () => void;
+}>({
+  isComposing: () => false,
+  setComposing: () => {},
+  justEndedComposing: () => false,
+  markCompositionEnd: () => {},
+});
+
+export const useDialogComposition = () =>
+  React.useContext(DialogCompositionContext);
+
+function Dialog({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Root>) {
+  const composingRef = React.useRef(false);
+  const justEndedRef = React.useRef(false);
+  const endTimerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  const contextValue = React.useMemo(
+    () => ({
+      isComposing: () => composingRef.current,
+      setComposing: (composing: boolean) => {
+        composingRef.current = composing;
+      },
+      justEndedComposing: () => justEndedRef.current,
+      markCompositionEnd: () => {
+        justEndedRef.current = true;
+        if (endTimerRef.current) {
+          clearTimeout(endTimerRef.current);
+        }
+        endTimerRef.current = setTimeout(() => {
+          justEndedRef.current = false;
+        }, 150);
+      },
+    }),
+    []
+  );
+
+  return (
+    <DialogCompositionContext.Provider value={contextValue}>
+      <DialogPrimitive.Root data-slot="dialog" {...props} />
+    </DialogCompositionContext.Provider>
+  );
+}
+
+function DialogTrigger({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Trigger>) {
+  return <DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />;
+}
+
+function DialogPortal({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Portal>) {
+  return <DialogPrimitive.Portal data-slot="dialog-portal" {...props} />;
+}
+
+function DialogClose({
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Close>) {
+  return <DialogPrimitive.Close data-slot="dialog-close" {...props} />;
+}
+
+function DialogOverlay({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Overlay>) {
+  return (
+    <DialogPrimitive.Overlay
+      data-slot="dialog-overlay"
+      className={cn(
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+DialogOverlay.displayName = "DialogOverlay";
+
+function DialogContent({
+  className,
+  children,
+  showCloseButton = true,
+  onEscapeKeyDown,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Content> & {
+  showCloseButton?: boolean;
+}) {
+  const { isComposing } = useDialogComposition();
+
+  const handleEscapeKeyDown = React.useCallback(
+    (e: KeyboardEvent) => {
+      // Check both the native isComposing property and our context state
+      // This handles Safari's timing issues with composition events
+      const isCurrentlyComposing = (e as any).isComposing || isComposing();
+
+      // If IME is composing, prevent dialog from closing
+      if (isCurrentlyComposing) {
+        e.preventDefault();
+        return;
+      }
+
+      // Call user's onEscapeKeyDown if provided
+      onEscapeKeyDown?.(e);
+    },
+    [isComposing, onEscapeKeyDown]
+  );
+
+  return (
+    <DialogPortal data-slot="dialog-portal">
+      <DialogOverlay />
+      <DialogPrimitive.Content
+        data-slot="dialog-content"
+        className={cn(
+          "bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-lg border p-6 shadow-lg duration-200 sm:max-w-lg",
+          className
+        )}
+        onEscapeKeyDown={handleEscapeKeyDown}
+        {...props}
+      >
+        {children}
+        {showCloseButton && (
+          <DialogPrimitive.Close
+            data-slot="dialog-close"
+            className="ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4"
+          >
+            <XIcon />
+            <span className="sr-only">Close</span>
+          </DialogPrimitive.Close>
+        )}
+      </DialogPrimitive.Content>
+    </DialogPortal>
+  );
+}
+
+function DialogHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="dialog-header"
+      className={cn("flex flex-col gap-2 text-center sm:text-left", className)}
+      {...props}
+    />
+  );
+}
+
+function DialogFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="dialog-footer"
+      className={cn(
+        "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DialogTitle({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Title>) {
+  return (
+    <DialogPrimitive.Title
+      data-slot="dialog-title"
+      className={cn("text-lg leading-none font-semibold", className)}
+      {...props}
+    />
+  );
+}
+
+function DialogDescription({
+  className,
+  ...props
+}: React.ComponentProps<typeof DialogPrimitive.Description>) {
+  return (
+    <DialogPrimitive.Description
+      data-slot="dialog-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Dialog,
+  DialogClose,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogOverlay,
+  DialogPortal,
+  DialogTitle,
+  DialogTrigger
+};
+

Front/client/src/components/ui/drawer.tsx

@@ -0,0 +1,133 @@
+import * as React from "react";
+import { Drawer as DrawerPrimitive } from "vaul";
+
+import { cn } from "@/lib/utils";
+
+function Drawer({
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Root>) {
+  return <DrawerPrimitive.Root data-slot="drawer" {...props} />;
+}
+
+function DrawerTrigger({
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Trigger>) {
+  return <DrawerPrimitive.Trigger data-slot="drawer-trigger" {...props} />;
+}
+
+function DrawerPortal({
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Portal>) {
+  return <DrawerPrimitive.Portal data-slot="drawer-portal" {...props} />;
+}
+
+function DrawerClose({
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Close>) {
+  return <DrawerPrimitive.Close data-slot="drawer-close" {...props} />;
+}
+
+function DrawerOverlay({
+  className,
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Overlay>) {
+  return (
+    <DrawerPrimitive.Overlay
+      data-slot="drawer-overlay"
+      className={cn(
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DrawerContent({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Content>) {
+  return (
+    <DrawerPortal data-slot="drawer-portal">
+      <DrawerOverlay />
+      <DrawerPrimitive.Content
+        data-slot="drawer-content"
+        className={cn(
+          "group/drawer-content bg-background fixed z-50 flex h-auto flex-col",
+          "data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80vh] data-[vaul-drawer-direction=top]:rounded-b-lg data-[vaul-drawer-direction=top]:border-b",
+          "data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80vh] data-[vaul-drawer-direction=bottom]:rounded-t-lg data-[vaul-drawer-direction=bottom]:border-t",
+          "data-[vaul-drawer-direction=right]:inset-y-0 data-[vaul-drawer-direction=right]:right-0 data-[vaul-drawer-direction=right]:w-3/4 data-[vaul-drawer-direction=right]:border-l data-[vaul-drawer-direction=right]:sm:max-w-sm",
+          "data-[vaul-drawer-direction=left]:inset-y-0 data-[vaul-drawer-direction=left]:left-0 data-[vaul-drawer-direction=left]:w-3/4 data-[vaul-drawer-direction=left]:border-r data-[vaul-drawer-direction=left]:sm:max-w-sm",
+          className
+        )}
+        {...props}
+      >
+        <div className="bg-muted mx-auto mt-4 hidden h-2 w-[100px] shrink-0 rounded-full group-data-[vaul-drawer-direction=bottom]/drawer-content:block" />
+        {children}
+      </DrawerPrimitive.Content>
+    </DrawerPortal>
+  );
+}
+
+function DrawerHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="drawer-header"
+      className={cn(
+        "flex flex-col gap-0.5 p-4 group-data-[vaul-drawer-direction=bottom]/drawer-content:text-center group-data-[vaul-drawer-direction=top]/drawer-content:text-center md:gap-1.5 md:text-left",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="drawer-footer"
+      className={cn("mt-auto flex flex-col gap-2 p-4", className)}
+      {...props}
+    />
+  );
+}
+
+function DrawerTitle({
+  className,
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Title>) {
+  return (
+    <DrawerPrimitive.Title
+      data-slot="drawer-title"
+      className={cn("text-foreground font-semibold", className)}
+      {...props}
+    />
+  );
+}
+
+function DrawerDescription({
+  className,
+  ...props
+}: React.ComponentProps<typeof DrawerPrimitive.Description>) {
+  return (
+    <DrawerPrimitive.Description
+      data-slot="drawer-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Drawer,
+  DrawerPortal,
+  DrawerOverlay,
+  DrawerTrigger,
+  DrawerClose,
+  DrawerContent,
+  DrawerHeader,
+  DrawerFooter,
+  DrawerTitle,
+  DrawerDescription,
+};

Front/client/src/components/ui/dropdown-menu.tsx

@@ -0,0 +1,255 @@
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+import { CheckIcon, ChevronRightIcon, CircleIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function DropdownMenu({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Root>) {
+  return <DropdownMenuPrimitive.Root data-slot="dropdown-menu" {...props} />;
+}
+
+function DropdownMenuPortal({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>) {
+  return (
+    <DropdownMenuPrimitive.Portal data-slot="dropdown-menu-portal" {...props} />
+  );
+}
+
+function DropdownMenuTrigger({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>) {
+  return (
+    <DropdownMenuPrimitive.Trigger
+      data-slot="dropdown-menu-trigger"
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuContent({
+  className,
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Content>) {
+  return (
+    <DropdownMenuPrimitive.Portal>
+      <DropdownMenuPrimitive.Content
+        data-slot="dropdown-menu-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border p-1 shadow-md",
+          className
+        )}
+        {...props}
+      />
+    </DropdownMenuPrimitive.Portal>
+  );
+}
+
+function DropdownMenuGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Group>) {
+  return (
+    <DropdownMenuPrimitive.Group data-slot="dropdown-menu-group" {...props} />
+  );
+}
+
+function DropdownMenuItem({
+  className,
+  inset,
+  variant = "default",
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+  inset?: boolean;
+  variant?: "default" | "destructive";
+}) {
+  return (
+    <DropdownMenuPrimitive.Item
+      data-slot="dropdown-menu-item"
+      data-inset={inset}
+      data-variant={variant}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuCheckboxItem({
+  className,
+  children,
+  checked,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>) {
+  return (
+    <DropdownMenuPrimitive.CheckboxItem
+      data-slot="dropdown-menu-checkbox-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      checked={checked}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.CheckboxItem>
+  );
+}
+
+function DropdownMenuRadioGroup({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>) {
+  return (
+    <DropdownMenuPrimitive.RadioGroup
+      data-slot="dropdown-menu-radio-group"
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuRadioItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>) {
+  return (
+    <DropdownMenuPrimitive.RadioItem
+      data-slot="dropdown-menu-radio-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <DropdownMenuPrimitive.ItemIndicator>
+          <CircleIcon className="size-2 fill-current" />
+        </DropdownMenuPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </DropdownMenuPrimitive.RadioItem>
+  );
+}
+
+function DropdownMenuLabel({
+  className,
+  inset,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+  inset?: boolean;
+}) {
+  return (
+    <DropdownMenuPrimitive.Label
+      data-slot="dropdown-menu-label"
+      data-inset={inset}
+      className={cn(
+        "px-2 py-1.5 text-sm font-medium data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>) {
+  return (
+    <DropdownMenuPrimitive.Separator
+      data-slot="dropdown-menu-separator"
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuShortcut({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="dropdown-menu-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function DropdownMenuSub({
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>) {
+  return <DropdownMenuPrimitive.Sub data-slot="dropdown-menu-sub" {...props} />;
+}
+
+function DropdownMenuSubTrigger({
+  className,
+  inset,
+  children,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+  inset?: boolean;
+}) {
+  return (
+    <DropdownMenuPrimitive.SubTrigger
+      data-slot="dropdown-menu-sub-trigger"
+      data-inset={inset}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronRightIcon className="ml-auto size-4" />
+    </DropdownMenuPrimitive.SubTrigger>
+  );
+}
+
+function DropdownMenuSubContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>) {
+  return (
+    <DropdownMenuPrimitive.SubContent
+      data-slot="dropdown-menu-sub-content"
+      className={cn(
+        "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  DropdownMenu,
+  DropdownMenuPortal,
+  DropdownMenuTrigger,
+  DropdownMenuContent,
+  DropdownMenuGroup,
+  DropdownMenuLabel,
+  DropdownMenuItem,
+  DropdownMenuCheckboxItem,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuSeparator,
+  DropdownMenuShortcut,
+  DropdownMenuSub,
+  DropdownMenuSubTrigger,
+  DropdownMenuSubContent,
+};

Front/client/src/components/ui/empty.tsx

@@ -0,0 +1,104 @@
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+function Empty({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="empty"
+      className={cn(
+        "flex min-w-0 flex-1 flex-col items-center justify-center gap-6 rounded-lg border-dashed p-6 text-center text-balance md:p-12",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function EmptyHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="empty-header"
+      className={cn(
+        "flex max-w-sm flex-col items-center gap-2 text-center",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+const emptyMediaVariants = cva(
+  "flex shrink-0 items-center justify-center mb-2 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        icon: "bg-muted text-foreground flex size-10 shrink-0 items-center justify-center rounded-lg [&_svg:not([class*='size-'])]:size-6",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+function EmptyMedia({
+  className,
+  variant = "default",
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof emptyMediaVariants>) {
+  return (
+    <div
+      data-slot="empty-icon"
+      data-variant={variant}
+      className={cn(emptyMediaVariants({ variant, className }))}
+      {...props}
+    />
+  );
+}
+
+function EmptyTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="empty-title"
+      className={cn("text-lg font-medium tracking-tight", className)}
+      {...props}
+    />
+  );
+}
+
+function EmptyDescription({ className, ...props }: React.ComponentProps<"p">) {
+  return (
+    <div
+      data-slot="empty-description"
+      className={cn(
+        "text-muted-foreground [&>a:hover]:text-primary text-sm/relaxed [&>a]:underline [&>a]:underline-offset-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function EmptyContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="empty-content"
+      className={cn(
+        "flex w-full max-w-sm min-w-0 flex-col items-center gap-4 text-sm text-balance",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  Empty,
+  EmptyHeader,
+  EmptyTitle,
+  EmptyDescription,
+  EmptyContent,
+  EmptyMedia,
+};

Front/client/src/components/ui/field.tsx

@@ -0,0 +1,242 @@
+import { useMemo } from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { Label } from "@/components/ui/label";
+import { Separator } from "@/components/ui/separator";
+
+function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
+  return (
+    <fieldset
+      data-slot="field-set"
+      className={cn(
+        "flex flex-col gap-6",
+        "has-[>[data-slot=checkbox-group]]:gap-3 has-[>[data-slot=radio-group]]:gap-3",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldLegend({
+  className,
+  variant = "legend",
+  ...props
+}: React.ComponentProps<"legend"> & { variant?: "legend" | "label" }) {
+  return (
+    <legend
+      data-slot="field-legend"
+      data-variant={variant}
+      className={cn(
+        "mb-3 font-medium",
+        "data-[variant=legend]:text-base",
+        "data-[variant=label]:text-sm",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="field-group"
+      className={cn(
+        "group/field-group @container/field-group flex w-full flex-col gap-7 data-[slot=checkbox-group]:gap-3 [&>[data-slot=field-group]]:gap-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+const fieldVariants = cva(
+  "group/field flex w-full gap-3 data-[invalid=true]:text-destructive",
+  {
+    variants: {
+      orientation: {
+        vertical: ["flex-col [&>*]:w-full [&>.sr-only]:w-auto"],
+        horizontal: [
+          "flex-row items-center",
+          "[&>[data-slot=field-label]]:flex-auto",
+          "has-[>[data-slot=field-content]]:items-start has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
+        ],
+        responsive: [
+          "flex-col [&>*]:w-full [&>.sr-only]:w-auto @md/field-group:flex-row @md/field-group:items-center @md/field-group:[&>*]:w-auto",
+          "@md/field-group:[&>[data-slot=field-label]]:flex-auto",
+          "@md/field-group:has-[>[data-slot=field-content]]:items-start @md/field-group:has-[>[data-slot=field-content]]:[&>[role=checkbox],[role=radio]]:mt-px",
+        ],
+      },
+    },
+    defaultVariants: {
+      orientation: "vertical",
+    },
+  }
+);
+
+function Field({
+  className,
+  orientation = "vertical",
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof fieldVariants>) {
+  return (
+    <div
+      role="group"
+      data-slot="field"
+      data-orientation={orientation}
+      className={cn(fieldVariants({ orientation }), className)}
+      {...props}
+    />
+  );
+}
+
+function FieldContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="field-content"
+      className={cn(
+        "group/field-content flex flex-1 flex-col gap-1.5 leading-snug",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof Label>) {
+  return (
+    <Label
+      data-slot="field-label"
+      className={cn(
+        "group/field-label peer/field-label flex w-fit gap-2 leading-snug group-data-[disabled=true]/field:opacity-50",
+        "has-[>[data-slot=field]]:w-full has-[>[data-slot=field]]:flex-col has-[>[data-slot=field]]:rounded-md has-[>[data-slot=field]]:border [&>*]:data-[slot=field]:p-4",
+        "has-data-[state=checked]:bg-primary/5 has-data-[state=checked]:border-primary dark:has-data-[state=checked]:bg-primary/10",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="field-label"
+      className={cn(
+        "flex w-fit items-center gap-2 text-sm leading-snug font-medium group-data-[disabled=true]/field:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldDescription({ className, ...props }: React.ComponentProps<"p">) {
+  return (
+    <p
+      data-slot="field-description"
+      className={cn(
+        "text-muted-foreground text-sm leading-normal font-normal group-has-[[data-orientation=horizontal]]/field:text-balance",
+        "last:mt-0 nth-last-2:-mt-1 [[data-variant=legend]+&]:-mt-1.5",
+        "[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function FieldSeparator({
+  children,
+  className,
+  ...props
+}: React.ComponentProps<"div"> & {
+  children?: React.ReactNode;
+}) {
+  return (
+    <div
+      data-slot="field-separator"
+      data-content={!!children}
+      className={cn(
+        "relative -my-2 h-5 text-sm group-data-[variant=outline]/field-group:-mb-2",
+        className
+      )}
+      {...props}
+    >
+      <Separator className="absolute inset-0 top-1/2" />
+      {children && (
+        <span
+          className="bg-background text-muted-foreground relative mx-auto block w-fit px-2"
+          data-slot="field-separator-content"
+        >
+          {children}
+        </span>
+      )}
+    </div>
+  );
+}
+
+function FieldError({
+  className,
+  children,
+  errors,
+  ...props
+}: React.ComponentProps<"div"> & {
+  errors?: Array<{ message?: string } | undefined>;
+}) {
+  const content = useMemo(() => {
+    if (children) {
+      return children;
+    }
+
+    if (!errors) {
+      return null;
+    }
+
+    if (errors?.length === 1 && errors[0]?.message) {
+      return errors[0].message;
+    }
+
+    return (
+      <ul className="ml-4 flex list-disc flex-col gap-1">
+        {errors.map(
+          (error, index) =>
+            error?.message && <li key={index}>{error.message}</li>
+        )}
+      </ul>
+    );
+  }, [children, errors]);
+
+  if (!content) {
+    return null;
+  }
+
+  return (
+    <div
+      role="alert"
+      data-slot="field-error"
+      className={cn("text-destructive text-sm font-normal", className)}
+      {...props}
+    >
+      {content}
+    </div>
+  );
+}
+
+export {
+  Field,
+  FieldLabel,
+  FieldDescription,
+  FieldError,
+  FieldGroup,
+  FieldLegend,
+  FieldSeparator,
+  FieldSet,
+  FieldContent,
+  FieldTitle,
+};

Front/client/src/components/ui/form.tsx

@@ -0,0 +1,168 @@
+"use client";
+
+import * as React from "react";
+import * as LabelPrimitive from "@radix-ui/react-label";
+import { Slot } from "@radix-ui/react-slot";
+import {
+  Controller,
+  FormProvider,
+  useFormContext,
+  useFormState,
+  type ControllerProps,
+  type FieldPath,
+  type FieldValues,
+} from "react-hook-form";
+
+import { cn } from "@/lib/utils";
+import { Label } from "@/components/ui/label";
+
+const Form = FormProvider;
+
+type FormFieldContextValue<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+> = {
+  name: TName;
+};
+
+const FormFieldContext = React.createContext<FormFieldContextValue>(
+  {} as FormFieldContextValue
+);
+
+const FormField = <
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,
+>({
+  ...props
+}: ControllerProps<TFieldValues, TName>) => {
+  return (
+    <FormFieldContext.Provider value={{ name: props.name }}>
+      <Controller {...props} />
+    </FormFieldContext.Provider>
+  );
+};
+
+const useFormField = () => {
+  const fieldContext = React.useContext(FormFieldContext);
+  const itemContext = React.useContext(FormItemContext);
+  const { getFieldState } = useFormContext();
+  const formState = useFormState({ name: fieldContext.name });
+  const fieldState = getFieldState(fieldContext.name, formState);
+
+  if (!fieldContext) {
+    throw new Error("useFormField should be used within <FormField>");
+  }
+
+  const { id } = itemContext;
+
+  return {
+    id,
+    name: fieldContext.name,
+    formItemId: `${id}-form-item`,
+    formDescriptionId: `${id}-form-item-description`,
+    formMessageId: `${id}-form-item-message`,
+    ...fieldState,
+  };
+};
+
+type FormItemContextValue = {
+  id: string;
+};
+
+const FormItemContext = React.createContext<FormItemContextValue>(
+  {} as FormItemContextValue
+);
+
+function FormItem({ className, ...props }: React.ComponentProps<"div">) {
+  const id = React.useId();
+
+  return (
+    <FormItemContext.Provider value={{ id }}>
+      <div
+        data-slot="form-item"
+        className={cn("grid gap-2", className)}
+        {...props}
+      />
+    </FormItemContext.Provider>
+  );
+}
+
+function FormLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  const { error, formItemId } = useFormField();
+
+  return (
+    <Label
+      data-slot="form-label"
+      data-error={!!error}
+      className={cn("data-[error=true]:text-destructive", className)}
+      htmlFor={formItemId}
+      {...props}
+    />
+  );
+}
+
+function FormControl({ ...props }: React.ComponentProps<typeof Slot>) {
+  const { error, formItemId, formDescriptionId, formMessageId } =
+    useFormField();
+
+  return (
+    <Slot
+      data-slot="form-control"
+      id={formItemId}
+      aria-describedby={
+        !error
+          ? `${formDescriptionId}`
+          : `${formDescriptionId} ${formMessageId}`
+      }
+      aria-invalid={!!error}
+      {...props}
+    />
+  );
+}
+
+function FormDescription({ className, ...props }: React.ComponentProps<"p">) {
+  const { formDescriptionId } = useFormField();
+
+  return (
+    <p
+      data-slot="form-description"
+      id={formDescriptionId}
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+function FormMessage({ className, ...props }: React.ComponentProps<"p">) {
+  const { error, formMessageId } = useFormField();
+  const body = error ? String(error?.message ?? "") : props.children;
+
+  if (!body) {
+    return null;
+  }
+
+  return (
+    <p
+      data-slot="form-message"
+      id={formMessageId}
+      className={cn("text-destructive text-sm", className)}
+      {...props}
+    >
+      {body}
+    </p>
+  );
+}
+
+export {
+  useFormField,
+  Form,
+  FormItem,
+  FormLabel,
+  FormControl,
+  FormDescription,
+  FormMessage,
+  FormField,
+};

Front/client/src/components/ui/hover-card.tsx

@@ -0,0 +1,42 @@
+import * as React from "react";
+import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
+
+import { cn } from "@/lib/utils";
+
+function HoverCard({
+  ...props
+}: React.ComponentProps<typeof HoverCardPrimitive.Root>) {
+  return <HoverCardPrimitive.Root data-slot="hover-card" {...props} />;
+}
+
+function HoverCardTrigger({
+  ...props
+}: React.ComponentProps<typeof HoverCardPrimitive.Trigger>) {
+  return (
+    <HoverCardPrimitive.Trigger data-slot="hover-card-trigger" {...props} />
+  );
+}
+
+function HoverCardContent({
+  className,
+  align = "center",
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof HoverCardPrimitive.Content>) {
+  return (
+    <HoverCardPrimitive.Portal data-slot="hover-card-portal">
+      <HoverCardPrimitive.Content
+        data-slot="hover-card-content"
+        align={align}
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-64 origin-(--radix-hover-card-content-transform-origin) rounded-md border p-4 shadow-md outline-hidden",
+          className
+        )}
+        {...props}
+      />
+    </HoverCardPrimitive.Portal>
+  );
+}
+
+export { HoverCard, HoverCardTrigger, HoverCardContent };

Front/client/src/components/ui/input-group.tsx

@@ -0,0 +1,168 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea";
+
+function InputGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="input-group"
+      role="group"
+      className={cn(
+        "group/input-group border-input dark:bg-input/30 relative flex w-full items-center rounded-md border shadow-xs transition-[color,box-shadow] outline-none",
+        "h-9 min-w-0 has-[>textarea]:h-auto",
+
+        // Variants based on alignment.
+        "has-[>[data-align=inline-start]]:[&>input]:pl-2",
+        "has-[>[data-align=inline-end]]:[&>input]:pr-2",
+        "has-[>[data-align=block-start]]:h-auto has-[>[data-align=block-start]]:flex-col has-[>[data-align=block-start]]:[&>input]:pb-3",
+        "has-[>[data-align=block-end]]:h-auto has-[>[data-align=block-end]]:flex-col has-[>[data-align=block-end]]:[&>input]:pt-3",
+
+        // Focus state.
+        "has-[[data-slot=input-group-control]:focus-visible]:border-ring has-[[data-slot=input-group-control]:focus-visible]:ring-ring/50 has-[[data-slot=input-group-control]:focus-visible]:ring-[3px]",
+
+        // Error state.
+        "has-[[data-slot][aria-invalid=true]]:ring-destructive/20 has-[[data-slot][aria-invalid=true]]:border-destructive dark:has-[[data-slot][aria-invalid=true]]:ring-destructive/40",
+
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+const inputGroupAddonVariants = cva(
+  "text-muted-foreground flex h-auto cursor-text items-center justify-center gap-2 py-1.5 text-sm font-medium select-none [&>svg:not([class*='size-'])]:size-4 [&>kbd]:rounded-[calc(var(--radius)-5px)] group-data-[disabled=true]/input-group:opacity-50",
+  {
+    variants: {
+      align: {
+        "inline-start":
+          "order-first pl-3 has-[>button]:ml-[-0.45rem] has-[>kbd]:ml-[-0.35rem]",
+        "inline-end":
+          "order-last pr-3 has-[>button]:mr-[-0.45rem] has-[>kbd]:mr-[-0.35rem]",
+        "block-start":
+          "order-first w-full justify-start px-3 pt-3 [.border-b]:pb-3 group-has-[>input]/input-group:pt-2.5",
+        "block-end":
+          "order-last w-full justify-start px-3 pb-3 [.border-t]:pt-3 group-has-[>input]/input-group:pb-2.5",
+      },
+    },
+    defaultVariants: {
+      align: "inline-start",
+    },
+  }
+);
+
+function InputGroupAddon({
+  className,
+  align = "inline-start",
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>) {
+  return (
+    <div
+      role="group"
+      data-slot="input-group-addon"
+      data-align={align}
+      className={cn(inputGroupAddonVariants({ align }), className)}
+      onClick={e => {
+        if ((e.target as HTMLElement).closest("button")) {
+          return;
+        }
+        e.currentTarget.parentElement?.querySelector("input")?.focus();
+      }}
+      {...props}
+    />
+  );
+}
+
+const inputGroupButtonVariants = cva(
+  "text-sm shadow-none flex gap-2 items-center",
+  {
+    variants: {
+      size: {
+        xs: "h-6 gap-1 px-2 rounded-[calc(var(--radius)-5px)] [&>svg:not([class*='size-'])]:size-3.5 has-[>svg]:px-2",
+        sm: "h-8 px-2.5 gap-1.5 rounded-md has-[>svg]:px-2.5",
+        "icon-xs":
+          "size-6 rounded-[calc(var(--radius)-5px)] p-0 has-[>svg]:p-0",
+        "icon-sm": "size-8 p-0 has-[>svg]:p-0",
+      },
+    },
+    defaultVariants: {
+      size: "xs",
+    },
+  }
+);
+
+function InputGroupButton({
+  className,
+  type = "button",
+  variant = "ghost",
+  size = "xs",
+  ...props
+}: Omit<React.ComponentProps<typeof Button>, "size"> &
+  VariantProps<typeof inputGroupButtonVariants>) {
+  return (
+    <Button
+      type={type}
+      data-size={size}
+      variant={variant}
+      className={cn(inputGroupButtonVariants({ size }), className)}
+      {...props}
+    />
+  );
+}
+
+function InputGroupText({ className, ...props }: React.ComponentProps<"span">) {
+  return (
+    <span
+      className={cn(
+        "text-muted-foreground flex items-center gap-2 text-sm [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function InputGroupInput({
+  className,
+  ...props
+}: React.ComponentProps<"input">) {
+  return (
+    <Input
+      data-slot="input-group-control"
+      className={cn(
+        "flex-1 rounded-none border-0 bg-transparent shadow-none focus-visible:ring-0 dark:bg-transparent",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function InputGroupTextarea({
+  className,
+  ...props
+}: React.ComponentProps<"textarea">) {
+  return (
+    <Textarea
+      data-slot="input-group-control"
+      className={cn(
+        "flex-1 resize-none rounded-none border-0 bg-transparent py-3 shadow-none focus-visible:ring-0 dark:bg-transparent",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  InputGroup,
+  InputGroupAddon,
+  InputGroupButton,
+  InputGroupText,
+  InputGroupInput,
+  InputGroupTextarea,
+};

Front/client/src/components/ui/input-otp.tsx

@@ -0,0 +1,75 @@
+import * as React from "react";
+import { OTPInput, OTPInputContext } from "input-otp";
+import { MinusIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function InputOTP({
+  className,
+  containerClassName,
+  ...props
+}: React.ComponentProps<typeof OTPInput> & {
+  containerClassName?: string;
+}) {
+  return (
+    <OTPInput
+      data-slot="input-otp"
+      containerClassName={cn(
+        "flex items-center gap-2 has-disabled:opacity-50",
+        containerClassName
+      )}
+      className={cn("disabled:cursor-not-allowed", className)}
+      {...props}
+    />
+  );
+}
+
+function InputOTPGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="input-otp-group"
+      className={cn("flex items-center", className)}
+      {...props}
+    />
+  );
+}
+
+function InputOTPSlot({
+  index,
+  className,
+  ...props
+}: React.ComponentProps<"div"> & {
+  index: number;
+}) {
+  const inputOTPContext = React.useContext(OTPInputContext);
+  const { char, hasFakeCaret, isActive } = inputOTPContext?.slots[index] ?? {};
+
+  return (
+    <div
+      data-slot="input-otp-slot"
+      data-active={isActive}
+      className={cn(
+        "data-[active=true]:border-ring data-[active=true]:ring-ring/50 data-[active=true]:aria-invalid:ring-destructive/20 dark:data-[active=true]:aria-invalid:ring-destructive/40 aria-invalid:border-destructive data-[active=true]:aria-invalid:border-destructive dark:bg-input/30 border-input relative flex h-9 w-9 items-center justify-center border-y border-r text-sm shadow-xs transition-all outline-none first:rounded-l-md first:border-l last:rounded-r-md data-[active=true]:z-10 data-[active=true]:ring-[3px]",
+        className
+      )}
+      {...props}
+    >
+      {char}
+      {hasFakeCaret && (
+        <div className="pointer-events-none absolute inset-0 flex items-center justify-center">
+          <div className="animate-caret-blink bg-foreground h-4 w-px duration-1000" />
+        </div>
+      )}
+    </div>
+  );
+}
+
+function InputOTPSeparator({ ...props }: React.ComponentProps<"div">) {
+  return (
+    <div data-slot="input-otp-separator" role="separator" {...props}>
+      <MinusIcon />
+    </div>
+  );
+}
+
+export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator };

Front/client/src/components/ui/input.tsx

@@ -0,0 +1,70 @@
+import { useDialogComposition } from "@/components/ui/dialog";
+import { useComposition } from "@/hooks/useComposition";
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+function Input({
+  className,
+  type,
+  onKeyDown,
+  onCompositionStart,
+  onCompositionEnd,
+  ...props
+}: React.ComponentProps<"input">) {
+  // Get dialog composition context if available (will be no-op if not inside Dialog)
+  const dialogComposition = useDialogComposition();
+
+  // Add composition event handlers to support input method editor (IME) for CJK languages.
+  const {
+    onCompositionStart: handleCompositionStart,
+    onCompositionEnd: handleCompositionEnd,
+    onKeyDown: handleKeyDown,
+  } = useComposition<HTMLInputElement>({
+    onKeyDown: (e) => {
+      // Check if this is an Enter key that should be blocked
+      const isComposing = (e.nativeEvent as any).isComposing || dialogComposition.justEndedComposing();
+
+      // If Enter key is pressed while composing or just after composition ended,
+      // don't call the user's onKeyDown (this blocks the business logic)
+      if (e.key === "Enter" && isComposing) {
+        return;
+      }
+
+      // Otherwise, call the user's onKeyDown
+      onKeyDown?.(e);
+    },
+    onCompositionStart: e => {
+      dialogComposition.setComposing(true);
+      onCompositionStart?.(e);
+    },
+    onCompositionEnd: e => {
+      // Mark that composition just ended - this helps handle the Enter key that confirms input
+      dialogComposition.markCompositionEnd();
+      // Delay setting composing to false to handle Safari's event order
+      // In Safari, compositionEnd fires before the ESC keydown event
+      setTimeout(() => {
+        dialogComposition.setComposing(false);
+      }, 100);
+      onCompositionEnd?.(e);
+    },
+  });
+
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      onCompositionStart={handleCompositionStart}
+      onCompositionEnd={handleCompositionEnd}
+      onKeyDown={handleKeyDown}
+      {...props}
+    />
+  );
+}
+
+export { Input };

Front/client/src/components/ui/item.tsx

@@ -0,0 +1,193 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { Separator } from "@/components/ui/separator";
+
+function ItemGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      role="list"
+      data-slot="item-group"
+      className={cn("group/item-group flex flex-col", className)}
+      {...props}
+    />
+  );
+}
+
+function ItemSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof Separator>) {
+  return (
+    <Separator
+      data-slot="item-separator"
+      orientation="horizontal"
+      className={cn("my-0", className)}
+      {...props}
+    />
+  );
+}
+
+const itemVariants = cva(
+  "group/item flex items-center border border-transparent text-sm rounded-md transition-colors [a]:hover:bg-accent/50 [a]:transition-colors duration-100 flex-wrap outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        outline: "border-border",
+        muted: "bg-muted/50",
+      },
+      size: {
+        default: "p-4 gap-4 ",
+        sm: "py-3 px-4 gap-2.5",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+function Item({
+  className,
+  variant = "default",
+  size = "default",
+  asChild = false,
+  ...props
+}: React.ComponentProps<"div"> &
+  VariantProps<typeof itemVariants> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot : "div";
+  return (
+    <Comp
+      data-slot="item"
+      data-variant={variant}
+      data-size={size}
+      className={cn(itemVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+const itemMediaVariants = cva(
+  "flex shrink-0 items-center justify-center gap-2 group-has-[[data-slot=item-description]]/item:self-start [&_svg]:pointer-events-none group-has-[[data-slot=item-description]]/item:translate-y-0.5",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        icon: "size-8 border rounded-sm bg-muted [&_svg:not([class*='size-'])]:size-4",
+        image:
+          "size-10 rounded-sm overflow-hidden [&_img]:size-full [&_img]:object-cover",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+);
+
+function ItemMedia({
+  className,
+  variant = "default",
+  ...props
+}: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>) {
+  return (
+    <div
+      data-slot="item-media"
+      data-variant={variant}
+      className={cn(itemMediaVariants({ variant, className }))}
+      {...props}
+    />
+  );
+}
+
+function ItemContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="item-content"
+      className={cn(
+        "flex flex-1 flex-col gap-1 [&+[data-slot=item-content]]:flex-none",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ItemTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="item-title"
+      className={cn(
+        "flex w-fit items-center gap-2 text-sm leading-snug font-medium",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ItemDescription({ className, ...props }: React.ComponentProps<"p">) {
+  return (
+    <p
+      data-slot="item-description"
+      className={cn(
+        "text-muted-foreground line-clamp-2 text-sm leading-normal font-normal text-balance",
+        "[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ItemActions({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="item-actions"
+      className={cn("flex items-center gap-2", className)}
+      {...props}
+    />
+  );
+}
+
+function ItemHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="item-header"
+      className={cn(
+        "flex basis-full items-center justify-between gap-2",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ItemFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="item-footer"
+      className={cn(
+        "flex basis-full items-center justify-between gap-2",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  Item,
+  ItemMedia,
+  ItemContent,
+  ItemActions,
+  ItemGroup,
+  ItemSeparator,
+  ItemTitle,
+  ItemDescription,
+  ItemHeader,
+  ItemFooter,
+};

Front/client/src/components/ui/kbd.tsx

@@ -0,0 +1,28 @@
+import { cn } from "@/lib/utils";
+
+function Kbd({ className, ...props }: React.ComponentProps<"kbd">) {
+  return (
+    <kbd
+      data-slot="kbd"
+      className={cn(
+        "bg-muted text-muted-foreground pointer-events-none inline-flex h-5 w-fit min-w-5 items-center justify-center gap-1 rounded-sm px-1 font-sans text-xs font-medium select-none",
+        "[&_svg:not([class*='size-'])]:size-3",
+        "[[data-slot=tooltip-content]_&]:bg-background/20 [[data-slot=tooltip-content]_&]:text-background dark:[[data-slot=tooltip-content]_&]:bg-background/10",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function KbdGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <kbd
+      data-slot="kbd-group"
+      className={cn("inline-flex items-center gap-1", className)}
+      {...props}
+    />
+  );
+}
+
+export { Kbd, KbdGroup };

Front/client/src/components/ui/label.tsx

@@ -0,0 +1,22 @@
+import * as React from "react";
+import * as LabelPrimitive from "@radix-ui/react-label";
+
+import { cn } from "@/lib/utils";
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Label };

Front/client/src/components/ui/menubar.tsx

@@ -0,0 +1,274 @@
+import * as React from "react";
+import * as MenubarPrimitive from "@radix-ui/react-menubar";
+import { CheckIcon, ChevronRightIcon, CircleIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Menubar({
+  className,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Root>) {
+  return (
+    <MenubarPrimitive.Root
+      data-slot="menubar"
+      className={cn(
+        "bg-background flex h-9 items-center gap-1 rounded-md border p-1 shadow-xs",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function MenubarMenu({
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Menu>) {
+  return <MenubarPrimitive.Menu data-slot="menubar-menu" {...props} />;
+}
+
+function MenubarGroup({
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Group>) {
+  return <MenubarPrimitive.Group data-slot="menubar-group" {...props} />;
+}
+
+function MenubarPortal({
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Portal>) {
+  return <MenubarPrimitive.Portal data-slot="menubar-portal" {...props} />;
+}
+
+function MenubarRadioGroup({
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.RadioGroup>) {
+  return (
+    <MenubarPrimitive.RadioGroup data-slot="menubar-radio-group" {...props} />
+  );
+}
+
+function MenubarTrigger({
+  className,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Trigger>) {
+  return (
+    <MenubarPrimitive.Trigger
+      data-slot="menubar-trigger"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground flex items-center rounded-sm px-2 py-1 text-sm font-medium outline-hidden select-none",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function MenubarContent({
+  className,
+  align = "start",
+  alignOffset = -4,
+  sideOffset = 8,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Content>) {
+  return (
+    <MenubarPortal>
+      <MenubarPrimitive.Content
+        data-slot="menubar-content"
+        align={align}
+        alignOffset={alignOffset}
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[12rem] origin-(--radix-menubar-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-md",
+          className
+        )}
+        {...props}
+      />
+    </MenubarPortal>
+  );
+}
+
+function MenubarItem({
+  className,
+  inset,
+  variant = "default",
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Item> & {
+  inset?: boolean;
+  variant?: "default" | "destructive";
+}) {
+  return (
+    <MenubarPrimitive.Item
+      data-slot="menubar-item"
+      data-inset={inset}
+      data-variant={variant}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 dark:data-[variant=destructive]:focus:bg-destructive/20 data-[variant=destructive]:focus:text-destructive data-[variant=destructive]:*:[svg]:!text-destructive [&_svg:not([class*='text-'])]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 data-[inset]:pl-8 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function MenubarCheckboxItem({
+  className,
+  children,
+  checked,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.CheckboxItem>) {
+  return (
+    <MenubarPrimitive.CheckboxItem
+      data-slot="menubar-checkbox-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-xs py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      checked={checked}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <MenubarPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </MenubarPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </MenubarPrimitive.CheckboxItem>
+  );
+}
+
+function MenubarRadioItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.RadioItem>) {
+  return (
+    <MenubarPrimitive.RadioItem
+      data-slot="menubar-radio-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-xs py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      <span className="pointer-events-none absolute left-2 flex size-3.5 items-center justify-center">
+        <MenubarPrimitive.ItemIndicator>
+          <CircleIcon className="size-2 fill-current" />
+        </MenubarPrimitive.ItemIndicator>
+      </span>
+      {children}
+    </MenubarPrimitive.RadioItem>
+  );
+}
+
+function MenubarLabel({
+  className,
+  inset,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Label> & {
+  inset?: boolean;
+}) {
+  return (
+    <MenubarPrimitive.Label
+      data-slot="menubar-label"
+      data-inset={inset}
+      className={cn(
+        "px-2 py-1.5 text-sm font-medium data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function MenubarSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Separator>) {
+  return (
+    <MenubarPrimitive.Separator
+      data-slot="menubar-separator"
+      className={cn("bg-border -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function MenubarShortcut({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      data-slot="menubar-shortcut"
+      className={cn(
+        "text-muted-foreground ml-auto text-xs tracking-widest",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function MenubarSub({
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.Sub>) {
+  return <MenubarPrimitive.Sub data-slot="menubar-sub" {...props} />;
+}
+
+function MenubarSubTrigger({
+  className,
+  inset,
+  children,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.SubTrigger> & {
+  inset?: boolean;
+}) {
+  return (
+    <MenubarPrimitive.SubTrigger
+      data-slot="menubar-sub-trigger"
+      data-inset={inset}
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground flex cursor-default items-center rounded-sm px-2 py-1.5 text-sm outline-none select-none data-[inset]:pl-8",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronRightIcon className="ml-auto h-4 w-4" />
+    </MenubarPrimitive.SubTrigger>
+  );
+}
+
+function MenubarSubContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof MenubarPrimitive.SubContent>) {
+  return (
+    <MenubarPrimitive.SubContent
+      data-slot="menubar-sub-content"
+      className={cn(
+        "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-menubar-content-transform-origin) overflow-hidden rounded-md border p-1 shadow-lg",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  Menubar,
+  MenubarPortal,
+  MenubarMenu,
+  MenubarTrigger,
+  MenubarContent,
+  MenubarGroup,
+  MenubarSeparator,
+  MenubarLabel,
+  MenubarItem,
+  MenubarShortcut,
+  MenubarCheckboxItem,
+  MenubarRadioGroup,
+  MenubarRadioItem,
+  MenubarSub,
+  MenubarSubTrigger,
+  MenubarSubContent,
+};

Front/client/src/components/ui/navigation-menu.tsx

@@ -0,0 +1,168 @@
+import * as React from "react";
+import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu";
+import { cva } from "class-variance-authority";
+import { ChevronDownIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function NavigationMenu({
+  className,
+  children,
+  viewport = true,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
+  viewport?: boolean;
+}) {
+  return (
+    <NavigationMenuPrimitive.Root
+      data-slot="navigation-menu"
+      data-viewport={viewport}
+      className={cn(
+        "group/navigation-menu relative flex max-w-max flex-1 items-center justify-center",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      {viewport && <NavigationMenuViewport />}
+    </NavigationMenuPrimitive.Root>
+  );
+}
+
+function NavigationMenuList({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.List>) {
+  return (
+    <NavigationMenuPrimitive.List
+      data-slot="navigation-menu-list"
+      className={cn(
+        "group flex flex-1 list-none items-center justify-center gap-1",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function NavigationMenuItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Item>) {
+  return (
+    <NavigationMenuPrimitive.Item
+      data-slot="navigation-menu-item"
+      className={cn("relative", className)}
+      {...props}
+    />
+  );
+}
+
+const navigationMenuTriggerStyle = cva(
+  "group inline-flex h-9 w-max items-center justify-center rounded-md bg-background px-4 py-2 text-sm font-medium hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground disabled:pointer-events-none disabled:opacity-50 data-[state=open]:hover:bg-accent data-[state=open]:text-accent-foreground data-[state=open]:focus:bg-accent data-[state=open]:bg-accent/50 focus-visible:ring-ring/50 outline-none transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1"
+);
+
+function NavigationMenuTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Trigger>) {
+  return (
+    <NavigationMenuPrimitive.Trigger
+      data-slot="navigation-menu-trigger"
+      className={cn(navigationMenuTriggerStyle(), "group", className)}
+      {...props}
+    >
+      {children}{" "}
+      <ChevronDownIcon
+        className="relative top-[1px] ml-1 size-3 transition duration-300 group-data-[state=open]:rotate-180"
+        aria-hidden="true"
+      />
+    </NavigationMenuPrimitive.Trigger>
+  );
+}
+
+function NavigationMenuContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Content>) {
+  return (
+    <NavigationMenuPrimitive.Content
+      data-slot="navigation-menu-content"
+      className={cn(
+        "data-[motion^=from-]:animate-in data-[motion^=to-]:animate-out data-[motion^=from-]:fade-in data-[motion^=to-]:fade-out data-[motion=from-end]:slide-in-from-right-52 data-[motion=from-start]:slide-in-from-left-52 data-[motion=to-end]:slide-out-to-right-52 data-[motion=to-start]:slide-out-to-left-52 top-0 left-0 w-full p-2 pr-2.5 md:absolute md:w-auto",
+        "group-data-[viewport=false]/navigation-menu:bg-popover group-data-[viewport=false]/navigation-menu:text-popover-foreground group-data-[viewport=false]/navigation-menu:data-[state=open]:animate-in group-data-[viewport=false]/navigation-menu:data-[state=closed]:animate-out group-data-[viewport=false]/navigation-menu:data-[state=closed]:zoom-out-95 group-data-[viewport=false]/navigation-menu:data-[state=open]:zoom-in-95 group-data-[viewport=false]/navigation-menu:data-[state=open]:fade-in-0 group-data-[viewport=false]/navigation-menu:data-[state=closed]:fade-out-0 group-data-[viewport=false]/navigation-menu:top-full group-data-[viewport=false]/navigation-menu:mt-1.5 group-data-[viewport=false]/navigation-menu:overflow-hidden group-data-[viewport=false]/navigation-menu:rounded-md group-data-[viewport=false]/navigation-menu:border group-data-[viewport=false]/navigation-menu:shadow group-data-[viewport=false]/navigation-menu:duration-200 **:data-[slot=navigation-menu-link]:focus:ring-0 **:data-[slot=navigation-menu-link]:focus:outline-none",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function NavigationMenuViewport({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Viewport>) {
+  return (
+    <div
+      className={cn(
+        "absolute top-full left-0 isolate z-50 flex justify-center"
+      )}
+    >
+      <NavigationMenuPrimitive.Viewport
+        data-slot="navigation-menu-viewport"
+        className={cn(
+          "origin-top-center bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-90 relative mt-1.5 h-[var(--radix-navigation-menu-viewport-height)] w-full overflow-hidden rounded-md border shadow md:w-[var(--radix-navigation-menu-viewport-width)]",
+          className
+        )}
+        {...props}
+      />
+    </div>
+  );
+}
+
+function NavigationMenuLink({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Link>) {
+  return (
+    <NavigationMenuPrimitive.Link
+      data-slot="navigation-menu-link"
+      className={cn(
+        "data-[active=true]:focus:bg-accent data-[active=true]:hover:bg-accent data-[active=true]:bg-accent/50 data-[active=true]:text-accent-foreground hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground focus-visible:ring-ring/50 [&_svg:not([class*='text-'])]:text-muted-foreground flex flex-col gap-1 rounded-sm p-2 text-sm transition-all outline-none focus-visible:ring-[3px] focus-visible:outline-1 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function NavigationMenuIndicator({
+  className,
+  ...props
+}: React.ComponentProps<typeof NavigationMenuPrimitive.Indicator>) {
+  return (
+    <NavigationMenuPrimitive.Indicator
+      data-slot="navigation-menu-indicator"
+      className={cn(
+        "data-[state=visible]:animate-in data-[state=hidden]:animate-out data-[state=hidden]:fade-out data-[state=visible]:fade-in top-full z-[1] flex h-1.5 items-end justify-center overflow-hidden",
+        className
+      )}
+      {...props}
+    >
+      <div className="bg-border relative top-[60%] h-2 w-2 rotate-45 rounded-tl-sm shadow-md" />
+    </NavigationMenuPrimitive.Indicator>
+  );
+}
+
+export {
+  NavigationMenu,
+  NavigationMenuList,
+  NavigationMenuItem,
+  NavigationMenuContent,
+  NavigationMenuTrigger,
+  NavigationMenuLink,
+  NavigationMenuIndicator,
+  NavigationMenuViewport,
+  navigationMenuTriggerStyle,
+};

Front/client/src/components/ui/pagination.tsx

@@ -0,0 +1,127 @@
+import * as React from "react";
+import {
+  ChevronLeftIcon,
+  ChevronRightIcon,
+  MoreHorizontalIcon,
+} from "lucide-react";
+
+import { cn } from "@/lib/utils";
+import { Button, buttonVariants } from "@/components/ui/button";
+
+function Pagination({ className, ...props }: React.ComponentProps<"nav">) {
+  return (
+    <nav
+      role="navigation"
+      aria-label="pagination"
+      data-slot="pagination"
+      className={cn("mx-auto flex w-full justify-center", className)}
+      {...props}
+    />
+  );
+}
+
+function PaginationContent({
+  className,
+  ...props
+}: React.ComponentProps<"ul">) {
+  return (
+    <ul
+      data-slot="pagination-content"
+      className={cn("flex flex-row items-center gap-1", className)}
+      {...props}
+    />
+  );
+}
+
+function PaginationItem({ ...props }: React.ComponentProps<"li">) {
+  return <li data-slot="pagination-item" {...props} />;
+}
+
+type PaginationLinkProps = {
+  isActive?: boolean;
+} & Pick<React.ComponentProps<typeof Button>, "size"> &
+  React.ComponentProps<"a">;
+
+function PaginationLink({
+  className,
+  isActive,
+  size = "icon",
+  ...props
+}: PaginationLinkProps) {
+  return (
+    <a
+      aria-current={isActive ? "page" : undefined}
+      data-slot="pagination-link"
+      data-active={isActive}
+      className={cn(
+        buttonVariants({
+          variant: isActive ? "outline" : "ghost",
+          size,
+        }),
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function PaginationPrevious({
+  className,
+  ...props
+}: React.ComponentProps<typeof PaginationLink>) {
+  return (
+    <PaginationLink
+      aria-label="Go to previous page"
+      size="default"
+      className={cn("gap-1 px-2.5 sm:pl-2.5", className)}
+      {...props}
+    >
+      <ChevronLeftIcon />
+      <span className="hidden sm:block">Previous</span>
+    </PaginationLink>
+  );
+}
+
+function PaginationNext({
+  className,
+  ...props
+}: React.ComponentProps<typeof PaginationLink>) {
+  return (
+    <PaginationLink
+      aria-label="Go to next page"
+      size="default"
+      className={cn("gap-1 px-2.5 sm:pr-2.5", className)}
+      {...props}
+    >
+      <span className="hidden sm:block">Next</span>
+      <ChevronRightIcon />
+    </PaginationLink>
+  );
+}
+
+function PaginationEllipsis({
+  className,
+  ...props
+}: React.ComponentProps<"span">) {
+  return (
+    <span
+      aria-hidden
+      data-slot="pagination-ellipsis"
+      className={cn("flex size-9 items-center justify-center", className)}
+      {...props}
+    >
+      <MoreHorizontalIcon className="size-4" />
+      <span className="sr-only">More pages</span>
+    </span>
+  );
+}
+
+export {
+  Pagination,
+  PaginationContent,
+  PaginationLink,
+  PaginationItem,
+  PaginationPrevious,
+  PaginationNext,
+  PaginationEllipsis,
+};

Front/client/src/components/ui/popover.tsx

@@ -0,0 +1,46 @@
+import * as React from "react";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+
+import { cn } from "@/lib/utils";
+
+function Popover({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Root>) {
+  return <PopoverPrimitive.Root data-slot="popover" {...props} />;
+}
+
+function PopoverTrigger({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
+  return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />;
+}
+
+function PopoverContent({
+  className,
+  align = "center",
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Content>) {
+  return (
+    <PopoverPrimitive.Portal>
+      <PopoverPrimitive.Content
+        data-slot="popover-content"
+        align={align}
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-72 origin-(--radix-popover-content-transform-origin) rounded-md border p-4 shadow-md outline-hidden",
+          className
+        )}
+        {...props}
+      />
+    </PopoverPrimitive.Portal>
+  );
+}
+
+function PopoverAnchor({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
+  return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />;
+}
+
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };

Front/client/src/components/ui/progress.tsx

@@ -0,0 +1,29 @@
+import * as React from "react";
+import * as ProgressPrimitive from "@radix-ui/react-progress";
+
+import { cn } from "@/lib/utils";
+
+function Progress({
+  className,
+  value,
+  ...props
+}: React.ComponentProps<typeof ProgressPrimitive.Root>) {
+  return (
+    <ProgressPrimitive.Root
+      data-slot="progress"
+      className={cn(
+        "bg-primary/20 relative h-2 w-full overflow-hidden rounded-full",
+        className
+      )}
+      {...props}
+    >
+      <ProgressPrimitive.Indicator
+        data-slot="progress-indicator"
+        className="bg-primary h-full w-full flex-1 transition-all"
+        style={{ transform: `translateX(-${100 - (value || 0)}%)` }}
+      />
+    </ProgressPrimitive.Root>
+  );
+}
+
+export { Progress };

Front/client/src/components/ui/radio-group.tsx

@@ -0,0 +1,43 @@
+import * as React from "react";
+import * as RadioGroupPrimitive from "@radix-ui/react-radio-group";
+import { CircleIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function RadioGroup({
+  className,
+  ...props
+}: React.ComponentProps<typeof RadioGroupPrimitive.Root>) {
+  return (
+    <RadioGroupPrimitive.Root
+      data-slot="radio-group"
+      className={cn("grid gap-3", className)}
+      {...props}
+    />
+  );
+}
+
+function RadioGroupItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof RadioGroupPrimitive.Item>) {
+  return (
+    <RadioGroupPrimitive.Item
+      data-slot="radio-group-item"
+      className={cn(
+        "border-input text-primary focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:bg-input/30 aspect-square size-4 shrink-0 rounded-full border shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <RadioGroupPrimitive.Indicator
+        data-slot="radio-group-indicator"
+        className="relative flex items-center justify-center"
+      >
+        <CircleIcon className="fill-primary absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2" />
+      </RadioGroupPrimitive.Indicator>
+    </RadioGroupPrimitive.Item>
+  );
+}
+
+export { RadioGroup, RadioGroupItem };

Front/client/src/components/ui/resizable.tsx

@@ -0,0 +1,54 @@
+import * as React from "react";
+import { GripVerticalIcon } from "lucide-react";
+import * as ResizablePrimitive from "react-resizable-panels";
+
+import { cn } from "@/lib/utils";
+
+function ResizablePanelGroup({
+  className,
+  ...props
+}: React.ComponentProps<typeof ResizablePrimitive.PanelGroup>) {
+  return (
+    <ResizablePrimitive.PanelGroup
+      data-slot="resizable-panel-group"
+      className={cn(
+        "flex h-full w-full data-[panel-group-direction=vertical]:flex-col",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function ResizablePanel({
+  ...props
+}: React.ComponentProps<typeof ResizablePrimitive.Panel>) {
+  return <ResizablePrimitive.Panel data-slot="resizable-panel" {...props} />;
+}
+
+function ResizableHandle({
+  withHandle,
+  className,
+  ...props
+}: React.ComponentProps<typeof ResizablePrimitive.PanelResizeHandle> & {
+  withHandle?: boolean;
+}) {
+  return (
+    <ResizablePrimitive.PanelResizeHandle
+      data-slot="resizable-handle"
+      className={cn(
+        "bg-border focus-visible:ring-ring relative flex w-px items-center justify-center after:absolute after:inset-y-0 after:left-1/2 after:w-1 after:-translate-x-1/2 focus-visible:ring-1 focus-visible:ring-offset-1 focus-visible:outline-hidden data-[panel-group-direction=vertical]:h-px data-[panel-group-direction=vertical]:w-full data-[panel-group-direction=vertical]:after:left-0 data-[panel-group-direction=vertical]:after:h-1 data-[panel-group-direction=vertical]:after:w-full data-[panel-group-direction=vertical]:after:translate-x-0 data-[panel-group-direction=vertical]:after:-translate-y-1/2 [&[data-panel-group-direction=vertical]>div]:rotate-90",
+        className
+      )}
+      {...props}
+    >
+      {withHandle && (
+        <div className="bg-border z-10 flex h-4 w-3 items-center justify-center rounded-xs border">
+          <GripVerticalIcon className="size-2.5" />
+        </div>
+      )}
+    </ResizablePrimitive.PanelResizeHandle>
+  );
+}
+
+export { ResizablePanelGroup, ResizablePanel, ResizableHandle };

Front/client/src/components/ui/scroll-area.tsx

@@ -0,0 +1,56 @@
+import * as React from "react";
+import * as ScrollAreaPrimitive from "@radix-ui/react-scroll-area";
+
+import { cn } from "@/lib/utils";
+
+function ScrollArea({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof ScrollAreaPrimitive.Root>) {
+  return (
+    <ScrollAreaPrimitive.Root
+      data-slot="scroll-area"
+      className={cn("relative", className)}
+      {...props}
+    >
+      <ScrollAreaPrimitive.Viewport
+        data-slot="scroll-area-viewport"
+        className="focus-visible:ring-ring/50 size-full rounded-[inherit] transition-[color,box-shadow] outline-none focus-visible:ring-[3px] focus-visible:outline-1"
+      >
+        {children}
+      </ScrollAreaPrimitive.Viewport>
+      <ScrollBar />
+      <ScrollAreaPrimitive.Corner />
+    </ScrollAreaPrimitive.Root>
+  );
+}
+
+function ScrollBar({
+  className,
+  orientation = "vertical",
+  ...props
+}: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>) {
+  return (
+    <ScrollAreaPrimitive.ScrollAreaScrollbar
+      data-slot="scroll-area-scrollbar"
+      orientation={orientation}
+      className={cn(
+        "flex touch-none p-px transition-colors select-none",
+        orientation === "vertical" &&
+          "h-full w-2.5 border-l border-l-transparent",
+        orientation === "horizontal" &&
+          "h-2.5 flex-col border-t border-t-transparent",
+        className
+      )}
+      {...props}
+    >
+      <ScrollAreaPrimitive.ScrollAreaThumb
+        data-slot="scroll-area-thumb"
+        className="bg-border relative flex-1 rounded-full"
+      />
+    </ScrollAreaPrimitive.ScrollAreaScrollbar>
+  );
+}
+
+export { ScrollArea, ScrollBar };

Front/client/src/components/ui/select.tsx

@@ -0,0 +1,185 @@
+import * as React from "react";
+import * as SelectPrimitive from "@radix-ui/react-select";
+import { CheckIcon, ChevronDownIcon, ChevronUpIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Select({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Root>) {
+  return <SelectPrimitive.Root data-slot="select" {...props} />;
+}
+
+function SelectGroup({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Group>) {
+  return <SelectPrimitive.Group data-slot="select-group" {...props} />;
+}
+
+function SelectValue({
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Value>) {
+  return <SelectPrimitive.Value data-slot="select-value" {...props} />;
+}
+
+function SelectTrigger({
+  className,
+  size = "default",
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Trigger> & {
+  size?: "sm" | "default";
+}) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      data-size={size}
+      className={cn(
+        "border-input data-[placeholder]:text-muted-foreground [&_svg:not([class*='text-'])]:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:bg-input/30 dark:hover:bg-input/50 flex w-fit items-center justify-between gap-2 rounded-md border bg-transparent px-3 py-2 text-sm whitespace-nowrap shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 data-[size=default]:h-9 data-[size=sm]:h-8 *:data-[slot=select-value]:line-clamp-1 *:data-[slot=select-value]:flex *:data-[slot=select-value]:items-center *:data-[slot=select-value]:gap-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon asChild>
+        <ChevronDownIcon className="size-4 opacity-50" />
+      </SelectPrimitive.Icon>
+    </SelectPrimitive.Trigger>
+  );
+}
+
+function SelectContent({
+  className,
+  children,
+  position = "popper",
+  align = "center",
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Content>) {
+  return (
+    <SelectPrimitive.Portal>
+      <SelectPrimitive.Content
+        data-slot="select-content"
+        className={cn(
+          "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-50 max-h-(--radix-select-content-available-height) min-w-[8rem] origin-(--radix-select-content-transform-origin) overflow-x-hidden overflow-y-auto rounded-md border shadow-md",
+          position === "popper" &&
+            "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
+          className
+        )}
+        position={position}
+        align={align}
+        {...props}
+      >
+        <SelectScrollUpButton />
+        <SelectPrimitive.Viewport
+          className={cn(
+            "p-1",
+            position === "popper" &&
+              "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)] scroll-my-1"
+          )}
+        >
+          {children}
+        </SelectPrimitive.Viewport>
+        <SelectScrollDownButton />
+      </SelectPrimitive.Content>
+    </SelectPrimitive.Portal>
+  );
+}
+
+function SelectLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Label>) {
+  return (
+    <SelectPrimitive.Label
+      data-slot="select-label"
+      className={cn("text-muted-foreground px-2 py-1.5 text-xs", className)}
+      {...props}
+    />
+  );
+}
+
+function SelectItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Item>) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "focus:bg-accent focus:text-accent-foreground [&_svg:not([class*='text-'])]:text-muted-foreground relative flex w-full cursor-default items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-hidden select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 *:[span]:last:flex *:[span]:last:items-center *:[span]:last:gap-2",
+        className
+      )}
+      {...props}
+    >
+      <span className="absolute right-2 flex size-3.5 items-center justify-center">
+        <SelectPrimitive.ItemIndicator>
+          <CheckIcon className="size-4" />
+        </SelectPrimitive.ItemIndicator>
+      </span>
+      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
+    </SelectPrimitive.Item>
+  );
+}
+
+function SelectSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Separator>) {
+  return (
+    <SelectPrimitive.Separator
+      data-slot="select-separator"
+      className={cn("bg-border pointer-events-none -mx-1 my-1 h-px", className)}
+      {...props}
+    />
+  );
+}
+
+function SelectScrollUpButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>) {
+  return (
+    <SelectPrimitive.ScrollUpButton
+      data-slot="select-scroll-up-button"
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronUpIcon className="size-4" />
+    </SelectPrimitive.ScrollUpButton>
+  );
+}
+
+function SelectScrollDownButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>) {
+  return (
+    <SelectPrimitive.ScrollDownButton
+      data-slot="select-scroll-down-button"
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronDownIcon className="size-4" />
+    </SelectPrimitive.ScrollDownButton>
+  );
+}
+
+export {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectScrollDownButton,
+  SelectScrollUpButton,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+};

Front/client/src/components/ui/separator.tsx

@@ -0,0 +1,26 @@
+import * as React from "react";
+import * as SeparatorPrimitive from "@radix-ui/react-separator";
+
+import { cn } from "@/lib/utils";
+
+function Separator({
+  className,
+  orientation = "horizontal",
+  decorative = true,
+  ...props
+}: React.ComponentProps<typeof SeparatorPrimitive.Root>) {
+  return (
+    <SeparatorPrimitive.Root
+      data-slot="separator"
+      decorative={decorative}
+      orientation={orientation}
+      className={cn(
+        "bg-border shrink-0 data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-px",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export { Separator };

Front/client/src/components/ui/sheet.tsx

@@ -0,0 +1,139 @@
+"use client";
+
+import * as React from "react";
+import * as SheetPrimitive from "@radix-ui/react-dialog";
+import { XIcon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Sheet({ ...props }: React.ComponentProps<typeof SheetPrimitive.Root>) {
+  return <SheetPrimitive.Root data-slot="sheet" {...props} />;
+}
+
+function SheetTrigger({
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Trigger>) {
+  return <SheetPrimitive.Trigger data-slot="sheet-trigger" {...props} />;
+}
+
+function SheetClose({
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Close>) {
+  return <SheetPrimitive.Close data-slot="sheet-close" {...props} />;
+}
+
+function SheetPortal({
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Portal>) {
+  return <SheetPrimitive.Portal data-slot="sheet-portal" {...props} />;
+}
+
+function SheetOverlay({
+  className,
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Overlay>) {
+  return (
+    <SheetPrimitive.Overlay
+      data-slot="sheet-overlay"
+      className={cn(
+        "data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 fixed inset-0 z-50 bg-black/50",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SheetContent({
+  className,
+  children,
+  side = "right",
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Content> & {
+  side?: "top" | "right" | "bottom" | "left";
+}) {
+  return (
+    <SheetPortal>
+      <SheetOverlay />
+      <SheetPrimitive.Content
+        data-slot="sheet-content"
+        className={cn(
+          "bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-50 flex flex-col gap-4 shadow-lg transition ease-in-out data-[state=closed]:duration-300 data-[state=open]:duration-500",
+          side === "right" &&
+            "data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right inset-y-0 right-0 h-full w-3/4 border-l sm:max-w-sm",
+          side === "left" &&
+            "data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left inset-y-0 left-0 h-full w-3/4 border-r sm:max-w-sm",
+          side === "top" &&
+            "data-[state=closed]:slide-out-to-top data-[state=open]:slide-in-from-top inset-x-0 top-0 h-auto border-b",
+          side === "bottom" &&
+            "data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom inset-x-0 bottom-0 h-auto border-t",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <SheetPrimitive.Close className="ring-offset-background focus:ring-ring data-[state=open]:bg-secondary absolute top-4 right-4 rounded-xs opacity-70 transition-opacity hover:opacity-100 focus:ring-2 focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none">
+          <XIcon className="size-4" />
+          <span className="sr-only">Close</span>
+        </SheetPrimitive.Close>
+      </SheetPrimitive.Content>
+    </SheetPortal>
+  );
+}
+
+function SheetHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sheet-header"
+      className={cn("flex flex-col gap-1.5 p-4", className)}
+      {...props}
+    />
+  );
+}
+
+function SheetFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sheet-footer"
+      className={cn("mt-auto flex flex-col gap-2 p-4", className)}
+      {...props}
+    />
+  );
+}
+
+function SheetTitle({
+  className,
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Title>) {
+  return (
+    <SheetPrimitive.Title
+      data-slot="sheet-title"
+      className={cn("text-foreground font-semibold", className)}
+      {...props}
+    />
+  );
+}
+
+function SheetDescription({
+  className,
+  ...props
+}: React.ComponentProps<typeof SheetPrimitive.Description>) {
+  return (
+    <SheetPrimitive.Description
+      data-slot="sheet-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Sheet,
+  SheetTrigger,
+  SheetClose,
+  SheetContent,
+  SheetHeader,
+  SheetFooter,
+  SheetTitle,
+  SheetDescription,
+};

Front/client/src/components/ui/sidebar.tsx

@@ -0,0 +1,734 @@
+"use client";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Separator } from "@/components/ui/separator";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+} from "@/components/ui/sheet";
+import { Skeleton } from "@/components/ui/skeleton";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+import { useIsMobile } from "@/hooks/useMobile";
+import { cn } from "@/lib/utils";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, VariantProps } from "class-variance-authority";
+import { PanelLeftIcon } from "lucide-react";
+import * as React from "react";
+
+const SIDEBAR_COOKIE_NAME = "sidebar_state";
+const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+const SIDEBAR_WIDTH = "16rem";
+const SIDEBAR_WIDTH_MOBILE = "18rem";
+const SIDEBAR_WIDTH_ICON = "3rem";
+const SIDEBAR_KEYBOARD_SHORTCUT = "b";
+
+type SidebarContextProps = {
+  state: "expanded" | "collapsed";
+  open: boolean;
+  setOpen: (open: boolean) => void;
+  openMobile: boolean;
+  setOpenMobile: (open: boolean) => void;
+  isMobile: boolean;
+  toggleSidebar: () => void;
+};
+
+const SidebarContext = React.createContext<SidebarContextProps | null>(null);
+
+function useSidebar() {
+  const context = React.useContext(SidebarContext);
+  if (!context) {
+    throw new Error("useSidebar must be used within a SidebarProvider.");
+  }
+
+  return context;
+}
+
+function SidebarProvider({
+  defaultOpen = true,
+  open: openProp,
+  onOpenChange: setOpenProp,
+  className,
+  style,
+  children,
+  ...props
+}: React.ComponentProps<"div"> & {
+  defaultOpen?: boolean;
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+}) {
+  const isMobile = useIsMobile();
+  const [openMobile, setOpenMobile] = React.useState(false);
+
+  // This is the internal state of the sidebar.
+  // We use openProp and setOpenProp for control from outside the component.
+  const [_open, _setOpen] = React.useState(defaultOpen);
+  const open = openProp ?? _open;
+  const setOpen = React.useCallback(
+    (value: boolean | ((value: boolean) => boolean)) => {
+      const openState = typeof value === "function" ? value(open) : value;
+      if (setOpenProp) {
+        setOpenProp(openState);
+      } else {
+        _setOpen(openState);
+      }
+
+      // This sets the cookie to keep the sidebar state.
+      document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
+    },
+    [setOpenProp, open]
+  );
+
+  // Helper to toggle the sidebar.
+  const toggleSidebar = React.useCallback(() => {
+    return isMobile ? setOpenMobile(open => !open) : setOpen(open => !open);
+  }, [isMobile, setOpen, setOpenMobile]);
+
+  // Adds a keyboard shortcut to toggle the sidebar.
+  React.useEffect(() => {
+    const handleKeyDown = (event: KeyboardEvent) => {
+      if (
+        event.key === SIDEBAR_KEYBOARD_SHORTCUT &&
+        (event.metaKey || event.ctrlKey)
+      ) {
+        event.preventDefault();
+        toggleSidebar();
+      }
+    };
+
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [toggleSidebar]);
+
+  // We add a state so that we can do data-state="expanded" or "collapsed".
+  // This makes it easier to style the sidebar with Tailwind classes.
+  const state = open ? "expanded" : "collapsed";
+
+  const contextValue = React.useMemo<SidebarContextProps>(
+    () => ({
+      state,
+      open,
+      setOpen,
+      isMobile,
+      openMobile,
+      setOpenMobile,
+      toggleSidebar,
+    }),
+    [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar]
+  );
+
+  return (
+    <SidebarContext.Provider value={contextValue}>
+      <TooltipProvider delayDuration={0}>
+        <div
+          data-slot="sidebar-wrapper"
+          style={
+            {
+              "--sidebar-width": SIDEBAR_WIDTH,
+              "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,
+              ...style,
+            } as React.CSSProperties
+          }
+          className={cn(
+            "group/sidebar-wrapper has-data-[variant=inset]:bg-sidebar flex min-h-svh w-full",
+            className
+          )}
+          {...props}
+        >
+          {children}
+        </div>
+      </TooltipProvider>
+    </SidebarContext.Provider>
+  );
+}
+
+function Sidebar({
+  side = "left",
+  variant = "sidebar",
+  collapsible = "offcanvas",
+  disableTransition = false,
+  className,
+  children,
+  ...props
+}: React.ComponentProps<"div"> & {
+  side?: "left" | "right";
+  variant?: "sidebar" | "floating" | "inset";
+  collapsible?: "offcanvas" | "icon" | "none";
+  disableTransition?: boolean;
+}) {
+  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();
+
+  if (collapsible === "none") {
+    return (
+      <div
+        data-slot="sidebar"
+        className={cn(
+          "bg-sidebar text-sidebar-foreground flex h-full w-(--sidebar-width) flex-col",
+          className
+        )}
+        {...props}
+      >
+        {children}
+      </div>
+    );
+  }
+
+  if (isMobile) {
+    return (
+      <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>
+        <SheetContent
+          data-sidebar="sidebar"
+          data-slot="sidebar"
+          data-mobile="true"
+          className="bg-sidebar text-sidebar-foreground w-(--sidebar-width) p-0 [&>button]:hidden"
+          style={
+            {
+              "--sidebar-width": SIDEBAR_WIDTH_MOBILE,
+            } as React.CSSProperties
+          }
+          side={side}
+        >
+          <SheetHeader className="sr-only">
+            <SheetTitle>Sidebar</SheetTitle>
+            <SheetDescription>Displays the mobile sidebar.</SheetDescription>
+          </SheetHeader>
+          <div className="flex h-full w-full flex-col">{children}</div>
+        </SheetContent>
+      </Sheet>
+    );
+  }
+
+  return (
+    <div
+      className="group peer text-sidebar-foreground hidden md:block"
+      data-state={state}
+      data-collapsible={state === "collapsed" ? collapsible : ""}
+      data-variant={variant}
+      data-side={side}
+      data-slot="sidebar"
+    >
+      {/* This is what handles the sidebar gap on desktop */}
+      <div
+        data-slot="sidebar-gap"
+        className={cn(
+          "relative w-(--sidebar-width) bg-transparent",
+          disableTransition
+            ? "transition-none"
+            : "transition-[width] duration-200 ease-linear",
+          "group-data-[collapsible=offcanvas]:w-0",
+          "group-data-[side=right]:rotate-180",
+          variant === "floating" || variant === "inset"
+            ? "group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]"
+            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)"
+        )}
+      />
+      <div
+        data-slot="sidebar-container"
+        className={cn(
+          "fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) md:flex",
+          disableTransition
+            ? "transition-none"
+            : "transition-[left,right,width] duration-200 ease-linear",
+          side === "left"
+            ? "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"
+            : "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]",
+          // Adjust the padding for floating and inset variants.
+          variant === "floating" || variant === "inset"
+            ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"
+            : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",
+          className
+        )}
+        {...props}
+      >
+        <div
+          data-sidebar="sidebar"
+          data-slot="sidebar-inner"
+          className="bg-sidebar group-data-[variant=floating]:border-sidebar-border flex h-full w-full flex-col group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:shadow-sm"
+        >
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function SidebarTrigger({
+  className,
+  onClick,
+  ...props
+}: React.ComponentProps<typeof Button>) {
+  const { toggleSidebar } = useSidebar();
+
+  return (
+    <Button
+      data-sidebar="trigger"
+      data-slot="sidebar-trigger"
+      variant="ghost"
+      size="icon"
+      className={cn("size-7", className)}
+      onClick={event => {
+        onClick?.(event);
+        toggleSidebar();
+      }}
+      {...props}
+    >
+      <PanelLeftIcon />
+      <span className="sr-only">Toggle Sidebar</span>
+    </Button>
+  );
+}
+
+function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
+  const { toggleSidebar } = useSidebar();
+
+  return (
+    <button
+      data-sidebar="rail"
+      data-slot="sidebar-rail"
+      aria-label="Toggle Sidebar"
+      tabIndex={-1}
+      onClick={toggleSidebar}
+      title="Toggle Sidebar"
+      className={cn(
+        "hover:after:bg-sidebar-border absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear group-data-[side=left]:-right-4 group-data-[side=right]:left-0 after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] sm:flex",
+        "in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize",
+        "[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize",
+        "hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:translate-x-0 group-data-[collapsible=offcanvas]:after:left-full",
+        "[[data-side=left][data-collapsible=offcanvas]_&]:-right-2",
+        "[[data-side=right][data-collapsible=offcanvas]_&]:-left-2",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
+  return (
+    <main
+      data-slot="sidebar-inset"
+      className={cn(
+        "bg-background relative flex w-full flex-1 flex-col",
+        "md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarInput({
+  className,
+  ...props
+}: React.ComponentProps<typeof Input>) {
+  return (
+    <Input
+      data-slot="sidebar-input"
+      data-sidebar="input"
+      className={cn("bg-background h-8 w-full shadow-none", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-header"
+      data-sidebar="header"
+      className={cn("flex flex-col gap-2 p-2", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-footer"
+      data-sidebar="footer"
+      className={cn("flex flex-col gap-2 p-2", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof Separator>) {
+  return (
+    <Separator
+      data-slot="sidebar-separator"
+      data-sidebar="separator"
+      className={cn("bg-sidebar-border mx-2 w-auto", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-content"
+      data-sidebar="content"
+      className={cn(
+        "flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-group"
+      data-sidebar="group"
+      className={cn("relative flex w-full min-w-0 flex-col p-2", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarGroupLabel({
+  className,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"div"> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot : "div";
+
+  return (
+    <Comp
+      data-slot="sidebar-group-label"
+      data-sidebar="group-label"
+      className={cn(
+        "text-sidebar-foreground/70 ring-sidebar-ring flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium outline-hidden transition-[margin,opacity] duration-200 ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+        "group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarGroupAction({
+  className,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot : "button";
+
+  return (
+    <Comp
+      data-slot="sidebar-group-action"
+      data-sidebar="group-action"
+      className={cn(
+        "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-md p-0 outline-hidden transition-transform focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+        // Increases the hit area of the button on mobile.
+        "after:absolute after:-inset-2 md:after:hidden",
+        "group-data-[collapsible=icon]:hidden",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarGroupContent({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-group-content"
+      data-sidebar="group-content"
+      className={cn("w-full text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
+  return (
+    <ul
+      data-slot="sidebar-menu"
+      data-sidebar="menu"
+      className={cn("flex w-full min-w-0 flex-col gap-1", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
+  return (
+    <li
+      data-slot="sidebar-menu-item"
+      data-sidebar="menu-item"
+      className={cn("group/menu-item relative", className)}
+      {...props}
+    />
+  );
+}
+
+const sidebarMenuButtonVariants = cva(
+  "peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm outline-hidden ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 group-has-data-[sidebar=menu-action]/menu-item:pr-8 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default: "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
+        outline:
+          "bg-background shadow-[0_0_0_1px_hsl(var(--sidebar-border))] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]",
+      },
+      size: {
+        default: "h-8 text-sm",
+        sm: "h-7 text-xs",
+        lg: "h-12 text-sm group-data-[collapsible=icon]:p-0!",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+function SidebarMenuButton({
+  asChild = false,
+  isActive = false,
+  variant = "default",
+  size = "default",
+  tooltip,
+  className,
+  ...props
+}: React.ComponentProps<"button"> & {
+  asChild?: boolean;
+  isActive?: boolean;
+  tooltip?: string | React.ComponentProps<typeof TooltipContent>;
+} & VariantProps<typeof sidebarMenuButtonVariants>) {
+  const Comp = asChild ? Slot : "button";
+  const { isMobile, state } = useSidebar();
+
+  const button = (
+    <Comp
+      data-slot="sidebar-menu-button"
+      data-sidebar="menu-button"
+      data-size={size}
+      data-active={isActive}
+      className={cn(sidebarMenuButtonVariants({ variant, size }), className)}
+      {...props}
+    />
+  );
+
+  if (!tooltip) {
+    return button;
+  }
+
+  if (typeof tooltip === "string") {
+    tooltip = {
+      children: tooltip,
+    };
+  }
+
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>{button}</TooltipTrigger>
+      <TooltipContent
+        side="right"
+        align="center"
+        hidden={state !== "collapsed" || isMobile}
+        {...tooltip}
+      />
+    </Tooltip>
+  );
+}
+
+function SidebarMenuAction({
+  className,
+  asChild = false,
+  showOnHover = false,
+  ...props
+}: React.ComponentProps<"button"> & {
+  asChild?: boolean;
+  showOnHover?: boolean;
+}) {
+  const Comp = asChild ? Slot : "button";
+
+  return (
+    <Comp
+      data-slot="sidebar-menu-action"
+      data-sidebar="menu-action"
+      className={cn(
+        "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground peer-hover/menu-button:text-sidebar-accent-foreground absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 outline-hidden transition-transform focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+        // Increases the hit area of the button on mobile.
+        "after:absolute after:-inset-2 md:after:hidden",
+        "peer-data-[size=sm]/menu-button:top-1",
+        "peer-data-[size=default]/menu-button:top-1.5",
+        "peer-data-[size=lg]/menu-button:top-2.5",
+        "group-data-[collapsible=icon]:hidden",
+        showOnHover &&
+          "peer-data-[active=true]/menu-button:text-sidebar-accent-foreground group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-[state=open]:opacity-100 md:opacity-0",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenuBadge({
+  className,
+  ...props
+}: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="sidebar-menu-badge"
+      data-sidebar="menu-badge"
+      className={cn(
+        "text-sidebar-foreground pointer-events-none absolute right-1 flex h-5 min-w-5 items-center justify-center rounded-md px-1 text-xs font-medium tabular-nums select-none",
+        "peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[active=true]/menu-button:text-sidebar-accent-foreground",
+        "peer-data-[size=sm]/menu-button:top-1",
+        "peer-data-[size=default]/menu-button:top-1.5",
+        "peer-data-[size=lg]/menu-button:top-2.5",
+        "group-data-[collapsible=icon]:hidden",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenuSkeleton({
+  className,
+  showIcon = false,
+  ...props
+}: React.ComponentProps<"div"> & {
+  showIcon?: boolean;
+}) {
+  // Random width between 50 to 90%.
+  const width = React.useMemo(() => {
+    return `${Math.floor(Math.random() * 40) + 50}%`;
+  }, []);
+
+  return (
+    <div
+      data-slot="sidebar-menu-skeleton"
+      data-sidebar="menu-skeleton"
+      className={cn("flex h-8 items-center gap-2 rounded-md px-2", className)}
+      {...props}
+    >
+      {showIcon && (
+        <Skeleton
+          className="size-4 rounded-md"
+          data-sidebar="menu-skeleton-icon"
+        />
+      )}
+      <Skeleton
+        className="h-4 max-w-(--skeleton-width) flex-1"
+        data-sidebar="menu-skeleton-text"
+        style={
+          {
+            "--skeleton-width": width,
+          } as React.CSSProperties
+        }
+      />
+    </div>
+  );
+}
+
+function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
+  return (
+    <ul
+      data-slot="sidebar-menu-sub"
+      data-sidebar="menu-sub"
+      className={cn(
+        "border-sidebar-border mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l px-2.5 py-0.5",
+        "group-data-[collapsible=icon]:hidden",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenuSubItem({
+  className,
+  ...props
+}: React.ComponentProps<"li">) {
+  return (
+    <li
+      data-slot="sidebar-menu-sub-item"
+      data-sidebar="menu-sub-item"
+      className={cn("group/menu-sub-item relative", className)}
+      {...props}
+    />
+  );
+}
+
+function SidebarMenuSubButton({
+  asChild = false,
+  size = "md",
+  isActive = false,
+  className,
+  ...props
+}: React.ComponentProps<"a"> & {
+  asChild?: boolean;
+  size?: "sm" | "md";
+  isActive?: boolean;
+}) {
+  const Comp = asChild ? Slot : "a";
+
+  return (
+    <Comp
+      data-slot="sidebar-menu-sub-button"
+      data-sidebar="menu-sub-button"
+      data-size={size}
+      data-active={isActive}
+      className={cn(
+        "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground active:bg-sidebar-accent active:text-sidebar-accent-foreground [&>svg]:text-sidebar-accent-foreground flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 outline-hidden focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0",
+        "data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground",
+        size === "sm" && "text-xs",
+        size === "md" && "text-sm",
+        "group-data-[collapsible=icon]:hidden",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+export {
+  Sidebar,
+  SidebarContent,
+  SidebarFooter,
+  SidebarGroup,
+  SidebarGroupAction,
+  SidebarGroupContent,
+  SidebarGroupLabel,
+  SidebarHeader,
+  SidebarInput,
+  SidebarInset,
+  SidebarMenu,
+  SidebarMenuAction,
+  SidebarMenuBadge,
+  SidebarMenuButton,
+  SidebarMenuItem,
+  SidebarMenuSkeleton,
+  SidebarMenuSub,
+  SidebarMenuSubButton,
+  SidebarMenuSubItem,
+  SidebarProvider,
+  SidebarRail,
+  SidebarSeparator,
+  SidebarTrigger,
+  useSidebar
+};
+

Front/client/src/components/ui/skeleton.tsx

@@ -0,0 +1,13 @@
+import { cn } from "@/lib/utils";
+
+function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="skeleton"
+      className={cn("bg-accent animate-pulse rounded-md", className)}
+      {...props}
+    />
+  );
+}
+
+export { Skeleton };

Front/client/src/components/ui/slider.tsx

@@ -0,0 +1,61 @@
+import * as React from "react";
+import * as SliderPrimitive from "@radix-ui/react-slider";
+
+import { cn } from "@/lib/utils";
+
+function Slider({
+  className,
+  defaultValue,
+  value,
+  min = 0,
+  max = 100,
+  ...props
+}: React.ComponentProps<typeof SliderPrimitive.Root>) {
+  const _values = React.useMemo(
+    () =>
+      Array.isArray(value)
+        ? value
+        : Array.isArray(defaultValue)
+          ? defaultValue
+          : [min, max],
+    [value, defaultValue, min, max]
+  );
+
+  return (
+    <SliderPrimitive.Root
+      data-slot="slider"
+      defaultValue={defaultValue}
+      value={value}
+      min={min}
+      max={max}
+      className={cn(
+        "relative flex w-full touch-none items-center select-none data-[disabled]:opacity-50 data-[orientation=vertical]:h-full data-[orientation=vertical]:min-h-44 data-[orientation=vertical]:w-auto data-[orientation=vertical]:flex-col",
+        className
+      )}
+      {...props}
+    >
+      <SliderPrimitive.Track
+        data-slot="slider-track"
+        className={cn(
+          "bg-muted relative grow overflow-hidden rounded-full data-[orientation=horizontal]:h-1.5 data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-1.5"
+        )}
+      >
+        <SliderPrimitive.Range
+          data-slot="slider-range"
+          className={cn(
+            "bg-primary absolute data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full"
+          )}
+        />
+      </SliderPrimitive.Track>
+      {Array.from({ length: _values.length }, (_, index) => (
+        <SliderPrimitive.Thumb
+          data-slot="slider-thumb"
+          key={index}
+          className="border-primary ring-ring/50 block size-4 shrink-0 rounded-full border bg-white shadow-sm transition-[color,box-shadow] hover:ring-4 focus-visible:ring-4 focus-visible:outline-hidden disabled:pointer-events-none disabled:opacity-50"
+        />
+      ))}
+    </SliderPrimitive.Root>
+  );
+}
+
+export { Slider };

Front/client/src/components/ui/sonner.tsx

@@ -0,0 +1,23 @@
+import { useTheme } from "next-themes";
+import { Toaster as Sonner, type ToasterProps } from "sonner";
+
+const Toaster = ({ ...props }: ToasterProps) => {
+  const { theme = "system" } = useTheme();
+
+  return (
+    <Sonner
+      theme={theme as ToasterProps["theme"]}
+      className="toaster group"
+      style={
+        {
+          "--normal-bg": "var(--popover)",
+          "--normal-text": "var(--popover-foreground)",
+          "--normal-border": "var(--border)",
+        } as React.CSSProperties
+      }
+      {...props}
+    />
+  );
+};
+
+export { Toaster };

Front/client/src/components/ui/spinner.tsx

@@ -0,0 +1,16 @@
+import { Loader2Icon } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+function Spinner({ className, ...props }: React.ComponentProps<"svg">) {
+  return (
+    <Loader2Icon
+      role="status"
+      aria-label="Loading"
+      className={cn("size-4 animate-spin", className)}
+      {...props}
+    />
+  );
+}
+
+export { Spinner };

Front/client/src/components/ui/switch.tsx

@@ -0,0 +1,29 @@
+import * as React from "react";
+import * as SwitchPrimitive from "@radix-ui/react-switch";
+
+import { cn } from "@/lib/utils";
+
+function Switch({
+  className,
+  ...props
+}: React.ComponentProps<typeof SwitchPrimitive.Root>) {
+  return (
+    <SwitchPrimitive.Root
+      data-slot="switch"
+      className={cn(
+        "peer data-[state=checked]:bg-primary data-[state=unchecked]:bg-input focus-visible:border-ring focus-visible:ring-ring/50 dark:data-[state=unchecked]:bg-input/80 inline-flex h-[1.15rem] w-8 shrink-0 items-center rounded-full border border-transparent shadow-xs transition-all outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <SwitchPrimitive.Thumb
+        data-slot="switch-thumb"
+        className={cn(
+          "bg-background dark:data-[state=unchecked]:bg-foreground dark:data-[state=checked]:bg-primary-foreground pointer-events-none block size-4 rounded-full ring-0 transition-transform data-[state=checked]:translate-x-[calc(100%-2px)] data-[state=unchecked]:translate-x-0"
+        )}
+      />
+    </SwitchPrimitive.Root>
+  );
+}
+
+export { Switch };

Front/client/src/components/ui/table.tsx

@@ -0,0 +1,114 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+function Table({ className, ...props }: React.ComponentProps<"table">) {
+  return (
+    <div
+      data-slot="table-container"
+      className="relative w-full overflow-x-auto"
+    >
+      <table
+        data-slot="table"
+        className={cn("w-full caption-bottom text-sm", className)}
+        {...props}
+      />
+    </div>
+  );
+}
+
+function TableHeader({ className, ...props }: React.ComponentProps<"thead">) {
+  return (
+    <thead
+      data-slot="table-header"
+      className={cn("[&_tr]:border-b", className)}
+      {...props}
+    />
+  );
+}
+
+function TableBody({ className, ...props }: React.ComponentProps<"tbody">) {
+  return (
+    <tbody
+      data-slot="table-body"
+      className={cn("[&_tr:last-child]:border-0", className)}
+      {...props}
+    />
+  );
+}
+
+function TableFooter({ className, ...props }: React.ComponentProps<"tfoot">) {
+  return (
+    <tfoot
+      data-slot="table-footer"
+      className={cn(
+        "bg-muted/50 border-t font-medium [&>tr]:last:border-b-0",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TableRow({ className, ...props }: React.ComponentProps<"tr">) {
+  return (
+    <tr
+      data-slot="table-row"
+      className={cn(
+        "hover:bg-muted/50 data-[state=selected]:bg-muted border-b transition-colors",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TableHead({ className, ...props }: React.ComponentProps<"th">) {
+  return (
+    <th
+      data-slot="table-head"
+      className={cn(
+        "text-foreground h-10 px-2 text-left align-middle font-medium whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TableCell({ className, ...props }: React.ComponentProps<"td">) {
+  return (
+    <td
+      data-slot="table-cell"
+      className={cn(
+        "p-2 align-middle whitespace-nowrap [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TableCaption({
+  className,
+  ...props
+}: React.ComponentProps<"caption">) {
+  return (
+    <caption
+      data-slot="table-caption"
+      className={cn("text-muted-foreground mt-4 text-sm", className)}
+      {...props}
+    />
+  );
+}
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+};

Front/client/src/components/ui/tabs.tsx

@@ -0,0 +1,64 @@
+import * as React from "react";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+
+import { cn } from "@/lib/utils";
+
+function Tabs({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Root>) {
+  return (
+    <TabsPrimitive.Root
+      data-slot="tabs"
+      className={cn("flex flex-col gap-2", className)}
+      {...props}
+    />
+  );
+}
+
+function TabsList({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.List>) {
+  return (
+    <TabsPrimitive.List
+      data-slot="tabs-list"
+      className={cn(
+        "bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TabsTrigger({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
+  return (
+    <TabsPrimitive.Trigger
+      data-slot="tabs-trigger"
+      className={cn(
+        "data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  );
+}
+
+function TabsContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Content>) {
+  return (
+    <TabsPrimitive.Content
+      data-slot="tabs-content"
+      className={cn("flex-1 outline-none", className)}
+      {...props}
+    />
+  );
+}
+
+export { Tabs, TabsList, TabsTrigger, TabsContent };

Front/client/src/components/ui/textarea.tsx

@@ -0,0 +1,67 @@
+import { useDialogComposition } from "@/components/ui/dialog";
+import { useComposition } from "@/hooks/useComposition";
+import { cn } from "@/lib/utils";
+import * as React from "react";
+
+function Textarea({
+  className,
+  onKeyDown,
+  onCompositionStart,
+  onCompositionEnd,
+  ...props
+}: React.ComponentProps<"textarea">) {
+  // Get dialog composition context if available (will be no-op if not inside Dialog)
+  const dialogComposition = useDialogComposition();
+
+  // Add composition event handlers to support input method editor (IME) for CJK languages.
+  const {
+    onCompositionStart: handleCompositionStart,
+    onCompositionEnd: handleCompositionEnd,
+    onKeyDown: handleKeyDown,
+  } = useComposition<HTMLTextAreaElement>({
+    onKeyDown: (e) => {
+      // Check if this is an Enter key that should be blocked
+      const isComposing = (e.nativeEvent as any).isComposing || dialogComposition.justEndedComposing();
+
+      // If Enter key is pressed while composing or just after composition ended,
+      // don't call the user's onKeyDown (this blocks the business logic)
+      // Note: For textarea, Shift+Enter should still work for newlines
+      if (e.key === "Enter" && !e.shiftKey && isComposing) {
+        return;
+      }
+
+      // Otherwise, call the user's onKeyDown
+      onKeyDown?.(e);
+    },
+    onCompositionStart: e => {
+      dialogComposition.setComposing(true);
+      onCompositionStart?.(e);
+    },
+    onCompositionEnd: e => {
+      // Mark that composition just ended - this helps handle the Enter key that confirms input
+      dialogComposition.markCompositionEnd();
+      // Delay setting composing to false to handle Safari's event order
+      // In Safari, compositionEnd fires before the ESC keydown event
+      setTimeout(() => {
+        dialogComposition.setComposing(false);
+      }, 100);
+      onCompositionEnd?.(e);
+    },
+  });
+
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        "border-input placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:bg-input/30 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        className
+      )}
+      onCompositionStart={handleCompositionStart}
+      onCompositionEnd={handleCompositionEnd}
+      onKeyDown={handleKeyDown}
+      {...props}
+    />
+  );
+}
+
+export { Textarea };

Front/client/src/components/ui/toggle-group.tsx

@@ -0,0 +1,73 @@
+"use client";
+
+import * as React from "react";
+import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { toggleVariants } from "@/components/ui/toggle";
+
+const ToggleGroupContext = React.createContext<
+  VariantProps<typeof toggleVariants>
+>({
+  size: "default",
+  variant: "default",
+});
+
+function ToggleGroup({
+  className,
+  variant,
+  size,
+  children,
+  ...props
+}: React.ComponentProps<typeof ToggleGroupPrimitive.Root> &
+  VariantProps<typeof toggleVariants>) {
+  return (
+    <ToggleGroupPrimitive.Root
+      data-slot="toggle-group"
+      data-variant={variant}
+      data-size={size}
+      className={cn(
+        "group/toggle-group flex w-fit items-center rounded-md data-[variant=outline]:shadow-xs",
+        className
+      )}
+      {...props}
+    >
+      <ToggleGroupContext.Provider value={{ variant, size }}>
+        {children}
+      </ToggleGroupContext.Provider>
+    </ToggleGroupPrimitive.Root>
+  );
+}
+
+function ToggleGroupItem({
+  className,
+  children,
+  variant,
+  size,
+  ...props
+}: React.ComponentProps<typeof ToggleGroupPrimitive.Item> &
+  VariantProps<typeof toggleVariants>) {
+  const context = React.useContext(ToggleGroupContext);
+
+  return (
+    <ToggleGroupPrimitive.Item
+      data-slot="toggle-group-item"
+      data-variant={context.variant || variant}
+      data-size={context.size || size}
+      className={cn(
+        toggleVariants({
+          variant: context.variant || variant,
+          size: context.size || size,
+        }),
+        "min-w-0 flex-1 shrink-0 rounded-none shadow-none first:rounded-l-md last:rounded-r-md focus:z-10 focus-visible:z-10 data-[variant=outline]:border-l-0 data-[variant=outline]:first:border-l",
+        className
+      )}
+      {...props}
+    >
+      {children}
+    </ToggleGroupPrimitive.Item>
+  );
+}
+
+export { ToggleGroup, ToggleGroupItem };

Front/client/src/components/ui/toggle.tsx

@@ -0,0 +1,45 @@
+import * as React from "react";
+import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const toggleVariants = cva(
+  "inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium hover:bg-muted hover:text-muted-foreground disabled:pointer-events-none disabled:opacity-50 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] outline-none transition-[color,box-shadow] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive whitespace-nowrap",
+  {
+    variants: {
+      variant: {
+        default: "bg-transparent",
+        outline:
+          "border border-input bg-transparent shadow-xs hover:bg-accent hover:text-accent-foreground",
+      },
+      size: {
+        default: "h-9 px-2 min-w-9",
+        sm: "h-8 px-1.5 min-w-8",
+        lg: "h-10 px-2.5 min-w-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+function Toggle({
+  className,
+  variant,
+  size,
+  ...props
+}: React.ComponentProps<typeof TogglePrimitive.Root> &
+  VariantProps<typeof toggleVariants>) {
+  return (
+    <TogglePrimitive.Root
+      data-slot="toggle"
+      className={cn(toggleVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Toggle, toggleVariants };

Front/client/src/components/ui/tooltip.tsx

@@ -0,0 +1,59 @@
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+
+import { cn } from "@/lib/utils";
+
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot="tooltip-provider"
+      delayDuration={delayDuration}
+      {...props}
+    />
+  );
+}
+
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return (
+    <TooltipProvider>
+      <TooltipPrimitive.Root data-slot="tooltip" {...props} />
+    </TooltipProvider>
+  );
+}
+
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot="tooltip-content"
+        sideOffset={sideOffset}
+        className={cn(
+          "bg-foreground text-background animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-md px-3 py-1.5 text-xs text-balance",
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className="bg-foreground fill-foreground z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  );
+}
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

Front/client/src/const.ts

@@ -0,0 +1,17 @@
+export { COOKIE_NAME, ONE_YEAR_MS } from "@shared/const";
+
+// Generate login URL at runtime so redirect URI reflects the current origin.
+export const getLoginUrl = () => {
+  const oauthPortalUrl = import.meta.env.VITE_OAUTH_PORTAL_URL;
+  const appId = import.meta.env.VITE_APP_ID;
+  const redirectUri = `${window.location.origin}/api/oauth/callback`;
+  const state = btoa(redirectUri);
+
+  const url = new URL(`${oauthPortalUrl}/app-auth`);
+  url.searchParams.set("appId", appId);
+  url.searchParams.set("redirectUri", redirectUri);
+  url.searchParams.set("state", state);
+  url.searchParams.set("type", "signIn");
+
+  return url.toString();
+};

Front/client/src/contexts/ThemeContext.tsx

@@ -0,0 +1,64 @@
+import React, { createContext, useContext, useEffect, useState } from "react";
+
+type Theme = "light" | "dark";
+
+interface ThemeContextType {
+  theme: Theme;
+  toggleTheme?: () => void;
+  switchable: boolean;
+}
+
+const ThemeContext = createContext<ThemeContextType | undefined>(undefined);
+
+interface ThemeProviderProps {
+  children: React.ReactNode;
+  defaultTheme?: Theme;
+  switchable?: boolean;
+}
+
+export function ThemeProvider({
+  children,
+  defaultTheme = "light",
+  switchable = false,
+}: ThemeProviderProps) {
+  const [theme, setTheme] = useState<Theme>(() => {
+    if (switchable) {
+      const stored = localStorage.getItem("theme");
+      return (stored as Theme) || defaultTheme;
+    }
+    return defaultTheme;
+  });
+
+  useEffect(() => {
+    const root = document.documentElement;
+    if (theme === "dark") {
+      root.classList.add("dark");
+    } else {
+      root.classList.remove("dark");
+    }
+
+    if (switchable) {
+      localStorage.setItem("theme", theme);
+    }
+  }, [theme, switchable]);
+
+  const toggleTheme = switchable
+    ? () => {
+        setTheme(prev => (prev === "light" ? "dark" : "light"));
+      }
+    : undefined;
+
+  return (
+    <ThemeContext.Provider value={{ theme, toggleTheme, switchable }}>
+      {children}
+    </ThemeContext.Provider>
+  );
+}
+
+export function useTheme() {
+  const context = useContext(ThemeContext);
+  if (!context) {
+    throw new Error("useTheme must be used within ThemeProvider");
+  }
+  return context;
+}

Front/client/src/hooks/useComposition.ts

@@ -0,0 +1,81 @@
+import { useRef } from "react";
+import { usePersistFn } from "./usePersistFn";
+
+export interface UseCompositionReturn<
+  T extends HTMLInputElement | HTMLTextAreaElement,
+> {
+  onCompositionStart: React.CompositionEventHandler<T>;
+  onCompositionEnd: React.CompositionEventHandler<T>;
+  onKeyDown: React.KeyboardEventHandler<T>;
+  isComposing: () => boolean;
+}
+
+export interface UseCompositionOptions<
+  T extends HTMLInputElement | HTMLTextAreaElement,
+> {
+  onKeyDown?: React.KeyboardEventHandler<T>;
+  onCompositionStart?: React.CompositionEventHandler<T>;
+  onCompositionEnd?: React.CompositionEventHandler<T>;
+}
+
+type TimerResponse = ReturnType<typeof setTimeout>;
+
+export function useComposition<
+  T extends HTMLInputElement | HTMLTextAreaElement = HTMLInputElement,
+>(options: UseCompositionOptions<T> = {}): UseCompositionReturn<T> {
+  const {
+    onKeyDown: originalOnKeyDown,
+    onCompositionStart: originalOnCompositionStart,
+    onCompositionEnd: originalOnCompositionEnd,
+  } = options;
+
+  const c = useRef(false);
+  const timer = useRef<TimerResponse | null>(null);
+  const timer2 = useRef<TimerResponse | null>(null);
+
+  const onCompositionStart = usePersistFn((e: React.CompositionEvent<T>) => {
+    if (timer.current) {
+      clearTimeout(timer.current);
+      timer.current = null;
+    }
+    if (timer2.current) {
+      clearTimeout(timer2.current);
+      timer2.current = null;
+    }
+    c.current = true;
+    originalOnCompositionStart?.(e);
+  });
+
+  const onCompositionEnd = usePersistFn((e: React.CompositionEvent<T>) => {
+    // 使用两层 setTimeout 来处理 Safari 浏览器中 compositionEnd 先于 onKeyDown 触发的问题
+    timer.current = setTimeout(() => {
+      timer2.current = setTimeout(() => {
+        c.current = false;
+      });
+    });
+    originalOnCompositionEnd?.(e);
+  });
+
+  const onKeyDown = usePersistFn((e: React.KeyboardEvent<T>) => {
+    // 在 composition 状态下，阻止 ESC 和 Enter（非 shift+Enter）事件的冒泡
+    if (
+      c.current &&
+      (e.key === "Escape" || (e.key === "Enter" && !e.shiftKey))
+    ) {
+      e.stopPropagation();
+      return;
+    }
+    originalOnKeyDown?.(e);
+  });
+
+  const isComposing = usePersistFn(() => {
+    return c.current;
+  });
+
+  return {
+    onCompositionStart,
+    onCompositionEnd,
+    onKeyDown,
+    isComposing,
+  };
+}

Front/client/src/hooks/useMobile.tsx

@@ -0,0 +1,21 @@
+import * as React from "react";
+
+const MOBILE_BREAKPOINT = 768;
+
+export function useIsMobile() {
+  const [isMobile, setIsMobile] = React.useState<boolean | undefined>(
+    undefined
+  );
+
+  React.useEffect(() => {
+    const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
+    const onChange = () => {
+      setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    };
+    mql.addEventListener("change", onChange);
+    setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
+
+  return !!isMobile;
+}

Front/client/src/hooks/usePersistFn.ts

@@ -0,0 +1,20 @@
+import { useRef } from "react";
+
+type noop = (...args: any[]) => any;
+
+/**
+ * usePersistFn instead of useCallback to reduce cognitive load
+ */
+export function usePersistFn<T extends noop>(fn: T) {
+  const fnRef = useRef<T>(fn);
+  fnRef.current = fn;
+
+  const persistFn = useRef<T>(null);
+  if (!persistFn.current) {
+    persistFn.current = function (this: unknown, ...args) {
+      return fnRef.current!.apply(this, args);
+    } as T;
+  }
+
+  return persistFn.current!;
+}

Front/client/src/index.css

@@ -0,0 +1,181 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+:root {
+  --primary: var(--color-blue-700);
+  --primary-foreground: var(--color-blue-50);
+  --sidebar-primary: var(--color-blue-600);
+  --sidebar-primary-foreground: var(--color-blue-50);
+  --chart-1: var(--color-blue-300);
+  --chart-2: var(--color-blue-500);
+  --chart-3: var(--color-blue-600);
+  --chart-4: var(--color-blue-700);
+  --chart-5: var(--color-blue-800);
+  --radius: 0.65rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.235 0.015 65);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.235 0.015 65);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.235 0.015 65);
+  --secondary: oklch(0.98 0.001 286.375);
+  --secondary-foreground: oklch(0.4 0.015 65);
+  --muted: oklch(0.967 0.001 286.375);
+  --muted-foreground: oklch(0.552 0.016 285.938);
+  --accent: oklch(0.967 0.001 286.375);
+  --accent-foreground: oklch(0.141 0.005 285.823);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(0.92 0.004 286.32);
+  --input: oklch(0.92 0.004 286.32);
+  --ring: oklch(0.623 0.214 259.815);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.235 0.015 65);
+  --sidebar-accent: oklch(0.967 0.001 286.375);
+  --sidebar-accent-foreground: oklch(0.141 0.005 285.823);
+  --sidebar-border: oklch(0.92 0.004 286.32);
+  --sidebar-ring: oklch(0.623 0.214 259.815);
+}
+
+.dark {
+  --primary: var(--color-blue-700);
+  --primary-foreground: var(--color-blue-50);
+  --sidebar-primary: var(--color-blue-500);
+  --sidebar-primary-foreground: var(--color-blue-50);
+  --background: oklch(0.141 0.005 285.823);
+  --foreground: oklch(0.85 0.005 65);
+  --card: oklch(0.21 0.006 285.885);
+  --card-foreground: oklch(0.85 0.005 65);
+  --popover: oklch(0.21 0.006 285.885);
+  --popover-foreground: oklch(0.85 0.005 65);
+  --secondary: oklch(0.24 0.006 286.033);
+  --secondary-foreground: oklch(0.7 0.005 65);
+  --muted: oklch(0.274 0.006 286.033);
+  --muted-foreground: oklch(0.705 0.015 286.067);
+  --accent: oklch(0.274 0.006 286.033);
+  --accent-foreground:  oklch(0.92 0.005 65);
+  --destructive: oklch(0.704 0.191 22.216);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.488 0.243 264.376);
+  --chart-1: var(--color-blue-300);
+  --chart-2: var(--color-blue-500);
+  --chart-3: var(--color-blue-600);
+  --chart-4: var(--color-blue-700);
+  --chart-5: var(--color-blue-800);
+  --sidebar: oklch(0.21 0.006 285.885);
+  --sidebar-foreground: oklch(0.85 0.005 65);
+  --sidebar-accent: oklch(0.274 0.006 286.033);
+  --sidebar-accent-foreground:  oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.488 0.243 264.376);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+    font-family: 'IBM Plex Sans KR', -apple-system, BlinkMacSystemFont, sans-serif;
+  }
+  code, pre, .font-mono {
+    font-family: 'JetBrains Mono', 'Fira Code', monospace;
+  }
+  button:not(:disabled),
+  [role="button"]:not([aria-disabled="true"]),
+  [type="button"]:not(:disabled),
+  [type="submit"]:not(:disabled),
+  [type="reset"]:not(:disabled),
+  a[href],
+  select:not(:disabled),
+  input[type="checkbox"]:not(:disabled),
+  input[type="radio"]:not(:disabled) {
+    @apply cursor-pointer;
+  }
+}
+
+@layer components {
+  /**
+   * Custom container utility that centers content and adds responsive padding.
+   *
+   * This overrides Tailwind's default container behavior to:
+   * - Auto-center content (mx-auto)
+   * - Add responsive horizontal padding
+   * - Set max-width for large screens
+   *
+   * Usage: <div className="container">...</div>
+   *
+   * For custom widths, use max-w-* utilities directly:
+   * <div className="max-w-6xl mx-auto px-4">...</div>
+   */
+  .container {
+    width: 100%;
+    margin-left: auto;
+    margin-right: auto;
+    padding-left: 1rem; /* 16px - mobile padding */
+    padding-right: 1rem;
+  }
+
+  .flex {
+    min-height: 0;
+    min-width: 0;
+  }
+
+  @media (min-width: 640px) {
+    .container {
+      padding-left: 1.5rem; /* 24px - tablet padding */
+      padding-right: 1.5rem;
+    }
+  }
+
+  @media (min-width: 1024px) {
+    .container {
+      padding-left: 2rem; /* 32px - desktop padding */
+      padding-right: 2rem;
+      max-width: 1280px; /* Standard content width */
+    }
+  }
+}

Front/client/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

Front/client/src/main.tsx

@@ -0,0 +1,5 @@
+import { createRoot } from "react-dom/client";
+import App from "./App";
+import "./index.css";
+
+createRoot(document.getElementById("root")!).render(<App />);

Front/client/src/pages/Home.tsx

@@ -0,0 +1,832 @@
+/**
+ * Home - 메인 페이지 (Zone-Centric 슬라이드 빌더)
+ */
+
+import { useState, useCallback, useMemo, useEffect, useRef } from "react";
+import { toast } from "sonner";
+import type { DesignAgentState, LayoutPresetId, Zone } from "../types/designAgent";
+import {
+  createInitialUserSelection,
+  selectZone,
+  selectRegion,
+  applyLayout,
+  applyFrame,
+  getSelectedZone,
+  getSelectedRegion,
+  moveSectionToZone,
+  saveZoneSizes,
+  saveImageOverride,
+  deriveUserOverridesKey,
+  applyPersistedNonFrameOverrides,
+  remapPersistedFramesToZoneFrames,
+} from "../utils/slidePlanUtils";
+import {
+  parseMdxFile,
+  runPipeline,
+  loadRun,
+  computeZonePositions,
+  formatAiRepairHumanReviewMessage,
+  type RunMeta,
+  type PipelineOverrides,
+} from "../services/designAgentApi";
+import {
+  flushUserOverrides,
+  getUserOverrides,
+  saveUserOverrides,
+  type UserOverrides,
+} from "../services/userOverridesApi";
+
+import LeftMdxPanel from "../components/LeftMdxPanel";
+import SlideCanvas from "../components/SlideCanvas";
+import LayoutPanel from "../components/LayoutPanel";
+import FramePanel from "../components/FramePanel";
+import {
+  Sparkles, Download, Link2, Loader2,
+  CheckCircle2, HelpCircle,
+} from "lucide-react";
+import { Button } from "@/components/ui/button";
+
+
+const INITIAL_STATE: DesignAgentState = {
+  uploadedFile: null,
+  normalizedContent: null,
+  slidePlan: null,
+  userSelection: createInitialUserSelection(),
+  isLoading: false,
+  error: null,
+};
+
+type RightPanelTab = "layout" | "frame";
+
+export default function Home() {
+  const [state, setState] = useState<DesignAgentState>(INITIAL_STATE);
+  const [rightTab, setRightTab] = useState<RightPanelTab>("frame");
+  // Phase Z run 산출물 메타 (loadRun 호출 시 set — Step 5 에서 연결).
+  const [runMeta, setRunMeta] = useState<RunMeta | null>(null);
+  // Phase 1 : 사용자가 frame / section / layout / zone resize 등 override 를
+  // 변경했을 때 true. 좌측 하단 버튼이 "선택대로 재생성하기" 로 전환.
+  // handleGenerate (재생성) 시 false 로 reset.
+  const [hasPendingChanges, setHasPendingChanges] = useState(false);
+
+  // Phase 2 : 사용자가 LayoutPanel 의 다른 layout 카드 → "적용하기" 누르면
+  // 빈 layout 모드로 전환 (final.html iframe 숨기고 빈 zone 만 표시 → 사용자가
+  // section drag drop + frame 선택). null 이면 평소 모드 (final.html 표시).
+  const [pendingLayout, setPendingLayout] = useState<LayoutPresetId | null>(null);
+
+  // IMP-52 u6 — restore-on-reopen: persisted user_overrides.json fetched at
+  // handleFileUpload time. layout / zone_geometries / zone_sections are
+  // seeded into userSelection immediately (so handleGenerate forwards them
+  // as CLI args). frames are stashed here because their on-disk key
+  // (unit_id = section_ids joined by "+") only maps to region.id after
+  // loadRun rebuilds the slidePlan — see handleGenerate post-loadRun.
+  const persistedOverridesRef = useRef<Partial<UserOverrides>>({});
+
+  // pendingLayout 활성 시 effective slidePlan = pendingZones 가 swap 된 plan.
+  // 그 외 = default state.slidePlan. 모든 zone / region lookup (handleFrameSelect /
+  // getSelectedZone / SlideCanvas) 이 일관되게 이 effectiveSlidePlan 사용.
+
+  // pendingLayout 활성 시 빈 layout 의 zones 계산 (정규화 좌표).
+  // section_ids 는 userSelection.overrides.zone_sections 에서만 — default 무시
+  // (사용자가 직접 채워야 함). frame_candidates 는 normal mode 의 union 사용.
+  const pendingZones = useMemo<Zone[] | null>(() => {
+    if (!pendingLayout) return null;
+    const positions = computeZonePositions(pendingLayout);
+    return positions.map((p, idx) => {
+      const sectionIds =
+        state.userSelection.overrides.zone_sections?.[p.name] ?? [];
+      // 그 zone 에 할당된 section 의 frame_candidates 를 자동 결정 결과 (slidePlan)
+      // 에서 lookup. section_id 매칭되는 zone 의 internal_regions[0].frame_candidates 사용.
+      // 없으면 첫 번째 zone 의 후보 fallback (시각용 — 정확한 매칭은 Step D 의
+      // backend forwarding 후에 의미 있음).
+      const sourceZone =
+        sectionIds.length > 0
+          ? state.slidePlan?.zones.find((z) =>
+              sectionIds.some((sid) => z.section_ids.includes(sid))
+            )
+          : undefined;
+      const frameCandidates =
+        sourceZone?.internal_regions[0]?.frame_candidates ??
+        state.slidePlan?.zones[0]?.internal_regions[0]?.frame_candidates ??
+        [];
+      return {
+        id: `pending-zone-${idx}`,
+        zone_id: p.name,
+        section_ids: sectionIds,
+        position: p.geometry,
+        internal_regions: [
+          {
+            id: `pending-region-${idx}`,
+            region_id: "region-single",
+            role: "primary" as const,
+            content_type: "text_block" as const,
+            ratio_estimate: 1,
+            content_unit_ids: [],
+            frame_match_strategy: {
+              kind: "frame_match" as const,
+              frame_id: null,
+              display_strategy: "inline_full" as const,
+            },
+            frame_candidates: frameCandidates,
+          },
+        ],
+        region_layout_type: "region-single",
+      } as Zone;
+    });
+  }, [pendingLayout, state.userSelection.overrides.zone_sections, state.slidePlan]);
+
+  // Layout 카드의 "적용하기" 클릭 → pendingLayout 모드 진입.
+  // 기존 zone_sections 를 새 layout 의 positions 순서로 자동 carry over —
+  // horizontal-2 (top, bottom) → vertical-2 (left, right) 같은 case 에서 사용자가
+  // 매번 drag drop 다시 안 해도 되게. 새 layout zone count 가 적으면 마지막 zone 에 합침.
+  const handleApplyPendingLayout = useCallback((layoutId: LayoutPresetId) => {
+    setState((p) => {
+      const newPositions = computeZonePositions(layoutId).map((pos) => pos.name);
+      const oldZones = p.slidePlan?.zones ?? [];
+      const carriedZoneSections: Record<string, string[]> = {};
+      oldZones.forEach((zone, idx) => {
+        const targetPos =
+          idx < newPositions.length
+            ? newPositions[idx]
+            : newPositions[newPositions.length - 1]; // 적은 zone count: 마지막에 합침
+        if (!targetPos) return;
+        if (!carriedZoneSections[targetPos]) {
+          carriedZoneSections[targetPos] = [];
+        }
+        carriedZoneSections[targetPos].push(...zone.section_ids);
+      });
+      return {
+        ...p,
+        userSelection: {
+          ...p.userSelection,
+          overrides: {
+            ...p.userSelection.overrides,
+            layout_preset: layoutId,
+            zone_sections: carriedZoneSections,
+          },
+          selectedZoneId: null,
+          selectedRegionId: null,
+        },
+      };
+    });
+    setPendingLayout(layoutId);
+    setHasPendingChanges(true);
+    setRightTab("frame");
+  }, []);
+
+  // pending 모드 취소 → 평소 (final.html iframe) 모드 복귀.
+  const handleCancelPendingLayout = useCallback(() => {
+    setPendingLayout(null);
+    setState((p) => ({
+      ...p,
+      userSelection: createInitialUserSelection(p.slidePlan),
+    }));
+    setHasPendingChanges(false);
+  }, []);
+
+  // ── 파일 업로드 → MDX 분석만 (파이프라인 X) ──
+  //   업로드 시점에는 좌측 패널의 섹션 트리만 채움. 실제 Phase Z 파이프라인은
+  //   하단 "슬라이드 플랜 생성하기" 버튼 (handleGenerate) 에서 실행.
+  const handleFileUpload = useCallback(async (file: File) => {
+    setState((p) => ({
+      ...p,
+      uploadedFile: file,
+      isLoading: true,
+      normalizedContent: null,
+      slidePlan: null,
+    }));
+    setRunMeta(null);
+
+    try {
+      const content = await parseMdxFile(file);
+      // IMP-52 u6 — restore-on-reopen. Key = MDX stem (matches backend
+      // u2 fallback's Path(args.mdx_path).stem). getUserOverrides returns
+      // {} on miss / corrupt / network failure (u5 contract) so the upload
+      // path never fails on a fresh MDX.
+      const overridesKey = deriveUserOverridesKey(file.name);
+      const persisted = await getUserOverrides(overridesKey);
+      persistedOverridesRef.current = persisted;
+      setState((p) => ({
+        ...p,
+        normalizedContent: content,
+        userSelection: applyPersistedNonFrameOverrides(p.userSelection, persisted),
+        isLoading: false,
+      }));
+      toast.success(`"${file.name}" 분석 완료 — 하단 버튼으로 슬라이드 생성하세요.`);
+    } catch (err) {
+      console.error(err);
+      toast.error(
+        `MDX 분석 오류: ${err instanceof Error ? err.message : String(err)}`
+      );
+      setState((p) => ({ ...p, isLoading: false }));
+    }
+  }, []);
+
+  // 2026-05-14 — 좌측 패널의 03/04/05 fix list 클릭 또는 URL `?mdx=04` 변경 시
+  // 호출되는 단일 callback. handleFileUpload 가 자동 분석 trigger.
+  const [selectedSample, setSelectedSample] = useState<"03" | "04" | "05" | null>(null);
+
+  // 2026-05-14 — mdx 별 slide-level CSS override (catalog/template 무변, frontend layer only).
+  // SlideCanvas 의 iframe onLoad 에서 동적 inject. 사용자 룰 : "보고용 슬라이드 결과물 단위"
+  // 변경. mdx04 의 default (rank 1 = process_product_two_way) 일 때만 적용 — 사용자 frame
+  // override 후 (rank 2 = bim_dx_comparison_table 등) 다른 frame 시 무적용.
+  const MDX04_DEFAULT_OVERRIDE_CSS = `
+    .slide-body {
+      grid-template-rows: 0.38fr 0.60fr !important;
+      gap: 1.5% !important;
+    }
+    .f29b__cell .text-line + .text-line { margin-top: 1px !important; }
+    .f29b__cell:nth-child(n+3) {
+      padding-top: 3px !important;
+      margin-top: 2px !important;
+    }
+  `.trim();
+
+  const handleSelectSample = useCallback(async (which: "03" | "04" | "05") => {
+    try {
+      const res = await fetch(`/api/sample-mdx?mdx=${encodeURIComponent(which)}`);
+      if (!res.ok) return;
+      const text = await res.text();
+      const filenameHeader = res.headers.get("X-Mdx-Filename");
+      const filename = filenameHeader
+        ? decodeURIComponent(filenameHeader)
+        : `${which}_demo.mdx`;
+      const file = new File([text], filename, { type: "text/markdown" });
+      setSelectedSample(which);
+      handleFileUpload(file);
+      // 슬라이드 생성은 사용자가 "슬라이드 플랜 생성하기" 클릭 시 handleGenerate 에서.
+    } catch {
+      // backend 미작동
+    }
+    // handleFileUpload 는 useCallback 으로 안정 — eslint dep 우회
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // 페이지 첫 로드 시 데모용 mdx 자동 로드 — 상대방에게 mdx 파일 공유 안 해도 되게.
+  // URL query `?mdx=04` / `?mdx=05` 로 다른 sample 선택 가능. default = 03.
+  // 사용자가 다른 파일을 직접 업로드하면 그것이 override 됨.
+  useEffect(() => {
+    const which = (new URLSearchParams(window.location.search).get("mdx") as "03" | "04" | "05" | null) || "03";
+    if (!["03", "04", "05"].includes(which)) return;
+    handleSelectSample(which);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // ── 슬라이드 플랜 생성 → Phase Z 파이프라인 실행 → 산출물 로드 ──
+  const handleGenerate = useCallback(async () => {
+    if (!state.uploadedFile) {
+      toast.error("MDX 파일을 먼저 업로드하세요.");
+      return;
+    }
+
+    // mdx04 도 mdx03 와 동일하게 정상 backend pipeline path (demo mode 제거).
+
+    // Step D : userSelection.overrides → backend 가 받는 schema 로 변환.
+    // - layout : userSelection.overrides.layout_preset (default 와 다를 때만)
+    // - frames : zone.section_ids → unit_id ("+".join). region.id 별 zone_frames lookup.
+    //   pendingZones 의 region 도 동일 — 그 region 의 zone 의 sections 가 unit_id 결정.
+    const overrides: PipelineOverrides = {};
+    const sourcePlan = effectiveSlidePlan;
+    if (sourcePlan && state.slidePlan) {
+      // 2026-05-22 demo hot-fix — 이전 비교 가드 (default !== override) 제거.
+      // restore loop 이 default = override 로 sync 시 override 안 보내고 backend
+      // default fallback 발생. user 가 명시한 layout 이 있으면 무조건 보냄.
+      const overrideLayout = state.userSelection.overrides.layout_preset;
+      if (overrideLayout) {
+        overrides.layout = overrideLayout;
+      }
+      const frames: Record<string, string> = {};
+      const skippedNoCatalog: string[] = [];
+      sourcePlan.zones.forEach((zone) => {
+        const region = zone.internal_regions[0];
+        if (!region) return;
+        const overrideFrameId =
+          state.userSelection.overrides.zone_frames?.[region.id];
+        const defaultFrameId = region.frame_match_strategy.frame_id;
+        if (
+          overrideFrameId &&
+          overrideFrameId !== defaultFrameId &&
+          zone.section_ids.length > 0
+        ) {
+          // catalog 미등록 frame 은 backend 가 어차피 skip — frontend 에서 미리 거름
+          // (불필요한 round trip + 사용자 헷갈림 방지). 후보 list 에서 catalog flag lookup.
+          const candidateMatch = region.frame_candidates?.find(
+            (c) => c.id === overrideFrameId
+          );
+          if (candidateMatch?.catalogRegistered === false) {
+            skippedNoCatalog.push(`${zone.zone_id}=${overrideFrameId}`);
+            return;
+          }
+          const unitId = zone.section_ids.join("+");
+          frames[unitId] = overrideFrameId;
+        }
+      });
+      if (Object.keys(frames).length > 0) overrides.frames = frames;
+      if (skippedNoCatalog.length > 0) {
+        toast.error(
+          `catalog 미등록 frame ${skippedNoCatalog.length} 개는 backend 가 적용 못 함 — render path 미연결: ${skippedNoCatalog.join(", ")}`
+        );
+      }
+
+      // zone-geometry override — backend 의 build_layout_css 에 전달 (horizontal-2 /
+      // vertical-2 만 적용). zone_id (top/bottom/...) → slide-body 내부 0~1 비율.
+      const zoneGeometries = state.userSelection.overrides.zone_geometries;
+      if (zoneGeometries && Object.keys(zoneGeometries).length > 0) {
+        overrides.zoneGeometries = zoneGeometries;
+      }
+
+      // 2026-05-22 — IMP-08 B-3 원래 동작 (sameAsDefault with effectiveSlidePlan) 복귀.
+      // 시연 안정성 우선. section swap 은 별 path (수동 drag detection) 로 풀어야 함.
+      // 임시 over-aggressive fix 가 default flow 깨뜨려 PARTIAL_COVERAGE 발생했음.
+      const userZoneSections = state.userSelection.overrides.zone_sections;
+      if (userZoneSections) {
+        const defaultByZone = new Map<string, string[]>();
+        sourcePlan.zones.forEach((z) => {
+          defaultByZone.set(z.zone_id, z.section_ids);
+        });
+        const zoneSectionsDiff: Record<string, string[]> = {};
+        for (const [zoneId, sids] of Object.entries(userZoneSections)) {
+          if (!Array.isArray(sids)) continue;
+          const cleaned = sids.filter((s) => typeof s === "string" && s.trim());
+          const defaults = defaultByZone.get(zoneId) ?? [];
+          const sameAsDefault =
+            cleaned.length === defaults.length &&
+            cleaned.every((sid, i) => sid === defaults[i]);
+          if (!sameAsDefault) {
+            zoneSectionsDiff[zoneId] = cleaned;
+          }
+        }
+        if (Object.keys(zoneSectionsDiff).length > 0) {
+          overrides.zoneSections = zoneSectionsDiff;
+        }
+      }
+    }
+
+    setState((p) => ({ ...p, isLoading: true }));
+    setHasPendingChanges(false);  // 재생성 트리거 시 override pending flag reset
+    setPendingLayout(null);       // pending layout 모드 종료
+    const overrideSummary =
+      Object.keys(overrides).length > 0
+        ? `(overrides: ${[
+            overrides.layout && `layout=${overrides.layout}`,
+            overrides.frames && `frames=${Object.keys(overrides.frames).length}`,
+            overrides.zoneSections &&
+              `zoneSections=${Object.keys(overrides.zoneSections).length}`,
+          ]
+            .filter(Boolean)
+            .join(", ")})`
+        : "";
+    toast.info(`Phase Z 파이프라인 실행 중... ${overrideSummary}`);
+
+    try {
+      // IMP-52 u10 — Force-commit any pending debounced PUTs before backend
+      // reads user_overrides.json on pipeline entry. Without this, a user
+      // who changes an override (300ms debounce window) and immediately
+      // clicks Generate would race the PUT against /api/run; the u2
+      // fallback could then load a stale persisted document.
+      await flushUserOverrides();
+      const result = await runPipeline(state.uploadedFile, overrides);
+
+      if (!result.success || !result.final_html_exists) {
+        const detail =
+          result.stderr?.trim().split("\n").slice(-3).join(" | ") ||
+          result.error ||
+          `exit_code=${result.exit_code}`;
+        toast.error(`파이프라인 실패: ${detail}`);
+        setState((p) => ({ ...p, isLoading: false }));
+        return;
+      }
+
+      const { normalizedContent, slidePlan, runMeta } = await loadRun(result.run_id);
+      // IMP-52 u6 — post-loadRun frame remap. persistedOverridesRef holds
+      // the user_overrides.json read at handleFileUpload time. Frames there
+      // are keyed by unit_id (section_ids joined by "+"); the in-memory
+      // zone_frames is keyed by region.id. Remap against the new slidePlan
+      // zones so SlideCanvas's override-vs-default preview indicator shows
+      // the user's persisted choice without forcing them to re-click.
+      const restoredZoneFrames = remapPersistedFramesToZoneFrames(
+        slidePlan,
+        persistedOverridesRef.current.frames as Record<string, string> | undefined,
+      );
+      setState((p) => {
+        // IMP-52 u6 — restore-on-reopen: re-layer the persisted non-frame
+        // axes (layout / zone_geometries / zone_sections) onto the post-load
+        // `base`. `createInitialUserSelection` rebuilds from slidePlan and
+        // drops anything the backend fallback could not round-trip through
+        // a CLI arg — `zone_geometries` in particular has no slidePlan
+        // representation, so without this merge the user would see their
+        // resized zones revert on every Generate.
+        const base = applyPersistedNonFrameOverrides(
+          createInitialUserSelection(slidePlan),
+          persistedOverridesRef.current,
+        );
+        return {
+          ...p,
+          normalizedContent,
+          slidePlan,
+          userSelection: {
+            ...base,
+            overrides: {
+              ...base.overrides,
+              zone_frames: { ...base.overrides.zone_frames, ...restoredZoneFrames },
+            },
+          },
+          isLoading: false,
+        };
+      });
+      setRunMeta(runMeta);
+      toast.success(`run "${result.run_id}" 완료 — ${runMeta.status}`);
+      const aiReviewMsg = formatAiRepairHumanReviewMessage(runMeta.ai_repair_status);
+      if (aiReviewMsg) toast.error(aiReviewMsg);
+    } catch (err) {
+      console.error(err);
+      toast.error(
+        `파이프라인 실행 오류: ${err instanceof Error ? err.message : String(err)}`
+      );
+      setState((p) => ({ ...p, isLoading: false }));
+    }
+  }, [state.uploadedFile, state.slidePlan, state.userSelection, pendingZones, pendingLayout]);
+
+  // ── 섹션 드래그 앤 드롭 (Zone으로 재배치) ──
+  const handleSectionDrop = useCallback((sectionId: string, zoneId: string) => {
+    setState((p) => {
+      const newSelection = moveSectionToZone(p.userSelection, sectionId, zoneId);
+      const finalSelection = selectZone(newSelection, zoneId); // 이동된 존 자동 선택
+      // IMP-52 u7 — persist the post-drop zone_sections snapshot. The on-disk
+      // schema axis (`zone_sections`) shares the in-memory shape (zone_id →
+      // section_ids), so we forward the full mutated value; the u4 PUT path
+      // replaces this axis atomically while preserving the foreign axes.
+      // p.uploadedFile gate skips persistence before any MDX is loaded —
+      // the demo-mode initial render path would otherwise PUT to the empty
+      // key. saveUserOverrides is debounced (300ms) and per-key coalesced.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, {
+          zone_sections: finalSelection.overrides.zone_sections,
+        });
+      }
+      return { ...p, userSelection: finalSelection };
+    });
+    setRightTab("frame");
+    setHasPendingChanges(true);
+  }, []);
+
+  // ── Zone 클릭 ──
+  const handleZoneClick = useCallback((zoneId: string) => {
+    setState((p) => ({ 
+      ...p, 
+      userSelection: selectZone(p.userSelection, zoneId) 
+    }));
+    setRightTab("frame");
+  }, []);
+
+  // ── Region 클릭 ──
+  const handleRegionClick = useCallback((regionId: string) => {
+    setState((p) => ({ 
+      ...p, 
+      userSelection: selectRegion(p.userSelection, regionId) 
+    }));
+    setRightTab("frame");
+  }, []);
+
+  // ── Layout 선택 ──
+  const handleLayoutSelect = useCallback((layoutId: string) => {
+    setState((p) => {
+      const newSelection = applyLayout(p.userSelection, layoutId as LayoutPresetId);
+      // IMP-52 u7 — persist the selected layout preset id. The on-disk
+      // `layout` axis is a single string; `applyLayout` validates the
+      // preset id before mutating the selection, so the value here is
+      // already the LayoutPresetId we want to round-trip.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { layout: layoutId });
+      }
+      return { ...p, userSelection: newSelection };
+    });
+    setHasPendingChanges(true);
+  }, []);
+
+  const handleLayoutResize = useCallback((groupId: string, sizes: number[]) => {
+    setState((p) => ({
+      ...p,
+      userSelection: saveZoneSizes(p.userSelection, groupId, sizes)
+    }));
+    setHasPendingChanges(true);
+  }, []);
+
+  const handleZoneResize = useCallback((geometries: Record<string, { x: number; y: number; w: number; h: number }>) => {
+    setState((p) => {
+      const mergedGeometries = {
+        ...p.userSelection.overrides.zone_geometries,
+        ...geometries,
+      };
+      // IMP-52 u7 — persist the merged zone_geometries snapshot. Resize
+      // gestures fire repeatedly during a drag; the 300ms u5 debounce
+      // collapses them into a single PUT at gesture-end, so we don't
+      // need to gate on resize-finished here.
+      if (p.uploadedFile) {
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { zone_geometries: mergedGeometries });
+      }
+      return {
+        ...p,
+        userSelection: {
+          ...p.userSelection,
+          overrides: {
+            ...p.userSelection.overrides,
+            zone_geometries: mergedGeometries,
+          },
+        },
+      };
+    });
+    setHasPendingChanges(true);
+  }, []);
+
+  // IMP-51 (#79) u10 — wire SlideCanvas's user-content image drag/resize
+  // emit into the 5th persisted axis. Mirrors handleZoneResize exactly:
+  //   • merge the single (imageId → {x,y,w,h}) tick onto the prior
+  //     in-memory `image_overrides` map via the u11 `saveImageOverride`
+  //     helper so the immutable update path is shared with the test suite,
+  //   • forward the full merged snapshot through `saveUserOverrides`
+  //     (the u3 typed client) under the `image_overrides` key — the 300ms
+  //     debounce defined alongside `zone_geometries` collapses the
+  //     per-mousemove emits into one PUT at gesture-end,
+  //   • flip `hasPendingChanges` so the "선택대로 재생성하기" CTA appears.
+  // Coordinates are slide-absolute percent (0–100) from u8/u9 — passed
+  // through unchanged so the on-disk schema matches the SlideCanvas
+  // overlay, the stamper selector (u4), and the render-time CSS
+  // injector (u7) without any per-zone transform.
+  const handleImageResize = useCallback(
+    (imageId: string, geometry: { x: number; y: number; w: number; h: number }) => {
+      setState((p) => {
+        const nextSelection = saveImageOverride(p.userSelection, imageId, geometry);
+        if (p.uploadedFile) {
+          const key = deriveUserOverridesKey(p.uploadedFile.name);
+          void saveUserOverrides(key, {
+            image_overrides: nextSelection.overrides.image_overrides,
+          });
+        }
+        return { ...p, userSelection: nextSelection };
+      });
+      setHasPendingChanges(true);
+    },
+    [],
+  );
+
+  // 편집 모드 텍스트 변경 시 hasPendingChanges 활성. useCallback 으로 reference 안정화 —
+  // SlideCanvas 의 useEffect 가 매번 rerun 안 하도록 (resize drag 매 mousemove 마다
+  // re-render 시 useEffect retrigger → iframe contentEditable 재설정 = 매우 느림).
+  const handleContentEdit = useCallback(() => {
+    setHasPendingChanges(true);
+  }, []);
+
+  // pending mode 일 때 effectiveSlidePlan = pendingZones 가 swap 된 plan.
+  // 그 외 = state.slidePlan. 모든 zone / region lookup 이 일관되게 이걸 사용 →
+  // pending mode 의 region.id ("pending-region-N") 가 zone_frames key 로 들어가
+  // SlideCanvas overlay 의 region.id 와 매칭됨.
+  const effectiveSlidePlan = useMemo(() => {
+    if (pendingZones && state.slidePlan) {
+      return { ...state.slidePlan, zones: pendingZones, layout_preset: pendingLayout! };
+    }
+    return state.slidePlan;
+  }, [pendingZones, state.slidePlan, pendingLayout]);
+
+  // 2026-05-14 — slide-level CSS override 계산. mdx04 default (rank 1 = process_product_two_way)
+  // 일 때만 적용 (catalog 무변, slide 결과물에만 inject). 사용자 frame override 후 다른
+  // frame 시 무적용 (rank 2 의 frame visual 유지).
+  const slideOverrideCss = useMemo<string | undefined>(() => {
+    if (selectedSample !== "04") return undefined;
+    const zone04_2 = state.slidePlan?.zones.find((z) => z.zone_id === "bottom");
+    const frameId = zone04_2?.internal_regions[0]?.frame_match_strategy.frame_id;
+    if (frameId !== "process_product_two_way") return undefined;
+    return MDX04_DEFAULT_OVERRIDE_CSS;
+  }, [selectedSample, state.slidePlan]);
+
+  // ── Frame 선택 ──
+  const handleFrameSelect = useCallback((frameId: string) => {
+    const zone = getSelectedZone(effectiveSlidePlan, state.userSelection);
+    const region = getSelectedRegion(zone, state.userSelection) || zone?.internal_regions?.[0];
+
+    if (!region) {
+      toast.error("디자인을 적용할 구역을 먼저 선택해주세요.");
+      return;
+    }
+
+    setState((p) => {
+      const newSelection = applyFrame(p.userSelection, region.id, frameId);
+      // IMP-52 u7 — persist frames keyed by `unit_id`. The on-disk schema
+      // uses `unit_id = zone.section_ids.join("+")` (the same convention
+      // handleGenerate uses when forwarding `overrides.frames` to the
+      // backend CLI). `zone_frames` is keyed by region.id, so we walk
+      // the effectiveSlidePlan zones to translate. Only true user
+      // overrides are persisted — `createInitialUserSelection` pre-fills
+      // `zone_frames[region.id]` with `region.frame_match_strategy.frame_id`
+      // (backend default) for every region, so we mirror handleGenerate's
+      // `overrideFrameId !== defaultFrameId` gate to avoid leaking defaults
+      // into user_overrides.json. Zones with no sections are skipped.
+      if (p.uploadedFile && effectiveSlidePlan) {
+        const framesByUnitId: Record<string, string> = {};
+        for (const z of effectiveSlidePlan.zones) {
+          const r = z.internal_regions[0];
+          if (!r) continue;
+          if (!Array.isArray(z.section_ids) || z.section_ids.length === 0) continue;
+          const unitId = z.section_ids.join("+");
+          const overrideId = newSelection.overrides.zone_frames?.[r.id];
+          const defaultFrameId = r.frame_match_strategy.frame_id;
+          if (
+            typeof overrideId === "string" &&
+            overrideId.length > 0 &&
+            overrideId !== defaultFrameId
+          ) {
+            framesByUnitId[unitId] = overrideId;
+          }
+        }
+        const key = deriveUserOverridesKey(p.uploadedFile.name);
+        void saveUserOverrides(key, { frames: framesByUnitId });
+      }
+      return { ...p, userSelection: newSelection };
+    });
+    setHasPendingChanges(true);
+  }, [effectiveSlidePlan, state.userSelection]);
+
+  const selectedZone = getSelectedZone(effectiveSlidePlan, state.userSelection);
+  const selectedRegion = getSelectedRegion(selectedZone, state.userSelection);
+
+  return (
+    <div className="h-screen flex flex-col bg-white overflow-hidden font-sans">
+      {/* Header */}
+      <header className="flex-shrink-0 h-12 flex items-center px-4 border-b border-slate-200 bg-white shadow-sm z-30">
+        <div className="flex items-center gap-2 w-56 flex-shrink-0">
+          <div className="w-8 h-8 bg-slate-900 rounded-lg flex items-center justify-center">
+            <Sparkles className="w-4 h-4 text-blue-400 fill-blue-400" />
+          </div>
+          <span className="text-sm font-black text-slate-800 tracking-tighter uppercase">Design Agent</span>
+        </div>
+
+        <div className="flex-1 flex items-center justify-center gap-2">
+          <span className="text-xs font-bold text-slate-400 uppercase tracking-widest">Active Slide /</span>
+          <span className="text-sm font-bold text-slate-700">{state.slidePlan?.title ?? "새 슬라이드"}</span>
+          {runMeta && (
+            <>
+              <span className="text-slate-300">·</span>
+              <span className="text-[10px] font-mono text-slate-500 px-1.5 py-0.5 bg-slate-100 rounded">
+                run: {runMeta.run_id}
+              </span>
+              <span
+                className={`text-[10px] font-bold px-1.5 py-0.5 rounded uppercase tracking-wider ${
+                  runMeta.status === "PASS"
+                    ? "bg-emerald-100 text-emerald-700"
+                    : runMeta.status === "RENDERED_WITH_VISUAL_REGRESSION"
+                    ? "bg-amber-100 text-amber-700"
+                    : runMeta.status === "PARTIAL_COVERAGE"
+                    ? "bg-orange-100 text-orange-700"
+                    : "bg-red-100 text-red-700"
+                }`}
+                title={`visual_check_passed: ${runMeta.visual_check_passed} / full_mdx_coverage: ${runMeta.full_mdx_coverage}`}
+              >
+                {runMeta.status}
+              </span>
+              {runMeta.filtered_section_ids.length > 0 && (
+                <details className="relative">
+                  <summary className="text-[10px] font-bold px-1.5 py-0.5 bg-amber-100 text-amber-700 rounded uppercase tracking-wider cursor-pointer list-none">
+                    Filtered: {runMeta.filtered_section_ids.length}
+                  </summary>
+                  <div className="absolute top-full mt-1 left-0 z-50 bg-white border border-slate-200 rounded shadow-lg p-3 w-96 max-h-96 overflow-y-auto">
+                    {runMeta.filtered_section_reasons.map((r, i) => (
+                      <div key={i} className="mb-2 pb-2 border-b border-slate-100 last:border-0 last:mb-0 last:pb-0 text-[11px]">
+                        <div className="font-mono text-slate-700">{r.section_ids.join(", ")}</div>
+                        <div className="text-slate-500">selection_state: <span className="font-mono">{r.selection_state}</span></div>
+                        {r.merge_type && <div className="text-slate-500">merge_type: <span className="font-mono">{r.merge_type}</span></div>}
+                        {r.template_id && <div className="text-slate-500">template_id: <span className="font-mono">{r.template_id}</span></div>}
+                        {r.v4_label && <div className="text-slate-500">v4_label: <span className="font-mono">{r.v4_label}</span></div>}
+                        {r.phase_z_status && <div className="text-slate-500">phase_z_status: <span className="font-mono">{r.phase_z_status}</span></div>}
+                        {r.score !== null && <div className="text-slate-500">score: <span className="font-mono">{r.score}</span></div>}
+                        {r.source && <div className="text-slate-500">source: <span className="font-mono">{r.source}</span></div>}
+                        {r.position && <div className="text-slate-500">position: <span className="font-mono">{r.position}</span></div>}
+                        <ul className="mt-1 list-disc list-inside text-slate-600">
+                          {r.filter_reasons.map((reason, j) => <li key={j} className="font-mono">{reason}</li>)}
+                        </ul>
+                      </div>
+                    ))}
+                  </div>
+                </details>
+              )}
+            </>
+          )}
+        </div>
+
+        <div className="flex items-center gap-3 w-56 flex-shrink-0 justify-end">
+          {state.isLoading ? (
+            <div className="flex items-center gap-1.5 text-blue-500">
+              <Loader2 className="w-3.5 h-3.5 animate-spin" />
+              <span className="text-[11px] font-bold uppercase">Processing...</span>
+            </div>
+          ) : state.slidePlan ? (
+            <div className="flex items-center gap-1 text-slate-400">
+              <CheckCircle2 className="w-3.5 h-3.5 text-emerald-500" />
+              <span className="text-[11px] font-bold uppercase tracking-tighter">Synced</span>
+            </div>
+          ) : null}
+          <div className="h-4 w-px bg-slate-200" />
+          <button className="text-slate-300 hover:text-slate-500 transition-colors"><HelpCircle className="w-4 h-4" /></button>
+        </div>
+      </header>
+
+      {/* Main Content Area */}
+      <div className="flex-1 flex overflow-hidden">
+        {/* Left Panel: MDX Explorer (Drag Source) */}
+        <aside className="w-64 flex-shrink-0 border-r border-slate-200 flex flex-col overflow-hidden shadow-sm z-20">
+          <LeftMdxPanel
+            normalizedContent={state.normalizedContent}
+            uploadedFile={state.uploadedFile}
+            isLoading={state.isLoading}
+            selectedSectionId={state.userSelection.selectedSectionId}
+            hasSlidePlan={!!state.slidePlan}
+            hasPendingChanges={hasPendingChanges}
+            onFileUpload={handleFileUpload}
+            onGenerate={handleGenerate}
+            onSectionClick={(sectionId) => {
+              if (!state.slidePlan) return;
+              const zone = state.slidePlan.zones.find((z) => z.section_ids.includes(sectionId));
+              if (zone) handleZoneClick(zone.id);
+            }}
+            onSelectSample={handleSelectSample}
+            selectedSample={selectedSample}
+          />
+        </aside>
+
+        {/* Center: Slide Canvas (Drop Target & Resizable) */}
+        <main className="flex-1 flex flex-col overflow-hidden bg-slate-100">
+          <SlideCanvas
+            slidePlan={effectiveSlidePlan}
+            normalizedContent={state.normalizedContent}
+            userSelection={state.userSelection}
+            finalHtmlUrl={runMeta?.final_html_url}
+            slideOverrideCss={slideOverrideCss}
+            isPipelineRunning={state.isLoading}
+            isPendingLayout={!!pendingLayout}
+            pendingLayoutId={pendingLayout}
+            onCancelPendingLayout={handleCancelPendingLayout}
+            onContentEdit={handleContentEdit}
+            onZoneClick={(zoneId) => {
+              handleZoneClick(zoneId);
+              setRightTab("frame");
+            }}
+            onSlideClick={() => setRightTab("layout")}
+            onRegionClick={handleRegionClick}
+            onFrameSelect={handleFrameSelect}
+            onSectionDrop={handleSectionDrop}
+            onLayoutResize={handleLayoutResize}
+            onZoneResize={handleZoneResize}
+            imageOverrides={state.userSelection.overrides.image_overrides}
+            onImageResize={handleImageResize}
+          />
+        </main>
+
+        {/* Right Panel: Frame / Layout Inspector */}
+        <aside className="w-72 flex-shrink-0 border-l border-slate-200 flex flex-col overflow-hidden bg-white shadow-sm z-20">
+          <div className="flex-shrink-0 flex p-1 bg-slate-50 border-b border-slate-200 m-2 rounded-lg">
+            <button className={`flex-1 py-1.5 text-[10px] font-black uppercase tracking-widest rounded-md transition-all ${rightTab === "frame" ? "bg-white text-blue-600 shadow-sm" : "text-slate-400"}`} onClick={() => setRightTab("frame")}>Frame</button>
+            <button className={`flex-1 py-1.5 text-[10px] font-black uppercase tracking-widest rounded-md transition-all ${rightTab === "layout" ? "bg-white text-blue-600 shadow-sm" : "text-slate-400"}`} onClick={() => setRightTab("layout")}>Layout</button>
+          </div>
+          <div className="flex-1 overflow-hidden">
+            {rightTab === "frame" ? (
+              <FramePanel
+                slidePlan={effectiveSlidePlan}
+                selectedZone={selectedZone}
+                selectedRegion={selectedRegion}
+                userSelection={state.userSelection}
+                onFrameSelect={handleFrameSelect}
+                onNoDesignToggle={() => {}}
+              />
+            ) : (
+              <LayoutPanel
+                selectedZone={selectedZone}
+                userSelection={state.userSelection}
+                onLayoutSelect={handleLayoutSelect}
+                onApplyLayout={handleApplyPendingLayout}
+                availableLayoutIds={runMeta?.layout_candidates}
+                pipelineSelectedLayoutId={state.slidePlan?.layout_preset}
+                pendingLayoutId={pendingLayout}
+              />
+            )}
+          </div>
+        </aside>
+      </div>
+
+      {/* Footer Actions */}
+      <footer className="flex-shrink-0 flex items-center justify-between px-6 py-3 bg-white border-t border-slate-200 z-30">
+        <div className="flex items-center gap-4">
+          <div className="flex items-center gap-1.5">
+            <div className="w-2 h-2 rounded-full bg-emerald-500 animate-pulse" />
+            <span className="text-[10px] font-bold text-slate-500 uppercase tracking-tighter">Phase Z Engine Active</span>
+          </div>
+        </div>
+        <div className="flex items-center gap-3">
+          <Button variant="outline" onClick={() => toast.info("연동하기 기능은 준비 중입니다.")} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"><Link2 className="w-3.5 h-3.5" />Connect</Button>
+          <Button variant="outline" onClick={() => toast.info("다운로드 기능은 준비 중입니다.")} disabled={!state.slidePlan} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest border-slate-200"><Download className="w-3.5 h-3.5" />Download</Button>
+          <Button onClick={() => toast.success("슬라이드 설정이 확정되었습니다.")} disabled={!state.slidePlan || state.isLoading} className="gap-2 h-9 text-[11px] font-bold uppercase tracking-widest bg-slate-900 hover:bg-slate-800"><Sparkles className="w-3.5 h-3.5" />Finalize Slide</Button>
+        </div>
+      </footer>
+    </div>
+  );
+}

Front/client/src/pages/NotFound.tsx

@@ -0,0 +1,49 @@
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { AlertCircle, Home } from "lucide-react";
+import { useLocation } from "wouter";
+
+export default function NotFound() {
+  const [, setLocation] = useLocation();
+
+  const handleGoHome = () => {
+    setLocation("/");
+  };
+
+  return (
+    <div className="min-h-screen w-full flex items-center justify-center bg-gradient-to-br from-slate-50 to-slate-100">
+      <Card className="w-full max-w-lg mx-4 shadow-lg border-0 bg-white/80 backdrop-blur-sm">
+        <CardContent className="pt-8 pb-8 text-center">
+          <div className="flex justify-center mb-6">
+            <div className="relative">
+              <div className="absolute inset-0 bg-red-100 rounded-full animate-pulse" />
+              <AlertCircle className="relative h-16 w-16 text-red-500" />
+            </div>
+          </div>
+
+          <h1 className="text-4xl font-bold text-slate-900 mb-2">404</h1>
+
+          <h2 className="text-xl font-semibold text-slate-700 mb-4">
+            Page Not Found
+          </h2>
+
+          <p className="text-slate-600 mb-8 leading-relaxed">
+            Sorry, the page you are looking for doesn't exist.
+            <br />
+            It may have been moved or deleted.
+          </p>
+
+          <div className="flex flex-col sm:flex-row gap-3 justify-center">
+            <Button
+              onClick={handleGoHome}
+              className="bg-blue-600 hover:bg-blue-700 text-white px-6 py-2.5 rounded-lg transition-all duration-200 shadow-md hover:shadow-lg"
+            >
+              <Home className="w-4 h-4 mr-2" />
+              Go Home
+            </Button>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

Front/client/src/services/applicationMode.ts

@@ -0,0 +1,64 @@
+// ─── IMP-41 u2 — application_mode helper (issue #70) ────────────────────────
+// Pure deterministic helpers for forwarding backend Step 9
+// `unit.application_candidates[]` to the FramePanel V4-label badge tooltip.
+//
+// Keyed by backend `application_mode` VALUE (NOT V4 label) — preserves the
+// AI-isolation contract: tooltip text is a read-only display of backend
+// authority, never re-derived on the frontend from V4 label.
+//
+// Source of truth = src/phase_z2_pipeline.py APPLICATION_MODE_BY_V4_LABEL
+// (:107-112) emitted via _application_candidates_for_unit() (:3071-3092)
+// onto unit.application_candidates[] in step09_application_plan.json.
+
+/** Backend application_mode enumeration (verbatim from APPLICATION_MODE_BY_V4_LABEL). */
+export type ApplicationMode =
+  | 'direct_insert'
+  | 'same_frame_with_adjustment'
+  | 'layout_or_region_change'
+  | 'exclude';
+
+/** Korean consequence phrases per issue #70 spec item #2. Keyed by mode VALUE. */
+export const APPLICATION_MODE_TOOLTIP_KR: Record<ApplicationMode, string> = {
+  direct_insert: '코드 직접 적용',
+  same_frame_with_adjustment: 'AI 보강 필요',
+  layout_or_region_change: 'AI restructure 필요',
+  exclude: 'render path 제외',
+};
+
+/**
+ * Compose the V4-label badge tooltip title. When `applicationMode` resolves
+ * to a known mode the title shows the Korean consequence + raw mode token;
+ * otherwise (undefined or unknown — legacy fixtures pre-IMP-32) it falls
+ * back to the raw V4 label string per Stage 2 contract.
+ */
+export function buildBadgeTitle(
+  label: string,
+  applicationMode: string | undefined,
+): string {
+  const consequence = applicationMode
+    ? APPLICATION_MODE_TOOLTIP_KR[applicationMode as ApplicationMode]
+    : undefined;
+  return consequence
+    ? `${consequence} (${applicationMode})`
+    : `V4 label: ${label}`;
+}
+
+/**
+ * Build a Map<template_id, applicationCandidate> from a Step 9
+ * `unit.application_candidates[]` array. Entries with a non-string or empty
+ * `template_id` are skipped. First occurrence wins on duplicate keys.
+ * Pure — does NOT sort, slice, or filter by label/confidence.
+ */
+export function mergeApplicationCandidates(
+  applicationCandidates: unknown,
+): Map<string, any> {
+  const out = new Map<string, any>();
+  if (!Array.isArray(applicationCandidates)) return out;
+  for (const ac of applicationCandidates) {
+    const key = (ac as any)?.template_id;
+    if (typeof key === 'string' && key.length > 0 && !out.has(key)) {
+      out.set(key, ac);
+    }
+  }
+  return out;
+}

Front/client/src/services/designAgentApi.ts

@@ -0,0 +1,676 @@
+/**
+ * Design Agent - API Service Layer (MVP Simulation)
+ * 
+ * 이 파일은 백엔드 파이프라인(Phase Z)의 로직을 프론트엔드에서 시뮬레이션합니다.
+ * 백엔드 연동 없이도 실제 데이터 흐름을 확인할 수 있도록 구현되었습니다.
+ */
+
+import type {
+  NormalizedContent,
+  SlidePlan,
+  LayoutCandidate,
+  FrameCandidate,
+  SectionContent,
+  ContentObject,
+  LayoutPresetId,
+} from "../types/designAgent";
+
+import {
+  MOCK_LAYOUT_CANDIDATES,
+  MOCK_FRAME_CANDIDATES_SECTION1,
+} from "../data/mockDesignAgentData";
+
+import { mergeApplicationCandidates } from "./applicationMode";
+
+/** 네트워크 지연 시뮬레이션 */
+const simulateDelay = (ms: number = 800) =>
+  new Promise((resolve) => setTimeout(resolve, ms));
+
+// ─────────────────────────────────────────────────────────────────────────────
+// STAGE 1 & 2: MDX Parsing & Normalization Simulation
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * MDX 본문 텍스트 → SectionContent[] 분해.
+ * 중목차 (##) = root section, 소목차 (###) = section.sub_sections.
+ * 일반 텍스트는 가장 가까운 (소목차 있으면 소목차, 아니면 중목차) 의 content_objects 에 누적.
+ */
+function parseMdxText(text: string): SectionContent[] {
+  const lines = text.split("\n");
+  const sections: SectionContent[] = [];
+  let currentSection: SectionContent | null = null;
+  let currentSubSection: SectionContent | null = null;
+
+  lines.forEach((line) => {
+    if (line.startsWith("## ")) {
+      currentSection = {
+        id: `section-${sections.length + 1}`,
+        index: sections.length + 1,
+        level: 2,
+        title: line.replace(/^##\s+/, "").trim(),
+        content_objects: [],
+        sub_sections: [],
+      };
+      sections.push(currentSection);
+      currentSubSection = null;
+    } else if (line.startsWith("### ") && currentSection) {
+      const subIdx = (currentSection.sub_sections?.length ?? 0) + 1;
+      currentSubSection = {
+        id: `${currentSection.id}-sub-${subIdx}`,
+        index: subIdx,
+        level: 3,
+        title: line.replace(/^###\s+/, "").trim(),
+        content_objects: [],
+        parentId: currentSection.id,
+      };
+      currentSection.sub_sections!.push(currentSubSection);
+    } else if (line.trim()) {
+      const target = currentSubSection ?? currentSection;
+      if (!target) return;
+      const co: ContentObject = {
+        id: `co-${target.id}-${target.content_objects.length + 1}`,
+        type: "text_block",
+        role: "detail",
+        raw_payload: line.trim(),
+        size_estimate: { line_count: 1 },
+      };
+      target.content_objects.push(co);
+    }
+  });
+
+  return sections;
+}
+
+export async function parseMdxFile(file: File): Promise<NormalizedContent> {
+  await simulateDelay(300);
+
+  const text = await file.text();
+  // frontmatter / # title 추출
+  let title = file.name.replace(/\.mdx?$/, "");
+  let body = text;
+  const fmMatch = body.match(/^---\n([\s\S]*?)\n---\n/);
+  if (fmMatch) {
+    const titleLine = fmMatch[1].split("\n").find((l) => l.startsWith("title:"));
+    if (titleLine) title = titleLine.replace(/^title:\s*/, "").trim();
+    body = body.slice(fmMatch[0].length);
+  }
+  const h1Match = body.match(/^#\s+(.+)$/m);
+  if (h1Match) title = h1Match[1].trim();
+
+  const sections = parseMdxText(body);
+
+  if (sections.length === 0) {
+    sections.push({
+      id: "section-1",
+      index: 1,
+      level: 2,
+      title: "기본 섹션",
+      content_objects: [
+        {
+          id: "co-1",
+          type: "text_block",
+          role: "summary",
+          raw_payload: "내용이 없습니다.",
+          size_estimate: {},
+        },
+      ],
+    });
+  }
+
+  return { title, sections };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// STAGE 2 & 3: Slide Plan & Zone Mapping Simulation
+// ─────────────────────────────────────────────────────────────────────────────
+
+export async function generateSlidePlan(
+  content: NormalizedContent
+): Promise<SlidePlan> {
+  console.log("[MVP] STAGE 2: Mapping sections to zones...");
+  await simulateDelay(1200);
+
+  const sectionCount = content.sections.length;
+  
+  // 섹션 개수에 따라 레이아웃 프리셋 결정
+  let layout_preset: LayoutPresetId = "single";
+  let zoneIds: string[] = ["main"];
+
+  if (sectionCount === 2) {
+    layout_preset = "horizontal-2";
+    zoneIds = ["left", "right"];
+  } else if (sectionCount >= 3) {
+    layout_preset = "grid-2x2";
+    zoneIds = ["tl", "tr", "bl", "br"];
+  }
+
+  const zones = content.sections.slice(0, zoneIds.length).map((section, idx) => {
+    const zone_id = zoneIds[idx];
+    
+    return {
+      id: `zone-${section.id}`,
+      zone_id: zone_id,
+      section_ids: [section.id],
+      position: { x: 0, y: 0, width: 0.5, height: 0.5 },
+      internal_regions: [
+        {
+          id: `region-${section.id}`,
+          region_id: `region-${idx + 1}`,
+          role: "primary" as const,
+          content_type: "mixed" as const,
+          ratio_estimate: 1,
+          content_unit_ids: section.content_objects.map(co => co.id),
+          frame_match_strategy: {
+            kind: "frame_match" as const,
+            frame_id: "frame-001", // 기본 Rank 1 매칭
+            display_strategy: "inline_full" as const,
+          },
+          frame_candidates: MOCK_FRAME_CANDIDATES_SECTION1,
+        }
+      ]
+    };
+  });
+
+  return {
+    id: `plan-${Date.now()}`,
+    title: content.title,
+    layout_preset,
+    zones,
+    updatedAt: new Date().toISOString(),
+  };
+}
+
+// ... 나머지 API는 Mock 유지
+export async function getLayoutCandidates(sectionId: string): Promise<LayoutCandidate[]> {
+  return MOCK_LAYOUT_CANDIDATES;
+}
+
+export async function getFrameCandidates(sectionId: string): Promise<FrameCandidate[]> {
+  return MOCK_FRAME_CANDIDATES_SECTION1;
+}
+
+export async function exportSlidePlan(slidePlan: SlidePlan, userSelection: any): Promise<any> {
+  return { success: true, exportedAt: new Date().toISOString() };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Phase Z 실제 산출물 로드 (Phase 1 — 보고용 read-only viewer prototype)
+//
+// data/runs/{run_id}/phase_z2/ → client/public/data/runs/{run_id}/ (정적 export).
+// scripts/sync_phase_z_run_to_frontend.py 가 산출물 복사 담당.
+//
+// 매핑 :
+//   step01_mdx_source.md           → mdx 원문
+//   step01_mdx_upload.json         → run metadata (run_id / mdx_path / slide_title)
+//   step02_normalized.json         → NormalizedContent.sections
+//   step07_layout.json             → SlidePlan.layout_preset + layout_candidates
+//   step08_zone_region_ratios.json → Zone 별 region/display 후보
+//   step09_application_plan.json   → SlidePlan.zones[].internal_regions[].frame_candidates
+//   step20_slide_status.json       → 최종 상태 (PASS / RENDERED_WITH_VISUAL_REGRESSION / ...)
+// ─────────────────────────────────────────────────────────────────────────────
+
+// IMP-10 D-1 : verbatim mirror of step20_slide_status.json.data.filtered_section_reasons[]
+// schema (src/phase_z2_pipeline.py:2217-2278). `source` / `position` only present on
+// the override-uncovered additive variant. Strings rendered verbatim — no enum redefinition.
+export interface FilteredSectionReason {
+  section_ids: string[];
+  merge_type: string | null;
+  template_id: string | null;
+  v4_label: string | null;
+  phase_z_status: string | null;
+  score: number | null;
+  selection_state: string;
+  filter_reasons: string[];
+  source?: string;
+  position?: string | null;
+}
+
+export interface AiRepairStatus {
+  status: "ok" | "applied" | "unsupported_kind" | "coverage_violated" | "error" | string;
+  counts: {
+    total: number;
+    applied: number;
+    no_proposal: number;
+    no_zone_match: number;
+    unsupported_kind: number;
+    error: number;
+  };
+  unsupported_kind_records: Array<{
+    unit_index?: number | null;
+    source_section_ids: string[];
+    apply_status: string;
+  }>;
+  error_records: Array<{
+    unit_index?: number | null;
+    source_section_ids: string[];
+    error: string;
+  }>;
+  coverage_status: string;
+  dropped_section_ids: string[];
+  human_review_required: boolean;
+}
+
+export interface RunMeta {
+  run_id: string;
+  mdx_path: string;
+  mdx_source: string; // step01_mdx_source.md raw text
+  status: "PASS" | "RENDERED_WITH_VISUAL_REGRESSION" | "PARTIAL_COVERAGE" | "ABORTED" | string;
+  visual_check_passed: boolean;
+  full_mdx_coverage: boolean;
+  filtered_section_ids: string[];                       // step20 filtered_section_ids
+  filtered_section_reasons: FilteredSectionReason[];    // step20 filtered_section_reasons
+  preview_url: string;     // /data/runs/{runId}/preview.png
+  final_html_url: string;  // /data/runs/{runId}/final.html
+  layout_candidates: string[]; // step07 layout_candidates list
+  region_layout_candidates_by_zone: Record<string, string[]>;       // step08 placeholder
+  display_strategy_candidates_by_zone: Record<string, string[]>;    // step08 placeholder
+  ai_repair_status: AiRepairStatus | null;
+}
+
+export function formatAiRepairHumanReviewMessage(
+  ai: AiRepairStatus | null | undefined,
+): string | null {
+  if (!ai || !ai.human_review_required) return null;
+  if (ai.status === "error") {
+    const n = ai.counts?.error ?? ai.error_records?.length ?? 0;
+    return `AI 재구성 호출 실패 (${n}건) — 다른 frame 선택 또는 수동 편집 필요`;
+  }
+  if (ai.status === "coverage_violated") {
+    const dropped = (ai.dropped_section_ids || []).join(", ");
+    return `AI 재구성 후 콘텐츠 누락 (dropped: ${dropped || "?"}) — 다른 frame 선택 또는 수동 편집 필요`;
+  }
+  if (ai.status === "unsupported_kind") {
+    const n = ai.counts?.unsupported_kind ?? ai.unsupported_kind_records?.length ?? 0;
+    return `AI 제안 형식 미지원 (${n}건) — 다른 frame 선택 또는 수동 편집 필요`;
+  }
+  return `AI 재구성 human_review 필요 (status: ${ai.status})`;
+}
+
+export interface LoadRunResult {
+  normalizedContent: NormalizedContent;
+  slidePlan: SlidePlan;
+  runMeta: RunMeta;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// runPipeline — POST /api/run (Vite plugin middleware)
+//   업로드된 MDX 파일을 backend Phase Z 파이프라인에 던지고 run_id 를 받음.
+//   이후 loadRun(run_id) 으로 산출물 fetch.
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface RunPipelineResult {
+  success: boolean;
+  run_id: string;
+  exit_code: number | null;
+  final_html_exists: boolean;
+  preview_exists: boolean;
+  stdout: string;
+  stderr: string;
+  error?: string;
+}
+
+export interface PipelineOverrides {
+  layout?: string;
+  /** unit_id (= "+".join(source_section_ids), e.g., "03-1" 또는 "03-1+03-2") → template_id */
+  frames?: Record<string, string>;
+  /** zone_id (top/bottom/left/right/...) → slide-body 내부 0~1 비율.
+   *  backend 의 build_layout_css 가 horizontal-2 / vertical-2 만 처리. */
+  zoneGeometries?: Record<string, { x: number; y: number; w: number; h: number }>;
+  /** IMP-08 B-3 : zone_id -> list of section_id assignments
+   *  (canonical ordinal `${parent}-sub-${n}`). Only forwarded when the
+   *  user explicitly diverges from the auto plan; default placements
+   *  are not echoed back to avoid polluting override provenance. */
+  zoneSections?: Record<string, string[]>;
+}
+
+export async function runPipeline(
+  file: File,
+  overrides?: PipelineOverrides
+): Promise<RunPipelineResult> {
+  const content = await file.text();
+  const res = await fetch("/api/run", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ filename: file.name, content, overrides }),
+  });
+  const data = (await res.json()) as RunPipelineResult;
+  if (!res.ok && !data.run_id) {
+    throw new Error(data.error || `pipeline failed (${res.status})`);
+  }
+  return data;
+}
+
+/**
+ * Layout preset → zone 별 정규화 좌표 (0~1).
+ * Backend 의 컨테이너 px 와 별도 — frontend 시각화는 비율만 사용.
+ * 8 preset 모두 backend layouts.yaml 의 positions 와 동일한 순서/이름.
+ */
+export function computeZonePositions(preset: LayoutPresetId): Array<{
+  name: string;
+  geometry: { x: number; y: number; width: number; height: number };
+}> {
+  switch (preset) {
+    case "single":
+      // backend layouts.yaml: positions = [primary]
+      return [{ name: "primary", geometry: { x: 0, y: 0, width: 1, height: 1 } }];
+    case "horizontal-2":
+      return [
+        { name: "top", geometry: { x: 0, y: 0, width: 1, height: 0.5 } },
+        { name: "bottom", geometry: { x: 0, y: 0.5, width: 1, height: 0.5 } },
+      ];
+    case "vertical-2":
+      return [
+        { name: "left", geometry: { x: 0, y: 0, width: 0.5, height: 1 } },
+        { name: "right", geometry: { x: 0.5, y: 0, width: 0.5, height: 1 } },
+      ];
+    case "top-1-bottom-2":
+      return [
+        { name: "top", geometry: { x: 0, y: 0, width: 1, height: 0.5 } },
+        { name: "bottom-left", geometry: { x: 0, y: 0.5, width: 0.5, height: 0.5 } },
+        { name: "bottom-right", geometry: { x: 0.5, y: 0.5, width: 0.5, height: 0.5 } },
+      ];
+    case "top-2-bottom-1":
+      return [
+        { name: "top-left", geometry: { x: 0, y: 0, width: 0.5, height: 0.5 } },
+        { name: "top-right", geometry: { x: 0.5, y: 0, width: 0.5, height: 0.5 } },
+        { name: "bottom", geometry: { x: 0, y: 0.5, width: 1, height: 0.5 } },
+      ];
+    case "left-1-right-2":
+      return [
+        { name: "left", geometry: { x: 0, y: 0, width: 0.5, height: 1 } },
+        { name: "right-top", geometry: { x: 0.5, y: 0, width: 0.5, height: 0.5 } },
+        { name: "right-bottom", geometry: { x: 0.5, y: 0.5, width: 0.5, height: 0.5 } },
+      ];
+    case "left-2-right-1":
+      // backend layouts.yaml: positions = [left-top, right, left-bottom] (순서!)
+      return [
+        { name: "left-top", geometry: { x: 0, y: 0, width: 0.5, height: 0.5 } },
+        { name: "right", geometry: { x: 0.5, y: 0, width: 0.5, height: 1 } },
+        { name: "left-bottom", geometry: { x: 0, y: 0.5, width: 0.5, height: 0.5 } },
+      ];
+    case "grid-2x2":
+      return [
+        { name: "top-left", geometry: { x: 0, y: 0, width: 0.5, height: 0.5 } },
+        { name: "top-right", geometry: { x: 0.5, y: 0, width: 0.5, height: 0.5 } },
+        { name: "bottom-left", geometry: { x: 0, y: 0.5, width: 0.5, height: 0.5 } },
+        { name: "bottom-right", geometry: { x: 0.5, y: 0.5, width: 0.5, height: 0.5 } },
+      ];
+    default:
+      return [{ name: "main", geometry: { x: 0, y: 0, width: 1, height: 1 } }];
+  }
+}
+
+/** confidence 점수 → 'high' / 'medium' / 'low' 분류 (frontend 시각용). */
+function classifyConfidence(score: number): "high" | "medium" | "low" {
+  if (score >= 0.85) return "high";
+  if (score >= 0.6) return "medium";
+  return "low";
+}
+
+/**
+ * 실제 Phase Z run 산출물을 로드하여 frontend type 으로 변환.
+ *
+ * @example
+ *   const { normalizedContent, slidePlan, runMeta } = await loadRun("mdx03_f29_fix_check");
+ */
+export async function loadRun(runId: string): Promise<LoadRunResult> {
+  console.log(`[Phase Z] loadRun: ${runId}`);
+  const base = `/data/runs/${runId}`;
+
+  const fetchJson = async (path: string) => {
+    const res = await fetch(`${base}/${path}`);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch ${path}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  };
+  const fetchText = async (path: string) => {
+    const res = await fetch(`${base}/${path}`);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch ${path}: ${res.status} ${res.statusText}`);
+    }
+    return res.text();
+  };
+
+  const [
+    mdxSource,
+    upload,
+    normalized,
+    layout,
+    zoneRegion,
+    applicationPlan,
+    slideStatus,
+  ] = await Promise.all([
+    fetchText("steps/step01_mdx_source.md"),
+    fetchJson("steps/step01_mdx_upload.json"),
+    fetchJson("steps/step02_normalized.json"),
+    fetchJson("steps/step07_layout.json"),
+    fetchJson("steps/step08_zone_region_ratios.json"),
+    fetchJson("steps/step09_application_plan.json"),
+    fetchJson("steps/step20_slide_status.json"),
+  ]);
+
+  // ── RunMeta ──
+  const runMeta: RunMeta = {
+    run_id: upload.data?.run_id ?? runId,
+    mdx_path: upload.data?.mdx_path ?? "",
+    mdx_source: mdxSource,
+    status: slideStatus.data?.overall ?? "UNKNOWN",
+    visual_check_passed: slideStatus.data?.visual_check_passed ?? false,
+    full_mdx_coverage: slideStatus.data?.full_mdx_coverage ?? false,
+    filtered_section_ids: slideStatus.data?.filtered_section_ids ?? [],
+    filtered_section_reasons: slideStatus.data?.filtered_section_reasons ?? [],
+    preview_url: `${base}/preview.png`,
+    final_html_url: `${base}/final.html`,
+    layout_candidates: layout.data?.layout_candidates ?? [],
+    region_layout_candidates_by_zone: Object.fromEntries(
+      (zoneRegion.data?.per_zone_plan ?? []).map((z: any) => [
+        z.position,
+        z.region_layout_candidates ?? [],
+      ])
+    ),
+    display_strategy_candidates_by_zone: Object.fromEntries(
+      (zoneRegion.data?.per_zone_plan ?? []).map((z: any) => [
+        z.position,
+        z.display_strategy_candidates ?? [],
+      ])
+    ),
+    ai_repair_status: (slideStatus.data?.ai_repair_status ?? null) as AiRepairStatus | null,
+  };
+
+  // ── NormalizedContent ──
+  // step02 의 sections (defensive 매핑 — 없으면 빈 배열).
+  // 각 section 의 raw_content 를 다시 파싱해서 sub_sections (소목차) 추출 → frontend
+  // 트리 패널이 사용자가 더 세분화된 단위로 zone 에 drag drop 가능.
+  const sectionsRaw: any[] = normalized.data?.sections ?? [];
+  const normalizedContent: NormalizedContent = {
+    title: upload.data?.slide_title ?? runId,
+    sections: sectionsRaw.map((s: any, idx: number) => {
+      const sectionId = s.section_id ?? `section-${idx + 1}`;
+      const raw = s.raw_content ?? "";
+      // backend step02 의 raw_content 는 `##` 헤더 *없이* 본문만 들어있음.
+      // parseMdxText 가 ### 부터 인식할 수 있도록 가짜 root prefix 붙임.
+      const subParsed = parseMdxText(`## __ROOT__\n${raw}`);
+      const reSubSections: SectionContent[] =
+        subParsed.length > 0 && subParsed[0].sub_sections?.length
+          ? subParsed[0].sub_sections.map((sub, subIdx) => ({
+              ...sub,
+              id: `${sectionId}-sub-${subIdx + 1}`,
+              parentId: sectionId,
+            }))
+          : [];
+      // 본 section 의 content_objects = subParsed[0] 의 content_objects 또는 raw 통째.
+      const ownContentObjects =
+        subParsed.length > 0 && subParsed[0].content_objects.length > 0
+          ? subParsed[0].content_objects.map((co, i) => ({
+              ...co,
+              id: `co-${sectionId}-${i + 1}`,
+            }))
+          : [
+              {
+                id: `co-${sectionId}-1`,
+                type: "text_block" as const,
+                role: "detail" as const,
+                size_estimate: { line_count: raw.split("\n").length },
+                raw_payload: raw,
+              },
+            ];
+      return {
+        id: sectionId,
+        index: idx + 1,
+        level: 2,
+        title: s.title ?? "",
+        content_objects: ownContentObjects,
+        sub_sections: reSubSections,
+      };
+    }),
+  };
+
+  // ── SlidePlan ──
+  const layoutPreset = (layout.data?.layout_preset ?? "single") as LayoutPresetId;
+  const positions = computeZonePositions(layoutPreset);
+  const units: any[] = applicationPlan.data?.units ?? [];
+
+  const zones = units.map((unit: any, idx: number) => {
+    const posEntry = positions[idx] ?? {
+      name: `zone-${idx}`,
+      geometry: { x: 0, y: 0, width: 1, height: 1 },
+    };
+    const sectionIds: string[] = (unit.unit_id ?? "")
+      .split("+")
+      .filter((s: string) => s.length > 0);
+
+    // V4 score 상위 N 개를 카드로 표시 (사용자 lock 2026-05-08 — top 6).
+    // 2026-05-14 — 사용자 룰 : "reject 외 다른 label 있으면 reject 는 상단 X".
+    // sort 우선순위 = label (use_as_is > light_edit > restructure > reject) + confidence desc.
+    // 모두 reject 인 경우 confidence desc 만 적용 (사용자 명시).
+    const TOP_N_FRAMES = 6;
+    const LABEL_PRIORITY: Record<string, number> = {
+      use_as_is: 0,
+      light_edit: 1,
+      restructure: 2,
+      reject: 3,
+    };
+    // IMP-29 u2 — source priority (deterministic, no LLM):
+    //   1) unit.candidate_evidence (IMP-05 L2 canonical, 14 fields per entry)
+    //   2) unit.v4_all_judgments   (pre-IMP-05 audit array)
+    //   3) unit.v4_candidates      (legacy minimal)
+    // fallback_chain alias is intentionally NOT read (Stage 2 guardrail).
+    const candidateEvidence = Array.isArray(unit.candidate_evidence)
+      ? unit.candidate_evidence
+      : [];
+    const candidateMap = new Map<string, any>();
+    const pushCandidate = (c: any) => {
+      if (!c) return;
+      const key = c.template_id ?? c.id ?? c.frame_id;
+      if (!key) return;
+      if (!candidateMap.has(key)) candidateMap.set(key, c);
+    };
+    candidateEvidence.forEach(pushCandidate);
+    (unit.v4_all_judgments ?? []).forEach(pushCandidate);
+    (unit.v4_candidates ?? []).forEach(pushCandidate);
+    const rawSource = Array.from(candidateMap.values());
+    const v4Source = [...rawSource].sort((a: any, b: any) => {
+      const lp = (LABEL_PRIORITY[a.label] ?? 99) - (LABEL_PRIORITY[b.label] ?? 99);
+      if (lp !== 0) return lp;
+      return (b.confidence ?? 0) - (a.confidence ?? 0);
+    });
+    // ─── IMP-41 u4 — application_candidates enrichment (issue #70) ───────────
+    // Backend Step 9 emits `unit.application_candidates[]` (src/phase_z2_pipeline.py
+    // _application_candidates_for_unit, :3071-3092) one entry per v4 candidate with
+    // application_mode / auto_applicable / delegated_to derived from
+    // APPLICATION_MODE_BY_V4_LABEL (:107-112). Indexing delegated to the pure
+    // helper `mergeApplicationCandidates` (services/applicationMode.ts) keyed
+    // by template_id. Enrichment ONLY — does NOT alter candidate source
+    // priority, sorting, or TOP_N_FRAMES slicing.
+    const applicationModeMap = mergeApplicationCandidates(unit.application_candidates);
+    const frameCandidates: FrameCandidate[] = v4Source
+      .slice(0, TOP_N_FRAMES)
+      .map((c: any) => {
+        const appMatch = applicationModeMap.get(c.template_id);
+        return ({
+        id: c.template_id,
+        name: c.template_id,
+        score: c.confidence ?? 0,
+        confidence: classifyConfidence(c.confidence ?? 0),
+        label: (c.label ?? "use_as_is") as FrameCandidate["label"],
+        // data/figma_previews/{frame_number padded 2-digit}.png — 32 개 모두 존재.
+        thumbnailUrl:
+          c.frame_number != null
+            ? `/frame-preview/${String(c.frame_number).padStart(2, "0")}`
+            : undefined,
+        // backend step09 의 catalog_registered (frame_contracts.yaml 등록 여부).
+        // candidate_evidence 및 v4_all_judgments 에 있음. v4_candidates fallback 시 undefined.
+        catalogRegistered: c.catalog_registered,
+        // backend step09 의 min_height_px (frame_contracts.yaml visual_hints.min_height_px).
+        // logical 1280x720 px 좌표계. contract 미등록 또는 visual_hints 부재 시 undefined.
+        // v4_all_judgments 에만 있음. candidate_evidence / v4_candidates fallback 시 undefined (graceful).
+        minHeightPx: c.min_height_px ?? undefined,
+        // ─── IMP-05 L2 candidate_evidence fields (IMP-29 u2) ─────────────────
+        // Populated when source = unit.candidate_evidence; otherwise silently
+        // undefined for legacy fixtures (pre-IMP-05 fallback path).
+        rank: c.rank,
+        frameId: c.frame_id,
+        v4Label: c.v4_label,
+        phaseZStatus: c.phase_z_status,
+        filteredForDirectExecution: c.filtered_for_direct_execution,
+        routeHint: c.route_hint,
+        decision: c.decision,
+        reason: c.reason,
+        capacityFit: c.capacity_fit,
+        // ─── IMP-41 u2 — application_mode forwarding (issue #70) ───────────
+        // Source = unit.application_candidates[] indexed by template_id above.
+        // Optional fields — undefined when no matching application_candidate
+        // (legacy fixtures pre-IMP-32 or candidates filtered out at Step 9).
+        applicationMode: appMatch?.application_mode,
+        autoApplicable: appMatch?.auto_applicable,
+        delegatedTo: appMatch?.delegated_to ?? null,
+      });
+      });
+
+    const displayStrategy = (
+      runMeta.display_strategy_candidates_by_zone[posEntry.name]?.[0] ??
+      "inline_full"
+    ) as "inline_full" | "inline_preview_with_details" | "details_only" | "dropped";
+
+    const regionId =
+      runMeta.region_layout_candidates_by_zone[posEntry.name]?.[0] ??
+      "region-single";
+
+    return {
+      id: `zone-${unit.unit_id}`,
+      zone_id: posEntry.name,
+      section_ids: sectionIds,
+      position: posEntry.geometry,
+      internal_regions: [
+        {
+          id: `region-${unit.unit_id}-1`,
+          region_id: regionId,
+          role: "primary" as const,
+          content_type: "text_block" as const,
+          ratio_estimate: 1,
+          content_unit_ids: [],
+          frame_match_strategy: {
+            kind: "frame_match" as const,
+            frame_id: unit.current_default_candidate ?? null,
+            display_strategy: displayStrategy,
+          },
+          frame_candidates: frameCandidates,
+        },
+      ],
+      region_layout_type: regionId,
+    };
+  });
+
+  const slidePlan: SlidePlan = {
+    id: runId,
+    title: normalizedContent.title,
+    layout_preset: layoutPreset,
+    zones,
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+  };
+
+  return { normalizedContent, slidePlan, runMeta };
+}
+

Front/client/src/services/userOverridesApi.ts

@@ -0,0 +1,243 @@
+// IMP-52 u5 — typed frontend client for `/api/user-overrides/:key` (GET + PUT).
+//
+// The on-disk schema (KNOWN_AXES) and endpoint contract are owned by:
+//   • src/user_overrides_io.py            (Python — backend pipeline fallback, u1/u2)
+//   • Front/vite.config.ts (handleGet/PutUserOverrides, u3/u4)
+// This module is the typed view used by Home.tsx restore-on-reopen (u6) and
+// the four mutation handlers (u7). It does NOT own the schema — any change
+// to KNOWN_AXES must land in u1/u4 first, then reflect here.
+//
+// IMP-51 (#79) u3 — added `image_overrides` (5th axis). `image_id` → percent-
+// of-slide {x,y,w,h}. Mirrors src/user_overrides_io.py KNOWN_AXES (u1) and
+// Front/vite.config.ts KNOWN_USER_OVERRIDES_AXES (u2). Backend stamper +
+// render-time CSS injection ride on u4~u7; the SlideCanvas drag/resize
+// handles that drive this axis ride on u8~u11.
+//
+// Contract (Stage 2 unit u5 summary):
+//   • Typed `getUserOverrides(key)` → returns `Partial<UserOverrides>` from
+//     the GET endpoint. Missing / corrupt / non-object payloads degrade to
+//     `{}` so the frontend reopen flow never crashes on a fresh MDX.
+//   • Typed `saveUserOverrides(key, partial)` → schedules a 300ms-debounced
+//     PUT carrying ONLY the axes the user has mutated since the last flush.
+//     Per-axis coalescing: a later call overwrites the same axis in the
+//     pending payload; axes the user did not mutate are NOT sent (the
+//     server-side merge in u4 preserves them on disk).
+//   • Per-key debounce buckets — rapid edits to MDX "03" do not delay the
+//     flush for MDX "04".
+//   • Explicit clear sentinel: `partial[axis] = null` forwards to the PUT
+//     body verbatim so u4 `mergeUserOverrides` can `delete` the axis on disk.
+//   • `flushUserOverrides()` / `flushUserOverrides(key)` force an immediate
+//     PUT (used by tests + Home.tsx Generate flow to ensure outstanding
+//     writes commit before pipeline run).
+
+const ENDPOINT_BASE = "/api/user-overrides";
+const DEBOUNCE_MS = 300;
+
+// ── Schema (mirror of backend KNOWN_AXES; see header comment) ───────────────
+
+/** unit_id → template_id. unit_id = source_section_ids joined by "+". */
+export type FramesOverride = Record<string, string>;
+
+/** zone_id → 0-1 normalized geometry inside slide-body. */
+export type ZoneGeometryOverride = {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+};
+export type ZoneGeometriesOverride = Record<string, ZoneGeometryOverride>;
+
+/** zone_id → ordered list of section_ids assigned to that zone. */
+export type ZoneSectionsOverride = Record<string, string[]>;
+
+/**
+ * IMP-51 #79 u3 — image_id → percent-of-slide geometry. Matches the user-
+ * content image selector `.slide img[data-image-role="user-content"]`
+ * (stamper in u4) and the render-time CSS injection map (u7). Coordinates
+ * are slide-absolute percent (0–100) so SlideCanvas drag handles (u8~u11)
+ * map 1:1 with the persisted axis without per-zone transforms.
+ */
+export type ImageOverride = {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+};
+export type ImageOverridesOverride = Record<string, ImageOverride>;
+
+/** Full on-disk schema. All axes optional — file may carry any subset. */
+export interface UserOverrides {
+  layout: string;
+  frames: FramesOverride;
+  zone_geometries: ZoneGeometriesOverride;
+  zone_sections: ZoneSectionsOverride;
+  image_overrides: ImageOverridesOverride;
+}
+
+/** Partial-mutation payload. `null` is the explicit clear sentinel (mirrors u4). */
+export type UserOverridesPartial = {
+  [K in keyof UserOverrides]?: UserOverrides[K] | null;
+};
+
+// ── Per-key debounce buckets ────────────────────────────────────────────────
+
+type PendingBucket = {
+  partial: UserOverridesPartial;
+  timer: ReturnType<typeof setTimeout> | null;
+  waiters: Array<{
+    resolve: (merged: Partial<UserOverrides>) => void;
+    reject: (err: unknown) => void;
+  }>;
+};
+
+const buckets = new Map<string, PendingBucket>();
+
+function getBucket(key: string): PendingBucket {
+  let b = buckets.get(key);
+  if (!b) {
+    b = { partial: {}, timer: null, waiters: [] };
+    buckets.set(key, b);
+  }
+  return b;
+}
+
+// ── GET ─────────────────────────────────────────────────────────────────────
+
+/**
+ * Fetch the persisted user_overrides for `key` (MDX stem). Returns `{}` on
+ * any failure mode (network error, 4xx/5xx, non-object body) so the caller
+ * can use it unconditionally during MDX reopen without branching on
+ * error paths.
+ */
+export async function getUserOverrides(
+  key: string,
+): Promise<Partial<UserOverrides>> {
+  let res: Response;
+  try {
+    res = await fetch(`${ENDPOINT_BASE}/${encodeURIComponent(key)}`, {
+      method: "GET",
+      headers: { Accept: "application/json" },
+    });
+  } catch {
+    return {};
+  }
+  if (!res.ok) return {};
+
+  let parsed: unknown;
+  try {
+    parsed = await res.json();
+  } catch {
+    return {};
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return {};
+  }
+  return parsed as Partial<UserOverrides>;
+}
+
+// ── PUT (debounced) ─────────────────────────────────────────────────────────
+
+async function flushBucket(
+  key: string,
+  bucket: PendingBucket,
+): Promise<void> {
+  const payload = bucket.partial;
+  const waiters = bucket.waiters;
+  bucket.partial = {};
+  bucket.timer = null;
+  bucket.waiters = [];
+
+  let merged: Partial<UserOverrides> = {};
+  try {
+    const res = await fetch(`${ENDPOINT_BASE}/${encodeURIComponent(key)}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+    });
+    if (res.ok) {
+      try {
+        const parsed = (await res.json()) as unknown;
+        if (
+          typeof parsed === "object" &&
+          parsed !== null &&
+          !Array.isArray(parsed)
+        ) {
+          merged = parsed as Partial<UserOverrides>;
+        }
+      } catch {
+        // server returned 200 with non-JSON body → treat as empty merged
+      }
+    } else {
+      const err = new Error(`PUT ${ENDPOINT_BASE}/${key} → ${res.status}`);
+      waiters.forEach((w) => w.reject(err));
+      return;
+    }
+  } catch (err) {
+    waiters.forEach((w) => w.reject(err));
+    return;
+  }
+  waiters.forEach((w) => w.resolve(merged));
+}
+
+/**
+ * Schedule a debounced PUT to persist the mutated axes. Resolves with the
+ * server-side merged document when the debounced PUT eventually fires.
+ * Multiple rapid calls for the same `key` coalesce into a single PUT;
+ * a later call's value for a given axis overrides an earlier pending value.
+ * Calls for different `key`s are isolated.
+ */
+export function saveUserOverrides(
+  key: string,
+  partial: UserOverridesPartial,
+): Promise<Partial<UserOverrides>> {
+  const bucket = getBucket(key);
+  // Per-axis coalescing — later mutations replace earlier pending values.
+  for (const axis of Object.keys(partial) as Array<keyof UserOverridesPartial>) {
+    bucket.partial[axis] = partial[axis] as never;
+  }
+  const p = new Promise<Partial<UserOverrides>>((resolve, reject) => {
+    bucket.waiters.push({ resolve, reject });
+  });
+  if (bucket.timer !== null) clearTimeout(bucket.timer);
+  bucket.timer = setTimeout(() => {
+    void flushBucket(key, bucket);
+  }, DEBOUNCE_MS);
+  return p;
+}
+
+/**
+ * Force-flush pending debounced writes. With no arg, flushes ALL pending
+ * keys (used before pipeline runs so the backend reads the latest file).
+ * With a key, flushes only that key's bucket.
+ *
+ * Resolves after every flushed bucket's PUT completes. Per-bucket errors
+ * are swallowed at the flush level — the original caller's
+ * saveUserOverrides() promise still rejects to its owner via the waiter.
+ */
+export async function flushUserOverrides(key?: string): Promise<void> {
+  const targets: Array<[string, PendingBucket]> = [];
+  if (key !== undefined) {
+    const b = buckets.get(key);
+    if (b && b.timer !== null) targets.push([key, b]);
+  } else {
+    buckets.forEach((b, k) => {
+      if (b.timer !== null) targets.push([k, b]);
+    });
+  }
+  const flushPromises = targets.map(([k, b]) => {
+    if (b.timer !== null) {
+      clearTimeout(b.timer);
+      b.timer = null;
+    }
+    return flushBucket(k, b);
+  });
+  await Promise.all(flushPromises);
+}
+
+/** Test-only — clears all pending buckets without firing PUTs. */
+export function __resetUserOverridesBuckets_FOR_TEST(): void {
+  buckets.forEach((b) => {
+    if (b.timer !== null) clearTimeout(b.timer);
+  });
+  buckets.clear();
+}

Front/client/src/types/designAgent.ts

@@ -0,0 +1,226 @@
+/**
+ * Design Agent - Type Definitions (Phase Z Compliance)
+ * 
+ * 이 타입 정의는 백엔드 파이프라인(Phase Z)의 아키텍처 위계를 반영합니다.
+ * Slide → Zone → Internal Region → Frame → Frame Slot → Content
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 1. Content Objects (Step 3)
+// ─────────────────────────────────────────────────────────────────────────────
+
+export type ContentObjectType = 'text_block' | 'table' | 'image' | 'diagram' | 'details' | 'transform_table';
+export type ContentObjectRole = 'summary' | 'detail' | 'decorative' | 'reference';
+
+/** MDX에서 추출된 최소 의미 단위 객체 */
+export interface ContentObject {
+  id: string;
+  type: ContentObjectType;
+  role: ContentObjectRole;
+  size_estimate: {
+    line_count?: number;
+    rows?: number;
+    aspect_ratio?: number;
+  };
+  raw_payload: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 2. MDX Normalized Model (Step 2)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** MDX 전체 구조 */
+export interface NormalizedContent {
+  title: string;
+  sections: SectionContent[];
+}
+
+/** MDX 섹션 (계층 구조 반영). 중목차 (##) 가 root, 소목차 (###) 는 sub_sections 안. */
+export interface SectionContent {
+  id: string;
+  index: number;
+  level: number; // #=1, ##=2, ###=3
+  title: string;
+  content_objects: ContentObject[];
+  parentId?: string;          // 계층 구조 표현용 (소목차 의 경우 중목차 id)
+  sub_sections?: SectionContent[];  // 중목차 의 경우 소목차 list (level 3+)
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 3. Slide & Zone Model (Step 6~8)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 8가지 레이아웃 보캡(Vocabulary) */
+export type LayoutPresetId = 
+  | 'single' 
+  | 'horizontal-2' 
+  | 'vertical-2' 
+  | 'top-1-bottom-2' 
+  | 'top-2-bottom-1' 
+  | 'left-1-right-2' 
+  | 'left-2-right-1' 
+  | 'grid-2x2';
+
+export interface LayoutCandidate {
+  id: string;
+  name: string;
+  type: 'full' | 'left-right' | 'three-col' | 'asymmetric' | 'top-bottom' | 'grid' | 'list';
+  description: string;
+}
+
+export interface SlidePlan {
+  id: string;
+  title: string;
+  layout_preset: LayoutPresetId;
+  zones: Zone[];
+  updatedAt?: string;
+  createdAt?: string;
+}
+
+/** 슬라이드 내 구역 */
+export interface Zone {
+  id: string;
+  zone_id: string; // top, bottom, left, right 등
+  section_ids: string[]; // 이 Zone에 할당된 섹션들
+  position: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+  internal_regions: InternalRegion[];
+  region_layout_type?: string; // vertical-stack, horizontal-split 등
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 4. Internal Region & Frame (Step 4, 9, 11)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Zone 내부의 세부 영역 (Layer A) */
+export interface InternalRegion {
+  id: string;
+  region_id: string;
+  role: 'primary' | 'secondary' | 'supporting' | 'reference';
+  content_type: ContentObjectType | 'mixed';
+  ratio_estimate: number;
+  content_unit_ids: string[];
+  
+  /** 매칭된 프레임 또는 표시 전략 */
+  frame_match_strategy: {
+    kind: 'frame_match' | 'display_only';
+    frame_id: string | null;
+    display_strategy: 'inline_full' | 'inline_preview_with_details' | 'details_only' | 'dropped';
+  };
+  
+  /** Top-K 프레임 후보 (Top-3 제안용) */
+  frame_candidates: FrameCandidate[];
+}
+
+/** IMP-05 L2 candidate_evidence.capacity_fit — backend capacity vs. content shape audit.
+ *  Source = src/phase_z2_pipeline.py compute_capacity_fit(). All fields optional —
+ *  frontend tolerates absence for pre-IMP-05 fixtures and contract-less templates. */
+export interface CapacityFitEvidence {
+  item_count?: number | null;
+  source_shape?: string | null;
+  capacity?: {
+    strict?: number | null;
+    min?: number | null;
+    max?: number | null;
+    truncate_at?: number | null;
+    pad_to?: number | null;
+  } | null;
+  fit_status?: string | null;
+  mismatch_reason?: string | null;
+}
+
+/** 프레임 후보 (V4 매칭 결과) */
+export interface FrameCandidate {
+  id: string;
+  name: string;
+  score: number;
+  confidence: 'high' | 'medium' | 'low';
+  thumbnailUrl?: string;
+  label: 'use_as_is' | 'light_edit' | 'restructure' | 'reject';
+  /** backend frame_contracts.yaml 에 catalog 등록 여부. false 면 사용자가 override
+   *  시도해도 Step 7-A 가 skip (render path 미연결). UI 회색 + "render path 미적용" 표시. */
+  catalogRegistered?: boolean;
+  /** IMP-11 D-2 — frame contract visual_hints.min_height_px (logical 1280x720 px).
+   *  Source = templates/phase_z2/catalog/frame_contracts.yaml visual_hints.min_height_px.
+   *  Undefined when contract unregistered or visual_hints absent (frontend tolerates undefined). */
+  minHeightPx?: number;
+
+  // ─── IMP-05 L2 candidate_evidence fields (IMP-29 u1) ───────────────────────
+  // Source = src/phase_z2_pipeline.py lookup_v4_match_with_fallback() candidate_trace.
+  // All fields optional — pre-IMP-05 fixtures fall back to v4_all_judgments/v4_candidates
+  // (deterministic, no LLM) and silently leave these undefined.
+
+  /** Candidate rank in V4 chain (1-based; 1 = primary). */
+  rank?: number;
+  /** Figma frame node id (backend `frame_id`). Distinct from `id` (= template_id). */
+  frameId?: string;
+  /** Alias of `label`. Kept separate for Codex IMP-05 L2 schema parity. */
+  v4Label?: 'use_as_is' | 'light_edit' | 'restructure' | 'reject';
+  /** Phase Z status enum (e.g. "auto_renderable", "fallback_candidate"). Open vocabulary. */
+  phaseZStatus?: string;
+  /** True when status is outside MVP1_ALLOWED_STATUSES (= excluded from direct render path). */
+  filteredForDirectExecution?: boolean;
+  /** Execution route mapped from `label` (direct_render / deterministic_minor_adjustment /
+   *  ai_adaptation_required / design_reference_only). Null on unknown labels. */
+  routeHint?: 'direct_render' | 'deterministic_minor_adjustment' | 'ai_adaptation_required' | 'design_reference_only' | null;
+  /** Selection outcome ("selected" or "skipped"). */
+  decision?: 'selected' | 'skipped';
+  /** Human-readable rationale (e.g. "primary_selected", "fallback_selected",
+   *  "duplicate_template_id", "skipped_no_contract", "capacity_mismatch:...",
+   *  "phase_z_status_not_allowed:..."). */
+  reason?: string | null;
+  /** Capacity vs. content shape audit (compute_capacity_fit output). */
+  capacityFit?: CapacityFitEvidence | null;
+
+  // ─── IMP-41 application_mode forwarding (issue #70 u1) ─────────────────────
+  // Source = src/phase_z2_pipeline.py APPLICATION_MODE_BY_V4_LABEL (:107-112),
+  // emitted by _application_candidates_for_unit() into Step 9
+  // unit.application_candidates[]. Optional — legacy fixtures pre-IMP-32 omit
+  // these and the FramePanel tooltip falls back to the raw V4 label.
+
+  /** Application mode mapped from V4 label by backend (authoritative). */
+  applicationMode?: 'direct_insert' | 'same_frame_with_adjustment' | 'layout_or_region_change' | 'exclude';
+  /** True when backend marks the candidate as automatically applicable. */
+  autoApplicable?: boolean;
+  /** Delegation target step / actor (e.g. "step10_contract_check", "human_review"). */
+  delegatedTo?: string | null;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 5. App State & Selection
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface UserSelection {
+  selectedSectionId: string | null;
+  selectedZoneId: string | null;
+  selectedRegionId: string | null;
+  
+  /** 수동 변경 저장 */
+  overrides: {
+    layout_preset?: LayoutPresetId;
+    zone_frames: Record<string, string>; // regionId -> frameId
+    zone_sections: Record<string, string[]>; // zoneId -> sectionIds[]
+    zone_sizes: Record<string, number[]>; // layoutGroupId -> [size1, size2, ...]
+    zone_geometries: Record<string, { x: number; y: number; w: number; h: number }>; // zone_id -> geometry
+    // IMP-51 (#79) u11 — image_id → slide-absolute percent geometry (0–100
+    // on each axis). image_id is stamped by `src/image_id_stamper.py` (u4)
+    // on user-content `<img>` tags; the same key is consumed by the u7 CSS
+    // injector and the SlideCanvas u8 overlay. Shape mirrors the on-disk
+    // `image_overrides` axis (KNOWN_AXES, src/user_overrides_io.py u1) and
+    // the typed-client `ImageOverridesOverride` (services/userOverridesApi.ts u3).
+    image_overrides: Record<string, { x: number; y: number; w: number; h: number }>;
+  };
+}
+
+export interface DesignAgentState {
+  uploadedFile: File | null;
+  normalizedContent: NormalizedContent | null;
+  slidePlan: SlidePlan | null;
+  userSelection: UserSelection;
+  isLoading: boolean;
+  error: string | null;
+}

Front/client/src/utils/slidePlanUtils.ts

@@ -0,0 +1,322 @@
+import type { UserSelection, SlidePlan, Zone, InternalRegion, LayoutPresetId } from "../types/designAgent";
+import type { UserOverrides } from "../services/userOverridesApi";
+
+// ─── IMP-52 u6 — restore-on-reopen helpers (pure, exported for testing) ────
+// These helpers compose persisted `user_overrides.json` payloads (typed by
+// the u5 service) onto the in-memory `UserSelection`. They live here rather
+// than inline in Home.tsx so vitest can drive them in a node environment
+// without booting React or pulling in the radix-ui / lucide UI deps that
+// Home.tsx requires. Home.tsx wires these into:
+//   • handleFileUpload (pre-Generate layout / zone_geometries / zone_sections
+//     seed so handleGenerate's CLI-args build picks them up)
+//   • handleGenerate post-loadRun (frame remap unit_id → region.id over the
+//     freshly built slidePlan)
+// The on-disk schema and clear-sentinel semantics are owned by:
+//   • src/user_overrides_io.py (KNOWN_AXES, u1)
+//   • Front/vite.config.ts mergeUserOverrides (u4)
+//   • Front/client/src/services/userOverridesApi.ts (UserOverrides type, u5)
+// Any KNOWN_AXES drift must land in those files first.
+
+/**
+ * Derive the `/api/user-overrides/:key` MDX-stem key from a filename.
+ * Strips a trailing `.mdx` (case-insensitive). The key matches the Python
+ * `Path(args.mdx_path).stem` derivation used by the backend fallback (u2),
+ * so the same persisted file is read from both ends without translation.
+ */
+export function deriveUserOverridesKey(filename: string): string {
+  return filename.replace(/\.mdx$/i, "");
+}
+
+const LAYOUT_PRESET_IDS = new Set<string>([
+  "single",
+  "horizontal-2",
+  "vertical-2",
+  "top-1-bottom-2",
+  "top-2-bottom-1",
+  "left-1-right-2",
+  "left-2-right-1",
+  "grid-2x2",
+]);
+
+/**
+ * Layer the three non-frame axes from a persisted `user_overrides.json`
+ * payload onto an existing `UserSelection`. Foreign / unrecognized payload
+ * shapes are silently ignored — the u5 GET path already returns `{}` on
+ * corrupt files, but we revalidate here so hand-edited files or future
+ * forward-compat axes cannot poison the in-memory state.
+ *
+ * Frames are NOT layered here because the on-disk key (`unit_id` =
+ * section_ids joined by `+`) only resolves after the slidePlan zones are
+ * known. Use `remapPersistedFramesToZoneFrames` in the post-loadRun step.
+ */
+export function applyPersistedNonFrameOverrides(
+  selection: UserSelection,
+  persisted: Partial<UserOverrides> | null | undefined,
+): UserSelection {
+  if (!persisted || typeof persisted !== "object") return selection;
+  const next = { ...selection.overrides };
+  if (typeof persisted.layout === "string" && LAYOUT_PRESET_IDS.has(persisted.layout)) {
+    next.layout_preset = persisted.layout as LayoutPresetId;
+  }
+  if (
+    persisted.zone_geometries &&
+    typeof persisted.zone_geometries === "object" &&
+    !Array.isArray(persisted.zone_geometries)
+  ) {
+    next.zone_geometries = { ...persisted.zone_geometries };
+  }
+  if (
+    persisted.zone_sections &&
+    typeof persisted.zone_sections === "object" &&
+    !Array.isArray(persisted.zone_sections)
+  ) {
+    next.zone_sections = { ...persisted.zone_sections };
+  }
+  // IMP-51 (#79) u11 — layer the 5th persisted axis (`image_overrides`) by
+  // the same array / non-object guard the zone_geometries branch uses. The
+  // u3 typed client (services/userOverridesApi.ts) shape and the on-disk
+  // KNOWN_AXES entry (src/user_overrides_io.py u1) are both flat dicts
+  // (image_id → {x,y,w,h} percent-of-slide), so a shallow copy is enough.
+  if (
+    persisted.image_overrides &&
+    typeof persisted.image_overrides === "object" &&
+    !Array.isArray(persisted.image_overrides)
+  ) {
+    next.image_overrides = { ...persisted.image_overrides };
+  }
+  return { ...selection, overrides: next };
+}
+
+/**
+ * Remap persisted frames (`unit_id` → template_id) to the in-memory
+ * `zone_frames` (region.id → template_id) using the freshly built
+ * slidePlan zones. `unit_id` follows handleGenerate's convention:
+ * `zone.section_ids.join("+")`. Persisted entries whose unit_id no longer
+ * matches any zone (e.g. user changed zone_sections between sessions) are
+ * silently dropped.
+ */
+export function remapPersistedFramesToZoneFrames(
+  slidePlan: SlidePlan | null | undefined,
+  framesByUnitId: Record<string, string> | null | undefined,
+): Record<string, string> {
+  if (!slidePlan || !framesByUnitId || typeof framesByUnitId !== "object") {
+    return {};
+  }
+  const out: Record<string, string> = {};
+  for (const zone of slidePlan.zones) {
+    const region = zone.internal_regions[0];
+    if (!region) continue;
+    if (!Array.isArray(zone.section_ids) || zone.section_ids.length === 0) continue;
+    const unitId = zone.section_ids.join("+");
+    const templateId = framesByUnitId[unitId];
+    if (typeof templateId === "string" && templateId.length > 0) {
+      out[region.id] = templateId;
+    }
+  }
+  return out;
+}
+
+/**
+ * Phase Z 초기 선택 상태 생성
+ * SlidePlan의 결과를 초기 값으로 사용 (Step 11까지의 결과 반영)
+ */
+export function createInitialUserSelection(slidePlan?: SlidePlan | null): UserSelection {
+  const initialSections: Record<string, string[]> = {};
+  const initialFrames: Record<string, string> = {};
+
+  if (slidePlan) {
+    slidePlan.zones.forEach(zone => {
+      // 1. 모든 섹션을 각자의 지정된 존에 할당 (초안 배치)
+      initialSections[zone.zone_id] = [...zone.section_ids];
+
+      // 2. 각 리전의 기본 frame.
+      // 2026-05-14 — backend frame_match_strategy.frame_id 가 있을 때만 init.
+      //   null 인 경우 (backend current_default_candidate=None 등) frame_candidates[0]
+      //   로 자동 채우지 않음 → SlideCanvas 의 preview overlay 트리거 조건
+      //   (override !== default) 안 발동. 사용자가 직접 frame 클릭해야 preview 보임.
+      //   배경 : 04-1 같은 case 에서 backend selection_path=rank_1 (env toggle 통과)
+      //   이어도 current_default=None 이면 default 와 override mismatch 로 preview 강제 발동.
+      zone.internal_regions.forEach(region => {
+        const topFrameId = region.frame_match_strategy.frame_id;
+        if (topFrameId) {
+          initialFrames[region.id] = topFrameId;
+        }
+      });
+    });
+  }
+
+  return {
+    selectedSectionId: null,
+    selectedZoneId: slidePlan?.zones[0]?.id || null,
+    selectedRegionId: slidePlan?.zones[0]?.internal_regions[0]?.id || null,
+    overrides: {
+      layout_preset: slidePlan?.layout_preset,
+      zone_frames: initialFrames,
+      zone_sections: initialSections,
+      zone_sizes: {},
+      zone_geometries: {},
+      // IMP-51 (#79) u11 — image_overrides axis starts empty; entries land
+      // here via `saveImageOverride` (SlideCanvas drag/resize handler) and
+      // are seeded on reopen via `applyPersistedNonFrameOverrides`.
+      image_overrides: {},
+    },
+  };
+}
+
+export function saveZoneGeometry(
+  selection: UserSelection,
+  zoneId: string,
+  geometry: { x: number; y: number; w: number; h: number }
+): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      zone_geometries: {
+        ...selection.overrides.zone_geometries,
+        [zoneId]: geometry,
+      }
+    }
+  };
+}
+
+/**
+ * IMP-51 (#79) u11 — record a single `image_id` → slide-absolute percent
+ * geometry on the in-memory selection. Mirrors `saveZoneGeometry` but on
+ * the 5th persisted axis (`image_overrides`); the SlideCanvas drag/resize
+ * handler (u8) emits one entry per pointer move, and u10's Home wiring
+ * funnels each emit through this helper before scheduling the debounced
+ * PUT. Pure / immutable — returns a fresh `UserSelection`; the input is
+ * never mutated. Existing entries for the same `imageId` are replaced.
+ */
+export function saveImageOverride(
+  selection: UserSelection,
+  imageId: string,
+  geometry: { x: number; y: number; w: number; h: number },
+): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      image_overrides: {
+        ...selection.overrides.image_overrides,
+        [imageId]: geometry,
+      },
+    },
+  };
+}
+
+export function saveZoneSizes(selection: UserSelection, groupId: string, sizes: number[]): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      zone_sizes: {
+        ...selection.overrides.zone_sizes,
+        [groupId]: sizes,
+      }
+    }
+  };
+}
+
+/**
+ * 특정 섹션을 새로운 존으로 이동 (Drag & Drop)
+ */
+export function moveSectionToZone(
+  selection: UserSelection, 
+  sectionId: string, 
+  targetZoneId: string
+): UserSelection {
+  const newZoneSections = { ...selection.overrides.zone_sections };
+  
+  // 1. 모든 존에서 해당 섹션 제거 (이동 전 위치 클리어)
+  Object.keys(newZoneSections).forEach(zid => {
+    newZoneSections[zid] = newZoneSections[zid].filter(id => id !== sectionId);
+  });
+
+  // 2. 타겟 존에 섹션 추가
+  if (!newZoneSections[targetZoneId]) {
+    newZoneSections[targetZoneId] = [];
+  }
+  if (!newZoneSections[targetZoneId].includes(sectionId)) {
+    newZoneSections[targetZoneId].push(sectionId);
+  }
+
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      zone_sections: newZoneSections
+    }
+  };
+}
+
+export function selectZone(selection: UserSelection, zoneId: string | null): UserSelection {
+  return {
+    ...selection,
+    selectedZoneId: zoneId,
+    selectedRegionId: null, // Zone이 바뀌면 Region 선택 해제
+  };
+}
+
+export function selectRegion(selection: UserSelection, regionId: string | null): UserSelection {
+  return {
+    ...selection,
+    selectedRegionId: regionId,
+  };
+}
+
+export function applyLayout(selection: UserSelection, layoutId: LayoutPresetId): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      layout_preset: layoutId,
+    },
+  };
+}
+
+export function applyFrame(selection: UserSelection, regionId: string, frameId: string): UserSelection {
+  return {
+    ...selection,
+    overrides: {
+      ...selection.overrides,
+      zone_frames: {
+        ...selection.overrides.zone_frames,
+        [regionId]: frameId,
+      },
+    },
+  };
+}
+
+/**
+ * 현재 선택된 Zone 객체 반환
+ */
+export function getSelectedZone(slidePlan: SlidePlan | null, selection: UserSelection): Zone | null {
+  if (!slidePlan || !selection.selectedZoneId) return null;
+  // id 또는 zone_id 매칭
+  return slidePlan.zones.find(z => z.id === selection.selectedZoneId || z.zone_id === selection.selectedZoneId) || null;
+}
+
+/**
+ * 현재 선택된 Region 객체 반환
+ */
+export function getSelectedRegion(zone: Zone | null, selection: UserSelection): InternalRegion | null {
+  if (!zone || !selection.selectedRegionId) return null;
+  return zone.internal_regions.find(r => r.id === selection.selectedRegionId) || null;
+}
+
+/**
+ * 특정 Zone에 할당된 섹션 ID 목록 반환 (오버라이드 우선)
+ */
+export function getSectionsForZone(zone: Zone, selection: UserSelection): string[] {
+  return selection.overrides.zone_sections[zone.zone_id] || zone.section_ids;
+}
+
+/**
+ * 최종 유효 레이아웃 ID 반환
+ */
+export function getEffectiveLayoutId(slidePlan: SlidePlan | null, selection: UserSelection): LayoutPresetId {
+  if (selection.overrides.layout_preset) return selection.overrides.layout_preset;
+  return slidePlan?.layout_preset || 'single';
+}

Front/client/tests/imp41_application_mode.test.ts

@@ -0,0 +1,123 @@
+// IMP-41 u3 — Vitest coverage for application_mode helper (issue #70).
+//
+// Scope (Stage 2 unit u3 contract):
+//   1) buildBadgeTitle: composite output for each known mode + legacy fallback
+//      (undefined applicationMode) + unknown fallback (string not in
+//      APPLICATION_MODE_TOOLTIP_KR).
+//   2) mergeApplicationCandidates: array → Map<template_id, candidate>
+//      semantics, including skip-missing-key and empty-input.
+//
+// Pure helper unit test — no React, no DOM, no fetch. Aligns with the
+// AI-isolation contract: assertions key by backend application_mode VALUE,
+// never by V4 label.
+
+import { describe, it, expect } from "vitest";
+import {
+  buildBadgeTitle,
+  mergeApplicationCandidates,
+  APPLICATION_MODE_TOOLTIP_KR,
+} from "../src/services/applicationMode";
+
+describe("buildBadgeTitle (IMP-41 u3)", () => {
+  it("returns composite '<consequence> (<mode>)' for direct_insert", () => {
+    expect(buildBadgeTitle("use_as_is", "direct_insert")).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.direct_insert} (direct_insert)`,
+    );
+  });
+
+  it("returns composite output for same_frame_with_adjustment", () => {
+    expect(
+      buildBadgeTitle("light_edit", "same_frame_with_adjustment"),
+    ).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.same_frame_with_adjustment} (same_frame_with_adjustment)`,
+    );
+  });
+
+  it("returns composite output for layout_or_region_change", () => {
+    expect(
+      buildBadgeTitle("restructure", "layout_or_region_change"),
+    ).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.layout_or_region_change} (layout_or_region_change)`,
+    );
+  });
+
+  it("returns composite output for exclude", () => {
+    expect(buildBadgeTitle("reject", "exclude")).toBe(
+      `${APPLICATION_MODE_TOOLTIP_KR.exclude} (exclude)`,
+    );
+  });
+
+  it("falls back to 'V4 label: <label>' when applicationMode is undefined (legacy fixtures pre-IMP-32)", () => {
+    expect(buildBadgeTitle("use_as_is", undefined)).toBe("V4 label: use_as_is");
+  });
+
+  it("falls back to 'V4 label: <label>' when applicationMode is an unknown string", () => {
+    expect(buildBadgeTitle("light_edit", "some_future_mode")).toBe(
+      "V4 label: light_edit",
+    );
+  });
+});
+
+describe("mergeApplicationCandidates (IMP-41 u3)", () => {
+  it("returns empty Map when input is undefined", () => {
+    const result = mergeApplicationCandidates(undefined);
+    expect(result).toBeInstanceOf(Map);
+    expect(result.size).toBe(0);
+  });
+
+  it("returns empty Map when input is null", () => {
+    const result = mergeApplicationCandidates(null);
+    expect(result.size).toBe(0);
+  });
+
+  it("returns empty Map when input is not an array", () => {
+    expect(mergeApplicationCandidates({ template_id: "f01" }).size).toBe(0);
+    expect(mergeApplicationCandidates("f01").size).toBe(0);
+    expect(mergeApplicationCandidates(42).size).toBe(0);
+  });
+
+  it("returns empty Map when input is an empty array", () => {
+    expect(mergeApplicationCandidates([]).size).toBe(0);
+  });
+
+  it("keys entries by template_id and preserves the candidate payload", () => {
+    const ac1 = {
+      template_id: "f01",
+      label: "use_as_is",
+      application_mode: "direct_insert",
+      auto_applicable: true,
+      delegated_to: null,
+    };
+    const ac2 = {
+      template_id: "f17",
+      label: "light_edit",
+      application_mode: "same_frame_with_adjustment",
+      auto_applicable: false,
+      delegated_to: "step10_contract_check",
+    };
+    const result = mergeApplicationCandidates([ac1, ac2]);
+    expect(result.size).toBe(2);
+    expect(result.get("f01")).toBe(ac1);
+    expect(result.get("f17")).toBe(ac2);
+  });
+
+  it("skips entries with missing or non-string template_id", () => {
+    const result = mergeApplicationCandidates([
+      { label: "use_as_is" }, // missing template_id
+      { template_id: "", label: "light_edit" }, // empty string
+      { template_id: 17, label: "restructure" }, // non-string
+      { template_id: "f29", label: "reject" }, // valid
+    ]);
+    expect(result.size).toBe(1);
+    expect(result.has("f29")).toBe(true);
+    expect(result.has("")).toBe(false);
+  });
+
+  it("keeps the first occurrence on duplicate template_id keys (deterministic)", () => {
+    const first = { template_id: "f01", label: "use_as_is" };
+    const second = { template_id: "f01", label: "reject" };
+    const result = mergeApplicationCandidates([first, second]);
+    expect(result.size).toBe(1);
+    expect(result.get("f01")).toBe(first);
+  });
+});

Front/client/tests/imp47b_human_review_toast.test.tsx

@@ -0,0 +1,135 @@
+// IMP-47B u11 — Frontend ai_repair_status notification surfacing.
+//
+// Scope (Stage 2 unit u11 contract):
+//   1) loadRun → RunMeta.ai_repair_status exposes the u8 step20 payload.
+//   2) formatAiRepairHumanReviewMessage(...) returns user-facing notification
+//      text on the three failure axes (error / coverage_violated /
+//      unsupported_kind) and returns null on success / no-AI paths.
+//
+// Pure-function unit test (no React Testing Library required — vitest is
+// already in devDependencies; @testing-library/* is NOT installed). The
+// Home.tsx wiring is a 2-line site that calls this helper after
+// setRunMeta(...); covering the helper covers the user-visible message text
+// directly without DOM rendering.
+//
+// File extension is `.tsx` per Stage 2 unit contract path; no JSX is required
+// for these assertions but the extension allows future RTL-based tests to
+// land here without renaming.
+
+import { describe, it, expect } from "vitest";
+import {
+  formatAiRepairHumanReviewMessage,
+  type AiRepairStatus,
+} from "../src/services/designAgentApi";
+
+const baseCounts = {
+  total: 1,
+  applied: 0,
+  no_proposal: 0,
+  no_zone_match: 0,
+  unsupported_kind: 0,
+  error: 0,
+};
+
+describe("formatAiRepairHumanReviewMessage (IMP-47B u11)", () => {
+  it("returns null when ai_repair_status is null (legacy / pre-Step12 abort)", () => {
+    expect(formatAiRepairHumanReviewMessage(null)).toBeNull();
+    expect(formatAiRepairHumanReviewMessage(undefined)).toBeNull();
+  });
+
+  it("returns null when human_review_required=false (success / no-AI path)", () => {
+    const ok: AiRepairStatus = {
+      status: "ok",
+      counts: { ...baseCounts, total: 0 },
+      unsupported_kind_records: [],
+      error_records: [],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: false,
+    };
+    expect(formatAiRepairHumanReviewMessage(ok)).toBeNull();
+
+    const applied: AiRepairStatus = {
+      ...ok,
+      status: "applied",
+      counts: { ...baseCounts, total: 1, applied: 1 },
+    };
+    expect(formatAiRepairHumanReviewMessage(applied)).toBeNull();
+  });
+
+  it("surfaces AI call failures with count + frame/manual guidance", () => {
+    const errored: AiRepairStatus = {
+      status: "error",
+      counts: { ...baseCounts, total: 2, error: 2 },
+      unsupported_kind_records: [],
+      error_records: [
+        { unit_index: 0, source_section_ids: ["03-1"], error: "timeout" },
+        { unit_index: 1, source_section_ids: ["03-2"], error: "validation" },
+      ],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(errored);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("AI 재구성 호출 실패");
+    expect(msg).toContain("2");
+    expect(msg).toContain("다른 frame 선택 또는 수동 편집 필요");
+  });
+
+  it("surfaces coverage violations with the dropped section ids", () => {
+    const dropped: AiRepairStatus = {
+      status: "coverage_violated",
+      counts: { ...baseCounts, total: 1, applied: 1 },
+      unsupported_kind_records: [],
+      error_records: [],
+      coverage_status: "violated",
+      dropped_section_ids: ["03-2"],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(dropped);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("콘텐츠 누락");
+    expect(msg).toContain("03-2");
+    expect(msg).toContain("다른 frame 선택 또는 수동 편집 필요");
+  });
+
+  it("surfaces unsupported proposal kinds with the unsupported count", () => {
+    const unsupported: AiRepairStatus = {
+      status: "unsupported_kind",
+      counts: { ...baseCounts, total: 1, unsupported_kind: 1 },
+      unsupported_kind_records: [
+        {
+          unit_index: 0,
+          source_section_ids: ["03-1"],
+          apply_status: "unsupported_kind_for_reject_route:builder_options_patch",
+        },
+      ],
+      error_records: [],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(unsupported);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("AI 제안 형식 미지원");
+    expect(msg).toContain("1");
+    expect(msg).toContain("다른 frame 선택 또는 수동 편집 필요");
+  });
+
+  it("falls back to a generic human_review message on unknown status enums", () => {
+    const future: AiRepairStatus = {
+      status: "future_axis_not_yet_mapped",
+      counts: { ...baseCounts, total: 0 },
+      unsupported_kind_records: [],
+      error_records: [],
+      coverage_status: "ok",
+      dropped_section_ids: [],
+      human_review_required: true,
+    };
+    const msg = formatAiRepairHumanReviewMessage(future);
+    expect(msg).not.toBeNull();
+    expect(msg).toContain("human_review");
+    expect(msg).toContain("future_axis_not_yet_mapped");
+  });
+});

Front/client/tests/user_overrides_endpoint.test.ts

@@ -0,0 +1,809 @@
+// IMP-52 u3/u4 — vitest coverage for the vite `/api/user-overrides/:key`
+// GET and PUT endpoints and their supporting helpers.
+//
+// Scope:
+//   u3 (read path):
+//     1) isValidUserOverridesKey: accept MDX-stem keys (03, 03__DX_BIM,
+//        a-b.c), reject empty / leading-dot / `..` / `/` / `\` /
+//        disallowed chars. Mirrors src/user_overrides_io.validate_key so
+//        backend (u2) and frontend endpoint (u3) agree on every key.
+//     2) userOverridesPath: returns <root>/data/user_overrides/<key>.json.
+//     3) handleGetUserOverrides: method != GET → false (next chained for
+//        PUT); invalid key → 400; missing file → 200 {}; corrupt JSON /
+//        non-object root → 200 {} (graceful degrade per u1 load contract);
+//        valid object JSON → 200 with parsed payload echoed back.
+//
+//   u4 (write path):
+//     4) mergeUserOverrides: only KNOWN_USER_OVERRIDES_AXES mutated;
+//        foreign top-level keys preserved; null clears axis; non-axis
+//        partial keys dropped (allowlist).
+//     5) atomicWriteUserOverrides: tmp + rename; parent dir auto-created.
+//     6) handlePutUserOverrides: method != PUT → false (next chained);
+//        invalid key → 400; invalid JSON → 400; non-object body → 400;
+//        success → 200 with merged result; partial-merge preserves axes
+//        not in payload; foreign-key preserve on disk; allowlist drops
+//        unknown payload keys; explicit null clears; corrupt existing →
+//        recover to clean state.
+//
+// Tests exercise the pure handlers with mock req/res — no real vite server.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import {
+  KNOWN_USER_OVERRIDES_AXES,
+  USER_OVERRIDES_KEY_RE,
+  atomicWriteUserOverrides,
+  handleGetUserOverrides,
+  handlePutUserOverrides,
+  isValidUserOverridesKey,
+  mergeUserOverrides,
+  userOverridesPath,
+} from "../../vite.config";
+
+// ---------------------------------------------------------------------------
+// mock res helper — captures writeHead(status, headers) + end(body) so the
+// handler can be invoked synchronously without spawning a TCP socket.
+// ---------------------------------------------------------------------------
+function makeMockRes() {
+  const state = {
+    statusCode: 0,
+    headers: {} as Record<string, string>,
+    body: "",
+    ended: false,
+  };
+  return {
+    state,
+    res: {
+      writeHead(status: number, headers?: Record<string, string>) {
+        state.statusCode = status;
+        if (headers) state.headers = headers;
+      },
+      end(body?: string) {
+        state.body = body ?? "";
+        state.ended = true;
+      },
+    },
+  };
+}
+
+describe("USER_OVERRIDES_KEY_RE (IMP-52 u3)", () => {
+  it("matches Python validate_key regex literally", () => {
+    // The pattern locked in src/user_overrides_io.py:_KEY_RE — any drift here
+    // means backend pipeline fallback (u2) and the vite endpoint disagree on
+    // which keys are routable, which is the single failure mode that would
+    // silently lose persisted overrides.
+    expect(USER_OVERRIDES_KEY_RE.source).toBe(
+      "^[A-Za-z0-9_][A-Za-z0-9_.\\-]*$",
+    );
+  });
+});
+
+describe("isValidUserOverridesKey (IMP-52 u3)", () => {
+  it("accepts MDX-stem-style keys actually used in samples/mdx/", () => {
+    // 03 / 04 / 05 are the wired sample MDXs (vite.config.ts:SAMPLE_MDX_MAP).
+    expect(isValidUserOverridesKey("03")).toBe(true);
+    expect(isValidUserOverridesKey("04")).toBe(true);
+    expect(isValidUserOverridesKey("05")).toBe(true);
+    // Stage 1 EVIDENCE references 03__DX_BIM... — must round-trip.
+    expect(isValidUserOverridesKey("03__DX_BIM")).toBe(true);
+    expect(isValidUserOverridesKey("a-b.c")).toBe(true);
+    expect(isValidUserOverridesKey("a")).toBe(true);
+    expect(isValidUserOverridesKey("_leading_underscore")).toBe(true);
+    expect(isValidUserOverridesKey("9starts_with_digit")).toBe(true);
+  });
+
+  it("rejects empty and whitespace-only keys", () => {
+    expect(isValidUserOverridesKey("")).toBe(false);
+  });
+
+  it("rejects path-traversal substrings", () => {
+    // `..` rejected explicitly even if the rest of the regex would allow it
+    // — `a..b` would otherwise pass the char class.
+    expect(isValidUserOverridesKey("..")).toBe(false);
+    expect(isValidUserOverridesKey("a..b")).toBe(false);
+    expect(isValidUserOverridesKey("../escape")).toBe(false);
+  });
+
+  it("rejects path separators", () => {
+    expect(isValidUserOverridesKey("a/b")).toBe(false);
+    expect(isValidUserOverridesKey("a\\b")).toBe(false);
+    expect(isValidUserOverridesKey("/")).toBe(false);
+    expect(isValidUserOverridesKey("\\")).toBe(false);
+  });
+
+  it("rejects keys starting with a non-word character", () => {
+    expect(isValidUserOverridesKey(".hidden")).toBe(false);
+    expect(isValidUserOverridesKey("-leading-dash")).toBe(false);
+  });
+
+  it("rejects characters outside [A-Za-z0-9_.-]", () => {
+    expect(isValidUserOverridesKey("a b")).toBe(false);
+    expect(isValidUserOverridesKey("a:b")).toBe(false);
+    expect(isValidUserOverridesKey("a*b")).toBe(false);
+    expect(isValidUserOverridesKey("a%2Fb")).toBe(false);
+  });
+});
+
+describe("userOverridesPath (IMP-52 u3)", () => {
+  it("resolves <root>/data/user_overrides/<key>.json regardless of OS sep", () => {
+    const root = path.join("X:", "design_agent");
+    const got = userOverridesPath(root, "03");
+    expect(got).toBe(path.join(root, "data", "user_overrides", "03.json"));
+  });
+});
+
+describe("handleGetUserOverrides (IMP-52 u3)", () => {
+  let tmpRoot: string;
+  let overridesDir: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u3-"));
+    overridesDir = path.join(tmpRoot, "data", "user_overrides");
+    fs.mkdirSync(overridesDir, { recursive: true });
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != GET", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "PUT", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(false);
+    // Crucial for u4: PUT must reach its own middleware unobstructed.
+    expect(state.ended).toBe(false);
+    expect(state.statusCode).toBe(0);
+  });
+
+  it("returns 400 on invalid key (path traversal)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/../escape" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid key" });
+  });
+
+  it("returns 400 on invalid key (missing key segment)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+  });
+
+  it("returns 200 {} on missing file (graceful degrade)", () => {
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+  });
+
+  it("returns 200 {} on corrupt JSON (graceful degrade)", () => {
+    fs.writeFileSync(path.join(overridesDir, "03.json"), "{not json", "utf-8");
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+  });
+
+  it("returns 200 {} when JSON root is not an object", () => {
+    // Mirrors u1 load() which treats non-object roots as corrupt — covers
+    // both arrays and primitives so the frontend never receives a shape
+    // the typed service (u5) can't deserialize.
+    fs.writeFileSync(
+      path.join(overridesDir, "arr.json"),
+      JSON.stringify([1, 2, 3]),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/arr" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.body).toBe("{}");
+
+    fs.writeFileSync(path.join(overridesDir, "num.json"), "42", "utf-8");
+    const { res: res2, state: state2 } = makeMockRes();
+    handleGetUserOverrides({ method: "GET", url: "/num" }, res2, tmpRoot);
+    expect(state2.statusCode).toBe(200);
+    expect(state2.body).toBe("{}");
+  });
+
+  it("returns 200 with parsed JSON object on hit", () => {
+    const payload = {
+      layout: "two_zone_split",
+      frames: { "03-1+03-2": "frame_07" },
+      zone_geometries: {
+        top: { x: 0.05, y: 0.1, w: 0.9, h: 0.3 },
+      },
+      zone_sections: { top: ["03-1", "03-2"] },
+    };
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify(payload),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    const handled = handleGetUserOverrides(
+      { method: "GET", url: "/03" },
+      res,
+      tmpRoot,
+    );
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(200);
+    expect(state.headers["Content-Type"]).toBe(
+      "application/json; charset=utf-8",
+    );
+    expect(JSON.parse(state.body)).toEqual(payload);
+  });
+
+  it("preserves foreign top-level keys in the response", () => {
+    // Forward-compat with future axes (e.g., zone_sizes, image_overrides).
+    // u1 save() preserves them on the disk side; u3 GET must surface them
+    // so the frontend service (u5) can decide whether to act on them.
+    const payload = {
+      layout: "single_zone",
+      zone_sizes: { top: 0.42 }, // not part of KNOWN_AXES yet
+      custom_extension: { foo: "bar" },
+    };
+    fs.writeFileSync(
+      path.join(overridesDir, "future.json"),
+      JSON.stringify(payload),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    handleGetUserOverrides({ method: "GET", url: "/future" }, res, tmpRoot);
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual(payload);
+  });
+
+  it("strips the leading slash and ignores query string when keying", () => {
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "x" }),
+      "utf-8",
+    );
+    const { res, state } = makeMockRes();
+    handleGetUserOverrides(
+      { method: "GET", url: "/03?ts=1747884800" },
+      res,
+      tmpRoot,
+    );
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual({ layout: "x" });
+  });
+});
+
+// ---------------------------------------------------------------------------
+// IMP-52 u4 — PUT endpoint coverage
+// ---------------------------------------------------------------------------
+
+describe("KNOWN_USER_OVERRIDES_AXES (IMP-52 u4)", () => {
+  it("matches the Python KNOWN_AXES tuple in src/user_overrides_io.py", () => {
+    // The on-disk schema is shared with backend pipeline fallback (u2).
+    // Any drift here means a PUT could write an axis that the Python
+    // load() ignores, or vice-versa, silently losing user overrides.
+    expect(KNOWN_USER_OVERRIDES_AXES).toEqual([
+      "layout",
+      "zone_geometries",
+      "zone_sections",
+      "frames",
+      "image_overrides",
+    ]);
+  });
+});
+
+describe("mergeUserOverrides (IMP-52 u4)", () => {
+  it("only mutates KNOWN_AXES present in partial", () => {
+    const existing = {
+      layout: "old",
+      frames: { "03-1": "frame_01" },
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.layout).toBe("new");
+    // axes not in partial are preserved
+    expect(merged.frames).toEqual({ "03-1": "frame_01" });
+    expect(merged.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+    expect(merged.zone_sections).toEqual({ top: ["03-1"] });
+  });
+
+  it("preserves foreign top-level keys in existing", () => {
+    // Forward-compat: future axes (zone_sizes, schema_version, etc.) on
+    // disk must survive PUT writes that only touch the 5 in-scope axes.
+    // `image_overrides` is no longer a foreign key after IMP-51 #79 u2 —
+    // it joined KNOWN_USER_OVERRIDES_AXES — so we probe with axes that
+    // are still NOT in the allowlist.
+    const existing = {
+      layout: "old",
+      zone_sizes: { top: 0.42 },
+      schema_version: 2,
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.zone_sizes).toEqual({ top: 0.42 });
+    expect(merged.schema_version).toBe(2);
+  });
+
+  it("clears axis when partial value is null (explicit clear)", () => {
+    const existing = { layout: "x", frames: { "03-1": "f01" } };
+    const merged = mergeUserOverrides(existing, { layout: null });
+    expect("layout" in merged).toBe(false);
+    expect(merged.frames).toEqual({ "03-1": "f01" });
+  });
+
+  it("drops non-axis keys in partial (allowlist)", () => {
+    // PUT payload may carry junk fields (typo, malicious key); allowlist
+    // ensures only the 5 axes can be written to disk.
+    const merged = mergeUserOverrides(
+      {},
+      { layout: "x", random_key: "evil", __proto__: "x" } as Record<
+        string,
+        unknown
+      >,
+    );
+    expect(merged.layout).toBe("x");
+    expect("random_key" in merged).toBe(false);
+  });
+
+  it("merges all 5 axes when present in partial", () => {
+    const merged = mergeUserOverrides(
+      {},
+      {
+        layout: "two_zone_split",
+        frames: { "03-1+03-2": "frame_07" },
+        zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+        zone_sections: { top: ["03-1", "03-2"] },
+        image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+      },
+    );
+    expect(Object.keys(merged).sort()).toEqual([
+      "frames",
+      "image_overrides",
+      "layout",
+      "zone_geometries",
+      "zone_sections",
+    ]);
+  });
+
+  it("preserves image_overrides when absent from partial (5th axis IMP-51 #79 u2)", () => {
+    // Sibling axis of layout/frames/zone_geometries/zone_sections: a PUT
+    // that touches only layout must NOT erase the image_overrides map
+    // already on disk. Mirrors the partial-merge invariant for the 4
+    // pre-existing axes.
+    const existing = {
+      layout: "old",
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    };
+    const merged = mergeUserOverrides(existing, { layout: "new" });
+    expect(merged.image_overrides).toEqual({
+      "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 },
+    });
+    expect(merged.layout).toBe("new");
+  });
+
+  it("clears image_overrides when partial value is null (explicit clear)", () => {
+    // Same null-sentinel contract as the 4 sibling axes — `null` removes
+    // the axis from disk so the next render reverts to baseline (no
+    // user image position/size override).
+    const existing = {
+      layout: "x",
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    };
+    const merged = mergeUserOverrides(existing, { image_overrides: null });
+    expect("image_overrides" in merged).toBe(false);
+    expect(merged.layout).toBe("x");
+  });
+
+  it("does not mutate the existing input", () => {
+    const existing = { layout: "old", frames: { a: "b" } };
+    const snapshot = JSON.parse(JSON.stringify(existing));
+    mergeUserOverrides(existing, { layout: "new", layout_evil: "x" } as Record<
+      string,
+      unknown
+    >);
+    expect(existing).toEqual(snapshot);
+  });
+});
+
+describe("atomicWriteUserOverrides (IMP-52 u4)", () => {
+  let tmpRoot: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u4-aw-"));
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("creates parent dir if missing and writes JSON content", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    expect(fs.existsSync(path.dirname(filePath))).toBe(false);
+    atomicWriteUserOverrides(filePath, { layout: "x" });
+    expect(fs.existsSync(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "x",
+    });
+  });
+
+  it("leaves no .tmp residue after a successful write", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    atomicWriteUserOverrides(filePath, { layout: "x" });
+    const dirContents = fs.readdirSync(path.dirname(filePath));
+    expect(dirContents).toEqual(["03.json"]);
+  });
+
+  it("overwrites an existing file atomically", () => {
+    const filePath = path.join(tmpRoot, "data", "user_overrides", "03.json");
+    atomicWriteUserOverrides(filePath, { layout: "v1" });
+    atomicWriteUserOverrides(filePath, { layout: "v2" });
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "v2",
+    });
+  });
+});
+
+// req mock — EventEmitter with method/url + a `send(body)` helper that
+// emits the data chunk and then `end`, mirroring the node IncomingMessage
+// flow used by vite's dev middlewares.
+function makeMockReq(opts: {
+  method?: string;
+  url?: string;
+}): EventEmitter & { method?: string; url?: string; send: (body: string) => void } {
+  const ee = new EventEmitter() as EventEmitter & {
+    method?: string;
+    url?: string;
+    send: (body: string) => void;
+  };
+  ee.method = opts.method;
+  ee.url = opts.url;
+  ee.send = (body: string) => {
+    if (body.length > 0) ee.emit("data", Buffer.from(body, "utf-8"));
+    ee.emit("end");
+  };
+  return ee;
+}
+
+describe("handlePutUserOverrides (IMP-52 u4)", () => {
+  let tmpRoot: string;
+  let overridesDir: string;
+
+  beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "imp52-u4-"));
+    overridesDir = path.join(tmpRoot, "data", "user_overrides");
+  });
+
+  afterEach(() => {
+    fs.rmSync(tmpRoot, { recursive: true, force: true });
+  });
+
+  it("returns false (next chained) when method != PUT", () => {
+    const req = makeMockReq({ method: "GET", url: "/03" });
+    const { res, state } = makeMockRes();
+    const handled = handlePutUserOverrides(req, res, tmpRoot);
+    expect(handled).toBe(false);
+    expect(state.ended).toBe(false);
+  });
+
+  it("returns 400 on invalid key", () => {
+    const req = makeMockReq({ method: "PUT", url: "/../escape" });
+    const { res, state } = makeMockRes();
+    const handled = handlePutUserOverrides(req, res, tmpRoot);
+    expect(handled).toBe(true);
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid key" });
+  });
+
+  it("returns 400 on invalid JSON body", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("{not json");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({ error: "invalid JSON" });
+    // file MUST NOT have been created on parse failure
+    expect(fs.existsSync(path.join(overridesDir, "03.json"))).toBe(false);
+  });
+
+  it("returns 400 when JSON body is an array", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify([1, 2, 3]));
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({
+      error: "body must be a JSON object",
+    });
+  });
+
+  it("returns 400 when JSON body is a primitive", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("42");
+    expect(state.statusCode).toBe(400);
+    expect(JSON.parse(state.body)).toEqual({
+      error: "body must be a JSON object",
+    });
+  });
+
+  it("creates the override file on first PUT and returns merged body", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    const payload = { layout: "two_zone_split" };
+    req.send(JSON.stringify(payload));
+
+    expect(state.statusCode).toBe(200);
+    expect(state.headers["Content-Type"]).toBe(
+      "application/json; charset=utf-8",
+    );
+    expect(JSON.parse(state.body)).toEqual({ layout: "two_zone_split" });
+
+    const filePath = path.join(overridesDir, "03.json");
+    expect(fs.existsSync(filePath)).toBe(true);
+    expect(JSON.parse(fs.readFileSync(filePath, "utf-8"))).toEqual({
+      layout: "two_zone_split",
+    });
+  });
+
+  it("partial-merges: axes absent from payload are preserved on disk", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({
+        layout: "old",
+        frames: { "03-1": "frame_01" },
+        zone_sections: { top: ["03-1"] },
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "new" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({
+      layout: "new",
+      frames: { "03-1": "frame_01" },
+      zone_sections: { top: ["03-1"] },
+    });
+  });
+
+  it("preserves foreign top-level keys on disk (forward-compat)", () => {
+    // `image_overrides` is no longer a foreign key after IMP-51 #79 u2;
+    // probe with axes that are still NOT in KNOWN_USER_OVERRIDES_AXES.
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "future.json"),
+      JSON.stringify({
+        layout: "old",
+        zone_sizes: { top: 0.42 },
+        schema_version: 2,
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/future" });
+    const { res } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "new" }));
+
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "future.json"), "utf-8"),
+    );
+    expect(onDisk.zone_sizes).toEqual({ top: 0.42 });
+    expect(onDisk.schema_version).toBe(2);
+    expect(onDisk.layout).toBe("new");
+  });
+
+  it("persists image_overrides partial-merge and preserves sibling axes (IMP-51 #79 u2)", () => {
+    // 5th axis end-to-end PUT round-trip: writing only image_overrides
+    // must NOT touch the 4 sibling axes already on disk. Mirrors the
+    // existing partial-merge test for layout above.
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({
+        layout: "two_zone_split",
+        frames: { "03-1": "frame_01" },
+        zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+        zone_sections: { top: ["03-1"] },
+      }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(
+      JSON.stringify({
+        image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+      }),
+    );
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+      image_overrides: { "img-1": { x: 0.1, y: 0.2, w: 0.3, h: 0.25 } },
+    });
+  });
+
+  it("drops non-axis payload keys (allowlist enforced at write)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    req.send(
+      JSON.stringify({
+        layout: "two_zone_split",
+        random_evil_key: "should not persist",
+      }),
+    );
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "two_zone_split" });
+    expect("random_evil_key" in onDisk).toBe(false);
+  });
+
+  it("clears an axis when payload sets it to null", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "old", frames: { "03-1": "f01" } }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: null }));
+
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect("layout" in onDisk).toBe(false);
+    expect(onDisk.frames).toEqual({ "03-1": "f01" });
+  });
+
+  it("recovers from corrupt existing file (graceful degrade)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      "{this is not JSON",
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "recovered" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "recovered" });
+  });
+
+  it("treats array-rooted existing file as empty (graceful degrade)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify(["not", "an", "object"]),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "recovered" }));
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "recovered" });
+  });
+
+  it("strips the leading slash and ignores query string when keying", () => {
+    const req = makeMockReq({
+      method: "PUT",
+      url: "/03?ts=1747884800",
+    });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send(JSON.stringify({ layout: "x" }));
+
+    expect(state.statusCode).toBe(200);
+    expect(fs.existsSync(path.join(overridesDir, "03.json"))).toBe(true);
+  });
+
+  it("accepts an empty body as a no-op partial (no axes mutated)", () => {
+    fs.mkdirSync(overridesDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(overridesDir, "03.json"),
+      JSON.stringify({ layout: "kept" }),
+      "utf-8",
+    );
+
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+    req.send("");
+
+    expect(state.statusCode).toBe(200);
+    const onDisk = JSON.parse(
+      fs.readFileSync(path.join(overridesDir, "03.json"), "utf-8"),
+    );
+    expect(onDisk).toEqual({ layout: "kept" });
+  });
+
+  it("accepts a chunked PUT body (concatenates data events)", () => {
+    const req = makeMockReq({ method: "PUT", url: "/03" });
+    const { res, state } = makeMockRes();
+    expect(handlePutUserOverrides(req, res, tmpRoot)).toBe(true);
+
+    const body = JSON.stringify({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+    });
+    // Emit in two halves to simulate a fragmented HTTP body.
+    const half = Math.floor(body.length / 2);
+    req.emit("data", Buffer.from(body.slice(0, half), "utf-8"));
+    req.emit("data", Buffer.from(body.slice(half), "utf-8"));
+    req.emit("end");
+
+    expect(state.statusCode).toBe(200);
+    expect(JSON.parse(state.body)).toEqual({
+      layout: "two_zone_split",
+      frames: { "03-1": "frame_01" },
+    });
+  });
+});

Front/client/tests/user_overrides_restore.test.ts

@@ -0,0 +1,462 @@
+// IMP-52 u6 — vitest coverage for restore-on-reopen helpers used by
+// `Home.tsx` to layer persisted `user_overrides.json` payloads onto the
+// in-memory `UserSelection` and `slidePlan`.
+//
+// Scope (Stage 2 unit u6 contract):
+//   1) deriveUserOverridesKey(filename) — MDX-stem key derivation that
+//      matches backend u2 fallback's `Path(args.mdx_path).stem`. Strips
+//      `.mdx` case-insensitively; preserves everything else.
+//   2) applyPersistedNonFrameOverrides(selection, persisted) — layers
+//      layout / zone_geometries / zone_sections onto an existing selection.
+//      Frames are NOT layered here (unit_id key requires slidePlan).
+//      Foreign / unrecognized payloads degrade silently (no throw, no
+//      partial mutation).
+//   3) remapPersistedFramesToZoneFrames(slidePlan, framesByUnitId) —
+//      remaps frames (unit_id → template_id) to zone_frames (region.id →
+//      template_id). Stale unit_ids (no matching zone) drop silently;
+//      zones without internal_regions[0] or without section_ids are
+//      skipped without throwing.
+//
+// All helpers are pure; tests run in vitest's default node environment
+// without RTL / jsdom. Home.tsx wiring sites (handleFileUpload pre-Generate
+// seed + handleGenerate post-loadRun frame remap) are 1-line call sites that
+// these helpers cover end-to-end.
+
+import { describe, it, expect } from "vitest";
+import type {
+  LayoutPresetId,
+  SlidePlan,
+  UserSelection,
+  Zone,
+} from "../src/types/designAgent";
+import {
+  applyPersistedNonFrameOverrides,
+  createInitialUserSelection,
+  deriveUserOverridesKey,
+  remapPersistedFramesToZoneFrames,
+  saveImageOverride,
+} from "../src/utils/slidePlanUtils";
+
+// ─── Fixtures ───────────────────────────────────────────────────────────────
+
+function makeSelection(overrides?: Partial<UserSelection["overrides"]>): UserSelection {
+  return {
+    selectedSectionId: null,
+    selectedZoneId: null,
+    selectedRegionId: null,
+    overrides: {
+      layout_preset: undefined,
+      zone_frames: {},
+      zone_sections: {},
+      zone_sizes: {},
+      zone_geometries: {},
+      // IMP-51 (#79) u11 — keep the fixture in sync with the 5th persisted
+      // axis declared on `UserSelection.overrides`. Empty by default so the
+      // existing IMP-52 cases remain unchanged in shape.
+      image_overrides: {},
+      ...overrides,
+    },
+  };
+}
+
+function makeZone(
+  partial: { id: string; zone_id: string; section_ids: string[]; region_id?: string },
+): Zone {
+  return {
+    id: partial.id,
+    zone_id: partial.zone_id,
+    section_ids: partial.section_ids,
+    position: { x: 0, y: 0, width: 1, height: 1 },
+    internal_regions: [
+      {
+        id: partial.region_id ?? `${partial.id}-r0`,
+        region_id: "region-single",
+        role: "primary",
+        content_type: "text_block",
+        ratio_estimate: 1,
+        content_unit_ids: [],
+        frame_match_strategy: {
+          kind: "frame_match",
+          frame_id: null,
+          display_strategy: "inline_full",
+        },
+        frame_candidates: [],
+      },
+    ],
+  };
+}
+
+function makeSlidePlan(zones: Zone[], layout: LayoutPresetId = "single"): SlidePlan {
+  return {
+    id: "plan-1",
+    title: "test plan",
+    layout_preset: layout,
+    zones,
+  };
+}
+
+// ─── deriveUserOverridesKey ─────────────────────────────────────────────────
+
+describe("deriveUserOverridesKey (IMP-52 u6)", () => {
+  it("strips trailing .mdx", () => {
+    expect(deriveUserOverridesKey("03__DX_BIM_value_chain.mdx")).toBe(
+      "03__DX_BIM_value_chain",
+    );
+  });
+
+  it("strips .MDX case-insensitively", () => {
+    expect(deriveUserOverridesKey("04_demo.MDX")).toBe("04_demo");
+    expect(deriveUserOverridesKey("05_intro.Mdx")).toBe("05_intro");
+  });
+
+  it("returns the filename unchanged when no .mdx suffix", () => {
+    expect(deriveUserOverridesKey("03__DX_BIM_value_chain")).toBe(
+      "03__DX_BIM_value_chain",
+    );
+    expect(deriveUserOverridesKey("notes.txt")).toBe("notes.txt");
+  });
+
+  it("only strips the final .mdx, preserves dots inside the stem", () => {
+    expect(deriveUserOverridesKey("05.2_layer.mdx")).toBe("05.2_layer");
+  });
+
+  it("returns empty string for empty input", () => {
+    expect(deriveUserOverridesKey("")).toBe("");
+  });
+
+  it("matches backend Path(args.mdx_path).stem for the canonical demo MDXs", () => {
+    // These are the three canonical samples loaded by /api/sample-mdx; the
+    // key on both ends must agree so a write from frontend (PUT) is found
+    // by backend (u2 fallback on next pipeline run).
+    expect(deriveUserOverridesKey("03_demo.mdx")).toBe("03_demo");
+    expect(deriveUserOverridesKey("04_demo.mdx")).toBe("04_demo");
+    expect(deriveUserOverridesKey("05_demo.mdx")).toBe("05_demo");
+  });
+});
+
+// ─── applyPersistedNonFrameOverrides ────────────────────────────────────────
+
+describe("applyPersistedNonFrameOverrides (IMP-52 u6)", () => {
+  it("layers layout / zone_geometries / zone_sections", () => {
+    const sel = makeSelection();
+    const persisted = {
+      layout: "horizontal-2",
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.4 } },
+      zone_sections: { top: ["03-1"], bottom: ["03-2"] },
+    } as const;
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.4 },
+    });
+    expect(next.overrides.zone_sections).toEqual({
+      top: ["03-1"],
+      bottom: ["03-2"],
+    });
+  });
+
+  it("does NOT layer frames (frames need post-loadRun remap)", () => {
+    const sel = makeSelection({ zone_frames: { "r-existing": "tpl-existing" } });
+    const persisted = {
+      frames: { "03-1+03-2": "tpl-persisted" },
+    };
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    // zone_frames is untouched here; the post-loadRun remap step owns it.
+    expect(next.overrides.zone_frames).toEqual({ "r-existing": "tpl-existing" });
+  });
+
+  it("rejects layout values outside the 8 known preset ids", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      layout: "rogue-layout" as unknown as string,
+    });
+    // Stays at the original — preset whitelist guards against hand-edited
+    // files or future schema drift.
+    expect(next.overrides.layout_preset).toBe("single");
+  });
+
+  it("ignores zone_geometries when the payload axis is an array", () => {
+    const sel = makeSelection({ zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } } });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      zone_geometries: [] as unknown as Record<string, { x: number; y: number; w: number; h: number }>,
+    });
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+  });
+
+  it("returns the selection unchanged when persisted is null / undefined / non-object", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    expect(applyPersistedNonFrameOverrides(sel, null)).toEqual(sel);
+    expect(applyPersistedNonFrameOverrides(sel, undefined)).toEqual(sel);
+  });
+
+  it("returns the selection unchanged when persisted is empty {}", () => {
+    const sel = makeSelection({ layout_preset: "single" });
+    const next = applyPersistedNonFrameOverrides(sel, {});
+    expect(next.overrides.layout_preset).toBe("single");
+    expect(next.overrides.zone_geometries).toEqual({});
+    expect(next.overrides.zone_sections).toEqual({});
+  });
+
+  it("returns a NEW selection object (no mutation of input)", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, { layout: "vertical-2" });
+    expect(next).not.toBe(sel);
+    expect(next.overrides).not.toBe(sel.overrides);
+    // Input still pristine.
+    expect(sel.overrides.layout_preset).toBeUndefined();
+  });
+});
+
+// ─── remapPersistedFramesToZoneFrames ───────────────────────────────────────
+
+describe("remapPersistedFramesToZoneFrames (IMP-52 u6)", () => {
+  it("maps unit_id (section_ids joined by +) to region.id", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+      makeZone({ id: "z-bot", zone_id: "bottom", section_ids: ["03-2", "03-3"], region_id: "r-bot" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "tpl-a",
+      "03-2+03-3": "tpl-b",
+    });
+    expect(remapped).toEqual({
+      "r-top": "tpl-a",
+      "r-bot": "tpl-b",
+    });
+  });
+
+  it("silently drops persisted entries whose unit_id matches no zone", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "tpl-a",
+      "stale-section-id": "tpl-stale", // user changed zone_sections between sessions
+    });
+    expect(remapped).toEqual({ "r-top": "tpl-a" });
+  });
+
+  it("returns {} when slidePlan is null / undefined", () => {
+    expect(remapPersistedFramesToZoneFrames(null, { "03-1": "tpl-a" })).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(undefined, { "03-1": "tpl-a" })).toEqual({});
+  });
+
+  it("returns {} when framesByUnitId is null / undefined / {}", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    expect(remapPersistedFramesToZoneFrames(plan, null)).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(plan, undefined)).toEqual({});
+    expect(remapPersistedFramesToZoneFrames(plan, {})).toEqual({});
+  });
+
+  it("skips zones with empty section_ids (no unit_id to derive)", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-empty", zone_id: "empty", section_ids: [], region_id: "r-empty" }),
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "": "tpl-should-not-match-empty-join",
+      "03-1": "tpl-a",
+    });
+    expect(remapped).toEqual({ "r-top": "tpl-a" });
+  });
+
+  it("skips zones without internal_regions[0]", () => {
+    const plan: SlidePlan = {
+      id: "plan-x",
+      title: "no regions",
+      layout_preset: "single",
+      zones: [
+        {
+          id: "z-bare",
+          zone_id: "bare",
+          section_ids: ["03-1"],
+          position: { x: 0, y: 0, width: 1, height: 1 },
+          internal_regions: [],
+        },
+      ],
+    };
+    expect(remapPersistedFramesToZoneFrames(plan, { "03-1": "tpl-a" })).toEqual({});
+  });
+
+  it("ignores persisted entries with empty / non-string template_id", () => {
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "" as unknown as string,
+    });
+    expect(remapped).toEqual({});
+  });
+
+  it("preserves the user-selected template even when slidePlan layout would imply a different default", () => {
+    // Backend u2 fallback should already have applied the user's frame
+    // override via CLI args, but if the plan's default frame_match_strategy
+    // disagrees, the post-loadRun remap still surfaces the user's choice
+    // for the SlideCanvas override-vs-default preview indicator.
+    const plan = makeSlidePlan([
+      makeZone({ id: "z-top", zone_id: "top", section_ids: ["03-1"], region_id: "r-top" }),
+    ]);
+    const remapped = remapPersistedFramesToZoneFrames(plan, {
+      "03-1": "user-chosen-tpl",
+    });
+    expect(remapped["r-top"]).toBe("user-chosen-tpl");
+  });
+});
+
+// ─── IMP-51 (#79) u11 — image_overrides axis ────────────────────────────────
+// New 5th persisted axis. The on-disk schema (KNOWN_AXES,
+// src/user_overrides_io.py u1), the typed client
+// (services/userOverridesApi.ts u3 ImageOverridesOverride), the Vite
+// allowlist (vite.config.ts u2), and the backend CLI flag (--override-image
+// in src/phase_z2_pipeline.py u5) all expect `image_id` → percent-of-slide
+// geometry. u11 owns the in-memory mirror on `UserSelection.overrides`
+// (declared in types/designAgent.ts) plus the three pure helpers that
+// Home.tsx (u10) wires:
+//   • applyPersistedNonFrameOverrides — restore-on-reopen layer.
+//   • createInitialUserSelection — fresh-slide initializer.
+//   • saveImageOverride — single-image record helper invoked by the
+//     SlideCanvas u8 drag/resize handler.
+
+describe("image_overrides axis — applyPersistedNonFrameOverrides (IMP-51 u11)", () => {
+  it("layers a flat image_overrides dict onto the selection", () => {
+    const sel = makeSelection();
+    const persisted = {
+      image_overrides: {
+        "img-abc1234567": { x: 10, y: 15, w: 30.5, h: 25 },
+        "img-deadbeef00": { x: 50, y: 50, w: 40, h: 40 },
+      },
+    };
+    const next = applyPersistedNonFrameOverrides(sel, persisted);
+    expect(next.overrides.image_overrides).toEqual({
+      "img-abc1234567": { x: 10, y: 15, w: 30.5, h: 25 },
+      "img-deadbeef00": { x: 50, y: 50, w: 40, h: 40 },
+    });
+    // Untouched axes stay at their fixture defaults so the round-trip is
+    // safe to interleave with the other four axes.
+    expect(next.overrides.zone_geometries).toEqual({});
+    expect(next.overrides.zone_sections).toEqual({});
+    expect(next.overrides.layout_preset).toBeUndefined();
+  });
+
+  it("ignores image_overrides when the payload axis is an array", () => {
+    const sel = makeSelection({
+      image_overrides: { "img-existing00": { x: 1, y: 2, w: 30, h: 40 } },
+    });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      image_overrides: [] as unknown as Record<
+        string,
+        { x: number; y: number; w: number; h: number }
+      >,
+    });
+    // Same guard the zone_geometries branch uses — array payloads from a
+    // hand-edited file are rejected and the prior in-memory value stays.
+    expect(next.overrides.image_overrides).toEqual({
+      "img-existing00": { x: 1, y: 2, w: 30, h: 40 },
+    });
+  });
+
+  it("ignores image_overrides when the payload axis is null", () => {
+    const sel = makeSelection({
+      image_overrides: { "img-existing00": { x: 0, y: 0, w: 100, h: 100 } },
+    });
+    const next = applyPersistedNonFrameOverrides(sel, {
+      image_overrides: null,
+    });
+    expect(next.overrides.image_overrides).toEqual({
+      "img-existing00": { x: 0, y: 0, w: 100, h: 100 },
+    });
+  });
+
+  it("layers image_overrides alongside the four IMP-52 axes in one call", () => {
+    const sel = makeSelection();
+    const next = applyPersistedNonFrameOverrides(sel, {
+      layout: "horizontal-2",
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.4 } },
+      zone_sections: { top: ["03-1"] },
+      image_overrides: { "img-abc1234567": { x: 25, y: 25, w: 50, h: 50 } },
+    });
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.4 },
+    });
+    expect(next.overrides.zone_sections).toEqual({ top: ["03-1"] });
+    expect(next.overrides.image_overrides).toEqual({
+      "img-abc1234567": { x: 25, y: 25, w: 50, h: 50 },
+    });
+  });
+
+  it("seeds an empty image_overrides on a fresh selection (createInitialUserSelection)", () => {
+    const sel = createInitialUserSelection();
+    expect(sel.overrides.image_overrides).toEqual({});
+    // Mirrors the shape Home.tsx receives before any user interaction —
+    // SlideCanvas u8 expects the axis to exist (not undefined) so its
+    // `Object.entries(measured + persisted)` merge never crashes.
+  });
+});
+
+describe("image_overrides axis — saveImageOverride (IMP-51 u11)", () => {
+  const ID_A = "img-abc1234567";
+  const ID_B = "img-deadbeef00";
+
+  it("adds a new image_id entry on an empty axis", () => {
+    const sel = makeSelection();
+    const next = saveImageOverride(sel, ID_A, { x: 10, y: 15, w: 30.5, h: 25 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 10, y: 15, w: 30.5, h: 25 },
+    });
+  });
+
+  it("replaces an existing entry under the same image_id (most recent drag wins)", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 0, y: 0, w: 20, h: 20 } },
+    });
+    const next = saveImageOverride(sel, ID_A, { x: 50, y: 50, w: 30, h: 30 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 50, y: 50, w: 30, h: 30 },
+    });
+  });
+
+  it("preserves sibling image_id entries when adding a new one", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 10, y: 10, w: 20, h: 20 } },
+    });
+    const next = saveImageOverride(sel, ID_B, { x: 60, y: 60, w: 30, h: 30 });
+    expect(next.overrides.image_overrides).toEqual({
+      [ID_A]: { x: 10, y: 10, w: 20, h: 20 },
+      [ID_B]: { x: 60, y: 60, w: 30, h: 30 },
+    });
+  });
+
+  it("does NOT touch the other four override axes", () => {
+    const sel = makeSelection({
+      zone_geometries: { top: { x: 0, y: 0, w: 1, h: 0.5 } },
+      zone_sections: { top: ["03-1"] },
+      zone_frames: { "r-top": "tpl-a" },
+      layout_preset: "horizontal-2",
+    });
+    const next = saveImageOverride(sel, ID_A, { x: 10, y: 10, w: 20, h: 20 });
+    expect(next.overrides.zone_geometries).toEqual({
+      top: { x: 0, y: 0, w: 1, h: 0.5 },
+    });
+    expect(next.overrides.zone_sections).toEqual({ top: ["03-1"] });
+    expect(next.overrides.zone_frames).toEqual({ "r-top": "tpl-a" });
+    expect(next.overrides.layout_preset).toBe("horizontal-2");
+  });
+
+  it("returns a NEW selection object (no input mutation)", () => {
+    const sel = makeSelection({
+      image_overrides: { [ID_A]: { x: 0, y: 0, w: 10, h: 10 } },
+    });
+    const before = { ...sel.overrides.image_overrides };
+    const next = saveImageOverride(sel, ID_B, { x: 30, y: 30, w: 20, h: 20 });
+    expect(next).not.toBe(sel);
+    expect(next.overrides).not.toBe(sel.overrides);
+    expect(next.overrides.image_overrides).not.toBe(sel.overrides.image_overrides);
+    // Input still pristine.
+    expect(sel.overrides.image_overrides).toEqual(before);
+  });
+});