Skip to content
Het fundament eronderShipping systemdeveloper-experience

Vangrails op nieuw werk

Een half gebouwd onderdeel bereikt het team niet.

Nieuw werk in Growth-OS wordt compleet gegenereerd: invoercontracten, serverdiensten met rechtencontrole, clientbedrading, een tenantgebonden stroomvorm en tests. Wat gescaffold is, blijft concept en buiten het productieregister tot een certificeringsrun slaagt. Bekende fouten, zoals caches zonder bereik of serverinterne code die in browsercode belandt, laten een check falen in plaats van zich te verspreiden.

  • 1 command to start a complete feature
  • 0 draft resources in the production registry
  • 1 verify pass before a release

Hoe het werkt

Het mechanisme van begin tot eind, zoals het in de repository is geïmplementeerd.

  1. 1

    Scaffold the slice

    One command generates contracts, permission-checked server services with idempotent receipts and version checks, client wiring, a tenant-scoped shape and tests. It refuses to overwrite existing code.

  2. 2

    Work with fast feedback

    Test commands run only what the change touches, and a doctor command reports configuration and service health without printing a secret.

  3. 3

    Certify to promote

    A certification run against a disposable database is the only way a draft resource becomes certified, and the registry check rejects anything that skipped it.

  4. 4

    Verify before release

    One verify pass runs the architecture, registry, migration and bundle gates, so drift shows up as a failed check with evidence rather than a surprise later.

Interactief voorbeeld

Bekijk het in werking

Deze rondleiding toont het geïmplementeerde backendcontract zonder account, credentials of providercalls.

Interactief voorbeeld

Walk the checks we run before shipping

  1. $ bun run scaffold resource · geslaagd

Toont 1 van 4 controles

Alleen deterministische voorbeelddata. De interactie gebruikt geen account-, provider- of netwerkverbinding.

Het probleem dat dit oplost

Zonder een gedeelde basis bouwt elk team deze randgevallen opnieuw, en anders.

The copy that lost the check

A new feature starts by copying the last one, and each copy drops a permission check here and a version column there until the pattern is no longer a pattern. Generating the slice keeps every one of them complete.

The prototype that went live

A half-finished experiment gets registered, deployed and depended on before anyone decided it was ready. Draft maturity keeps it out of the production registry until certification says otherwise.

Rules that live only in a document

Conventions in a file nobody reads under deadline get re-argued in every review and quietly broken between them. Here breaking one fails a check.

Kernpunten

Waarom dit belangrijk is

Whole features, not snippets

One command generates the full slice: contracts, permission-checked server code, client wiring, a tenant-scoped shape and tests, already connected.

Unfinished stays unshipped

A new scaffold is draft, omitted from the production registry, and rejected by the registry check until a certification run proves it works.

Shortcuts turn red

A pattern check catches literal query keys, unscoped cache operations, browser imports of server internals and unrestricted stream shapes, and the existing debt can only shrink.

Technische garanties

Wat dit wel en niet belooft

Veiligheidsgrens

Checks zeggen waar ze draaiden. Een geslaagde run op een laptop of een wegwerpdatabase wordt nooit gepresenteerd als bewijs over de deployment, en een baan die niet kon draaien is een benoemde beperking in plaats van een stil succes.

Implementatiebewijs

De grens hierboven is geen claim maar code. Deze bestanden dragen het contract:

  • scripts/scaffold.ts
  • scripts/certify-resource.ts
  • scripts/check-patterns.ts
  • docs/DEVELOPER-EXPERIENCE.md
  • docs/RELEASE-CERTIFICATION.md
Vragen

Veelgestelde vragen

Waar Vangrails op nieuw werk op rust

De documentatie beschrijft dezelfde contracten die deze pagina demonstreert.