diff --git a/docs/design/specs/v7/spec-v7-intro-video.md b/docs/design/specs/v7/spec-v7-intro-video.md index 863007a..11de78b 100644 --- a/docs/design/specs/v7/spec-v7-intro-video.md +++ b/docs/design/specs/v7/spec-v7-intro-video.md @@ -28,10 +28,10 @@ Decisions (owner-approved 2026-10-28): |DataLayer|165–420|5.5–14|Structure documents + per-language dictionaries + manifests → joined once at build time → bilingual rendered page| |LiveEdit|420–960|14–32|`?edit` typed into the URL → Basic-auth dialog → inline heading edit → save bar: PUT contents/projects.json, commit on branch, 409 → three-way rebase| |GitStorage|960–1290|32–43|Repository file tree with the edited JSON highlighted, commit diff card, master/preview-branch graph, `?edit=preview`, merge = publish| -|Pipeline|1290–1650|43–55|push → master → build · resume · deploy job cards lighting in sequence, infra guard card (deploy-infra.yml), updated live page| +|Pipeline|1290–1650|43–55|push → master → GitHub Actions group box (named on screen: `GitHub Actions · .github/workflows/deploy.yml`) → build · resume · deploy cards reached strictly in order — each connector draws only after the previous card has appeared, its arrowhead only after its line completes — then a downward arrow from the deploy job to the updated live page; infra guard card (deploy-infra.yml) follows the deploy beat| |Outro|1650–1860|55–62|"Edit on the live site. Stored in git. Live on merge to master."| -**Scene composition** (reviewed 2026-10-28 from rendered stills; the first render hugged every diagram to the right edge): each scene's visual group is centered on x=960 inside a strict band — title row y 80–175 (left), visual band y ~200–760 (centered), bullet row y 790+ (left). The four groups span x 420–1500 (DataLayer), 580–1340 (LiveEdit stage), 480–1410 (GitStorage), 465–1455 (Pipeline). Same review fixed: absolute stage anchors in LiveEdit wrapped by a positioned div, never by `Fade` (Fade's `transform` becomes the containing block and anchors them after the skeleton); repository tree rows at 14px so no line wraps or overflows the panel; the "merge = publish" badge moved clear of the merge curve; the infra card widened to 440px. +**Scene composition** (reviewed 2026-10-28 from rendered stills; the first render hugged every diagram to the right edge): each scene's visual group is centered on x=960 inside a strict band — title row y 80–175 (left), visual band y ~200–760 (centered), bullet row y 790+ (left). The four groups span x 420–1500 (DataLayer), 580–1340 (LiveEdit stage), 480–1410 (GitStorage), 449–1471 (Pipeline: push card + GitHub Actions group box). Same review fixed: absolute stage anchors in LiveEdit wrapped by a positioned div, never by `Fade` (Fade's `transform` becomes the containing block and anchors them after the skeleton); repository tree rows at 14px so no line wraps or overflows the panel; the "merge = publish" badge moved clear of the merge curve; the infra card widened to 440px. A second review (same day) applied a strict chain rule to every scene with connectors — DataLayer, GitStorage, Pipeline: an element appears only after the connector that reaches it has finished drawing, and an arrowhead appears only after its own line completes. `markerEnd` is gated on the stroke being ≥90 % drawn (SVG renders `markerEnd` even at full dash offset, so ungated heads floated in the air before their lines); GitStorage's branch/merge node circles are gated with `appear()` on their curve completing (master line and its node stay static — the published base predates the edit); DataLayer re-timed to documents → arrows → join panel → browser; Pipeline's three job cards sit in a dashed group box naming the runner on screen, `GitHub Actions · .github/workflows/deploy.yml`, and both caption tracks name the GitHub Actions pipeline in that scene's cue. Verified beat-by-beat from rendered stills. ## 3. Render commands diff --git a/public/media/how-it-works.en.vtt b/public/media/how-it-works.en.vtt index 376b9d6..7e2ccc9 100644 --- a/public/media/how-it-works.en.vtt +++ b/public/media/how-it-works.en.vtt @@ -13,7 +13,7 @@ Everything the site shows is a JSON document: structure documents, per-language Content lives as JSON in the repository: branches are previews, and merging to master publishes. 00:00:43.000 --> 00:00:54.900 -Merging to master runs the pipeline — build, resume PDFs, deploy — from commit to live in minutes. +Merging to master runs the GitHub Actions pipeline — build, resume PDFs, deploy — from commit to live in minutes. 00:00:55.000 --> 00:01:02.000 Edit on the live site. Stored in git. Live on merge to master. diff --git a/public/media/how-it-works.mp4 b/public/media/how-it-works.mp4 index cea2f0d..fce60c3 100644 Binary files a/public/media/how-it-works.mp4 and b/public/media/how-it-works.mp4 differ diff --git a/public/media/how-it-works.vi.vtt b/public/media/how-it-works.vi.vtt index 229cc6d..ef1980b 100644 --- a/public/media/how-it-works.vi.vtt +++ b/public/media/how-it-works.vi.vtt @@ -13,7 +13,7 @@ Mọi thứ trang hiển thị đều là tài liệu JSON: cấu trúc, từ đ Nội dung nằm trong repository dưới dạng JSON: nhánh là bản xem trước, merge vào master là công bố. 00:00:43.000 --> 00:00:54.900 -Merge vào master chạy pipeline — build, tạo resume PDF, triển khai — từ commit đến khi live chỉ vài phút. +Merge vào master chạy pipeline GitHub Actions — build, tạo resume PDF, triển khai — từ commit đến khi live chỉ vài phút. 00:00:55.000 --> 00:01:02.000 Sửa ngay trên trang thật. Lưu trong git. Live khi merge vào master. diff --git a/video/src/scenes/DataLayer.tsx b/video/src/scenes/DataLayer.tsx index 745d9b7..2c0b5ca 100644 --- a/video/src/scenes/DataLayer.tsx +++ b/video/src/scenes/DataLayer.tsx @@ -14,9 +14,8 @@ const DOCS = [ export const DataLayer: React.FC = () => { const frame = useCurrentFrame(); - const joinOn = appear(frame, 120); - const pageOn = appear(frame, 175); - const arrowA = drawIn(frame, 95, 35); + const pageOn = appear(frame, 195); + const arrowA = drawIn(frame, 100, 35); const arrowB = drawIn(frame, 150, 35); const pulse = interpolate(frame % 60, [0, 30, 60], [0, 0.55, 0], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }); @@ -46,7 +45,7 @@ export const DataLayer: React.FC = () => { ))} - +
at build time
@@ -74,7 +73,7 @@ export const DataLayer: React.FC = () => { pathLength={1} strokeDasharray={1} strokeDashoffset={arrowA} - markerEnd="url(#arrow)" + markerEnd={arrowA < 0.1 ? 'url(#arrow)' : undefined} opacity={0.8} /> ))} @@ -86,11 +85,11 @@ export const DataLayer: React.FC = () => { pathLength={1} strokeDasharray={1} strokeDashoffset={arrowB} - markerEnd="url(#arrow-accent)" + markerEnd={arrowB < 0.1 ? 'url(#arrow-accent)' : undefined} /> - +
{['EN', 'VI'].map((l, i) => ( @@ -109,7 +108,7 @@ export const DataLayer: React.FC = () => { ))}
- 0.5} /> + 190} />
diff --git a/video/src/scenes/GitStorage.tsx b/video/src/scenes/GitStorage.tsx index 55329b5..a4f6326 100644 --- a/video/src/scenes/GitStorage.tsx +++ b/video/src/scenes/GitStorage.tsx @@ -16,9 +16,11 @@ const TREE = [ export const GitStorage: React.FC = () => { const frame = useCurrentFrame(); const branchDraw = drawIn(frame, 55, 45); - const mergeDraw = drawIn(frame, 130, 45); + const mergeDraw = drawIn(frame, 140, 45); + const branchOn = appear(frame, 100); + const mergedOn = appear(frame, 185); const pulse = interpolate(frame % 50, [0, 25, 50], [0, 0.6, 0], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }); - const commitOn = appear(frame, 180); + const commitOn = appear(frame, 115); return ( @@ -61,7 +63,7 @@ export const GitStorage: React.FC = () => {
- +
@@ -102,15 +104,15 @@ export const GitStorage: React.FC = () => { pathLength={1} strokeDasharray={1} strokeDashoffset={mergeDraw} - markerEnd="url(#arrow-success)" + markerEnd={mergeDraw < 0.1 ? 'url(#arrow-success)' : undefined} /> - - - + + + - +
@@ -120,7 +122,7 @@ export const GitStorage: React.FC = () => {
- +
diff --git a/video/src/scenes/Pipeline.tsx b/video/src/scenes/Pipeline.tsx index 507bbfd..b2043bd 100644 --- a/video/src/scenes/Pipeline.tsx +++ b/video/src/scenes/Pipeline.tsx @@ -10,15 +10,21 @@ const JOBS = [ { name: 'deploy', detail: 'rsync dist/ → VPS stack' }, ]; -// Centered group: push + three job cards span 465–1455 (center 960) at y 210–330; +// Sequential chain: a card is only reached by an arrow that starts drawing +// after the previous card has appeared — push → arrow → build → arrow → +// resume → arrow → deploy → arrow → live site. The three job cards sit inside +// one dashed GitHub Actions group box so the runner is named on screen, not +// just implied by the job names. +// Centered group: push 449–659 + group box 689–1471 (center 960) at y 180–358; // infra card and browser occupy y 470–790 — above the bullet row (y 840+). export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { const frame = useCurrentFrame(); - const arrow1 = drawIn(frame, 30, 25); - const arrow2 = drawIn(frame, 75, 25); - const arrow3 = drawIn(frame, 120, 25); - const infraOn = appear(frame, 165); - const deployed = appear(frame, 235); + const arrow1 = drawIn(frame, 40, 25); + const arrow2 = drawIn(frame, 95, 25); + const arrow3 = drawIn(frame, 150, 25); + const arrowDown = drawIn(frame, 200, 30); + const infraOn = appear(frame, 185); + const deployed = appear(frame, 240); return ( @@ -27,7 +33,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { index="04 · AUTO DEPLOYMENT" title="Merge to master — the pipeline ships it" bullets={[ - 'deploy.yml: build · resume PDFs · deploy — three jobs', + 'GitHub Actions runs deploy.yml: build · resume PDFs · deploy', 'nginx.conf / compose.yaml changes redeploy the stack itself', 'No CMS, no manual upload: push to master is the publish button', ]} @@ -35,7 +41,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { /> - +
@@ -44,9 +50,28 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { + +
+
+ GitHub Actions + · .github/workflows/deploy.yml +
+
+
+ {JOBS.map((j, i) => ( - - + +
{j.name} @@ -64,13 +89,13 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { - - - - + + + + - +
@@ -80,7 +105,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { - + {captured ? ( = ({ captured }) => { ) : ( <> 0.5} /> - +