Arbeidsområder, autentisering, API-er og observabilitet, bygget på Cloudflare. Strukturerte logger og sporing av forespørsler følger med; ekstern overvåking er valgfri.
Start med arbeidsområdeoversikten. Se API-kontrakten og den delte funksjonen, deretter infrastrukturen bak appen.
Arbeidsområdeoversikten leverer dataene på denne siden.
curl -H "Authorization: Bearer $API_TOKEN" \
https://api.example.com/workspaces/starter-lab/overview
{
"workspace": {
"id": "wrk_starter",
"slug": "starter-lab",
"name": "Starter Lab",
"planId": "team"
},
"notifications": []
}Denne installasjonen har ikke et eksempelarbeidsområde. Vertsnavnet og svaret viser et eksempel med seed-data.
Hver rute beskriver parametere, svar og feil. Gruppen krever bearer-autentisering.
export const WorkspaceApi = HttpApiGroup.make('workspace')
.add(
HttpApiEndpoint.get('overview', '/workspaces/:slug/overview', {
params: SlugParams,
success: WorkspaceOverviewDto,
error: WORKSPACE_ERRORS
})
)
.middleware(BearerAuth)Webappen, REST og MCP kaller den samme kapabiliteten.
export const workspaceOverview: Effect.Effect<
WorkspaceOverviewProjection,
CapabilityUnavailable,
WorkspaceContext | NotificationFeed
> = Effect.gen(function* () {
const ctx = yield* WorkspaceContext
const feed = yield* NotificationFeed
const notifications = yield* feed.list
return {
workspace: ctx.workspace,
notifications
}
})return runWorkspaceCapabilities(
DEMO_WORKSPACE_SLUG,
Effect.all(
{
overview: workspaceOverview,
…
},
{ concurrency: 'unbounded' }
)
).handle('overview', ({ params, request }) =>
workspaceRead(READ_OPERATIONS.overview, params, undefined, request)
)const caller = yield* requireCaller()
const invoke = yield* decodeOperationInput(operation, payload)
…
const guarded = Effect.gen(function* () {
yield* authorizeMcpOperation(caller, operation.permission, MCP_READ_SCOPE)
return yield* invoke
}).pipe(Effect.scoped)Cloudflare Workers kjører appen og API-et. D1 lagrer forretningsdata, Durable Objects lagrer private assistentsamtaler, og Queues og Email håndterer levering.
Webapp, REST- og MCP-API og bakgrunnsjobber
apps/web · apps/api · apps/background
Arbeidsområdedata, skjema og migrasjoner
packages/db
Privat assistenthistorikk, ett aktivt svar og gjenopptakelse etter frakobling
apps/web · WorkspaceAssistantConversation
Levering av webhooks med nye forsøk og økende ventetid
apps/background
Transaksjonsbasert e-post, aktivert når den er konfigurert
packages/email
pnpm run deploy
Disse integrasjonene er av til du konfigurerer dem. Du kan kjøre appen uten dem.
| Leverandør | Rolle |
|---|---|
| Stripe | Fakturering |
| Cloudflare Web Analytics | Nettstedsanalyse |
| Cloudflare Email | Transaksjonell e-post |
| Turnstile | Bot-beskyttelse |
Oppsettsveiledningen og arkitekturdokumentasjonen ligger sammen med koden.
docs/
Oppsett, arkitektur, utrulling og lisens.
Klon repoet og kjør kommandoene nedenfor. Eksempelarbeidsområdet kjører lokalt uten Stripe-konto, OAuth-app eller e-postleverandør.
Klon og kjør