# chuchipirat/chuchipirat architecture

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

- Interactive diagram: https://gitdiagram.com/chuchipirat/chuchipirat
- Repository: https://github.com/chuchipirat/chuchipirat

## Overview

chuchipirat is a web application for volunteers planning and running camp or course kitchens. Its central workflow is to create an event, select or create recipes, assign them to a menu plan, and generate scaled shopping and material lists for preparation; PDFs support offline use. The tree also shows user authentication, master-data management, donations, analytics, administration, and Supabase Edge Functions. The README documents the planning capabilities and stack; sampled source and the SOURCE INDEX clarify selected menu-plan, event, analytics, and database-context responsibilities, but do not establish every runtime connection.

Main entry points: [`src/components/Event/Menuplan/useMenuplanHandlers.tsx`](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Menuplan/useMenuplanHandlers.tsx) (Menu plan), [`src/components/Event/Event/event.tsx`](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Event/event.tsx) (Events), [`src/components/Recipe/recipes.tsx`](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Recipe/recipes.tsx) (Recipe library), [`src/components/App/AppRoutes.tsx`](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/App/AppRoutes.tsx) (Application routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Event planning"]
  node_events["Events<br/>[event.tsx]"]
  node_event_model["Event model<br/>[event.class.ts]"]
  node_group_config["Group configuration"]
  node_menuplan["Menu plan"]
  node_menuplan_logic["Menu plan logic<br/>[menuplanService.ts]"]
  node_shopping["Shopping list"]
  node_material_list["Material list"]
  node_used_recipes["Used recipes"]
end

subgraph group_catalog["Recipes and data"]
  node_recipes["Recipe library<br/>[recipes.tsx]"]
  node_recipe_model["Recipe model<br/>[recipe.class.ts]"]
  node_masterdata["Master data<br/>[products.tsx]"]
end

subgraph group_platform["Application platform"]
  node_app["Application routes<br/>[AppRoutes.tsx]"]
  node_auth["Authentication<br/>[AuthService.ts]"]
  node_db_context["Database context"]
  node_db_service["Database service<br/>[DatabaseService.ts]"]
end

subgraph group_services["External services"]
  node_donations["Donations<br/>[DonatePage.tsx]"]
  node_edge_functions["Edge functions<br/>[index.ts]"]
  node_analytics["Analytics"]
end

node_cook(("Kitchen volunteers"))
node_umami["Umami"]
node_supabase[("Supabase")]

node_cook -->|"uses"| node_app
node_app -->|"routes to"| node_events
node_events -.->|"uses"| node_event_model
node_events -->|"configures"| node_group_config
node_cook -->|"searches and creates"| node_recipes
node_recipes -->|"uses"| node_recipe_model
node_cook -->|"plans meals"| node_menuplan
node_menuplan -->|"uses"| node_menuplan_logic
node_menuplan -->|"selects recipes"| node_recipes
node_cook -->|"generates list"| node_shopping
node_cook -->|"generates list"| node_material_list
node_cook -->|"prints recipes"| node_used_recipes
node_menuplan -->|"supplies planned recipes"| node_shopping
node_menuplan -->|"supplies planned recipes"| node_material_list
node_menuplan -->|"provides recipes"| node_used_recipes
node_cook -.->|"maintains data"| node_masterdata
node_db_context -->|"provides"| node_db_service
node_auth -.->|"uses client"| node_supabase
node_cook -.->|"donates"| node_donations
node_donations -.->|"payment processing"| node_edge_functions
node_analytics -->|"tracks events"| node_umami

click node_app "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/App/AppRoutes.tsx"
click node_events "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Event/event.tsx"
click node_event_model "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Event/event.class.ts"
click node_group_config "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/GroupConfiguration/groupConfiguration.class.ts"
click node_recipes "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Recipe/recipes.tsx"
click node_recipe_model "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Recipe/recipe.class.ts"
click node_menuplan "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Menuplan/useMenuplanHandlers.tsx"
click node_menuplan_logic "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Menuplan/menuplanService.ts"
click node_shopping "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/ShoppingList/useShoppingListHandlers.tsx"
click node_material_list "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/MaterialList/useMaterialListHandlers.tsx"
click node_masterdata "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Product/products.tsx"
click node_auth "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/AuthService.ts"
click node_db_context "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/DatabaseContext.tsx"
click node_db_service "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/DatabaseService.ts"
click node_donations "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Donate/DonatePage.tsx"
click node_edge_functions "https://github.com/chuchipirat/chuchipirat/blob/main/supabase/volumes/functions/main/index.ts"
click node_analytics "https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Analytics/analyticsService.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_events,node_event_model,node_group_config,node_menuplan,node_menuplan_logic,node_shopping,node_material_list,node_used_recipes toneBlue
class node_recipes,node_recipe_model,node_masterdata,node_supabase toneAmber
class node_app,node_auth,node_db_context,node_db_service toneMint
class node_donations,node_edge_functions,node_analytics toneRose
class node_cook,node_umami toneIndigo
```

## Components

### Event planning

- [Events](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Event/event.tsx): `src/components/Event/Event/event.tsx`
- [Event model](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Event/event.class.ts): `src/components/Event/Event/event.class.ts`
- [Group configuration](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/GroupConfiguration/groupConfiguration.class.ts): `src/components/Event/GroupConfiguration/groupConfiguration.class.ts`
- [Menu plan](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Menuplan/useMenuplanHandlers.tsx): `src/components/Event/Menuplan/useMenuplanHandlers.tsx`
- [Menu plan logic](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/Menuplan/menuplanService.ts): `src/components/Event/Menuplan/menuplanService.ts`
- [Shopping list](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/ShoppingList/useShoppingListHandlers.tsx): `src/components/Event/ShoppingList/useShoppingListHandlers.tsx`
- [Material list](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Event/MaterialList/useMaterialListHandlers.tsx): `src/components/Event/MaterialList/useMaterialListHandlers.tsx`
- **Used recipes**

### Recipes and data

- [Recipe library](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Recipe/recipes.tsx): `src/components/Recipe/recipes.tsx`
- [Recipe model](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Recipe/recipe.class.ts): `src/components/Recipe/recipe.class.ts`
- [Master data](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Product/products.tsx): `src/components/Product/products.tsx`

### Application platform

- [Application routes](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/App/AppRoutes.tsx): `src/components/App/AppRoutes.tsx`
- [Authentication](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/AuthService.ts): `src/components/Database/AuthService.ts`
- [Database context](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/DatabaseContext.tsx): `src/components/Database/DatabaseContext.tsx`
- [Database service](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Database/DatabaseService.ts): `src/components/Database/DatabaseService.ts`

### External services

- [Donations](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Donate/DonatePage.tsx): `src/components/Donate/DonatePage.tsx`
- [Edge functions](https://github.com/chuchipirat/chuchipirat/blob/main/supabase/volumes/functions/main/index.ts): `supabase/volumes/functions/main/index.ts`
- [Analytics](https://github.com/chuchipirat/chuchipirat/blob/main/src/components/Analytics/analyticsService.ts): `src/components/Analytics/analyticsService.ts`

### Other components

- **Kitchen volunteers**
- **Umami**
- **Supabase**

## Connections

- Kitchen volunteers → Application routes: uses (evidence: `README.md`)
- Application routes → Events: routes to (evidence: `src/components/App/AppRoutes.tsx`)
- Events → Event model: uses (evidence: `src/components/Event/Event/event.tsx`)
- Events → Group configuration: configures (evidence: `README.md`)
- Kitchen volunteers → Recipe library: searches and creates (evidence: `README.md`)
- Recipe library → Recipe model: uses (evidence: `src/components/Recipe/recipe.class.ts`)
- Kitchen volunteers → Menu plan: plans meals (evidence: `README.md`)
- Menu plan → Menu plan logic: uses (evidence: `src/components/Event/Menuplan/useMenuplanHandlers.tsx`)
- Menu plan → Recipe library: selects recipes (evidence: `README.md`)
- Kitchen volunteers → Shopping list: generates list (evidence: `README.md`)
- Kitchen volunteers → Material list: generates list (evidence: `README.md`)
- Kitchen volunteers → Used recipes: prints recipes (evidence: `README.md`)
- Menu plan → Shopping list: supplies planned recipes (evidence: `README.md`)
- Menu plan → Material list: supplies planned recipes (evidence: `README.md`)
- Menu plan → Used recipes: provides recipes (evidence: `README.md`)
- Kitchen volunteers → Master data: maintains data
- Database context → Database service: provides (evidence: `src/components/Database/DatabaseContext.tsx`)
- Authentication → Supabase: uses client
- Kitchen volunteers → Donations: donates
- Donations → Edge functions: payment processing
- Analytics → Umami: tracks events (evidence: `src/components/Analytics/analyticsService.ts`)
