Skip to content

docs(roadmap): plan G19 — integration sandbox vertical (ADR 0011)#195

Merged
omercelikdev merged 1 commit into
mainfrom
docs/g19-sandbox-plan
Jul 27, 2026
Merged

docs(roadmap): plan G19 — integration sandbox vertical (ADR 0011)#195
omercelikdev merged 1 commit into
mainfrom
docs/g19-sandbox-plan

Conversation

@omercelikdev

Copy link
Copy Markdown
Owner

What

Planning-only PR — no code changes. Adds the design + roadmap for turning Mockifyr into a self-hosted integration sandbox platform while keeping it, unchanged, a WireMock-compatible mock engine:

  • ADR 0011 (docs/decisions/0011-integration-sandbox-vertical.md) — the full architecture: what an integration sandbox is, which parts Mockifyr already has (tenant-first, scenarios, delay/fault, protocol breadth, G18 messages), and the three gaps that close it — dynamic CRUD state, OpenAPI bootstrap, keyed access.
  • Roadmap G19a–G19e (docs/roadmap.md) — five verticals with per-item done criteria:
    • G19a Core resource model + tenant/collection-scoped IResourceStore + /__admin/resources
    • G19b state response directive (facade-applied, like delay/fault) + {{state.*}} templating
    • G19c OpenAPI 3.x import adapter (edge-only Microsoft.OpenApi, MIT) + Add-stub UI entry
    • G19d API-key tenant resolution + per-key quotas (opt-in --sandbox-auth)
    • G19e Sandbox dashboard section (Resources + Access) + quick-start
  • ADR index row (Status: Proposed → Accepted on merge).

Guardrails honored

  • Core stays pure — state/quotas are directives applied by the facade; new contracts only.
  • Everything opt-in — no directive, no flag, no import → zero behavior change.
  • Parity surface untouched — imported stubs compile to ordinary mappings; differential suites must stay green throughout G19.
  • No-oracle honesty (G18 precedent) — real-client self-tests + Stryker mutation testing, recorded in docs/parity/g19-sandbox.md.
  • Explicit non-goals: portal, self-registration, billing, OAuth, hosted SaaS.

🤖 Generated with Claude Code

Positions Mockifyr as a self-hosted integration sandbox platform on top of
the existing engine: dynamic CRUD state as a facade-applied response
directive (G19a/b), OpenAPI import as an edge adapter (G19c), API-key
tenant resolution + quotas (G19d), and a Sandbox dashboard section (G19e).
Core stays pure, everything is opt-in, the mapping-JSON parity surface
does not move, and validation follows the G18 no-oracle honesty rule
(real-client self-tests + mutation testing, recorded in docs/parity/).

Refs G19.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@omercelikdev
omercelikdev merged commit dca5ab7 into main Jul 27, 2026
3 checks passed
@omercelikdev
omercelikdev deleted the docs/g19-sandbox-plan branch July 27, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant