Milestones

Your brief, line by line

Each requirement from the project description, what this proof of concept already demonstrates, and where you can see it for yourself.

Source review & data design

5/5 demonstrated

Review published API docs, terms and access requirements for all three providers
Provider-by-provider review with links to every document →
Working in POC
Identify access method, authentication, request limits and restrictions
Auth, documented limits and the limits we actually apply →
Working in POC
Source-by-source field availability matrix
24 fields × 3 providers, with exact source paths; CSV download →
Working in POC
Normalized event / sub-event schema and a sample JSON record
JSON Schema, TypeScript types, live sample record →
Working in POC
Which providers can be integrated now — and why not, if not
RunSignup: now · ACTIVE: needs free key · Race Roster: partner approval →
Working in POC

7/7 demonstrated

RunSignup integration (priority)
Live: full US sweep with automatic partitioning past the 1,000-result cap →
Working in POC
ACTIVE integration where documented access allows
Adapter built & tested against the documented schema; activates with an API key
Built · awaiting access
Race Roster integration where documented access allows
Partner-gated: adapter makes zero calls and reports the limitation each run
Built · awaiting access
One record per event distance (sub-event)
Status, price and dates tracked per distance →
Working in POC
Event details, status, period dates & prices, capacity / waitlist, source, retrieval time
Every field with explicit availability →
Working in POC
Maximum capacity kept separate from registrations / remaining — never inferred
Separate sourced fields with a reason when missing →
Working in POC
Relative countdowns retained and converted to calendar dates
countdowns[] keeps the original text plus the computed date
Working in POC

7/7 demonstrated

Nightly start at 2:00 a.m. America/New_York
DST-aware GitHub Actions schedule →
Working in POC
One-at-a-time queue, ≥ 60 s between calls (longer if a provider requires)
Single queue, Retry-After honoured, retries count toward spacing →
Working in POC
Runtime estimate for the target list before deployment
Estimate logged per run + interactive estimator →
Working in POC
Export to JSON / CSV and upload to a private cloud folder
Private bucket, secure download proxy, checksums →
Working in POC
Record-level error logging, safe backoff, failed-run alerts
Per-record errors, exponential backoff, circuit breaker, GitHub issue (emailed) + Slack/Teams webhook →
Working in POC
Deployment & operating instructions
Plain-English manual (web + PDF) →
Working in POC
Three consecutive successful staging runs
Visible in the run history →
Working in POC

Included beyond the brief

Search, filter and inspect every record exactly as your frontend will see it.

Price and status snapshots per distance — ready for "price rises Friday" badges.

Generated TypeScript types and a ready-to-paste App Router example.

Indexed tables and search functions your site can query directly, not just files.

Secrets only in CI and server functions; private bucket; no keys in the browser.

RunSignup affiliate token support for directory revenue share, off by default.