# openfoodfacts/nutripatrol-frontend architecture

> Architecture diagram of the GitHub repository openfoodfacts/nutripatrol-frontend, 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/openfoodfacts/nutripatrol-frontend
- Repository: https://github.com/openfoodfacts/nutripatrol-frontend

## Overview

Nutri-Patrol is a React moderation frontend for reporting product/image issues and reviewing reported-image tickets. The main user workflow is sign-in, submit a flag to the API, then see confirmation; moderators use the ticket dashboard to inspect reports and update ticket status. The graph also preserves the documented tutorial and flag-information pages. Edges reflect shown calls or README statements; unsampled implementation details and uncertain connections are omitted.

Main entry points: [`src/App.tsx`](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/App.tsx) (App routing), [`src/pages/FlagFormPage.tsx`](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/FlagFormPage.tsx) (Flag form), [`src/admin/tickets/TicketList.tsx`](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketList.tsx) (Ticket lists), [`src/admin/tickets/TicketShow.tsx`](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketShow.tsx) (Ticket detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["App routing<br/>[App.tsx]"]
  node_home["Home page<br/>[HomePage.tsx]"]
  node_flaginfo["Flag guidance<br/>[FlagInfos.tsx]"]
  node_tutorial["Moderation tutorial<br/>[Tutorial.tsx]"]
end

subgraph group_reporting["Flag Reporting"]
  node_flagform["Flag form<br/>[FlagFormPage.tsx]"]
  node_flagchoices["Flag choices<br/>[flagsConst.ts]"]
  node_confirmation["Submission confirmation<br/>[ThanksPage.tsx]"]
  node_analytics["Usage analytics<br/>[analytics.ts]"]
end

subgraph group_moderation["Ticket Moderation"]
  node_admin["Admin dashboard<br/>[App.tsx]"]
  node_ticketlists["Ticket lists<br/>[TicketList.tsx]"]
  node_reasonlists["Reason lists"]
  node_inappropriate["Inappropriate tickets"]
  node_ticketdetail["Ticket detail<br/>[TicketShow.tsx]"]
  node_flagdetails["Report summaries<br/>[FlagSummary.tsx]"]
  node_flagdata["Flag data helpers<br/>[flags.ts]"]
  node_ticketchoices["Ticket filters<br/>[choices.ts]"]
  node_thumbnail["Image preview"]
  node_actions["Ticket actions"]
  node_provider["API data provider<br/>[dataProvider.ts]"]
end

subgraph group_identity["Identity"]
  node_login["Login page<br/>[LoginPage.tsx]"]
  node_auth["Auth provider<br/>[authProvider.ts]"]
  node_devauth["Development accounts<br/>[devAuth.ts]"]
end

node_user(("Contributor or moderator"))
node_api[("Nutri-Patrol API")]
node_off["Open Food Facts"]

node_user -->|"opens frontend"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_flaginfo
node_app -->|"routes to"| node_tutorial
node_app -->|"routes to"| node_flagform
node_app -->|"routes to"| node_confirmation
node_app -->|"configures"| node_admin
node_admin -->|"uses"| node_provider
node_admin -->|"uses"| node_auth
node_flagform -->|"uses options"| node_flagchoices
node_flagform -->|"submits flag"| node_api
node_flagform -->|"tracks submission"| node_analytics
node_flagform -->|"shows after success"| node_confirmation
node_provider -->|"reads and updates tickets"| node_api
node_admin -->|"renders tickets"| node_ticketlists
node_admin -->|"routes to"| node_reasonlists
node_admin -->|"routes to"| node_inappropriate
node_ticketlists -->|"uses filters"| node_ticketchoices
node_ticketlists -->|"renders preview"| node_thumbnail
node_ticketlists -->|"renders actions"| node_actions
node_ticketdetail -->|"renders reports"| node_flagdetails
node_ticketdetail -->|"renders preview"| node_thumbnail
node_ticketdetail -->|"renders actions"| node_actions
node_flagdetails -->|"uses flag helpers"| node_flagdata
node_reasonlists -->|"uses list"| node_ticketlists
node_login -->|"checks session"| node_auth
node_auth -->|"uses dev role"| node_devauth
node_login -->|"offers sign-in"| node_off

click node_app "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/App.tsx"
click node_home "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/HomePage.tsx"
click node_flaginfo "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/FlagInfos.tsx"
click node_tutorial "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/Tutorial.tsx"
click node_flagform "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/FlagFormPage.tsx"
click node_flagchoices "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/const/flagsConst.ts"
click node_confirmation "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/ThanksPage.tsx"
click node_analytics "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/analytics.ts"
click node_admin "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/App.tsx"
click node_ticketlists "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketList.tsx"
click node_reasonlists "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/ReasonTicketList.tsx"
click node_inappropriate "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/InappropriateTicketList.tsx"
click node_ticketdetail "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketShow.tsx"
click node_flagdetails "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/FlagSummary.tsx"
click node_flagdata "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/flags.ts"
click node_ticketchoices "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/choices.ts"
click node_thumbnail "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketThumbnailField.tsx"
click node_actions "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketActionsField.tsx"
click node_provider "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/dataProvider.ts"
click node_login "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/LoginPage.tsx"
click node_auth "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/authProvider.ts"
click node_devauth "https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/devAuth.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_home,node_flaginfo,node_tutorial toneBlue
class node_flagform,node_flagchoices,node_confirmation,node_analytics,node_api toneAmber
class node_admin,node_ticketlists,node_reasonlists,node_inappropriate,node_ticketdetail,node_flagdetails,node_flagdata,node_ticketchoices,node_thumbnail,node_actions,node_provider toneMint
class node_login,node_auth,node_devauth toneRose
class node_user,node_off toneIndigo
```

## Components

### Application

- [App routing](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Home page](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [Flag guidance](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/FlagInfos.tsx): `src/pages/FlagInfos.tsx`
- [Moderation tutorial](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/Tutorial.tsx): `src/pages/Tutorial.tsx`

### Flag Reporting

- [Flag form](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/FlagFormPage.tsx): `src/pages/FlagFormPage.tsx`
- [Flag choices](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/const/flagsConst.ts): `src/const/flagsConst.ts`
- [Submission confirmation](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/ThanksPage.tsx): `src/pages/ThanksPage.tsx`
- [Usage analytics](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/analytics.ts): `src/analytics.ts`

### Ticket Moderation

- [Admin dashboard](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Ticket lists](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketList.tsx): `src/admin/tickets/TicketList.tsx`
- [Reason lists](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/ReasonTicketList.tsx): `src/admin/tickets/ReasonTicketList.tsx`
- [Inappropriate tickets](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/InappropriateTicketList.tsx): `src/admin/tickets/InappropriateTicketList.tsx`
- [Ticket detail](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketShow.tsx): `src/admin/tickets/TicketShow.tsx`
- [Report summaries](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/FlagSummary.tsx): `src/admin/tickets/FlagSummary.tsx`
- [Flag data helpers](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/flags.ts): `src/admin/tickets/flags.ts`
- [Ticket filters](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/choices.ts): `src/admin/tickets/choices.ts`
- [Image preview](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketThumbnailField.tsx): `src/admin/tickets/TicketThumbnailField.tsx`
- [Ticket actions](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/tickets/TicketActionsField.tsx): `src/admin/tickets/TicketActionsField.tsx`
- [API data provider](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/dataProvider.ts): `src/admin/dataProvider.ts`

### Identity

- [Login page](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/pages/LoginPage.tsx): `src/pages/LoginPage.tsx`
- [Auth provider](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/authProvider.ts): `src/admin/authProvider.ts`
- [Development accounts](https://github.com/openfoodfacts/nutripatrol-frontend/blob/main/src/admin/devAuth.ts): `src/admin/devAuth.ts`

### Other components

- **Contributor or moderator**
- **Nutri-Patrol API**
- **Open Food Facts**

## Connections

- Contributor or moderator → App routing: opens frontend (evidence: `README.md`)
- App routing → Home page: routes to (evidence: `src/App.tsx`)
- App routing → Flag guidance: routes to (evidence: `src/App.tsx`)
- App routing → Moderation tutorial: routes to (evidence: `src/App.tsx`)
- App routing → Flag form: routes to (evidence: `src/App.tsx`)
- App routing → Submission confirmation: routes to (evidence: `src/App.tsx`)
- App routing → Admin dashboard: configures (evidence: `src/App.tsx`)
- Admin dashboard → API data provider: uses (evidence: `src/App.tsx`)
- Admin dashboard → Auth provider: uses (evidence: `src/App.tsx`)
- Flag form → Flag choices: uses options (evidence: `src/pages/FlagFormPage.tsx`)
- Flag form → Nutri-Patrol API: submits flag (evidence: `src/pages/FlagFormPage.tsx`)
- Flag form → Usage analytics: tracks submission (evidence: `src/pages/FlagFormPage.tsx`)
- Flag form → Submission confirmation: shows after success (evidence: `src/pages/FlagFormPage.tsx`)
- API data provider → Nutri-Patrol API: reads and updates tickets (evidence: `src/admin/dataProvider.ts`)
- Admin dashboard → Ticket lists: renders tickets (evidence: `src/App.tsx`)
- Admin dashboard → Reason lists: routes to (evidence: `src/App.tsx`)
- Admin dashboard → Inappropriate tickets: routes to (evidence: `src/App.tsx`)
- Ticket lists → Ticket filters: uses filters (evidence: `src/admin/tickets/TicketList.tsx`)
- Ticket lists → Image preview: renders preview (evidence: `src/admin/tickets/TicketList.tsx`)
- Ticket lists → Ticket actions: renders actions (evidence: `src/admin/tickets/TicketList.tsx`)
- Ticket detail → Report summaries: renders reports (evidence: `src/admin/tickets/TicketShow.tsx`)
- Ticket detail → Image preview: renders preview (evidence: `src/admin/tickets/TicketShow.tsx`)
- Ticket detail → Ticket actions: renders actions (evidence: `src/admin/tickets/TicketShow.tsx`)
- Report summaries → Flag data helpers: uses flag helpers (evidence: `src/admin/tickets/FlagSummary.tsx`)
- Reason lists → Ticket lists: uses list (evidence: `src/admin/tickets/ReasonTicketList.tsx`)
- Login page → Auth provider: checks session (evidence: `src/pages/LoginPage.tsx`)
- Auth provider → Development accounts: uses dev role (evidence: `src/admin/authProvider.ts`)
- Login page → Open Food Facts: offers sign-in (evidence: `README.md`)
