System-apps explorer

File Explorer (Tier-0) • direct in shell • VFS navigatie • bestanden openen met DApp • context menu • double-click = launch grant • status: ontwerp, nog geen code

Kerndefinitie: De File Explorer is een Tier-0 systeemapplicatie die direct in de shell draait. Het biedt navigatie door het virtuele bestandssysteem (VFS) en stelt gebruikers in staat bestanden te openen, te beheren en te delen. Double-click op een bestand activeert een launch grant met exact-path matching.

1. Architectuur

┌─────────────────────────────────────────────────┐
│               Shell (Tier-0)                     │
│  ┌─────────────────────────────────────────┐     │
│  │         File Explorer (direct)           │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ VFS Navigator                   │    │     │
│  │  │ (tree view + breadcrumb)        │    │     │
│  │  └─────────────────────────────────┘    │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ File Operations                 │    │     │
│  │  │ (open, delete, rename, share)   │    │     │
│  │  └─────────────────────────────────┘    │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Context Menu                    │    │     │
│  │  │ (right-click actions)           │    │     │
│  │  └─────────────────────────────────┘    │     │
│  │  ┌─────────────────────────────────┐    │     │
│  │  │ Launch Grant Manager            │    │     │
│  │  │ (double-click handler)          │    │     │
│  │  └─────────────────────────────────┘    │     │
│  └─────────────────────┬───────────────────┘     │
│                        │ VAPI                     │
│  ┌─────────────────────┴───────────────────┐     │
│  │           VFS Layer                     │     │
│  │  ┌─────────┐ ┌─────────┐ ┌──────────┐  │     │
│  │  │ vfs://  │ │ vfs://  │ │ vfs://   │  │     │
│  │  │ app/    │ │ user/   │ │ shared/  │  │     │
│  │  └─────────┘ └─────────┘ └──────────┘  │     │
│  │  ┌─────────┐                            │     │
│  │  │ vfs://  │                            │     │
│  │  │ tmp/    │                            │     │
│  │  └─────────┘                            │     │
│  └─────────────────────────────────────────┘     │
└─────────────────────────────────────────────────┘

2. VFS navigatie

PrefixBeschrijvingToegankelijkheid
vfs://app/App-specifieke bestanden (per DApp geïsoleerd)Alleen eigen DApp + Tier-0
vfs://user/Gebruikersbestanden (persoonlijke opslag)Gebruiker + geautoriseerde DApps
vfs://shared/Gedeelde bestanden (tussen DApps)Alle geautoriseerde DApps
vfs://tmp/Tijdelijke bestanden (automatisch opruimen)Alle DApps (tijdelijk)
VFS boomstructuur:
    vfs://
    ├── app/
    │   ├── 0x1234...abcd/       (DApp-specifiek)
    │   │   ├── data/
    │   │   ├── config.json
    │   │   └── index.html
    │   └── 0x5678...efgh/
    │       └── ...
    ├── user/
    │   ├── documents/
    │   ├── images/
    │   └── downloads/
    ├── shared/
    │   ├── public/
    │   └── exchange/
    └── tmp/
        └── (automatisch opruimen na sessie)

3. Bestanden openen met DApp

Besluit: Elk bestandstype kan worden gekoppeld aan een specifieke DApp. De koppeling wordt bepaald door bestandsextensie of MIME-type. Double-click activeert de gekoppelde DApp via launch grant.
BestandstypeStandaard DAppAlternatieven
.htmlBrowser-viewerCode-editor, HTML-validator
.jsonJSON-viewerCode-editor, Schema-validator
.mdMarkdown-viewerWYSIWYG-editor
.png/.jpgImage-viewerImage-editor, Gallery
.pdfPDF-viewerPDF-editor
.solSolidity-editorContract-deployer

4. Context menu

Rechtsklik op bestand/map
    │
    ├── Openen (met standaard DApp)
    │
    ├── Openen met... (lijst van compatibele DApps)
    │
    ├── ─────────────────────────────
    │
    ├── Kopiëren (pad naar clipboard)
    │
    ├── Plakken (vanuit clipboard)
    │
    ├── Hernoemen (inline bewerken)
    │
    ├── Verwijderen (met confirmatie)
    │
    ├── ─────────────────────────────
    │
    ├── Delen (genereer share-link via vfs://shared/)
    │
    ├── Eigenschappen (grootte, aanmaakdatum, type)
    │
    └── ─────────────────────────────
        └── Launch grant beheren (permissies voor deze DApp)

5. Double-click = launch grant

BESLIST: Double-click op een bestand activeert een launch grant. Dit is een tijdelijke permissie die een DApp toestaat het bestand te openen. Maximaal 32 launch grants actief, met exact-path matching.
PropertyWaardeToelichting
maxGrants32Maximaal aantal actieve launch grants
matchingexact-pathGeen prefix-matching, geen family-matching
expirySessieGrants verlopen bij sluiten van DApp
scopeper bestandElk grant is gekoppeld aan specifiek bestandspad
Double-click flow:
    │
    ├── 1. Gebruiker dubbelklikt op bestand
    │       │
    │       └── Pad: vfs://user/documents/contract.sol
    │
    ├── 2. Launch Grant check
    │       │
    │       ├── Grant bestaat al? → direct openen
    │       │
    │       └── Grant bestaat niet? → nieuwe grant aanmaken
    │               │
    │               ├── maxGrants < 32? → grant toekennen
    │               │
    │               └── maxGrants >= 32? → oudste grant verwijderen
    │
    ├── 3. DApp openen
    │       │
    │       └── Laad bestand in gekoppelde DApp
    │
    └── 4. Grant opslaan
            ├── Pad: "vfs://user/documents/contract.sol"
            ├── DApp: "0xabcd...1234"
            └── Timestamp: "2026-01-16T14:20:00Z"

6. Bestandsoperaties

OperatieBeschrijvingPermissie vereist
OpenenBestand laden in DAppstorage:read:{pad}
VerwijderenBestand verwijderen (met confirmatie)storage:delete:{pad}
HernoemenBestandsnaam wijzigen (inline bewerking)storage:write:{pad}
DelenShare-link genereren via vfs://shared/storage:share:{pad}
KopiërenPad naar clipboardGeen permissie vereist
PlakkenBestand/plakken vanuit clipboardstorage:write:{doelpad}

7. Acceptatiecriteria

8. Risico's en aanbevelingen

RisicoImpactMitigatie
Launch grant misbruikHoogExact-path matching + max 32 + sessie-expiry
VFS-pad manipulatieHoogPad-sanitisatie + canonicalisatie + toegangscontrole
Performance bij grote mappenGemiddeldLazy loading + virtuele scroll + caching
Conflicten bij delenGemiddeldCopy-on-write + versiebeheer

9. Verwijzingen naar verwante specs

Volgende stap Na akkoord: File Explorer UI + VFS-navigatie + context menu + launch grant manager + double-click handler + bestandsoperaties.