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| |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| |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| |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."| |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 ## 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. Content lives as JSON in the repository: branches are previews, and merging to master publishes.
00:00:43.000 --> 00:00:54.900 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 00:00:55.000 --> 00:01:02.000
Edit on the live site. Stored in git. Live on merge to master. 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ố. 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 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 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. 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 = () => { export const DataLayer: React.FC = () => {
const frame = useCurrentFrame(); const frame = useCurrentFrame();
const joinOn = appear(frame, 120); const pageOn = appear(frame, 195);
const pageOn = appear(frame, 175); const arrowA = drawIn(frame, 100, 35);
const arrowA = drawIn(frame, 95, 35);
const arrowB = drawIn(frame, 150, 35); const arrowB = drawIn(frame, 150, 35);
const pulse = interpolate(frame % 60, [0, 30, 60], [0, 0.55, 0], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' }); 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>
))} ))}
<Fade start={110} y={18}> <Fade start={135} y={18}>
<Panel width={240} accent style={{ left: 900, top: 410, textAlign: 'center', background: theme.accentTint }}> <Panel width={240} accent style={{ left: 900, top: 410, textAlign: 'center', background: theme.accentTint }}>
<Label size={24} color={theme.accent}>joined once</Label> <Label size={24} color={theme.accent}>joined once</Label>
<div style={{ marginTop: 6, fontSize: 16, color: theme.textSecondary }}>at build time</div> <div style={{ marginTop: 6, fontSize: 16, color: theme.textSecondary }}>at build time</div>
@@ -74,7 +73,7 @@ export const DataLayer: React.FC = () => {
pathLength={1} pathLength={1}
strokeDasharray={1} strokeDasharray={1}
strokeDashoffset={arrowA} strokeDashoffset={arrowA}
markerEnd="url(#arrow)" markerEnd={arrowA < 0.1 ? 'url(#arrow)' : undefined}
opacity={0.8} opacity={0.8}
/> />
))} ))}
@@ -86,11 +85,11 @@ export const DataLayer: React.FC = () => {
pathLength={1} pathLength={1}
strokeDasharray={1} strokeDasharray={1}
strokeDashoffset={arrowB} strokeDashoffset={arrowB}
markerEnd="url(#arrow-accent)" markerEnd={arrowB < 0.1 ? 'url(#arrow-accent)' : undefined}
/> />
</svg> </svg>
<Fade start={165} y={24}> <Fade start={185} y={24}>
<BrowserFrame width={300} height={420} style={{ left: 1200, top: 245 }}> <BrowserFrame width={300} height={420} style={{ left: 1200, top: 245 }}>
<div style={{ display: 'flex', gap: 8, padding: '14px 16px 0' }}> <div style={{ display: 'flex', gap: 8, padding: '14px 16px 0' }}>
{['EN', 'VI'].map((l, i) => ( {['EN', 'VI'].map((l, i) => (
@@ -109,7 +108,7 @@ export const DataLayer: React.FC = () => {
</span> </span>
))} ))}
</div> </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 }} /> <div style={{ position: 'absolute', left: 0, right: 0, bottom: 0, height: 3, background: theme.accent, opacity: pageOn }} />
</BrowserFrame> </BrowserFrame>
</Fade> </Fade>
+11 -9
View File
@@ -16,9 +16,11 @@ const TREE = [
export const GitStorage: React.FC = () => { export const GitStorage: React.FC = () => {
const frame = useCurrentFrame(); const frame = useCurrentFrame();
const branchDraw = drawIn(frame, 55, 45); 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 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 ( return (
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}> <AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
@@ -61,7 +63,7 @@ export const GitStorage: React.FC = () => {
</div> </div>
</Panel> </Panel>
<Fade start={170} y={20}> <Fade start={105} y={20}>
<Panel width={470} style={{ left: 480, top: 480 }}> <Panel width={470} style={{ left: 480, top: 480 }}>
<div style={{ display: 'flex', gap: 10, alignItems: 'center' }}> <div style={{ display: 'flex', gap: 10, alignItems: 'center' }}>
<span style={{ width: 12, height: 12, borderRadius: 6, background: theme.accent }} /> <span style={{ width: 12, height: 12, borderRadius: 6, background: theme.accent }} />
@@ -102,15 +104,15 @@ export const GitStorage: React.FC = () => {
pathLength={1} pathLength={1}
strokeDasharray={1} strokeDasharray={1}
strokeDashoffset={mergeDraw} 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={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} fill={theme.accent} opacity={branchOn} />
<circle cx={1240} cy={460} r={11 + 12 * pulse} fill="none" stroke={theme.accent} strokeWidth={2} opacity={1 - pulse} /> <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} /> <circle cx={1370} cy={680} r={11} fill={theme.success} opacity={mergedOn} />
</svg> </svg>
<Fade start={40}> <Fade start={95}>
<div style={{ position: 'absolute', left: 1110, top: 380, width: 260, textAlign: 'center' }}> <div style={{ position: 'absolute', left: 1110, top: 380, width: 260, textAlign: 'center' }}>
<Label size={18}>preview branch · drafts</Label> <Label size={18}>preview branch · drafts</Label>
</div> </div>
@@ -120,7 +122,7 @@ export const GitStorage: React.FC = () => {
<Label size={18} color={theme.textMuted}>master · deploys</Label> <Label size={18} color={theme.textMuted}>master · deploys</Label>
</div> </div>
</Fade> </Fade>
<Fade start={165}> <Fade start={195}>
<div style={{ position: 'absolute', left: 1250, top: 728 }}> <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' }}> <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> <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' }, { 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+). // infra card and browser occupy y 470–790 — above the bullet row (y 840+).
export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => { export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
const frame = useCurrentFrame(); const frame = useCurrentFrame();
const arrow1 = drawIn(frame, 30, 25); const arrow1 = drawIn(frame, 40, 25);
const arrow2 = drawIn(frame, 75, 25); const arrow2 = drawIn(frame, 95, 25);
const arrow3 = drawIn(frame, 120, 25); const arrow3 = drawIn(frame, 150, 25);
const infraOn = appear(frame, 165); const arrowDown = drawIn(frame, 200, 30);
const deployed = appear(frame, 235); const infraOn = appear(frame, 185);
const deployed = appear(frame, 240);
return ( return (
<AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}> <AbsoluteFill style={{ background: theme.bg, fontFamily: theme.sans }}>
@@ -27,7 +33,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
index="04 · AUTO DEPLOYMENT" index="04 · AUTO DEPLOYMENT"
title="Merge to master — the pipeline ships it" title="Merge to master — the pipeline ships it"
bullets={[ 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', 'nginx.conf / compose.yaml changes redeploy the stack itself',
'No CMS, no manual upload: push to master is the publish button', '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}> <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' }}> <div style={{ display: 'flex', gap: 10, alignItems: 'center' }}>
<span style={{ width: 12, height: 12, borderRadius: 6, background: theme.success }} /> <span style={{ width: 12, height: 12, borderRadius: 6, background: theme.success }} />
<Label size={20}>push to master</Label> <Label size={20}>push to master</Label>
@@ -44,9 +50,28 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
</Panel> </Panel>
</Fade> </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) => ( {JOBS.map((j, i) => (
<Fade key={j.name} start={45 + i * 45} y={20}> <Fade key={j.name} start={65 + i * 55} y={20}>
<Panel width={230} style={{ left: 705 + i * 260, top: 210 }}> <Panel width={230} style={{ left: 705 + i * 260, top: 222 }}>
<div style={{ display: 'flex', gap: 8, alignItems: 'center' }}> <div style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
<span style={{ width: 10, height: 10, borderRadius: 5, background: theme.accent }} /> <span style={{ width: 10, height: 10, borderRadius: 5, background: theme.accent }} />
<Mono size={18} color={theme.textPrimary}>{j.name}</Mono> <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 }}> <svg width={1920} height={1080} style={{ position: 'absolute', inset: 0 }}>
<ArrowDefs /> <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 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 265 L 960 265" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow2} markerEnd="url(#arrow)" /> <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 265 L 1220 265" fill="none" stroke={theme.textMuted} strokeWidth={2} pathLength={1} strokeDasharray={1} strokeDashoffset={arrow3} markerEnd="url(#arrow)" /> <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 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 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> </svg>
<Fade start={160} y={20}> <Fade start={185} y={20}>
<Panel width={440} style={{ left: 465, top: 480, opacity: infraOn }}> <Panel width={440} style={{ left: 465, top: 480, opacity: infraOn }}>
<Label size={18}>infra follows the same rules</Label> <Label size={18}>infra follows the same rules</Label>
<div style={{ marginTop: 10 }}> <div style={{ marginTop: 10 }}>
@@ -80,7 +105,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
</Panel> </Panel>
</Fade> </Fade>
<Fade start={225} y={24}> <Fade start={230} y={24}>
<BrowserFrame width={460} height={320} style={{ left: 995, top: 470 }}> <BrowserFrame width={460} height={320} style={{ left: 995, top: 470 }}>
{captured ? ( {captured ? (
<OffthreadVideo <OffthreadVideo
@@ -90,7 +115,7 @@ export const Pipeline: React.FC<{ captured: boolean }> = ({ captured }) => {
) : ( ) : (
<> <>
<PageSkeleton active={deployed > 0.5} /> <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={{ 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' }}> <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"> <svg width={22} height={22} viewBox="0 0 24 24" fill="none" stroke={theme.accent} strokeWidth={2.5} strokeLinecap="round">