387 lines
18 KiB
HTML
387 lines
18 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>Article Request · Sequence</title>
|
||
<link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
||
<style>
|
||
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
||
|
||
:root {
|
||
--color-paper: #f5f4ed;
|
||
--color-paper-2: #efeee5;
|
||
--color-ink: #0b0d0b;
|
||
--color-muted: #52534e;
|
||
--color-soft: #65655c;
|
||
--color-rule: rgba(11,13,11,0.12);
|
||
--color-rule-solid: rgba(135,139,134,0.25);
|
||
--color-accent: #f7591f;
|
||
--color-accent-tint: rgba(247,89,31,0.08);
|
||
--color-link: #1a70c7;
|
||
--font-sans: 'Geist', system-ui, sans-serif;
|
||
--font-serif: 'Instrument Serif', 'Times New Roman', serif;
|
||
--font-mono: 'Geist Mono', ui-monospace, Menlo, monospace;
|
||
}
|
||
|
||
body {
|
||
font-family: var(--font-sans);
|
||
background: var(--color-paper);
|
||
min-height: 100vh;
|
||
padding: 3rem 2rem;
|
||
color: var(--color-ink);
|
||
}
|
||
|
||
.container { max-width: 1200px; margin: 0 auto; }
|
||
|
||
.header { margin-bottom: 2.5rem; }
|
||
|
||
.header-eyebrow {
|
||
font-family: var(--font-mono);
|
||
font-size: 0.66rem;
|
||
font-weight: 500;
|
||
letter-spacing: 0.18em;
|
||
text-transform: uppercase;
|
||
color: var(--color-muted);
|
||
margin-bottom: 0.75rem;
|
||
}
|
||
|
||
h1 {
|
||
font-family: var(--font-serif);
|
||
font-size: clamp(1.75rem, 3vw + 1rem, 2.5rem);
|
||
font-weight: 400;
|
||
letter-spacing: -0.02em;
|
||
line-height: 1.1;
|
||
color: var(--color-ink);
|
||
margin-bottom: 0.5rem;
|
||
}
|
||
|
||
.subtitle {
|
||
font-family: var(--font-sans);
|
||
font-size: 1rem;
|
||
line-height: 1.55;
|
||
color: var(--color-muted);
|
||
max-width: 58ch;
|
||
}
|
||
|
||
.diagram-container {
|
||
background: var(--color-paper-2);
|
||
border-radius: 8px;
|
||
border: 1px solid var(--color-rule);
|
||
padding: 1.5rem;
|
||
overflow-x: auto;
|
||
}
|
||
|
||
svg { width: 100%; min-width: 900px; display: block; }
|
||
|
||
.cards {
|
||
display: grid;
|
||
grid-template-columns: 1.1fr 1fr 0.9fr;
|
||
gap: 1rem;
|
||
margin-top: 1.5rem;
|
||
}
|
||
|
||
@media (max-width: 820px) {
|
||
.cards { grid-template-columns: 1fr; }
|
||
}
|
||
|
||
.card {
|
||
background: #ffffff;
|
||
border-radius: 6px;
|
||
border: 1px solid var(--color-rule);
|
||
padding: 1.25rem;
|
||
}
|
||
|
||
.card .eyebrow {
|
||
font-family: var(--font-mono);
|
||
font-size: 0.5rem;
|
||
letter-spacing: 0.18em;
|
||
text-transform: uppercase;
|
||
color: var(--color-muted);
|
||
margin-bottom: 0.5rem;
|
||
}
|
||
|
||
.card-header {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 0.6rem;
|
||
margin-bottom: 0.875rem;
|
||
padding-bottom: 0.875rem;
|
||
border-bottom: 1px solid rgba(11,13,11,0.08);
|
||
}
|
||
|
||
.card-dot {
|
||
width: 7px; height: 7px;
|
||
border-radius: 50%;
|
||
flex-shrink: 0;
|
||
}
|
||
.card-dot.ink { background: var(--color-ink); }
|
||
.card-dot.muted { background: var(--color-muted); }
|
||
.card-dot.coral { background: var(--color-accent); }
|
||
.card-dot.link { background: var(--color-link); }
|
||
|
||
.card h3 {
|
||
font-family: var(--font-sans);
|
||
font-size: 0.875rem;
|
||
font-weight: 600;
|
||
color: var(--color-ink);
|
||
letter-spacing: -0.005em;
|
||
}
|
||
|
||
.card p {
|
||
color: var(--color-muted);
|
||
font-size: 0.8125rem;
|
||
line-height: 1.55;
|
||
}
|
||
|
||
.card ul {
|
||
list-style: none;
|
||
color: var(--color-muted);
|
||
font-size: 0.8125rem;
|
||
line-height: 1.55;
|
||
}
|
||
|
||
.card li {
|
||
margin-bottom: 0.3rem;
|
||
padding-left: 0.875rem;
|
||
position: relative;
|
||
}
|
||
|
||
.card li::before {
|
||
content: '—';
|
||
position: absolute;
|
||
left: 0;
|
||
color: rgba(11,13,11,0.25);
|
||
font-size: 0.75rem;
|
||
}
|
||
|
||
.footer {
|
||
margin-top: 2rem;
|
||
padding-top: 1.5rem;
|
||
border-top: 1px solid rgba(11,13,11,0.10);
|
||
font-family: var(--font-mono);
|
||
font-size: 0.72rem;
|
||
letter-spacing: 0.06em;
|
||
color: var(--color-soft);
|
||
display: flex;
|
||
justify-content: space-between;
|
||
align-items: center;
|
||
flex-wrap: wrap;
|
||
gap: 0.5rem;
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div class="container">
|
||
|
||
<!-- Header -->
|
||
<div class="header">
|
||
<p class="header-eyebrow">Sequence · Diagram Design</p>
|
||
<h1>Article request, cold cache</h1>
|
||
<p class="subtitle">How littlemight.com serves a reader when the requested slug isn't already sitting in Cloudflare's edge cache — origin render, beacon, and back in one round trip.</p>
|
||
</div>
|
||
|
||
<!-- Sequence Diagram -->
|
||
<div class="diagram-container">
|
||
<svg viewBox="0 0 1000 584" xmlns="http://www.w3.org/2000/svg">
|
||
<defs>
|
||
<!-- Dot grid background -->
|
||
<pattern id="dots" width="22" height="22" patternUnits="userSpaceOnUse">
|
||
<circle cx="1" cy="1" r="0.9" fill="rgba(11,13,11,0.10)"/>
|
||
</pattern>
|
||
|
||
<!-- Arrow markers -->
|
||
<marker id="arrow" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
||
<polygon points="0 0, 8 3, 0 6" fill="#52534e"/>
|
||
</marker>
|
||
<marker id="arrow-accent" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
||
<polygon points="0 0, 8 3, 0 6" fill="#f7591f"/>
|
||
</marker>
|
||
<marker id="arrow-link" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
|
||
<polygon points="0 0, 8 3, 0 6" fill="#1a70c7"/>
|
||
</marker>
|
||
</defs>
|
||
|
||
<!-- Background: paper + dot grid -->
|
||
<rect width="100%" height="100%" fill="#f5f4ed"/>
|
||
<rect width="100%" height="100%" fill="url(#dots)" opacity="0.55"/>
|
||
|
||
<!-- =================================================================
|
||
LIFELINES — dashed vertical lines from each actor, behind everything.
|
||
Actor lifeline x-coords: 128, 352, 584, 800
|
||
================================================================= -->
|
||
<line x1="128" y1="128" x2="128" y2="488" stroke="rgba(11,13,11,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
||
<line x1="352" y1="128" x2="352" y2="488" stroke="rgba(11,13,11,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
||
<line x1="584" y1="128" x2="584" y2="488" stroke="rgba(11,13,11,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
||
<line x1="800" y1="128" x2="800" y2="488" stroke="rgba(11,13,11,0.22)" stroke-width="1" stroke-dasharray="3,3"/>
|
||
|
||
<!-- =================================================================
|
||
ACTIVATION BARS — w=8 rects on lifelines showing control duration.
|
||
Drawn before message arrows so arrows land on their edges.
|
||
================================================================= -->
|
||
<!-- Cloudflare activation: receives at y=176, responds at y=408 -->
|
||
<rect x="348" y="180" width="8" height="232" fill="rgba(11,13,11,0.06)" stroke="#52534e" stroke-width="0.8"/>
|
||
<!-- Astro activation: called at y=232, returns at y=352 -->
|
||
<rect x="580" y="236" width="8" height="120" fill="rgba(11,13,11,0.06)" stroke="#52534e" stroke-width="0.8"/>
|
||
|
||
<!-- =================================================================
|
||
MESSAGE ARROWS — time flows top→down.
|
||
Draw before labels so label masks cover the line.
|
||
================================================================= -->
|
||
|
||
<!-- M1: Reader → Cloudflare (HTTPS request · link-blue) -->
|
||
<line x1="128" y1="176" x2="352" y2="176" stroke="#1a70c7" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
||
|
||
<!-- M2: Cloudflare → Astro (cache miss · muted) -->
|
||
<line x1="352" y1="232" x2="580" y2="232" stroke="#52534e" stroke-width="1.2" marker-end="url(#arrow)"/>
|
||
|
||
<!-- M3: Astro self-message (render MDX · muted U-loop) -->
|
||
<path d="M 588 284 L 624 284 L 624 316 L 588 316" fill="none" stroke="#52534e" stroke-width="1.2" marker-end="url(#arrow)"/>
|
||
|
||
<!-- M4: Astro → Cloudflare (return HTML · muted dashed) -->
|
||
<line x1="580" y1="352" x2="356" y2="352" stroke="#52534e" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
||
|
||
<!-- M5: Cloudflare → Reader (primary success · coral) -->
|
||
<line x1="348" y1="408" x2="128" y2="408" stroke="#f7591f" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
||
|
||
<!-- M6: Reader → Analytics (async beacon · muted dashed) -->
|
||
<line x1="128" y1="464" x2="800" y2="464" stroke="#52534e" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
||
|
||
<!-- =================================================================
|
||
MESSAGE LABELS — each with an opaque paper-colored mask.
|
||
================================================================= -->
|
||
|
||
<!-- M1 label -->
|
||
<rect x="188" y="160" width="104" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="240" y="170" fill="#1a70c7" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">GET /ARTICLES/SLUG</text>
|
||
|
||
<!-- M2 label -->
|
||
<rect x="416" y="216" width="100" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="466" y="226" fill="#52534e" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">CACHE MISS · ORIGIN</text>
|
||
|
||
<!-- M3 label (to the right of the self-loop) -->
|
||
<rect x="632" y="292" width="72" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="668" y="302" fill="#52534e" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">RENDER MDX</text>
|
||
|
||
<!-- M4 label -->
|
||
<rect x="420" y="336" width="96" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="468" y="346" fill="#52534e" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · HTML + MAX-AGE</text>
|
||
|
||
<!-- M5 label (coral · primary response) -->
|
||
<rect x="192" y="392" width="96" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="240" y="402" fill="#f7591f" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">200 · EDGE-CACHED</text>
|
||
|
||
<!-- M6 label (placed between Astro and Analytics lifelines, a clear gap) -->
|
||
<rect x="648" y="448" width="96" height="12" rx="2" fill="#f5f4ed"/>
|
||
<text x="696" y="458" fill="#52534e" font-size="8" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">PAGEVIEW BEACON</text>
|
||
|
||
<!-- =================================================================
|
||
ACTOR BOXES — drawn after arrows/labels.
|
||
Each actor: 144–160 wide × 56 tall. Centers: 128, 352, 584, 800.
|
||
================================================================= -->
|
||
|
||
<!-- Actor 1: Reader (external / soft) -->
|
||
<rect x="56" y="72" width="144" height="56" rx="6" fill="#f5f4ed"/>
|
||
<rect x="56" y="72" width="144" height="56" rx="6" fill="rgba(82,83,78,0.10)" stroke="#65655c" stroke-width="1"/>
|
||
<rect x="64" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(101,101,92,0.40)" stroke-width="0.8"/>
|
||
<text x="78" y="89" fill="#65655c" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EXT</text>
|
||
<text x="128" y="104" fill="#0b0d0b" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Reader</text>
|
||
<text x="128" y="119" fill="#52534e" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Browser</text>
|
||
|
||
<!-- Actor 2: Cloudflare (cloud / muted) -->
|
||
<rect x="280" y="72" width="144" height="56" rx="6" fill="#f5f4ed"/>
|
||
<rect x="280" y="72" width="144" height="56" rx="6" fill="rgba(11,13,11,0.03)" stroke="rgba(11,13,11,0.30)" stroke-width="1"/>
|
||
<rect x="288" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(11,13,11,0.22)" stroke-width="0.8"/>
|
||
<text x="304" y="89" fill="#65655c" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">EDGE</text>
|
||
<text x="352" y="104" fill="#0b0d0b" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Cloudflare</text>
|
||
<text x="352" y="119" fill="#52534e" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Pages · cache</text>
|
||
|
||
<!-- Actor 3: Astro Origin (focal / coral) -->
|
||
<rect x="504" y="72" width="160" height="56" rx="6" fill="#f5f4ed"/>
|
||
<rect x="504" y="72" width="160" height="56" rx="6" fill="rgba(247,89,31,0.08)" stroke="#f7591f" stroke-width="1"/>
|
||
<rect x="512" y="80" width="32" height="12" rx="2" fill="transparent" stroke="rgba(247,89,31,0.50)" stroke-width="0.8"/>
|
||
<text x="528" y="89" fill="#f7591f" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ORIG</text>
|
||
<text x="584" y="104" fill="#0b0d0b" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Astro Origin</text>
|
||
<text x="584" y="119" fill="#52534e" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">SSR + MDX</text>
|
||
|
||
<!-- Actor 4: Analytics (optional / dashed) -->
|
||
<rect x="728" y="72" width="144" height="56" rx="6" fill="#f5f4ed"/>
|
||
<rect x="728" y="72" width="144" height="56" rx="6" fill="rgba(11,13,11,0.02)" stroke="rgba(11,13,11,0.22)" stroke-width="1" stroke-dasharray="4,3"/>
|
||
<rect x="736" y="80" width="28" height="12" rx="2" fill="transparent" stroke="rgba(11,13,11,0.22)" stroke-width="0.8"/>
|
||
<text x="750" y="89" fill="#65655c" font-size="7" font-family="'Geist Mono', monospace" text-anchor="middle" letter-spacing="0.08em">ASY</text>
|
||
<text x="800" y="104" fill="#0b0d0b" font-size="12" font-weight="600" font-family="'Geist', sans-serif" text-anchor="middle">Analytics</text>
|
||
<text x="800" y="119" fill="#52534e" font-size="9" font-family="'Geist Mono', monospace" text-anchor="middle">Beacon · async</text>
|
||
|
||
<!-- =================================================================
|
||
LEGEND — horizontal strip at the bottom.
|
||
Separator at y=504, eyebrow at y=520, items at y=540–548.
|
||
================================================================= -->
|
||
<line x1="56" y1="504" x2="944" y2="504" stroke="rgba(11,13,11,0.10)" stroke-width="0.8"/>
|
||
<text x="56" y="520" fill="#52534e" font-size="8" font-family="'Geist Mono', monospace" letter-spacing="0.18em">LEGEND</text>
|
||
|
||
<!-- Item 1: Actor swatch (coral focal) -->
|
||
<rect x="56" y="540" width="14" height="10" rx="2" fill="rgba(247,89,31,0.08)" stroke="#f7591f" stroke-width="1"/>
|
||
<text x="76" y="548" fill="#52534e" font-size="8.5" font-family="'Geist', sans-serif">Focal actor</text>
|
||
|
||
<!-- Item 2: Activation bar swatch -->
|
||
<rect x="188" y="536" width="4" height="18" fill="rgba(11,13,11,0.06)" stroke="#52534e" stroke-width="0.8"/>
|
||
<text x="200" y="548" fill="#52534e" font-size="8.5" font-family="'Geist', sans-serif">Activation</text>
|
||
|
||
<!-- Item 3: Request arrow (link-blue) -->
|
||
<line x1="308" y1="546" x2="336" y2="546" stroke="#1a70c7" stroke-width="1.2" marker-end="url(#arrow-link)"/>
|
||
<text x="344" y="548" fill="#52534e" font-size="8.5" font-family="'Geist', sans-serif">HTTP request</text>
|
||
|
||
<!-- Item 4: Return / async (muted dashed) -->
|
||
<line x1="476" y1="546" x2="504" y2="546" stroke="#52534e" stroke-width="1.2" stroke-dasharray="5,4" marker-end="url(#arrow)"/>
|
||
<text x="512" y="548" fill="#52534e" font-size="8.5" font-family="'Geist', sans-serif">Return / async</text>
|
||
|
||
<!-- Item 5: Primary response (coral) -->
|
||
<line x1="652" y1="546" x2="680" y2="546" stroke="#f7591f" stroke-width="1.4" marker-end="url(#arrow-accent)"/>
|
||
<text x="688" y="548" fill="#52534e" font-size="8.5" font-family="'Geist', sans-serif">Primary response</text>
|
||
|
||
</svg>
|
||
</div>
|
||
|
||
<!-- Summary cards -->
|
||
<div class="cards">
|
||
<div class="card">
|
||
<p class="eyebrow">THE HEADLINE</p>
|
||
<div class="card-header">
|
||
<span class="card-dot coral"></span>
|
||
<h3>Edge handles the hot path</h3>
|
||
</div>
|
||
<p>On subsequent reads the whole exchange collapses to M1 → M5. Cloudflare serves the cached HTML without waking the origin. The coral arrow is the only one the reader ever perceives.</p>
|
||
</div>
|
||
|
||
<div class="card">
|
||
<div class="card-header">
|
||
<span class="card-dot ink"></span>
|
||
<h3>Origin render on miss</h3>
|
||
</div>
|
||
<ul>
|
||
<li>Astro SSRs MDX on cold cache</li>
|
||
<li>Returns HTML + cache headers</li>
|
||
<li>Edge stores the result</li>
|
||
<li>Next reader skips the origin trip</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="card">
|
||
<div class="card-header">
|
||
<span class="card-dot muted"></span>
|
||
<h3>Analytics is fire-and-forget</h3>
|
||
</div>
|
||
<p>The pageview beacon is dashed for a reason: the reader never waits on it, and a failed beacon never breaks the page.</p>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- Footer -->
|
||
<div class="footer">
|
||
<span>littlemight.com · article request sequence</span>
|
||
<span>example · diagram-design</span>
|
||
</div>
|
||
|
||
</div>
|
||
</body>
|
||
</html>
|