# youssefobunit/fourage_zouhour architecture

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

- Interactive diagram: https://gitdiagram.com/youssefobunit/fourage_zouhour
- Repository: https://github.com/youssefobunit/fourage_zouhour

## Overview

The repository is a Flutter application named forage, with a Supabase-backed administrative user-creation function and native platform runners. The README is only Flutter starter text and documents no product workflow or domain capabilities. The Dart source tree suggests catalog/filtering, cloud sync, device identity, session storage, and security activity/configuration areas, but their runtime connections cannot be verified from the supplied excerpts. The graph therefore shows only evidenced native Windows and admin-function calls; other app modules are represented without inferred links.

Main entry points: [`supabase/functions/admin-create-user/index.ts`](https://github.com/youssefobunit/fourage_zouhour/blob/main/supabase/functions/admin-create-user/index.ts) (Create admin user), [`windows/runner/flutter_window.cpp`](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/flutter_window.cpp) (Flutter window host), [`windows/runner/main.cpp`](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/main.cpp) (Windows entry point), [`lib/main.dart`](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flutter_app["Flutter application"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_catalog["Catalog and filters"]
  node_cloud_sync["Cloud sync"]
  node_identity["Device identity"]
  node_sessions["Session storage"]
  node_security_activity["Security activity"]
  node_security_config["Security config"]
  node_glass_ui["Glass UI<br/>[atelier_glass.dart]"]
  node_liquid_ui["Liquid UI"]
end

subgraph group_admin_backend["Admin backend"]
  node_admin_create["Create admin user<br/>[index.ts]"]
  node_user_validation["User validation<br/>[validation.mjs]"]
  node_profile_store[("Profile and access data")]
end

subgraph group_windows_runtime["Windows runtime"]
  node_windows_main["Windows entry point<br/>[main.cpp]"]
  node_flutter_window["Flutter window host<br/>[flutter_window.cpp]"]
  node_win32_window["Win32 window<br/>[win32_window.cpp]"]
  node_plugin_registry["Plugin registration"]
end

node_user(("App user"))
node_supabase[("Supabase services")]

node_user -.->|"uses app"| node_app_entry
node_windows_main -->|"creates window"| node_flutter_window
node_flutter_window -->|"inherits window"| node_win32_window
node_flutter_window -->|"registers plugins"| node_plugin_registry
node_admin_create -->|"validates request"| node_user_validation
node_admin_create -->|"authenticates requester"| node_supabase
node_admin_create -->|"reads and writes profile"| node_profile_store
node_admin_create -->|"creates account"| node_supabase

click node_app_entry "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/main.dart"
click node_catalog "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/catalog_and_filters.dart"
click node_cloud_sync "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/cloud_sync_client.dart"
click node_identity "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/device_identity.dart"
click node_sessions "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/session_storage.dart"
click node_security_activity "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/security_activity_page.dart"
click node_security_config "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/security_config.dart"
click node_glass_ui "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/atelier_glass.dart"
click node_liquid_ui "https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/atelier_liquid.dart"
click node_admin_create "https://github.com/youssefobunit/fourage_zouhour/blob/main/supabase/functions/admin-create-user/index.ts"
click node_user_validation "https://github.com/youssefobunit/fourage_zouhour/blob/main/supabase/functions/admin-create-user/validation.mjs"
click node_profile_store "https://github.com/youssefobunit/fourage_zouhour/tree/main/supabase/migrations"
click node_windows_main "https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/main.cpp"
click node_flutter_window "https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/flutter_window.cpp"
click node_win32_window "https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/win32_window.cpp"
click node_plugin_registry "https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/flutter/generated_plugin_registrant.cc"

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_entry,node_catalog,node_cloud_sync,node_identity,node_sessions,node_security_activity,node_security_config,node_glass_ui,node_liquid_ui,node_user toneBlue
class node_admin_create,node_user_validation,node_profile_store,node_supabase toneAmber
class node_windows_main,node_flutter_window,node_win32_window,node_plugin_registry toneMint
```

## Components

### Flutter application

- [App entry](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/main.dart): `lib/main.dart`
- [Catalog and filters](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/catalog_and_filters.dart): `lib/catalog_and_filters.dart`
- [Cloud sync](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/cloud_sync_client.dart): `lib/cloud_sync_client.dart`
- [Device identity](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/device_identity.dart): `lib/device_identity.dart`
- [Session storage](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/session_storage.dart): `lib/session_storage.dart`
- [Security activity](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/security_activity_page.dart): `lib/security_activity_page.dart`
- [Security config](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/security_config.dart): `lib/security_config.dart`
- [Glass UI](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/atelier_glass.dart): `lib/atelier_glass.dart`
- [Liquid UI](https://github.com/youssefobunit/fourage_zouhour/blob/main/lib/atelier_liquid.dart): `lib/atelier_liquid.dart`

### Admin backend

- [Create admin user](https://github.com/youssefobunit/fourage_zouhour/blob/main/supabase/functions/admin-create-user/index.ts): `supabase/functions/admin-create-user/index.ts`
- [User validation](https://github.com/youssefobunit/fourage_zouhour/blob/main/supabase/functions/admin-create-user/validation.mjs): `supabase/functions/admin-create-user/validation.mjs`
- [Profile and access data](https://github.com/youssefobunit/fourage_zouhour/tree/main/supabase/migrations): `supabase/migrations`

### Windows runtime

- [Windows entry point](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window host](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Plugin registration](https://github.com/youssefobunit/fourage_zouhour/blob/main/windows/flutter/generated_plugin_registrant.cc): `windows/flutter/generated_plugin_registrant.cc`

### Other components

- **App user**
- **Supabase services**

## Connections

- App user → App entry: uses app
- Windows entry point → Flutter window host: creates window (evidence: `windows/runner/main.cpp`)
- Flutter window host → Win32 window: inherits window (evidence: `windows/runner/flutter_window.cpp`)
- Flutter window host → Plugin registration: registers plugins (evidence: `windows/runner/flutter_window.cpp`)
- Create admin user → User validation: validates request (evidence: `supabase/functions/admin-create-user/index.ts`)
- Create admin user → Supabase services: authenticates requester (evidence: `supabase/functions/admin-create-user/index.ts`)
- Create admin user → Profile and access data: reads and writes profile (evidence: `supabase/functions/admin-create-user/index.ts`)
- Create admin user → Supabase services: creates account (evidence: `supabase/functions/admin-create-user/index.ts`)
