# bmifsud/poc-artriout architecture

> Architecture diagram of the GitHub repository bmifsud/poc-artriout, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bmifsud/poc-artriout
- Repository: https://github.com/bmifsud/poc-artriout

## Overview

AR Trion is a privacy-first, browser-based augmented-reality platform. Its visible client workflow checks WebGPU support, presents a BIPA consent dialog, and requests a camera stream only after consent. The packages also provide local inference options, MediaPipe hand-landmark processing, zero-egress enforcement, ephemeral frame sanitization, and WebGPU-oriented rendering configuration. The excerpts show package capabilities, but do not show a connected frame-processing or rendering loop; those stages are therefore represented without invented links.

Main entry points: [`apps/web-app/src/index.ts`](https://github.com/bmifsud/poc-artriout/blob/main/apps/web-app/src/index.ts) (App Bootstrap), [`packages/compliance/src/ClickwrapConsent.ts`](https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsent.ts) (Consent and Camera Gate), [`packages/perception/src/LocalInferenceRuntime.ts`](https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/LocalInferenceRuntime.ts) (Local Inference Runtime), [`packages/compliance/src/ClickwrapConsentModal.ts`](https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsentModal.ts) (Consent Dialog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web Client"]
  node_app["App Bootstrap<br/>[index.ts]"]
end

subgraph group_compliance["Privacy Compliance"]
  node_consentmodal["Consent Dialog"]
  node_consent["Consent and Camera Gate"]
  node_sanitizer["Frame Sanitization<br/>[MemorySanitizer.ts]"]
end

subgraph group_perception["Edge Perception"]
  node_inference["Local Inference Runtime"]
  node_mediapipe["MediaPipe Hand Landmarker"]
  node_egress["Network Egress Guard"]
end

subgraph group_rendering["WebGPU Rendering"]
  node_gpucheck["WebGPU Capability"]
  node_wasmconfig["WebGPU WASM Config"]
end

node_user(("Browser User"))
node_browsergpu["Browser WebGPU"]
node_camera["Browser Camera"]

node_user -->|"opens"| node_app
node_app -->|"checks support"| node_gpucheck
node_gpucheck -->|"requests adapter"| node_browsergpu
node_app -->|"renders dialog"| node_consentmodal
node_consentmodal -->|"grants consent"| node_consent
node_app -->|"requests camera"| node_consent
node_consent -->|"checks consent; opens stream"| node_camera
node_inference -->|"activates guard"| node_egress
node_inference -->|"records remote-model violation"| node_egress

click node_app "https://github.com/bmifsud/poc-artriout/blob/main/apps/web-app/src/index.ts"
click node_gpucheck "https://github.com/bmifsud/poc-artriout/blob/main/packages/rendering/src/WebGPUCapabilityDetector.ts"
click node_consentmodal "https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsentModal.ts"
click node_consent "https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsent.ts"
click node_sanitizer "https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/MemorySanitizer.ts"
click node_inference "https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/LocalInferenceRuntime.ts"
click node_mediapipe "https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/MediaPipeHandLandmarker.ts"
click node_egress "https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/NetworkEgressGuard.ts"
click node_wasmconfig "https://github.com/bmifsud/poc-artriout/blob/main/packages/rendering/src/EmscriptenConfig.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_user,node_browsergpu,node_camera toneBlue
class node_consentmodal,node_consent,node_sanitizer toneAmber
class node_inference,node_mediapipe,node_egress toneMint
class node_gpucheck,node_wasmconfig toneRose
```

## Components

### Web Client

- [App Bootstrap](https://github.com/bmifsud/poc-artriout/blob/main/apps/web-app/src/index.ts): `apps/web-app/src/index.ts`

### Privacy Compliance

- [Consent Dialog](https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsentModal.ts): `packages/compliance/src/ClickwrapConsentModal.ts`
- [Consent and Camera Gate](https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/ClickwrapConsent.ts): `packages/compliance/src/ClickwrapConsent.ts`
- [Frame Sanitization](https://github.com/bmifsud/poc-artriout/blob/main/packages/compliance/src/MemorySanitizer.ts): `packages/compliance/src/MemorySanitizer.ts`

### Edge Perception

- [Local Inference Runtime](https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/LocalInferenceRuntime.ts): `packages/perception/src/LocalInferenceRuntime.ts`
- [MediaPipe Hand Landmarker](https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/MediaPipeHandLandmarker.ts): `packages/perception/src/MediaPipeHandLandmarker.ts`
- [Network Egress Guard](https://github.com/bmifsud/poc-artriout/blob/main/packages/perception/src/NetworkEgressGuard.ts): `packages/perception/src/NetworkEgressGuard.ts`

### WebGPU Rendering

- [WebGPU Capability](https://github.com/bmifsud/poc-artriout/blob/main/packages/rendering/src/WebGPUCapabilityDetector.ts): `packages/rendering/src/WebGPUCapabilityDetector.ts`
- [WebGPU WASM Config](https://github.com/bmifsud/poc-artriout/blob/main/packages/rendering/src/EmscriptenConfig.ts): `packages/rendering/src/EmscriptenConfig.ts`

### Other components

- **Browser User**
- **Browser WebGPU**
- **Browser Camera**

## Connections

- Browser User → App Bootstrap: opens (evidence: `apps/web-app/src/index.ts`)
- App Bootstrap → WebGPU Capability: checks support (evidence: `apps/web-app/src/index.ts`)
- WebGPU Capability → Browser WebGPU: requests adapter (evidence: `packages/rendering/src/WebGPUCapabilityDetector.ts`)
- App Bootstrap → Consent Dialog: renders dialog (evidence: `apps/web-app/src/index.ts`)
- Consent Dialog → Consent and Camera Gate: grants consent (evidence: `packages/compliance/src/ClickwrapConsentModal.ts`)
- App Bootstrap → Consent and Camera Gate: requests camera (evidence: `apps/web-app/src/index.ts`)
- Consent and Camera Gate → Browser Camera: checks consent; opens stream (evidence: `packages/compliance/src/ClickwrapConsent.ts`)
- Local Inference Runtime → Network Egress Guard: activates guard (evidence: `packages/perception/src/LocalInferenceRuntime.ts`)
- Local Inference Runtime → Network Egress Guard: records remote-model violation (evidence: `packages/perception/src/LocalInferenceRuntime.ts`)
