API Observatory

A developer-facing map of frontend service calls, Flask routes, cache behavior, and response shapes.

User job

Help builders understand which route powers a screen and whether a data issue is frontend, middleware, or upstream.

Source stack

src/services/api.ts + Flask route modules + docs

src/services/api.ts01

backend/app/routes/api.py02

supabase_endpoints.py03

live_endpoints.py04

Proposed route

/api/observatory

Route

goal catalog page

Hooks

source touchpoints

Mode

Debug

beta-scoped lab

Route matrix

Frontend helper, Flask endpoint, cache policy, and primary table are shown in one searchable matrix.

Representative fields and nullable states are documented for each route family.

Common 401, 404, empty, stale, and partial-response states get specific triage guidance.