Sprinting Solo

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-1

Miljø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

  1. ENV_NAME"tst" | "prd" | ...zoneOf()
  2. zoneOf()zone = nonp | prodConfig
  3. ENV_NAME<app>-<type>-<env>ResourceNames
  4. Configenv + zone on every lineLogs
  5. Configrefuses zone = prodSeed
P-2

Lagdelt 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

  1. Schemadefaults + typesAppConfig
  2. ZoneFileoverrides (nonp | prod)AppConfig
  3. EnvFileoverrides (tst, prd, ...)AppConfig
  4. ProcessEnvoverridesAppConfig
  5. SecretStoresecrets at runtimeProcessEnv
  6. AppConfigtyped, validated at startupCode
  7. ToggleServicetoggle(name, tenant) with cached ETag; default in codeCode
P-3

Testdata

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

  1. Migrationsschema + reference data (all zones)Database
  2. Zonenonp only, else refuseSeed
  3. Seedtest orgs, users, records (fixed ids, upsert)Database
  4. Realm(nonp)named personas (admin, member, viewer)Tests
  5. Seedsame personas as rows + constantsTests
  6. Testsclean schema per fileDatabase
P-4

Sporbare 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

  1. Browserrequest + client trace id headerAPI
  2. APIrequest id, user, tenantRequestContext
  3. RequestContextevery line carries env, zone, request id, tenantLogs
  4. APIexception (context data + debug data)ErrorFilter
  5. ErrorFilterfull error, redactedLogs
  6. ErrorFilterProblem Details + request idBrowser
  7. User"it failed, ref 7f3c…"Agent
  8. Agentlookup by request idLogs
P-5

Adskilte 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

  1. Tokenuser (issuer, sub)PermissionGuard
  2. PathorganisationIdPermissionGuard
  3. Membershiprole of user in organisationPermissionGuard
  4. PermissionGuardallowed, scope = organisationIdService
  5. ServiceWHERE organisation_id = scopeDatabase
P-6

Brugere 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

  1. IdPiss, sub, email, email_verifiedToken
  2. TokenBearerAPI
  3. APIfind by (iss, sub)UserTable
  4. UserTablenot foundAPI
  5. Invitationpre-created by e-mailAPI
  6. APIlink if email_verified, else createUserTable
P-7

Rettigheder 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

  1. CataloguepermissionsRoleMap
  2. RoleMaprole -> permissionsGuard
  3. Assignmentsuser x scope -> roleGuard
  4. Guardallow | 403 (deny by default)API
  5. Guardeffective permissionsMeEndpoint
  6. MeEndpoint<Can permission="notes:write">Frontend
P-8

Fælles kerne

Backend, frontend og tjenester skal bruge de samme kontrakter og regler uden at genimplementere dem.

exo1 · delvistexo2 · delvistexo3 · delvist

Løsningen

  • En inderste kerne uden afhængigheder med kontrakter, rettigheder og fejlkoder.
  • Serverinfrastruktur i et ydre lag, der afhænger af kernen – aldrig omvendt.
  • Kernen har sine egne tests og samme tjek-kommando som dem, der bruger den.

Sådan hænger det sammen

  1. ServerInfradepends onKernel
  2. APIdepends onServerInfra
  3. APIdepends onKernel
  4. Webdepends onKernel
  5. Appdepends onKernel
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

  1. Developerbefore commitcheck
  2. Agentedit -> fast checks; stop -> run checkHooks
  3. Hookssame commandcheck
  4. CI(cit)on every PR and push to maincheck
  5. Releaseon tag vX.Y.Zcheck
  6. Releasereal login, full stacke2e
  7. Releasedeploy tagged commit, wait for versionPlatform
P-10

Agent-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

  1. Blueprintdistilled rulesCLAUDE.md
  2. CLAUDE.mdalways loadedAgent
  3. TopicDocsread on demandAgent
  4. Skillsrecurring moves, end with checksAgent
  5. Agentedit / stopHooks
  6. Hooksfast checks; reminder to run checkChecks
  7. 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