APIs, SaaS & System Architecture
This hub covers the boundaries that keep SaaS products understandable and safe: tenant context, authorization, API contracts, durable workflows, database isolation and explicit failure semantics.
How are retries made safe across services and jobs?
When is a modular monolith better than distributed services?
Define the boundary, then choose the technology.
Protect the boundary
Derive tenant and authorization scope from trusted identity, never from an untrusted payload.
Make retries explicit
Idempotency keys, outboxes and durable inboxes are business correctness mechanisms.
Distribute only for a reason
Separate services when ownership, scaling or failure isolation justifies the coordination cost.
Continue with practical guides.
GPT-Image 2.6: build a production asset pipeline, not a prompt demo
OpenAI's GPT-Image 2.6 adds Sunburst, Flare, complexity, markup edits, SVG and GIF. Build a governed asset pipeline with validation, evaluation and rollback.
Read the guideSaudi commerce · Logistics · ZidZid shipping weight disputes: build evidence before wallet deductions
Design a reliable Zid shipping-weight workflow with packed measurements, versioned factors, AWB and wallet reconciliation, and per-shipment dispute evidence.
Read the guideAI · Agents · Model routingClaude Fable 5.2: route frontier work without making it the default
Migrate to Claude Fable 5.2 with workload routing, retention gates, tool compatibility, evals, canaries and a clean rollback plan.
Read the guideSaudi commerce · Payments · Mobile POSTap to Pay on iPhone in Saudi Arabia: design the payment boundary
Design Saudi Tap to Pay on iPhone safely across merchant apps, PSPs, backends, webhooks, reconciliation, refunds and commerce platforms.
Read the guideAI engineering · Cybersecurity · AgentsGPT-6 Cyber: build an authorized research control plane
A production guide to GPT-6-Cyber: Daybreak Red access, scope manifests, isolated labs, tool approvals, evidence capture and independent patch verification.
Read the guideOpenAI · Coding agents · Distributed systemsOpenAI Pando: design Git infrastructure for coding-agent scale
A source-backed analysis of OpenAI's Pando architecture and a practical design for source control that stays correct under coding-agent concurrency.
Read the guideAI engineering · Anthropic · API migrationClaude Opus 4.8 fast mode retires: migrate without latency regressions
A production migration guide for removing Claude Opus 4.8 fast-mode dependencies without confusing feature retirement with model retirement or hiding compatibility regressions.
Read the guideSaudi commerce · Salla · Inventory architectureSalla order stock relocation: move branches without overselling
A production guide to treating Salla stock relocation as an auditable command, recovering unknown outcomes and reconciling every downstream inventory projection.
Read the guideOpenAI · Life sciences AI · GovernanceGPT-6 Rosalind Research: build a governed life-sciences workflow
A production guide to GPT-6 Rosalind Research access, data boundaries, scientific tools, evidence, human review, migration, audit and revocation.
Read the guideSaudi commerce · Salla · Webhook architectureSalla conditional webhooks: filter events without losing control
A production guide to filtering Salla events at the source while preserving security, idempotency, audit evidence and authoritative recovery.
Read the guideOpenAI · AI agents · GovernanceOpenAI Model Spec: turn agent autonomy into an action contract
A production guide to translating OpenAI's updated guidance on intent, context, agency and side effects into deterministic controls around tool-using agents.
Read the guideSaudi commerce · Salla · Booking architectureSalla order reservations: prevent double-booking across systems
A production guide to treating Salla reservations as observations, detecting interval and capacity conflicts, and keeping calendar and ERP projections recoverable.
Read the guide