# kingterentius/foodtribeos architecture

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

- Interactive diagram: https://gitdiagram.com/kingterentius/foodtribeos
- Repository: https://github.com/kingterentius/foodtribeos

## Overview

Food Tribe OS is an in-development platform for food-service organizations. Its documented target workflow is event-driven: an inventory donation can prompt a volunteer-shift suggestion in Events, with Dapr providing messaging, service invocation, and state-management building blocks. The README also names Identity, Inventory, and Events as core domains. The tree shows app and service areas, but the only indexed source is package metadata; this graph therefore reflects documented architecture, not verified runtime wiring.

Main entry points: [`food-tribe-os/services`](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services) (Inventory service), [`food-tribe-os/services/users`](https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/services/users) (Identity service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Product apps"]
  node_web["Web app"]
  node_discovery["Discovery app"]
  node_features["App features"]
end

subgraph group_domains["Domain services"]
  node_identity["Identity service"]
  node_inventory["Inventory service"]
  node_events["Events service"]
  node_api["API service"]
  node_gamification["Gamification service"]
end

subgraph group_runtime["Dapr building blocks"]
  node_dapr{{"Dapr runtime"}}
  node_state[("Abstract state store")]
end

node_organizations(("Food organizations"))

node_inventory -->|"publishes donation"| node_dapr
node_dapr -->|"dispatches event"| node_events
node_identity -->|"invokes services"| node_dapr
node_inventory -->|"invokes services"| node_dapr
node_events -->|"invokes services"| node_dapr
node_identity -->|"manages state"| node_dapr
node_inventory -->|"manages state"| node_dapr
node_events -->|"manages state"| node_dapr
node_dapr -->|"stores state"| node_state

click node_web "https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/apps/web"
click node_discovery "https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/apps/discovery-app"
click node_features "https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/apps/features"
click node_identity "https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/services/users"
click node_inventory "https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services"
click node_events "https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services"
click node_api "https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services/api"
click node_gamification "https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services/gamification"

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_web,node_discovery,node_features toneBlue
class node_identity,node_inventory,node_events,node_api,node_gamification toneAmber
class node_dapr,node_state toneMint
class node_organizations toneIndigo
```

## Components

### Product apps

- [Web app](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/apps/web): `food-tribe-os/apps/web`
- [Discovery app](https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/apps/discovery-app): `food-tribe-os/apps/discovery-app`
- [App features](https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/apps/features): `food-tribe-os/apps/features`

### Domain services

- [Identity service](https://github.com/kingterentius/foodtribeos/blob/master/food-tribe-os/services/users): `food-tribe-os/services/users`
- [Inventory service](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services): `food-tribe-os/services`
- [Events service](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services): `food-tribe-os/services`
- [API service](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services/api): `food-tribe-os/services/api`
- [Gamification service](https://github.com/kingterentius/foodtribeos/tree/master/food-tribe-os/services/gamification): `food-tribe-os/services/gamification`

### Dapr building blocks

- **Dapr runtime**
- **Abstract state store**

### Other components

- **Food organizations**

## Connections

- Inventory service → Dapr runtime: publishes donation
- Dapr runtime → Events service: dispatches event
- Identity service → Dapr runtime: invokes services
- Inventory service → Dapr runtime: invokes services
- Events service → Dapr runtime: invokes services
- Identity service → Dapr runtime: manages state
- Inventory service → Dapr runtime: manages state
- Events service → Dapr runtime: manages state
- Dapr runtime → Abstract state store: stores state
