brackt/app/routes/admin/jobs.sync-and-simulate.ts
chrisp 273742f02e
Some checks failed
🚀 Deploy / 🧪 Test (push) Failing after 2m45s
🚀 Deploy / ʦ🔍 Typecheck & Lint (push) Successful in 1m27s
🚀 Deploy / 🐳 Build (push) Has been skipped
🚀 Deploy / 🚀 Deploy (push) Has been skipped
Phase A: external HTTP cron jobs for snapshots, standings sync, and simulation (#79)
## Summary

- Removes the last in-process \`setInterval\` (\`server/snapshots.ts\` 24h loop) and replaces it with an external HTTP cron job via Forgejo Actions
- Adds automated standings sync + conditional simulation: syncs every 2h, only simulates when standings actually changed (detected by comparing \`gamesPlayed\`/\`leagueRank\` before upsert)
- Adds \`GET /healthz\` for Docker healthcheck (Phase B prerequisite)

## What's new

| Endpoint | Triggered by | What it does |
|---|---|---|
| \`POST /admin/jobs/run-daily-snapshots\` | Forgejo schedule \`5 0 * * *\` | Creates daily fantasy standings snapshots for all active/draft seasons |
| \`POST /admin/jobs/sync-and-simulate\` | Forgejo schedule \`0 */2 * * *\` | Syncs standings from external APIs; runs simulation only if standings changed |
| \`GET /healthz\` | Docker / Traefik | Returns 200 \`{ok:true}\` when DB reachable, 503 otherwise |

Both cron endpoints are protected by \`X-Cron-Secret\` header (set \`CRON_SECRET\` in Forgejo repo secrets + production env).

## Schema changes (migration 0118)

Two new nullable columns on \`sports_seasons\`:
- \`standings_last_changed_at\` — written by \`syncStandings()\` when data actually changes
- \`last_simulated_at\` — written by the cron job after a successful simulation run

## Deployment notes

1. Add \`CRON_SECRET\` to Forgejo repo secrets (generate with \`openssl rand -hex 32\`)
2. Add same value to production environment
3. Migration runs automatically via the \`migrate\` container on deploy

## Test plan

- [ ] \`curl -X POST https://brackt.com/admin/jobs/run-daily-snapshots -H "X-Cron-Secret: ..."\` → 200 \`{total, succeeded, errors}\`
- [ ] \`curl -X POST https://brackt.com/admin/jobs/sync-and-simulate -H "X-Cron-Secret: ..."\` → 200 with \`synced\`/\`unchanged\`/\`simulated\` breakdown
- [ ] \`curl https://brackt.com/healthz\` → 200 \`{ok:true}\`
- [ ] Verify Forgejo workflow runs appear in Actions tab after merge
- [ ] Kill web process mid-day; confirm external cron still fires (no in-process dependency)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Chris Parsons <chrisparsons1127@gmail.com>
Reviewed-on: #79
2026-06-08 07:42:14 +00:00

61 lines
2.2 KiB
TypeScript

import { database } from "~/database/context";
import { eq } from "drizzle-orm";
import * as schema from "~/database/schema";
import { findSportsSeasonsByStatus } from "~/models/sports-season";
import { syncStandings } from "~/services/standings-sync";
import { runSportsSeasonSimulation } from "~/services/simulations/runner";
import { requireCronSecret } from "~/lib/cron-auth";
export async function action({ request }: { request: Request }) {
requireCronSecret(request);
const activeSeasons = await findSportsSeasonsByStatus("active");
const synced: string[] = [];
const unchanged: string[] = [];
const simulated: string[] = [];
const syncErrors: { id: string; error: string }[] = [];
const simErrors: { id: string; error: string }[] = [];
for (const season of activeSeasons) {
let changed = false;
try {
const result = await syncStandings(season.id);
changed = result.changed;
if (changed) {
synced.push(season.id);
} else {
unchanged.push(season.id);
}
} catch (err) {
// Sports without a sync adapter (F1, IndyCar, etc.) throw — skip gracefully
syncErrors.push({ id: season.id, error: err instanceof Error ? err.message : String(err) });
continue;
}
if (!changed) continue;
// changed === true means syncStandings() detected new data this run, so simulate.
// Overlap is guarded inside runSportsSeasonSimulation (throws if simulationStatus === "running").
try {
await runSportsSeasonSimulation(season.id);
await database()
.update(schema.sportsSeasons)
.set({ lastSimulatedAt: new Date() })
.where(eq(schema.sportsSeasons.id, season.id));
simulated.push(season.id);
} catch (err) {
// Seasons without a simulator config or that fail readiness checks throw — skip gracefully
simErrors.push({ id: season.id, error: err instanceof Error ? err.message : String(err) });
}
}
const hasErrors = syncErrors.length > 0 || simErrors.length > 0;
const hasSuccess = synced.length > 0 || unchanged.length > 0;
const status = hasErrors && !hasSuccess ? 500 : 200;
return Response.json(
{ synced, unchanged, simulated, syncErrors, simErrors },
{ status }
);
}