Freeze the evidence boundary first
This curriculum teaches the durable host workflow around reviewed Mappls surfaces. It does not manufacture provider endpoints, callbacks, resource states, entitlement, or completion evidence.
Model the lifecycle before the UI
Turn the route planning session blueprint into an explicit aggregate boundary owned by the application.
Build
Prove before continuing
Implement every command and event pair
Make intent, actor authority, allowed source state, committed state, and emitted fact reviewable together.
Build
Prove before continuing
Persist restart-safe records
Separate business identity, provider evidence, command receipts, immutable facts, audit, and downstream delivery.
Build
Prove before continuing
Make concurrency and replay deterministic
Apply optimistic expected versions and aggregate-scoped idempotency before executing effects.
Build
Prove before continuing
Control effects and unknown outcomes
Commit outbox intent atomically, execute effects outside the transaction, and reconcile ambiguous results.
Build
Prove before continuing
Run all hostile fixture scenarios
Exercise the success path plus replay, concurrency, state, and response-loss failures without an account.
Build
Prove before continuing
Trace the Deep-link & Native UI Journey Host capstone
Follow the maintained source through domain rules, adapter seam, repository transaction, HTTP boundary, UI evidence, and restart test.
Build
Prove before continuing
Qualify the real integration boundary
Replace only reviewed adapter seams and collect independent production evidence without weakening application invariants.
Build
Prove before continuing
Application-owned reliability scaffolds
The aggregate and SQL examples implement host truth; the fixture clients call the credential-free Journey Lab. Replace only the separately reviewed provider adapter seam.
type State = "draft" | "editing" | "calculating" | "candidates_ready" | "selected" | "handoff_pending" | "handed_off" | "cancelled";
type CommandName = "create_plan" | "open_direction_ui" | "request_routes" | "receive_routes" | "select_route" | "request_navigation" | "confirm_handoff" | "cancel_plan";
type Command = {
name: CommandName;
aggregateId: string;
expectedVersion: number;
idempotencyKey: string;
};
const transitions = {
"create_plan": { from: [null], to: "draft", event: "route_plan.created" },
"open_direction_ui": { from: ["draft", "selected"], to: "editing", event: "route_plan.editor_opened" },
"request_routes": { from: ["editing"], to: "calculating", event: "route_plan.calculation_requested" },
"receive_routes": { from: ["calculating"], to: "candidates_ready", event: "route_plan.candidates_received" },
"select_route": { from: ["candidates_ready"], to: "selected", event: "route_plan.route_selected" },
"request_navigation": { from: ["selected", "candidates_ready"], to: "handoff_pending", event: "route_plan.navigation_requested" },
"confirm_handoff": { from: ["handoff_pending"], to: "handed_off", event: "route_plan.navigation_handed_off" },
"cancel_plan": { from: ["draft", "editing", "calculating", "candidates_ready", "selected", "handoff_pending"], to: "cancelled", event: "route_plan.cancelled" },
} as const;
export function decide(current: { state: State | null; version: number }, command: Command) {
const rule = transitions[command.name];
if (command.expectedVersion !== current.version) throw new Error("version_conflict");
if (!rule.from.includes(current.state as never)) throw new Error("invalid_transition");
return {
state: rule.to as State,
version: current.version + 1,
event: rule.event,
idempotencyKey: command.idempotencyKey,
};
}
// Persist the result, immutable event, audit row, and outbox intent atomically.
// Store the first result by idempotencyKey before executing another effect.Exit with reviewable evidence
Workshop completion proves an application-owned reliability design only. Production still requires issued entitlement, exact adapter contract tests, regional and quota validation, security/privacy review, operational drills, and independent release approval.
Trace every external claim to an indexed source
Break the application before connecting the provider.
Run all five hostile scenarios and the maintained capstone test suite. Then qualify the exact provider seam under independently reviewed non-production entitlement.