# rafanonato/saas-nutrition architecture

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

- Interactive diagram: https://gitdiagram.com/rafanonato/saas-nutrition
- Repository: https://github.com/rafanonato/saas-nutrition

## Overview

TalkNutri is a multi-tenant clinical nutrition SaaS. The primary workflow moves from clinician sign-in and patient selection through consultation and assessment, diet prescription, then clinician-approved document delivery; clinic administration, compliance, billing, and patient WhatsApp support are additional capabilities. The graph combines shown frontend/backend routing and calls with documented product relationships. Several domain implementations were not sampled, so uncertain implementation-level connections are omitted.

Main entry points: [`src/App.tsx`](https://github.com/rafanonato/saas-nutrition/blob/main/src/App.tsx) (Workspace shell), [`src/server/app.ts`](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/app.ts) (Express API routing), [`src/components/views/EditorDieteticoView.tsx`](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/EditorDieteticoView.tsx) (Diet editor), [`src/server/services/metaWhatsApp.service.ts`](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/metaWhatsApp.service.ts) (WhatsApp messaging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Clinical workspace"]
  node_app["Workspace shell<br/>[App.tsx]"]
  node_auth["Sign-in and 2FA<br/>[AuthContext.tsx]"]
  node_clinic["Clinic and patient management<br/>[tenantService.ts]"]
end

subgraph group_clinical["Clinical assessment"]
  node_consultation["Consultation workflow<br/>[AnamneseView.tsx]"]
  node_audio["Clinical audio capture"]
  node_recordings["Recording storage"]
  node_ocr["Exam OCR<br/>[ocrService.ts]"]
  node_assessment["Physical assessment"]
  node_metabolic["Metabolic calculator"]
end

subgraph group_prescription["Diet prescription"]
  node_diet_editor["Diet editor"]
  node_optimizer["HiGHS optimizer"]
  node_food_data[("Food and template data<br/>[foodDatabase.ts]")]
  node_dri[("DRI references<br/>[driTables.ts]")]
  node_finalization["Review and signature"]
end

subgraph group_platform["Platform services"]
  node_compliance["LGPD compliance"]
  node_billing["SaaS billing<br/>[billing.service.ts]"]
  node_api["Express API routing<br/>[app.ts]"]
  node_controllers["Clinical API controllers"]
  node_database[("Persistent data access<br/>[client.ts]")]
end

subgraph group_delivery["Patient delivery"]
  node_pdf["PDF document service"]
  node_queue["Background queue<br/>[queue.service.ts]"]
  node_whatsapp["WhatsApp messaging"]
  node_copilot["Clinical AI copilot"]
end

node_nutritionist(("Nutritionist"))
node_patient(("Patient"))
node_meta["Meta Cloud API"]

node_nutritionist -->|"uses workspace"| node_app
node_app -->|"checks session"| node_auth
node_app -->|"routes to"| node_consultation
node_app -->|"routes to"| node_assessment
node_app -->|"routes to"| node_diet_editor
node_app -->|"routes to"| node_finalization
node_app -->|"loads and updates"| node_clinic
node_consultation -->|"opens capture"| node_audio
node_consultation -->|"opens exam OCR"| node_ocr
node_audio -->|"reads and saves"| node_recordings
node_assessment -->|"calculates metabolism"| node_metabolic
node_diet_editor -.->|"optimizes portions"| node_optimizer
node_diet_editor -.->|"uses food data"| node_food_data
node_diet_editor -.->|"checks adequacy"| node_dri
node_finalization -.->|"generates approved plan"| node_pdf
node_pdf -->|"dispatches work"| node_queue
node_patient -.->|"messages"| node_whatsapp
node_whatsapp -->|"sends messages"| node_meta
node_whatsapp -->|"requests plan document"| node_pdf
node_whatsapp -.->|"delivers plan and replies"| node_patient
node_app -.->|"opens copilot"| node_copilot
node_app -.->|"calls REST API"| node_api
node_api -->|"routes requests"| node_controllers
node_api -->|"applies authentication"| node_auth
node_controllers -.->|"accesses records"| node_database
node_api -->|"routes consent operations"| node_compliance
node_api -.->|"routes billing operations"| node_billing
node_database -.->|"stores clinical records"| node_patient

click node_app "https://github.com/rafanonato/saas-nutrition/blob/main/src/App.tsx"
click node_auth "https://github.com/rafanonato/saas-nutrition/blob/main/src/context/AuthContext.tsx"
click node_clinic "https://github.com/rafanonato/saas-nutrition/blob/main/src/services/tenantService.ts"
click node_consultation "https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/AnamneseView.tsx"
click node_audio "https://github.com/rafanonato/saas-nutrition/blob/main/src/components/assessment/ConsultationAudioRecordingModal.tsx"
click node_recordings "https://github.com/rafanonato/saas-nutrition/blob/main/src/utils/audioRecordingStorage.ts"
click node_ocr "https://github.com/rafanonato/saas-nutrition/blob/main/src/services/ocrService.ts"
click node_assessment "https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/AvaliacaoFisicaView.tsx"
click node_metabolic "https://github.com/rafanonato/saas-nutrition/blob/main/src/utils/metabolicCalculator.ts"
click node_diet_editor "https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/EditorDieteticoView.tsx"
click node_optimizer "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/highsSolver.service.ts"
click node_food_data "https://github.com/rafanonato/saas-nutrition/blob/main/src/data/foodDatabase.ts"
click node_dri "https://github.com/rafanonato/saas-nutrition/blob/main/src/data/driTables.ts"
click node_finalization "https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/FinalizacaoView.tsx"
click node_pdf "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/mealPlanDocument.service.ts"
click node_queue "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/queue.service.ts"
click node_whatsapp "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/metaWhatsApp.service.ts"
click node_copilot "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/controllers/copilot.controller.ts"
click node_compliance "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/compliance.service.ts"
click node_billing "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/billing.service.ts"
click node_api "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/app.ts"
click node_controllers "https://github.com/rafanonato/saas-nutrition/tree/main/src/server/controllers"
click node_database "https://github.com/rafanonato/saas-nutrition/blob/main/src/server/db/client.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_auth,node_clinic toneBlue
class node_consultation,node_audio,node_recordings,node_ocr,node_assessment,node_metabolic toneAmber
class node_diet_editor,node_optimizer,node_food_data,node_dri,node_finalization,node_meta toneMint
class node_compliance,node_billing,node_api,node_controllers,node_database toneRose
class node_pdf,node_queue,node_whatsapp,node_copilot,node_nutritionist,node_patient toneIndigo
```

## Components

### Clinical workspace

- [Workspace shell](https://github.com/rafanonato/saas-nutrition/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-in and 2FA](https://github.com/rafanonato/saas-nutrition/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Clinic and patient management](https://github.com/rafanonato/saas-nutrition/blob/main/src/services/tenantService.ts): `src/services/tenantService.ts`

### Clinical assessment

- [Consultation workflow](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/AnamneseView.tsx): `src/components/views/AnamneseView.tsx`
- [Clinical audio capture](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/assessment/ConsultationAudioRecordingModal.tsx): `src/components/assessment/ConsultationAudioRecordingModal.tsx`
- [Recording storage](https://github.com/rafanonato/saas-nutrition/blob/main/src/utils/audioRecordingStorage.ts): `src/utils/audioRecordingStorage.ts`
- [Exam OCR](https://github.com/rafanonato/saas-nutrition/blob/main/src/services/ocrService.ts): `src/services/ocrService.ts`
- [Physical assessment](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/AvaliacaoFisicaView.tsx): `src/components/views/AvaliacaoFisicaView.tsx`
- [Metabolic calculator](https://github.com/rafanonato/saas-nutrition/blob/main/src/utils/metabolicCalculator.ts): `src/utils/metabolicCalculator.ts`

### Diet prescription

- [Diet editor](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/EditorDieteticoView.tsx): `src/components/views/EditorDieteticoView.tsx`
- [HiGHS optimizer](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/highsSolver.service.ts): `src/server/services/highsSolver.service.ts`
- [Food and template data](https://github.com/rafanonato/saas-nutrition/blob/main/src/data/foodDatabase.ts): `src/data/foodDatabase.ts`
- [DRI references](https://github.com/rafanonato/saas-nutrition/blob/main/src/data/driTables.ts): `src/data/driTables.ts`
- [Review and signature](https://github.com/rafanonato/saas-nutrition/blob/main/src/components/views/FinalizacaoView.tsx): `src/components/views/FinalizacaoView.tsx`

### Platform services

- [LGPD compliance](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/compliance.service.ts): `src/server/services/compliance.service.ts`
- [SaaS billing](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/billing.service.ts): `src/server/services/billing.service.ts`
- [Express API routing](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/app.ts): `src/server/app.ts`
- [Clinical API controllers](https://github.com/rafanonato/saas-nutrition/tree/main/src/server/controllers): `src/server/controllers`
- [Persistent data access](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/db/client.ts): `src/server/db/client.ts`

### Patient delivery

- [PDF document service](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/mealPlanDocument.service.ts): `src/server/services/mealPlanDocument.service.ts`
- [Background queue](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/queue.service.ts): `src/server/services/queue.service.ts`
- [WhatsApp messaging](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/services/metaWhatsApp.service.ts): `src/server/services/metaWhatsApp.service.ts`
- [Clinical AI copilot](https://github.com/rafanonato/saas-nutrition/blob/main/src/server/controllers/copilot.controller.ts): `src/server/controllers/copilot.controller.ts`

### Other components

- **Nutritionist**
- **Patient**
- **Meta Cloud API**

## Connections

- Nutritionist → Workspace shell: uses workspace (evidence: `README.md`)
- Workspace shell → Sign-in and 2FA: checks session (evidence: `src/App.tsx`)
- Workspace shell → Consultation workflow: routes to (evidence: `src/App.tsx`)
- Workspace shell → Physical assessment: routes to (evidence: `src/App.tsx`)
- Workspace shell → Diet editor: routes to (evidence: `src/App.tsx`)
- Workspace shell → Review and signature: routes to (evidence: `src/App.tsx`)
- Workspace shell → Clinic and patient management: loads and updates (evidence: `src/App.tsx`)
- Consultation workflow → Clinical audio capture: opens capture (evidence: `src/components/views/AnamneseView.tsx`)
- Consultation workflow → Exam OCR: opens exam OCR (evidence: `src/components/views/AnamneseView.tsx`)
- Clinical audio capture → Recording storage: reads and saves (evidence: `src/components/assessment/ConsultationAudioRecordingModal.tsx`)
- Physical assessment → Metabolic calculator: calculates metabolism (evidence: `src/components/views/AvaliacaoFisicaView.tsx`)
- Diet editor → HiGHS optimizer: optimizes portions (evidence: `README.md`)
- Diet editor → Food and template data: uses food data (evidence: `README.md`)
- Diet editor → DRI references: checks adequacy (evidence: `README.md`)
- Review and signature → PDF document service: generates approved plan (evidence: `README.md`)
- PDF document service → Background queue: dispatches work (evidence: `src/server/services/mealPlanDocument.service.ts`)
- Patient → WhatsApp messaging: messages (evidence: `README.md`)
- WhatsApp messaging → Meta Cloud API: sends messages
- WhatsApp messaging → PDF document service: requests plan document (evidence: `src/server/controllers/whatsapp.controller.ts`)
- WhatsApp messaging → Patient: delivers plan and replies (evidence: `README.md`)
- Workspace shell → Clinical AI copilot: opens copilot (evidence: `README.md`)
- Workspace shell → Express API routing: calls REST API (evidence: `README.md`)
- Express API routing → Clinical API controllers: routes requests (evidence: `src/server/app.ts`)
- Express API routing → Sign-in and 2FA: applies authentication (evidence: `src/server/app.ts`)
- Clinical API controllers → Persistent data access: accesses records (evidence: `src/server/controllers/auth.controller.ts`)
- Express API routing → LGPD compliance: routes consent operations (evidence: `src/server/app.ts`)
- Express API routing → SaaS billing: routes billing operations (evidence: `README.md`)
- Persistent data access → Patient: stores clinical records (evidence: `README.md`)
