Add 5 posts (EN + ZH): fully on-chain SVG NFTs, the CRLF art trap, a Chainlink VRF v2.5 lottery, page-by-page PDF verification, JPA @Version

Five posts with custom OG + banner and hire CTAs. Three are web3, giving that category its first posts — /categories/web3/ previously 404'd while the index advertised it as '0 posts - coming soon'. Backdated where the work genuinely is older: the foundry-nft and hardhat-smartcontract-lottery commits date to 2024-08-15..19, so those two posts fill the empty 2024-10 and 2024-12 archive months with updatedDate holding the real date. The two 2026-08-19 posts use their real work date. TERMINALS/BANNERS entries for all five slugs are committed this time (both generators were clean; diffs verified purely additive).
2026-09-29 02:41:58 +08:00
parent 9889ef58f8
commit 95b21e3456
23 changed files with 2875 additions and 1 deletions
@@ -929,6 +929,106 @@ BANNERS['reading-a-containers-own-api-docs'] = {
  ],
 };

+BANNERS['fully-on-chain-svg-nfts'] = {
+  titlebar: 'foundry — sepolia · the art lives in the contract',
+  lines: [
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'forge script script/DeployMoodNft.s.sol --broadcast' },
+    { t: 'prompt', text: 'IPFS' }, { t: 'err', text: 'BasicNft stores a URI — art depends on a pin + a gateway' },
+    { t: 'prompt', text: 'ON-CHAIN' }, { t: 'cmd', text: 'Base64.encode(vm.readFile("img/smile.svg")) at deploy' },
+    { t: 'prompt', text: 'DEPLOY' }, { t: 'ok', text: 'BasicNft@0x84F0… · 4102 bytes of code · 868,596 gas' },
+    { t: 'prompt', text: 'MINT' }, { t: 'cmd', text: 'mintNft() → 181,874 gas · tokenId 0 belongs to the minter' },
+    { t: 'prompt', text: 'FLIP' }, { t: 'err', text: 'flipMood(0) by a non-owner → MoodNft__NotOwnerOfToken' },
+    { t: 'prompt', text: 'FLIP' }, { t: 'ok', text: 'owner flips → HAPPY ⇄ SAD, straight from on-chain state' },
+    { t: 'prompt', text: '' }, { t: 'hl', text: 'metadata + art inside the contract · no gateway lookup' },
+  ],
+  flow: [
+    { n: '1', label: 'draw the SVG' },
+    { n: '2', label: 'base64 at deploy' },
+    { n: '3', label: 'data: URI metadata' },
+    { n: '4', label: 'owner flips mood ✓' },
+  ],
+};
+
+BANNERS['why-my-on-chain-nft-art-changed-on-windows'] = {
+  titlebar: 'windows — one byte rewrites the artwork',
+  lines: [
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'vm.readFile("img/smile.svg") → Base64.encode' },
+    { t: 'prompt', text: 'WIN' }, { t: 'err', text: 'core.autocrlf rewrites the SVG with CRLF on checkout' },
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: "printf 'a\\nb' | base64   → YQpi" },
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: "printf 'a\\r\\nb' | base64 → YQ0KYg==" },
+    { t: 'prompt', text: 'SILENT' }, { t: 'err', text: 'editor identical · git status clean · forge never warns' },
+    { t: 'prompt', text: 'FIX' }, { t: 'cmd', text: 'img/*.svg text eol=lf   in .gitattributes' },
+    { t: 'prompt', text: 'SAME' }, { t: 'ok', text: 'Windows and Linux checkouts encode identical bytes' },
+    { t: 'prompt', text: '' }, { t: 'hl', text: 'assert the encoded URI in a test — art stays reproducible ✓' },
+  ],
+  flow: [
+    { n: '1', label: 'read the bytes' },
+    { n: '2', label: 'CRLF injected' },
+    { n: '3', label: 'base64 differs' },
+    { n: '4', label: 'eol=lf pinned ✓' },
+  ],
+};
+
+BANNERS['chainlink-vrf-v2-lottery-contract'] = {
+  titlebar: 'anvil — raffle · vrf v2.5 + automation',
+  lines: [
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'forge test --match-contract RaffleTest' },
+    { t: 'prompt', text: 'VRF' }, { t: 'err', text: 'InsufficientBalance() — the mock subscription held no funds' },
+    { t: 'prompt', text: 'FIX' }, { t: 'cmd', text: 'fundSubscription + addConsumer before the tests run' },
+    { t: 'prompt', text: 'KEEP' }, { t: 'cmd', text: 'checkUpkeep → true once the interval has elapsed' },
+    { t: 'prompt', text: 'DRAW' }, { t: 'cmd', text: 'performUpkeep → requestRandomWords · state = CALCULATING' },
+    { t: 'prompt', text: 'VRF' }, { t: 'ok', text: 'fulfillRandomWords → randomWords[0] % players.length' },
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'forge snapshot → the full draw costs 335,011 gas' },
+    { t: 'prompt', text: '' }, { t: 'hl', text: 'testnet learning project · not production money-handling code' },
+  ],
+  flow: [
+    { n: '1', label: 'pay to enter' },
+    { n: '2', label: 'timer trips upkeep' },
+    { n: '3', label: 'VRF returns proof' },
+    { n: '4', label: 'winner paid ✓' },
+  ],
+};
+
+BANNERS['verifying-a-pdf-report-page-by-page'] = {
+  titlebar: 'dsm — mPDF vs the browser print',
+  lines: [
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'php tools/pdf-verify.php /tmp/report-v10.html --expect=19' },
+    { t: 'prompt', text: 'BUG' }, { t: 'err', text: 'page header rendered at 2.5pt — invisible past page 1' },
+    { t: 'prompt', text: 'BUG' }, { t: 'err', text: 'stripSheetMargins also clipped .invoice-sheet' },
+    { t: 'prompt', text: 'BUG' }, { t: 'err', text: 'footer art off by 30–490pt — absolute only honoured at top level' },
+    { t: 'prompt', text: 'FIX' }, { t: 'cmd', text: 'per-sheet render · match only a standalone .sheet rule' },
+    { t: 'prompt', text: 'FIX' }, { t: 'cmd', text: 'hoistPinnedArt() + SetHTMLFooter() for the pinned artwork' },
+    { t: 'prompt', text: 'PASS' }, { t: 'ok', text: '19/19 pages MATCH · every deviation ≤ 2pt' },
+    { t: 'prompt', text: '' }, { t: 'hl', text: '20,225,818 bytes · 19 pages · 10.4s · essence 7 pages PASS' },
+  ],
+  flow: [
+    { n: '1', label: 'render per sheet' },
+    { n: '2', label: 'print baseline' },
+    { n: '3', label: 'diff geometry' },
+    { n: '4', label: '≤ 2pt ✓' },
+  ],
+};
+
+BANNERS['jpa-version-field-lost-update'] = {
+  titlebar: 'spring boot — two editors, one row',
+  lines: [
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: 'GET /api/posts/1 → { id: 1, version: 3 }' },
+    { t: 'prompt', text: 'A' }, { t: 'ok', text: 'PUT version 3 → 200 · the row is now version 4' },
+    { t: 'prompt', text: 'B' }, { t: 'err', text: 'PUT version 3 → would overwrite A and still answer 200' },
+    { t: 'prompt', text: 'FIX' }, { t: 'cmd', text: '@Version on the entity → UPDATE … WHERE version = 3' },
+    { t: 'prompt', text: 'JPA' }, { t: 'err', text: 'ObjectOptimisticLockingFailureException' },
+    { t: 'prompt', text: 'API' }, { t: 'ok', text: 'PostVersionConflictException → 409 Conflict' },
+    { t: 'prompt', text: '$' }, { t: 'cmd', text: './mvnw test → integration test asserts the conflict path' },
+    { t: 'prompt', text: '' }, { t: 'hl', text: 'stale writes fail loudly · the client re-reads instead of clobbering' },
+  ],
+  flow: [
+    { n: '1', label: 'read v3' },
+    { n: '2', label: 'A saves' },
+    { n: '3', label: 'B saves stale' },
+    { n: '4', label: '409 ✓' },
+  ],
+};
+
 // ---------- read frontmatter ----------
 const postPath = join(ROOT, 'src', 'content', 'posts', `${slug}.md`);
 let category = 'devops';
@@ -286,6 +286,36 @@ TERMINALS['reading-a-containers-own-api-docs'] = `
    <div class="line"><span class="prompt">$</span><span class="cmd">grep process.env → AUTH_SECRET · PORT 3000 · WORKER_TIMEOUT</span></div>
    <div class="line"><span class="prompt">$</span><span class="cmd">exec cat /proc/net/tcp</span><span class="fix">→ listening on 3000 ✓</span></div>`;

+TERMINALS['fully-on-chain-svg-nfts'] = `
+    <div class="line"><span class="prompt">$</span><span class="cmd">forge script script/DeployMoodNft.s.sol --broadcast</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">tokenURI → ipfs://… · art depends on a pin and a gateway</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">Base64.encode(vm.readFile("img/smile.svg"))</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="fix">→ data:application/json;base64,… · the whole NFT on chain ✓</span></div>`;
+
+TERMINALS['why-my-on-chain-nft-art-changed-on-windows'] = `
+    <div class="line"><span class="prompt">$</span><span class="cmd">vm.readFile("img/smile.svg") → Base64.encode</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">core.autocrlf rewrote the SVG with CRLF in the working tree</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">printf 'a\\nb' | base64  ≠  printf 'a\\r\\nb' | base64</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">img/*.svg text eol=lf</span><span class="fix">→ same bytes on every machine ✓</span></div>`;
+
+TERMINALS['chainlink-vrf-v2-lottery-contract'] = `
+    <div class="line"><span class="prompt">$</span><span class="cmd">forge test --match-contract RaffleTest</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">InsufficientBalance() · the VRF mock had no subscription balance</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">fundSubscription + addConsumer in setUp()</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="fix">→ draw picks a winner · 335,011 gas ✓</span></div>`;
+
+TERMINALS['verifying-a-pdf-report-page-by-page'] = `
+    <div class="line"><span class="prompt">$</span><span class="cmd">php tools/pdf-verify.php /tmp/report-v10.html --expect=19</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">page header rendered at 2.5pt · footer art off by 30–490pt</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">per-sheet render + diff against the browser's own print</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="fix">→ 19/19 PASS · every deviation ≤ 2pt ✓</span></div>`;
+
+TERMINALS['jpa-version-field-lost-update'] = `
+    <div class="line"><span class="prompt">$</span><span class="cmd">PUT /api/posts/1  { "version": 3, "title": … }</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="err">row is already at version 4 · the write would win silently</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="cmd">@Version → UPDATE … WHERE version = 3</span></div>
+    <div class="line"><span class="prompt">&nbsp;</span><span class="fix">→ 409 Conflict, not a lost update ✓</span></div>`;
+
 // ---------- read frontmatter ----------
 const postPath = join(ROOT, 'src', 'content', 'posts', `${slug}.md`);
 if (!existsSync(postPath)) {