System-apps settings

Settings-DApp (Tier-0) • direct in shell • 5 categorieën • real-time validatie • settings guard • import/export • status: ontwerp, nog geen code

Kerndefinitie: De Settings-DApp is een Tier-0 systeemapplicatie die direct in de shell draait. Het biedt centraal instellingenbeheer voor de hele OS. DApps mogen niet alle velden schrijven, een settings guard bepaalt wat wel en niet mag.

1. Architectuur

┌─────────────────────────────────────────────────┐
│               Shell (Tier-0)                     │
│  ┌─────────────────────────────────────────┐     │
│  │           Settings-DApp (direct)         │     │
│  │  ┌──────────┐  ┌──────────┐             │     │
│  │  │ General  │  │ Appearance│             │     │
│  │  └──────────┘  └──────────┘             │     │
│  │  ┌──────────┐  ┌──────────┐             │     │
│  │  │ Security │  │ Privacy  │             │     │
│  │  └──────────┘  └──────────┘             │     │
│  │  ┌──────────┐  ┌─────────────────────┐  │     │
│  │  │ Advanced │  │ Import/Export       │  │     │
│  │  └──────────┘  └─────────────────────┘  │     │
│  └─────────────────────┬───────────────────┘     │
│                        │ VAPI                     │
│  ┌─────────────────────┴───────────────────┐     │
│  │           Settings Guard                 │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Permissie-matrix per DApp       │    │     │
│  │  │ (wie mag welk veld schrijven)   │    │     │
│  │  └─────────────────────────────────┘    │     │
│  └─────────────────────┬───────────────────┘     │
│                        │                         │
│  ┌─────────────────────┴───────────────────┐     │
│  │           Settings Store                │     │
│  │  (localStorage + versioned schema)      │     │
│  └─────────────────────────────────────────┘     │
└─────────────────────────────────────────────────┘

DApp (Tier-1/2) ──maos.request──▶ Settings Guard ──check──▶ Settings Store
                                                                │
                                              ┌─────────────────┴─────────────────┐
                                              │ Allowed                           │ Denied
                                              ▼                                   ▼
                                         Write veld                        Reject + audit log

2. Categorieën

CategorieVoorbeeldenSchrijfrecht (DApps)
GeneralTaal, tijdzone, notificaties, default chainBeperkt (alleen specifieke velden)
AppearanceThema (licht/donker), kleur, lettertype, schaalJa (gebruikersvoorkeur)
SecurityPin-code, biometrie, sessie-timeout, 2FANee (alleen kernel)
PrivacyAnalytics, data-deling, cookie-beleid, DApp-trackingNee (alleen gebruiker)
AdvancedRPC-config, debug-mode, developer-tools, loggingNee (alleen kernel)

3. Settings guard

Besluit: Elke schrijfoperatie naar settings gaat door de settings guard. De guard bepaalt op basis van DApp-id + tier + veld-naam of de operatie is toegestaan.
SettingsGuard.check(dappId, tier, field, value):
    │
    ├── 1. Veld zoeken in permissie-matrix
    │       │
    │       ├── Veld niet gevonden → deny (standaard = gesloten)
    │       │
    │       └── Veld gevonden → check permissies
    │
    ├── 2. Permissie-check
    │       │
    │       ├── write: "kernel" → deny (alleen kernel schrijft)
    │       ├── write: "user" → deny (alleen gebruiker via UI)
    │       ├── write: "dapp:{dappId}" → approve (specifieke DApp)
    │       ├── write: "tier:0" → approve (Tier-0 system-apps)
    │       └── write: "any" → approve (iedereen)
    │
    └── 3. Validatie
            ├── Type-check (string/number/boolean)
            ├── Range-check (min/max, enum)
            └── Custom validator (indien aanwezig)

3.1 Permissie-matrix (voorbeeld)

VeldTypeDefaultSchrijfrecht
general.languagestring"nl"any
general.timezonestring"Europe/Amsterdam"any
general.defaultChainnumber270dapp:wallet
appearance.themeenum"dark"any
appearance.accentColorstring"#58a6ff"any
security.pinEnabledbooleanfalsekernel
security.sessionTimeoutnumber30kernel
privacy.analyticsbooleanfalseuser
advanced.debugModebooleanfalsekernel
advanced.rpcOverridestringnullkernel

4. Real-time validatie

Gebruiker wijzigt veld
    │
    ├── 1. On-change event trigger
    │
    ├── 2. Client-side validatie
    │       ├── Type-check
    │       ├── Range-check
    │       └── Pattern-match (regex)
    │
    ├── 3. Indien nodig: async validatie
    │       └── Server-side check (bv. unique constraint)
    │
    ├── 4. Resultaat
    │       ├── Valid → groene indicator, wijziging toepassen
    │       └── Invalid → rode foutmelding, wijziging blokkeren
    │
    └── 5. Opslaan (alleen bij valid)
            ├── Settings guard check
            ├── Schema-upgrade (indien nodig)
            └── Persist naar localStorage

5. Import / export

ActieFormaatInhoud
ExportJSON (versiegedreven)Alle settings + schema-versie + timestamp
ImportJSON (gevalideerd)Settings worden gemerged met bestaande, schema-upgrade automatisch
Export-flow:
    ┌──────────────────┐
    │ Settings Store   │
    │ (alle velden)    │
    └────────┬─────────┘
             │
             ▼
    ┌──────────────────┐
    │ JSON serialise   │
    │ + versie-tag     │
    │ + timestamp      │
    └────────┬─────────┘
             │
             ▼
    ┌──────────────────┐
    │ Download als     │
    │ .maos-settings   │
    └──────────────────┘

Import-flow:
    ┌──────────────────┐
    │ .maos-settings   │
    │ bestand kiezen   │
    └────────┬─────────┘
             │
             ▼
    ┌──────────────────┐
    │ JSON parse +     │
    │ schema-validatie │
    └────────┬─────────┘
             │
        ┌────┴────┐
        │ Valid   │ Invalid
        ▼         ▼
    ┌────────┐ ┌────────┐
    │ Merge  │ │ Fout:  │
    │ + save │ │ toon   │
    └────────┘ └────────┘

6. Acceptatiecriteria

7. Risico's en aanbevelingen

RisicoImpactMitigatie
Settings corruptieHoogSchema-versie + backup bij upgrade + rollback
Guard-bypassHoogGuard draait in kernel, niet in DApp-context
Import-mismatchGemiddeldSchema-validatie + merge-strategie + conflict-resolutie
Performance bij grote settingsGemiddeldLazy loading per categorie

8. Verwijzingen naar verwante specs

Volgende stap Na akkoord: Settings-DApp UI + guard-implementatie + validatie-regels + import/export flow + schema-versiebeheer.