paper-dynasty-database/benchmarks/BASELINE.md

Phase 0 Baseline Benchmarks — WP-00

Captured before any Phase 0 render-pipeline optimizations (WP-01 through WP-04). Run these benchmarks again after each work package lands to measure improvement.

---

1. Per-Card Render Time

What is measured: Time from HTTP request to full PNG response for a single card image. Each render triggers a full Playwright Chromium launch, page load, screenshot, and teardown.

Method

# Set API_BASE to the environment under test
export API_BASE=http://pddev.manticorum.com:816

# Run against 10 batting cards (auto-fetches player IDs)
./benchmarks/benchmark_renders.sh

# Or supply explicit player IDs:
./benchmarks/benchmark_renders.sh 101 102 103 104 105 106 107 108 109 110

# For pitching cards:
CARD_TYPE=pitching ./benchmarks/benchmark_renders.sh

Prerequisites: curl, jq, bc

Results are appended to benchmarks/render_timings.txt.

Baseline Results — 2026-03-13

Environment	Card type	N	Min (s)	Max (s)	Avg (s)
dev (pddev.manticorum.com:816)	batting	10	TBD	TBD	TBD
dev (pddev.manticorum.com:816)	pitching	10	TBD	TBD	TBD

Note: Run ./benchmarks/benchmark_renders.sh against the dev API and paste the per-render timings from render_timings.txt into the table above.

Expected baseline (pre-optimization): ~2.0–3.0s per render (Chromium spawn ~1.0–1.5s + Google Fonts fetch ~0.3–0.5s + render ~0.3s)

---

2. Batch Upload Time

What is measured: Wall-clock time to render and upload N card images to S3 using the pd-cards upload CLI (in the card-creation repo).

Method

# In the card-creation repo:
time pd-cards upload --cardset 24 --limit 20

Or to capture more detail:

START=$(date +%s%3N)
pd-cards upload --cardset 24 --limit 20
END=$(date +%s%3N)
echo "Elapsed: $(( (END - START) / 1000 )).$((  (END - START) % 1000 ))s"

Baseline Results — 2026-03-13

Environment	Cards	Elapsed (s)	Per-card avg (s)
dev (batting)	20	TBD	TBD
dev (pitching)	20	TBD	TBD

Note: Run the upload command in the card-creation repo and record timings here.

Expected baseline (pre-optimization): ~40–60s for 20 cards (~2–3s each sequential)

---

3. Re-run After Each Work Package

Milestone	Per-card avg (s)	20-card upload (s)	Notes
Baseline (pre-WP-01/02)	TBD	TBD	This document
After WP-01 (self-hosted fonts)	—	—
After WP-02 (persistent browser)	—	—
After WP-01 + WP-02 combined	—	—
After WP-04 (concurrent upload)	—	—

Target: <1.0s per render, <5 min for 800-card upload (with WP-01 + WP-02 deployed).