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
| Categorie | Voorbeelden | Schrijfrecht (DApps) |
| General | Taal, tijdzone, notificaties, default chain | Beperkt (alleen specifieke velden) |
| Appearance | Thema (licht/donker), kleur, lettertype, schaal | Ja (gebruikersvoorkeur) |
| Security | Pin-code, biometrie, sessie-timeout, 2FA | Nee (alleen kernel) |
| Privacy | Analytics, data-deling, cookie-beleid, DApp-tracking | Nee (alleen gebruiker) |
| Advanced | RPC-config, debug-mode, developer-tools, logging | Nee (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)
| Veld | Type | Default | Schrijfrecht |
general.language | string | "nl" | any |
general.timezone | string | "Europe/Amsterdam" | any |
general.defaultChain | number | 270 | dapp:wallet |
appearance.theme | enum | "dark" | any |
appearance.accentColor | string | "#58a6ff" | any |
security.pinEnabled | boolean | false | kernel |
security.sessionTimeout | number | 30 | kernel |
privacy.analytics | boolean | false | user |
advanced.debugMode | boolean | false | kernel |
advanced.rpcOverride | string | null | kernel |
4. Real-time validatie
- On-change validatie: Elk veld wordt gevalideerd zodra de gebruiker het wijzigt.
- Inline foutmeldingen: Fouten worden direct onder het veld getoond.
- Blokkerend: Ongeldige waarden worden niet opgeslagen.
- Async validatie: Sommige velden vereisen server-side check (bv. unieke waarden).
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
| Actie | Formaat | Inhoud |
| Export | JSON (versiegedreven) | Alle settings + schema-versie + timestamp |
| Import | JSON (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
- Settings-DApp draait direct in shell, niet in iframe.
- Alle 5 categorieën bereikbaar via navigatie.
- Real-time validatie werkt op elk veld (on-change).
- Settings guard blokkeert ongeautoriseerde schrijfacties.
- Import/export werkt met versiegedreven JSON-formaat.
- Schema-upgrade bij import van oudere versies.
- Audit logging bij elke geweigerde schrijfactie.
7. Risico's en aanbevelingen
| Risico | Impact | Mitigatie |
| Settings corruptie | Hoog | Schema-versie + backup bij upgrade + rollback |
| Guard-bypass | Hoog | Guard draait in kernel, niet in DApp-context |
| Import-mismatch | Gemiddeld | Schema-validatie + merge-strategie + conflict-resolutie |
| Performance bij grote settings | Gemiddeld | Lazy loading per categorie |
8. Verwijzingen naar verwante specs
Volgende stap Na akkoord: Settings-DApp UI + guard-implementatie + validatie-regels + import/export flow + schema-versiebeheer.