# fph-dev89/traqhaccp architecture

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

- Interactive diagram: https://gitdiagram.com/fph-dev89/traqhaccp
- Repository: https://github.com/fph-dev89/traqhaccp

## Overview

TraqHACCP is a French PWA for a pâtisserie’s HACCP sanitary register. The main workflow boots the app, authenticates an establishment, loads its register, and renders operational views; staff then record and manage traceability data, which can synchronize with Supabase and support recall and inspection reporting. The graph also preserves documented offline operation and the product’s regulatory, settings, and DDPP-document capabilities. Several domain features are documented but their detailed implementation was not sampled, so their internal links are omitted.

Main entry points: [`js/patisserie/state.js`](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/state.js) (Register state and persistence), [`js/patisserie/views.js`](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/views.js) (Operational views), [`js/patisserie/app.js`](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/app.js) (App entry and navigation), [`js/patisserie/modals.js`](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/modals.js) (Register forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["App workflow"]
  node_app["App entry and navigation<br/>[app.js]"]
  node_auth["Establishment authentication<br/>[auth.js]"]
  node_views["Operational views<br/>[views.js]"]
  node_feedback["Audio and toast feedback<br/>[audio-toast.js]"]
end

subgraph group_operations["Register operations"]
  node_modals["Register forms<br/>[modals.js]"]
  node_calculations["HACCP and recipe calculations<br/>[calculations.js]"]
  node_settings["Establishment settings<br/>[settings.js]"]
  node_settings_data["Register configuration<br/>[settings-data.js]"]
  node_scanner["Label scanning<br/>[ai-scanner.js]"]
end

subgraph group_platform["Data and platform"]
  node_state["Register state and persistence<br/>[state.js]"]
  node_sync["Cloud synchronization<br/>[sync.js]"]
  node_supabase_client["Supabase client<br/>[supabase_client.js]"]
  node_config["Runtime configuration<br/>[config.js]"]
  node_service_worker["Offline PWA cache<br/>[sw.js]"]
end

subgraph group_compliance["Compliance and reporting"]
  node_settings_norms["Norm settings<br/>[settings-norms.js]"]
  node_norms["Regulatory thresholds<br/>[haccp_norms.js]"]
  node_constants["HACCP reference data<br/>[constants.js]"]
  node_recall["Product recall<br/>[recall.js]"]
  node_ddpp_docs["DDPP documents<br/>[ddpp_documents.js]"]
  node_ddpp_report["PDF report generation<br/>[ddpp_report.js]"]
  node_archive["Register archive"]
end

node_staff(("Pâtisserie staff"))
node_supabase[("Supabase service")]

node_staff -->|"uses"| node_app
node_app -->|"initializes"| node_auth
node_app -->|"renders"| node_views
node_app -->|"opens"| node_modals
node_app -->|"invokes"| node_recall
node_app -->|"uses"| node_feedback
node_auth -->|"authenticates"| node_supabase_client
node_auth -->|"starts sync"| node_sync
node_auth -->|"loads establishment"| node_state
node_auth -->|"refreshes"| node_views
node_modals -->|"updates"| node_state
node_modals -->|"refreshes"| node_views
node_modals -->|"calculates"| node_calculations
node_modals -->|"scans labels"| node_scanner
node_modals -->|"plays feedback"| node_feedback
node_views -->|"reads"| node_state
node_views -->|"calculates metrics"| node_calculations
node_views -->|"renders settings"| node_settings
node_views -->|"reads thresholds"| node_norms
node_settings -->|"reads and saves"| node_state
node_settings -->|"schedules upload"| node_sync
node_settings -->|"uses"| node_settings_data
node_settings -->|"uses"| node_settings_norms
node_settings -->|"uses"| node_constants
node_settings_norms -->|"uses thresholds"| node_norms
node_settings_data -->|"uses"| node_state
node_settings_data -->|"uses"| node_constants
node_calculations -->|"reads"| node_state
node_recall -->|"reads register"| node_state
node_recall -->|"uses"| node_ddpp_docs
node_recall -->|"uses"| node_ddpp_report
node_ddpp_docs -->|"uses"| node_norms
node_ddpp_docs -->|"builds documents"| node_ddpp_report
node_archive -->|"uses"| node_ddpp_report
node_sync -->|"synchronizes via"| node_supabase_client
node_sync -->|"reads register"| node_state
node_supabase_client -->|"reads configuration"| node_config
node_supabase_client -->|"calls API"| node_supabase
node_service_worker -->|"supports offline use"| node_staff

click node_app "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/app.js"
click node_auth "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/auth.js"
click node_views "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/views.js"
click node_modals "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/modals.js"
click node_state "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/state.js"
click node_calculations "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/calculations.js"
click node_settings "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings.js"
click node_settings_data "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings-data.js"
click node_settings_norms "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings-norms.js"
click node_norms "https://github.com/fph-dev89/traqhaccp/blob/main/src/domain/haccp_norms.js"
click node_constants "https://github.com/fph-dev89/traqhaccp/blob/main/src/domain/constants.js"
click node_scanner "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/ai-scanner.js"
click node_recall "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/recall.js"
click node_ddpp_docs "https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/ddpp_documents.js"
click node_ddpp_report "https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/ddpp_report.js"
click node_archive "https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/archive_registre.js"
click node_sync "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/sync.js"
click node_supabase_client "https://github.com/fph-dev89/traqhaccp/blob/main/src/infrastructure/supabase_client.js"
click node_config "https://github.com/fph-dev89/traqhaccp/blob/main/src/infrastructure/config.js"
click node_service_worker "https://github.com/fph-dev89/traqhaccp/blob/main/sw.js"
click node_feedback "https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/audio-toast.js"

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_auth,node_views,node_feedback toneBlue
class node_modals,node_calculations,node_settings,node_settings_data,node_scanner,node_supabase toneAmber
class node_state,node_sync,node_supabase_client,node_config,node_service_worker toneMint
class node_settings_norms,node_norms,node_constants,node_recall,node_ddpp_docs,node_ddpp_report,node_archive toneRose
class node_staff toneIndigo
```

## Components

### App workflow

- [App entry and navigation](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/app.js): `js/patisserie/app.js`
- [Establishment authentication](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/auth.js): `js/patisserie/auth.js`
- [Operational views](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/views.js): `js/patisserie/views.js`
- [Audio and toast feedback](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/audio-toast.js): `js/patisserie/audio-toast.js`

### Register operations

- [Register forms](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/modals.js): `js/patisserie/modals.js`
- [HACCP and recipe calculations](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/calculations.js): `js/patisserie/calculations.js`
- [Establishment settings](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings.js): `js/patisserie/settings.js`
- [Register configuration](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings-data.js): `js/patisserie/settings-data.js`
- [Label scanning](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/ai-scanner.js): `js/patisserie/ai-scanner.js`

### Data and platform

- [Register state and persistence](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/state.js): `js/patisserie/state.js`
- [Cloud synchronization](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/sync.js): `js/patisserie/sync.js`
- [Supabase client](https://github.com/fph-dev89/traqhaccp/blob/main/src/infrastructure/supabase_client.js): `src/infrastructure/supabase_client.js`
- [Runtime configuration](https://github.com/fph-dev89/traqhaccp/blob/main/src/infrastructure/config.js): `src/infrastructure/config.js`
- [Offline PWA cache](https://github.com/fph-dev89/traqhaccp/blob/main/sw.js): `sw.js`

### Compliance and reporting

- [Norm settings](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/settings-norms.js): `js/patisserie/settings-norms.js`
- [Regulatory thresholds](https://github.com/fph-dev89/traqhaccp/blob/main/src/domain/haccp_norms.js): `src/domain/haccp_norms.js`
- [HACCP reference data](https://github.com/fph-dev89/traqhaccp/blob/main/src/domain/constants.js): `src/domain/constants.js`
- [Product recall](https://github.com/fph-dev89/traqhaccp/blob/main/js/patisserie/recall.js): `js/patisserie/recall.js`
- [DDPP documents](https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/ddpp_documents.js): `src/presentation/ddpp_documents.js`
- [PDF report generation](https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/ddpp_report.js): `src/presentation/ddpp_report.js`
- [Register archive](https://github.com/fph-dev89/traqhaccp/blob/main/src/presentation/archive_registre.js): `src/presentation/archive_registre.js`

### Other components

- **Pâtisserie staff**
- **Supabase service**

## Connections

- Pâtisserie staff → App entry and navigation: uses (evidence: `README.md`)
- App entry and navigation → Establishment authentication: initializes (evidence: `js/patisserie/app.js`)
- App entry and navigation → Operational views: renders (evidence: `js/patisserie/app.js`)
- App entry and navigation → Register forms: opens (evidence: `js/patisserie/app.js`)
- App entry and navigation → Product recall: invokes (evidence: `js/patisserie/app.js`)
- App entry and navigation → Audio and toast feedback: uses (evidence: `js/patisserie/app.js`)
- Establishment authentication → Supabase client: authenticates (evidence: `js/patisserie/auth.js`)
- Establishment authentication → Cloud synchronization: starts sync (evidence: `js/patisserie/auth.js`)
- Establishment authentication → Register state and persistence: loads establishment (evidence: `js/patisserie/auth.js`)
- Establishment authentication → Operational views: refreshes (evidence: `js/patisserie/auth.js`)
- Register forms → Register state and persistence: updates (evidence: `js/patisserie/modals.js`)
- Register forms → Operational views: refreshes (evidence: `js/patisserie/modals.js`)
- Register forms → HACCP and recipe calculations: calculates (evidence: `js/patisserie/modals.js`)
- Register forms → Label scanning: scans labels (evidence: `js/patisserie/modals.js`)
- Register forms → Audio and toast feedback: plays feedback (evidence: `js/patisserie/modals.js`)
- Operational views → Register state and persistence: reads (evidence: `js/patisserie/views.js`)
- Operational views → HACCP and recipe calculations: calculates metrics (evidence: `js/patisserie/views.js`)
- Operational views → Establishment settings: renders settings (evidence: `js/patisserie/views.js`)
- Operational views → Regulatory thresholds: reads thresholds (evidence: `js/patisserie/views.js`)
- Establishment settings → Register state and persistence: reads and saves (evidence: `js/patisserie/settings.js`)
- Establishment settings → Cloud synchronization: schedules upload (evidence: `js/patisserie/settings.js`)
- Establishment settings → Register configuration: uses (evidence: `js/patisserie/settings.js`)
- Establishment settings → Norm settings: uses (evidence: `js/patisserie/settings.js`)
- Establishment settings → HACCP reference data: uses (evidence: `js/patisserie/settings.js`)
- Norm settings → Regulatory thresholds: uses thresholds (evidence: `js/patisserie/settings-norms.js`)
- Register configuration → Register state and persistence: uses (evidence: `js/patisserie/settings-data.js`)
- Register configuration → HACCP reference data: uses (evidence: `js/patisserie/settings-data.js`)
- HACCP and recipe calculations → Register state and persistence: reads (evidence: `js/patisserie/calculations.js`)
- Product recall → Register state and persistence: reads register (evidence: `js/patisserie/recall.js`)
- Product recall → DDPP documents: uses (evidence: `js/patisserie/recall.js`)
- Product recall → PDF report generation: uses (evidence: `js/patisserie/recall.js`)
- DDPP documents → Regulatory thresholds: uses (evidence: `src/presentation/ddpp_documents.js`)
- DDPP documents → PDF report generation: builds documents (evidence: `src/presentation/ddpp_documents.js`)
- Register archive → PDF report generation: uses (evidence: `src/presentation/archive_registre.js`)
- Cloud synchronization → Supabase client: synchronizes via (evidence: `js/patisserie/sync.js`)
- Cloud synchronization → Register state and persistence: reads register (evidence: `js/patisserie/sync.js`)
- Supabase client → Runtime configuration: reads configuration (evidence: `src/infrastructure/supabase_client.js`)
- Supabase client → Supabase service: calls API (evidence: `README.md`)
- Offline PWA cache → Pâtisserie staff: supports offline use (evidence: `README.md`)
