backend-guide

command
v0.1.16 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 30, 2026 License: Apache-2.0 Imports: 17 Imported by: 0

Documentation

Overview

Command backend-guide is the companion example to docs/BACKEND_SPEC_LLM.md — a complete, COMPILING Appximo backend built the library way (ADR-016): a schema (schema.json) for the declarative surface, plus custom Class-1 handlers for the logic a schema can't express (external calls, cross-resource transactions, parallel work). Every handler below is referenced verbatim by the guide, and every safety pattern from Phase 0 (LIBRARY-HARDEN-S1) is shown: SafeGo for goroutines, SafeParallel for bounded fan-out, Route.Timeout for deadlines, a Public route with the caller treated as hostile.

Run it like the pure binary (all three env vars required):

DATABASE_URL=... JWT_SECRET=... ADMIN_KEY=... \
  go run ./examples/backend-guide --schema examples/backend-guide/schema.json

External integrations fall back to a local stub when their *_URL env var is unset, so the example runs standalone; set the vars to call the real services.

Directories

Path Synopsis
Command worker is the FRAMEWORK-MODE outbox consumer for the backend-guide example — the other half of the async story in docs/BACKEND_SPEC_LLM.md §6.
Command worker is the FRAMEWORK-MODE outbox consumer for the backend-guide example — the other half of the async story in docs/BACKEND_SPEC_LLM.md §6.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL