Delelageret
Fabrikkens dele er mønstre: løsninger på problemer, der går igen i alle forretningsapplikationer. Vi har hentet dem i Sprintings egne produktionssystemer, gjort dem uafhængige af teknologi og bygger dem ind i hvert exo.
P-1Miljøer og zoner
Kode og mennesker skal altid vide, hvilket miljø de er i, og om det er produktion.
exo1 · anvendtexo2 · anvendtexo3 · anvendt
Løsningen
- Hvert miljø har et kort navn (lcl, tst, prd), og navnet er den eneste indstilling.
- Zonen (prod eller nonp) udledes af navnet ét sted i koden; intet krydser zonegrænsen.
- Farlige handlinger som testdata og fejldetaljer nægter at køre i prod-zonen.
Sådan hænger det sammen
- ENV_NAME"tst" | "prd" | ...zoneOf()
- zoneOf()zone = nonp | prodConfig
- ENV_NAME<app>-<type>-<env>ResourceNames
- Configenv + zone on every lineLogs
- Configrefuses zone = prodSeed
P-2Lagdelt konfiguration
Indstillinger er forskellige pr. miljø, og noget adfærd skal kunne ændres uden en ny udrulning.
exo1 · delvistexo2 · delvistexo3 · delvist
Løsningen
- Ét skema med typer og standardværdier; applikationen starter ikke med ugyldig konfiguration.
- Lag fra standard over zone og miljø til procesmiljø; hemmeligheder kommer fra hostingens hemmelighedslager.
- Feature-toggles er en separat, lille mekanisme – én for hele platformen.
Sådan hænger det sammen
- Schemadefaults + typesAppConfig
- ZoneFileoverrides (nonp | prod)AppConfig
- EnvFileoverrides (tst, prd, ...)AppConfig
- ProcessEnvoverridesAppConfig
- SecretStoresecrets at runtimeProcessEnv
- AppConfigtyped, validated at startupCode
- ToggleServicetoggle(name, tenant) with cached ETag; default in codeCode
P-3Testdata
Alle udviklere, tests og testmiljøer skal have de samme kendte data, og produktion må aldrig få testdata.
exo1 · delvistexo2 · delvistexo3 · delvist
Løsningen
- Seed-data indlæses automatisk og idempotent efter migreringer – men aldrig i prod-zonen.
- Faste id'er og navngivne testpersoner med kendte roller, de samme for udviklere, agenter og tests.
- Tests isolerer sig selv i stedet for at dele en database.
Sådan hænger det sammen
- Migrationsschema + reference data (all zones)Database
- Zonenonp only, else refuseSeed
- Seedtest orgs, users, records (fixed ids, upsert)Database
- Realm(nonp)named personas (admin, member, viewer)Tests
- Seedsame personas as rows + constantsTests
- Testsclean schema per fileDatabase
P-4Sporbare fejl
Forbind det, brugeren så, med det, serveren loggede, uden at lække interne detaljer.
exo1 · delvistexo2 · delvistexo3 · delvist
Løsningen
- Hver forespørgsel får et id, og hver loglinje bærer miljø, zone, forespørgsel og kunde.
- Én fejlkontrakt (RFC 9457 Problem Details) og ét globalt filter, der skjuler detaljer i produktion.
- Hemmeligheder maskeres før logning, og en agent kan slå en fejlreference op i loggene.
Sådan hænger det sammen
- Browserrequest + client trace id headerAPI
- APIrequest id, user, tenantRequestContext
- RequestContextevery line carries env, zone, request id, tenantLogs
- APIexception (context data + debug data)ErrorFilter
- ErrorFilterfull error, redactedLogs
- ErrorFilterProblem Details + request idBrowser
- User"it failed, ref 7f3c…"Agent
- Agentlookup by request idLogs
P-5Adskilte kundedata
Én organisation må aldrig se en andens data – i nogen forespørgsel.
exo1 · anvendtexo2 · anvendtexo3 · delvist
Løsningen
- Hver ejet række har en organisationsnøgle, og scopet kommer fra én kilde pr. forespørgsel.
- Tjenesten filtrerer altid på scopet gennem et fælles lag, så det ikke kan glemmes.
- Hvert endpoint testes for, at organisation B ikke kan læse eller ændre organisation A's data.
Sådan hænger det sammen
- Tokenuser (issuer, sub)PermissionGuard
- PathorganisationIdPermissionGuard
- Membershiprole of user in organisationPermissionGuard
- PermissionGuardallowed, scope = organisationIdService
- ServiceWHERE organisation_id = scopeDatabase
P-6Brugere fra login-systemet
Opret og forbind applikationens brugere fra login-systemet uden manuelle trin eller utilsigtet adgang.
exo1 · anvendtexo2 · anvendtexo3 · anvendt
Løsningen
- Login-systemet beviser, hvem man er; applikationen bestemmer, hvad man må.
- Brugere oprettes ved første login og nøgles på login-systemets stabile id, ikke e-mailen.
- Inviterede brugere forbindes kun med en bekræftet e-mail, og nye brugere får ingen rettigheder automatisk.
Sådan hænger det sammen
- IdPiss, sub, email, email_verifiedToken
- TokenBearerAPI
- APIfind by (iss, sub)UserTable
- UserTablenot foundAPI
- Invitationpre-created by e-mailAPI
- APIlink if email_verified, else createUserTable
P-7Rettigheder som data
Hvem må se hvilken skærm og kalde hvilket endpoint – ens i frontend og backend.
exo1 · anvendtexo2 · anvendtexo3 · anvendt
Løsningen
- Et katalog af navngivne rettigheder, roller der peger på dem, og tildelinger i databasen.
- Lukket som standard: et endpoint uden erklæret rettighed er lukket.
- Én fælles regelmotor; frontenden viser og skjuler med de samme rettigheder.
Sådan hænger det sammen
- CataloguepermissionsRoleMap
- RoleMaprole -> permissionsGuard
- Assignmentsuser x scope -> roleGuard
- Guardallow | 403 (deny by default)API
- Guardeffective permissionsMeEndpoint
- MeEndpoint<Can permission="notes:write">Frontend
P-9Én tjek-port
"Færdig" skal betyde det samme for en udvikler, en agent og pipelinen.
exo1 · anvendtexo2 · anvendtexo3 · anvendt
Løsningen
- Én kommando er definitionen af færdig: lint, typer, unit- og integrationstests mod en rigtig database.
- End-to-end-tests gennem det rigtige login før hver release.
- Samme kommando kører lokalt, i agenternes hooks og i CI.
Sådan hænger det sammen
- Developerbefore commitcheck
- Agentedit -> fast checks; stop -> run checkHooks
- Hookssame commandcheck
- CI(cit)on every PR and push to maincheck
- Releaseon tag vX.Y.Zcheck
- Releasereal login, full stacke2e
- Releasedeploy tagged commit, wait for versionPlatform
P-10Agent-laget
Agenter skal kende konventionerne og kunne tjekke deres eget arbejde – uden en enorm kontekst eller fri adgang.
exo1 · anvendtexo2 · anvendtexo3 · anvendt
Løsningen
- Én instruktionsfil pr. repository, destilleret fra arkitekturen, og emnedokumenter, der læses ved behov.
- Skills til de tilbagevendende træk, som alle slutter med at køre tjekkene.
- Hooks lukker feedback-sløjfen, og tilladelserne er afgrænsede.
Sådan hænger det sammen
- Blueprintdistilled rulesCLAUDE.md
- CLAUDE.mdalways loadedAgent
- TopicDocsread on demandAgent
- Skillsrecurring moves, end with checksAgent
- Agentedit / stopHooks
- Hooksfast checks; reminder to run checkChecks
- Checksgreen | redAgent
"Anvendt" betyder, at exo'ets kode indeholder mønstret. Det er først gennemprøvet, når en rigtig applikation er bygget på exo'et.
← Tilbage til fabrikken