feat: video scenes build in strict chains — connectors finish before targets, arrowheads gated on completed strokes, GitStorage nodes appear with their curves, Pipeline names GitHub Actions on screen; spec-v7 composition rules updated

This commit is contained in:
dong.nguyen committed 2026-10-29 00:10:06 +07:00
1 parent 7bb7bd68ae
commit aad36e38fc
7 files changed
+64 -38

No files matched your search

+2 -2
View File
@@ -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
+1 -1
View File
@@ -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.
Binary file not shown.
+1 -1
View File
@@ -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.
+7 -8
View File
@@ -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 = () => {
</Fade>
))}
<Fade start={110} y={18}>
<Fade start={135} y={18}>
<Panel width={240} accent style={{ left: 900, top: 410, textAlign: 'center', background: theme.accentTint }}>
<Label size={24} color={theme.accent}>joined once</Label>
<div style={{ marginTop: 6, fontSize: 16, color: theme.textSecondary }}>at build time</div>
@@ -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}
/>
</svg>
<Fade start={165} y={24}>
<Fade start={185} y={24}>
<BrowserFrame width={300} height={420} style={{ left: 1200, top: 245 }}>
<div style={{ display: 'flex', gap: 8, padding: '14px 16px 0' }}>
{['EN', 'VI'].map((l, i) => (
@@ -109,7 +108,7 @@ export const DataLayer: React.FC = () => {
</span>
))}
</div>
<PageSkeleton active={joinOn > 0.5} />
<PageSkeleton active={frame > 190} />
<div style={{ position: 'absolute', left: 0, right: 0, bottom: 0, height: 3, background: theme.accent, opacity: pageOn }} />
</BrowserFrame>
</Fade>
+11 -9
View File
@@ -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 (
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
@@ -61,7 +63,7 @@ export const GitStorage: React.FC = () => {
</div>
</Panel>
<Fade start={170} y={20}>
<Fade start={105} y={20}>
<Panel width={470} style={{ left: 480, top: 480 }}>
<div style={{ display: 'flex', gap: 10, alignItems: 'center' }}>
<span style={{ width: 12, height: 12, borderRadius: 6, background: theme.accent }} />
@@ -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}
/>
<circle cx={1100} cy={680} r={9} fill={theme.borderStrong} />
<circle cx={1240} cy={460} r={11} fill={theme.accent} />
<circle cx={1240} cy={460} r={11 + 12 * pulse} fill="none" stroke={theme.accent} strokeWidth={2} opacity={1 - pulse} />
<circle cx={1370} cy={680} r={11} fill={theme.success} />
<circle cx={1240} cy={460} r={11} fill={theme.accent} opacity={branchOn} />
<circle cx={1240} cy={460} r={11 + 12 * pulse} fill="none" stroke={theme.accent} strokeWidth={2} opacity={(1 - pulse) * branchOn} />
<circle cx={1370} cy={680} r={11} fill={theme.success} opacity={mergedOn} />
</svg>
<Fade start={40}>
<Fade start={95}>
<div style={{ position: 'absolute', left: 1110, top: 380, width: 260, textAlign: 'center' }}>
<Label size={18}>preview branch · drafts</Label>
</div>
@@ -120,7 +122,7 @@ export const GitStorage: React.FC = () => {
<Label size={18} color={theme.textMuted}>master · deploys</Label>
</div>
</Fade>
<Fade start={165}>
<Fade start={195}>
<div style={{ position: 'absolute', left: 1250, top: 728 }}>
<span style={{ background: 'rgba(107, 184, 134, 0.14)', border: `1px solid ${theme.success}`, borderRadius: 8, padding: '6px 12px' }}>
<Label size={16} color={theme.success}>merge = publish</Label>
+42 -17
View File
@@ -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 (
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
@@ -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 }) => {
/>
<Fade start={10}>
<Panel width={210} style={{ left: 465, top: 210 }}>
<Panel width={210} style={{ left: 449, top: 210 }}>
<div style={{ display: 'flex', gap: 10, alignItems: 'center' }}>
<span style={{ width: 12, height: 12, borderRadius: 6, background: theme.success }} />
<Label size={20}>push to master</Label>
@@ -44,9 +50,28 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
</Panel>
</Fade>
<Fade start={50} y={14}>
<div
style={{
position: 'absolute',
left: 689,
top: 180,
width: 782,
height: 178,
borderRadius: 12,
border: `1px dashed ${theme.borderStrong}`,
}}
>
<div style={{ position: 'absolute', left: 16, top: 10, fontFamily: theme.mono, fontSize: 15 }}>
<span style={{ color: theme.accent }}>GitHub Actions</span>
<span style={{ color: theme.textMuted }}> · .github/workflows/deploy.yml</span>
</div>
</div>
</Fade>
{JOBS.map((j, i) => (
<Fade key={j.name} start={45 + i * 45} y={20}>
<Panel width={230} style={{ left: 705 + i * 260, top: 210 }}>
<Fade key={j.name} start={65 + i * 55} y={20}>
<Panel width={230} style={{ left: 705 + i * 260, top: 222 }}>
<div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
<span style={{ width: 10, height: 10, borderRadius: 5, background: theme.accent }} />
<Mono size={18} color={theme.textPrimary}>{j.name}</Mono>
@@ -64,13 +89,13 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
<svg width={1920} height={1080} style={{ position: 'absolute', inset: 0 }}>
<ArrowDefs />
<path d="M 680 265 L 700 265" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow1} markerEnd="url(#arrow)" />
<path d="M 940 265 L 960 265" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow2} markerEnd="url(#arrow)" />
<path d="M 1200 265 L 1220 265" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow3} markerEnd="url(#arrow)" />
<path d="M 1160 340 L 1160 465" fill="none" stroke={theme.accent} strokeWidth={2.5} pathLength={1} strokeDasharray={1} strokeDashoffset={drawIn(frame, 150, 30)} markerEnd="url(#arrow-accent)" />
<path d="M 662 282 L 700 282" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow1} markerEnd={arrow1 < 0.1 ? 'url(#arrow)' : undefined} />
<path d="M 940 282 L 960 282" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow2} markerEnd={arrow2 < 0.1 ? 'url(#arrow)' : undefined} />
<path d="M 1200 282 L 1220 282" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow3} markerEnd={arrow3 < 0.1 ? 'url(#arrow)' : undefined} />
<path d="M 1340 362 L 1340 465" fill="none" stroke={theme.accent} strokeWidth={2.5} pathLength={1} strokeDasharray={1} strokeDashoffset={arrowDown} markerEnd={arrowDown < 0.1 ? 'url(#arrow-accent)' : undefined} />
</svg>
<Fade start={160} y={20}>
<Fade start={185} y={20}>
<Panel width={440} style={{ left: 465, top: 480, opacity: infraOn }}>
<Label size={18}>infra follows the same rules</Label>
<div style={{ marginTop: 10 }}>
@@ -80,7 +105,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
</Panel>
</Fade>
<Fade start={225} y={24}>
<Fade start={230} y={24}>
<BrowserFrame width={460} height={320} style={{ left: 995, top: 470 }}>
{captured ? (
<OffthreadVideo
@@ -90,7 +115,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
) : (
<>
<PageSkeleton active={deployed > 0.5} />
<Fade start={245}>
<Fade start={250}>
<div style={{ position: 'absolute', left: 0, right: 0, top: 0, bottom: 0, background: 'rgba(10, 12, 10, 0.62)', display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
<div style={{ background: theme.accentTint, border: `1px solid ${theme.accent}`, borderRadius: 10, padding: '14px 22px', display: 'flex', gap: 10, alignItems: 'center' }}>
<svg width={22} height={22} viewBox="0 0 24 24" fill="none" stroke={theme.accent} strokeWidth={2.5} strokeLinecap="round">