Miljoer og bygg-konfigurasjon

Impulse AI kjorer mot tre miljoer: Development (localhost), Staging (Railway staging) og Production (Railway production). Hvilket miljo appen bruker bestemmes automatisk ved bygg-tid basert pa hvordan appen er bygget og distribuert.

Miljoer

Miljo	API URL	Bruksomrade
Development	http://127.0.0.1:3001	Lokal utvikling i simulator
Staging	https://api-stg.impulseai.app	Testing pa device, TestFlight
Production	https://api.impulseai.app	App Store-distribusjon

Hver miljo har egne Supabase-instanser og API-nokler. All konfigurasjon ligger i KMP shared-modulen (Environment.kt).

---

Automatisk miljovelg

Appen bestemmer miljo automatisk uten manuell konfigurasjon:

Scenario	Miljo	Deteksjon
Simulator (Debug)	Development	#if DEBUG + targetEnvironment(simulator)
USB-device fra Xcode	Staging	#if DEBUG + fysisk device
TestFlight	Staging	Release-build + sandboxReceipt
App Store	Production	Release-build + ikke sandbox

Hvordan det fungerer

Logikken kjorer i ImpulseApp.swift ved oppstart:

#if DEBUG
    #if targetEnvironment(simulator)
        // Simulator → localhost (DEVELOPMENT)
    #else
        // Fysisk device via USB → STAGING
    #endif
#else
    // Release-build
    let isTestFlight = Bundle.main.appStoreReceiptURL?
        .lastPathComponent == "sandboxReceipt"
    if isTestFlight {
        // TestFlight → STAGING
    } else {
        // App Store → PRODUCTION
    }
#endif

Nøkkelkonsepter:

• #if DEBUG er en kompilator-flagg — satt til true i Debug-konfigurasjon, false i Release
• targetEnvironment(simulator) skiller mellom simulator og fysisk device i Debug-builds
• sandboxReceipt er Apples markør for TestFlight-installerte apper — App Store-versjoner har receipt i stedet

aside.tip

Du trenger ikke gjøre noe manuelt. Koble til device og kjor fra Xcode → staging. Bygg med Fastlane → TestFlight → staging. Alt er automatisk.

---

Manuell override

For spesielle tilfeller kan du overstyre miljoet manuelt. Overrides har høyere prioritet enn de automatiske reglene.

Via Xcode scheme

1. Product → Scheme → Edit Scheme (eller ⌘<)
2. Velg Run → Arguments → Environment Variables
3. Legg til eller aktiver APP_ENVIRONMENT med verdi STAGING, PRODUCTION eller DEVELOPMENT

Verdier som stettes

Verdi	Miljo
STAGING eller STG	Staging
PRODUCTION eller PRD	Production
DEVELOPMENT eller DEV	Development (fjerner override)

Persistering

Nar du setter APP_ENVIRONMENT via Xcode, lagres verdien i UserDefaults. Det betyr:

• Appen beholder miljovalget etter at du kobler fra Xcode
• Virker ogsa etter restart av appen
• Nullstill ved a sette APP_ENVIRONMENT=DEVELOPMENT eller slette appen

aside.caution

Manuell override overstyrer ALL automatisk logikk. Hvis du har satt PRODUCTION manuelt og glemmer det, vil selv simulator-builds snakke med produksjons-APIet. Sett tilbake til DEVELOPMENT nar du er ferdig med testing.

---

Konfigurasjon per miljo

API og backend

	Development	Staging	Production
API	http://127.0.0.1:3001	https://api-stg.impulseai.app	https://api.impulseai.app
Supabase	http://127.0.0.1:54331	conxpuqktkeiphnnpfiv.supabase.co	jksqfeutntcvukrisrno.supabase.co
Web	im-landing-seven.vercel.app	im-landing-seven.vercel.app	impulseai.app

API-nokler

Appen bruker to typer nokler, begge hardkodet i Environment.kt:

Nokkel	Rolle	Sikkerhetsniva
X-API-Key	Anti-bot-beskyttelse, per miljo	Lav — ikke en hemmelighet
Supabase publishable key	Klient-autentisering	Lav — designet for klienten

Ingen hemmeligheter lagres i appen. Bruker-autentisering skjer via OAuth → JWT-tokens som lagres i iOS Keychain.

---

Arkitektur: Environment.kt

All miljokonfigurasjon er sentralisert i KMP shared-modulen:

shared/src/commonMain/kotlin/com/im/shared/config/Environment.kt

enum class Environment {
    DEVELOPMENT,  // localhost
    STAGING,      // Railway staging
    PRODUCTION    // Railway production
}

object AppConfig {
    var environment: Environment = Environment.DEVELOPMENT

    val apiUrl: String get() = environment.apiBaseUrl + "/api/v1"
    val isDevelopment: Boolean get() = environment == Environment.DEVELOPMENT
    val isProduction: Boolean get() = environment == Environment.PRODUCTION
}

Flyten:

ImpulseApp.swift init()
    → Bestem miljo (automatisk eller override)
    → AppConfig.shared.setEnvironment(env:)
    → ApiClient bruker AppConfig.apiUrl for alle requests

Fordi Environment.kt er i KMP shared-modulen, deler iOS og Android samme URL-er og konfigurasjon. Bare deteksjonslogikken (ImpulseApp.swift vs Android Application) er plattformspesifikk.

---

Bygg og distribusjon

Debug-builds (fra Xcode)

# Simulator → DEVELOPMENT automatisk
# Device → STAGING automatisk
# Bare trykk Run (⌘R) i Xcode

TestFlight (via Fastlane)

cd apps/mobile-kmp/iosApp
bundle exec fastlane ios beta

• Bygger Release-konfigurasjon
• Laster opp til App Store Connect
• Appen detekterer sandboxReceipt → bruker Staging

App Store (produksjon)

bundle exec fastlane ios promote

• Promoterer siste TestFlight-build til App Store Review
• Appen detekterer fravær av sandboxReceipt → bruker Production

aside.note

Samme IPA brukes i TestFlight og App Store. Miljovalget skjer ved runtime basert pa receipt-type, ikke ved bygg-tid. Dette betyr at du aldri trenger a bygge separat for staging vs produksjon.

---

Feilsoking

Appen bruker feil miljo

1. Sjekk om det ligger en manuell override i UserDefaults:

   • Slett appen fra device/simulator og installer pa nytt
   • Eller sett APP_ENVIRONMENT=DEVELOPMENT i Xcode scheme

2. Verifiser hvilket miljo appen bruker:

   • Sjekk Xcode-konsollen ved oppstart — Sentry og analytics logger miljoinformasjon

TestFlight-build bruker localhost

Dette skal ikke skje med den automatiske konfigurasjonen. Hvis det skjer:

1. Verifiser at builden er Release-konfigurasjon (Fastlane setter dette automatisk)
2. Sjekk at det ikke er en UserDefaults-override som sitter igjen

Device fra Xcode bruker localhost i stedet for staging

Sjekk at du kjorer pa fysisk device, ikke simulator. I Xcode: se at target-velgeren viser device-navnet ditt, ikke en simulator.

---

Versjonssjekk og tvungen oppdatering

Appen sjekker ved hver oppstart om versjonen er stottet via GET /api/v1/config. Endepunktet krever kun X-API-Key (ingen JWT), slik at sjekken fungerer for oppstart.

Hvordan det fungerer

App starter → GET /api/v1/config → Server returnerer min_version
                                    ↓
                          App sammenligner sin versjon
                                    ↓
                    ├─ Under min_version → BLOKKERT (fullskjerm, kun "Oppdater")
                    ├─ Under latest_version → Soft nudge (dismissbar)
                    └─ OK → Normal oppstart

Miljovariabel-kontroll (Doppler)

Variabel	Beskrivelse	Default
MIN_APP_VERSION_IOS	Minimum iOS-versjon (hard block)	0.0.0 (ingen)
MIN_APP_VERSION_ANDROID	Minimum Android-versjon (hard block)	0.0.0 (ingen)
LATEST_APP_VERSION_IOS	Nyeste iOS-versjon (soft nudge)	0.0.0 (ingen)
LATEST_APP_VERSION_ANDROID	Nyeste Android-versjon (soft nudge)	0.0.0 (ingen)

Viktige regler

• Nettverksfeil = normal oppstart — aldri blokker brukeren pga. feilet config-kall
• Sjekken skjer under splash — brukeren ser aldri innhold for force-update vises
• Versjon sendes i X-App-Version og X-App-Platform headere pa alle API-kall

---

API-nokkelrotasjon

API-klientnokkelen (X-API-Key) stotter komma-separerte verdier for trygg rotasjon uten nedetid.

Multi-key mekanisme

# En nokkel (normalt)
API_CLIENT_KEY=abc123

# To nokler (under rotasjon)
API_CLIENT_KEY=abc123,def456

Serveren aksepterer enhver nokkel i listen. Klienten sender alltid bare en.

Rotasjonsworkflow

1. Generer ny nokkel:           openssl rand -hex 32
2. Doppler: API_CLIENT_KEY =    "gammel_key,ny_key"
3. Deploy API                   (begge nokler fungerer na)
4. Oppdater Environment.kt     (ny nokkel i STAGING/PRODUCTION)
5. Ship app-oppdatering
6. Sett MIN_APP_VERSION         (tvinger brukere til a oppdatere)
7. Monitorer logger             (se keyPrefix for a spore gammel vs ny)
8. Fjern gammel nokkel           nar trafikk pa gammel prefix = 0

Dekommisjoneringsovervaking

Middleware-en logger keyPrefix (forste 8 tegn) ved akseptert nokkel:

{"keyPrefix":"315dc797"} API key accepted

Filtrer pa keyPrefix i Railway logs for a se nar gammel nokkel ikke lenger brukes.

aside.caution

Fjern ALDRI gammel nokkel for min_version tvinger oppdatering. En app med revokert nokkel kan ikke engang na config-endepunktet for a lare at den ma oppdatere.

---

Nøkkelfiler

Fil	Innhold
shared/.../config/Environment.kt	Miljo-enum, URL-er, API-nokler, AppConfig
iosApp/ImpulseApp.swift	Automatisk miljodeteksjon ved oppstart
iosApp/iosApp.xcodeproj/xcshareddata/xcschemes/iosApp.xcscheme	Manuell APP_ENVIRONMENT override
shared/.../api/ApiClient.kt	HTTP-klient som bruker AppConfig.apiUrl
shared/.../util/BuildConfig.ios.kt	iOS-spesifikk debug-deteksjon og localhost-adresse