Architecture Overview
Last reviewed: 2026-06-30
AppRanks Product OS is deployed as Cloudflare Workers with split surfaces for admin, runtime and ingestion. A legacy platform Worker remains as compatibility/rollback surface.
Surfaces
Section titled “Surfaces”| Surface | Entry | Purpose |
|---|---|---|
| Admin | worker/src/admin-index.ts |
Dashboard static assets, Product OS API, docs and OpenAPI. |
| Runtime | worker/src/runtime-index.ts |
App-facing low-latency runtime, identity, entitlements and decision routes. |
| Ingestion | worker/src/ingestion-index.ts |
Provider webhooks, analytics batch ingestion, queues and scheduled work. |
| Platform | worker/src/index.ts |
Legacy monolith compatibility surface. |
Shared Services
Section titled “Shared Services”- Postgres/Neon through Cloudflare Hyperdrive is the primary source of truth.
- KV stores compiled runtime config and fast snapshots.
- Queues decouple analytics and Google Play RTDN processing.
- R2 stores raw analytics event batches.
- Worker assets serve dashboard and docs static builds.
Documentation Serving
Section titled “Documentation Serving”The Starlight docs build is static and copied into worker/public/docs. The admin Worker serves /docs, /docs/, /docs/* and /openapi.json. Runtime and ingestion do not expose docs.