# timlecodeur/goodwater-apps architecture

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

- Interactive diagram: https://gitdiagram.com/timlecodeur/goodwater-apps
- Repository: https://github.com/timlecodeur/goodwater-apps

## Overview

Goodwater is a monorepo of three independent web applications: recipe/menu/shopping-list management, workout tracking, and task management. In each, a user works through a browser interface that calls a Node.js server; the server handles domain operations and persistence. The excerpts show recipe-file and SQLite access, exercise-catalogue initialization, task creation, and task offline queuing. The README documents broader capabilities, but unsampled routes and implementations are represented only at subsystem level; links between independently configured applications are not inferred.

Main entry points: [`goodwater-recipes/app.js`](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/app.js) (Recipes API), [`goodwater-gym/app.js`](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/app.js) (Gym API), [`goodwater-task/public/script.js`](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/public/script.js) (Task interface), [`goodwater-recipes/public/script.js`](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/script.js) (Recipe interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_recipes["Recipes"]
  node_recipe_ui["Recipe interface<br/>[script.js]"]
  node_recipe_auth_action["Registration action"]
  node_recipe_nutrition["Nutrition calculator<br/>[nutrition.js]"]
  node_recipe_server["Recipes API<br/>[app.js]"]
  node_recipe_files[("Recipe files")]
  node_recipe_db[("Recipes database")]
end

subgraph group_gym["Gym"]
  node_gym_ui["Workout interface<br/>[script.js]"]
  node_gym_server["Gym API<br/>[app.js]"]
  node_gym_catalogue["Exercise catalogue"]
  node_gym_localizer["Exercise localization"]
  node_gym_db[("Gym database")]
end

subgraph group_tasks["Tasks"]
  node_task_ui["Task interface<br/>[script.js]"]
  node_task_offline["Offline queue<br/>[script.js]"]
  node_task_server["Task API<br/>[app.js]"]
  node_task_db[("Task database")]
end

node_recipe_user(("User"))
node_gym_user(("User"))
node_task_user(("User"))

node_recipe_user -->|"uses"| node_recipe_ui
node_recipe_ui -->|"requests API"| node_recipe_server
node_recipe_auth_action -->|"submits action"| node_recipe_server
node_recipe_server -->|"reads recipes"| node_recipe_files
node_recipe_server -->|"queries data"| node_recipe_db
node_gym_user -->|"uses"| node_gym_ui
node_gym_ui -->|"requests API"| node_gym_server
node_gym_server -->|"loads catalogue"| node_gym_catalogue
node_gym_server -->|"stores workouts"| node_gym_db
node_gym_localizer -->|"localizes names"| node_gym_catalogue
node_task_user -->|"uses"| node_task_ui
node_task_ui -->|"requests API"| node_task_server
node_task_ui -->|"queues requests"| node_task_offline
node_task_server -->|"writes tasks"| node_task_db

click node_recipe_ui "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/script.js"
click node_recipe_auth_action "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/registration-action.js"
click node_recipe_nutrition "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/data/nutrition.js"
click node_recipe_server "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/app.js"
click node_recipe_files "https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-recipes/data"
click node_recipe_db "https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-recipes/data"
click node_gym_ui "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/public/script.js"
click node_gym_server "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/app.js"
click node_gym_catalogue "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/data/exercises-dataset.json"
click node_gym_localizer "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/scripts/localize-exercises.js"
click node_gym_db "https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-gym/data"
click node_task_ui "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/public/script.js"
click node_task_offline "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/public/script.js"
click node_task_server "https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/app.js"
click node_task_db "https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-task/data"

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_recipe_ui,node_recipe_auth_action,node_recipe_nutrition,node_recipe_server,node_recipe_files,node_recipe_db,node_recipe_user,node_gym_user,node_task_user toneBlue
class node_gym_ui,node_gym_server,node_gym_catalogue,node_gym_localizer,node_gym_db toneAmber
class node_task_ui,node_task_offline,node_task_server,node_task_db toneMint
```

## Components

### Recipes

- [Recipe interface](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/script.js): `goodwater-recipes/public/script.js`
- [Registration action](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/registration-action.js): `goodwater-recipes/public/registration-action.js`
- [Nutrition calculator](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/public/data/nutrition.js): `goodwater-recipes/public/data/nutrition.js`
- [Recipes API](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-recipes/app.js): `goodwater-recipes/app.js`
- [Recipe files](https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-recipes/data): `goodwater-recipes/data`
- [Recipes database](https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-recipes/data): `goodwater-recipes/data`

### Gym

- [Workout interface](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/public/script.js): `goodwater-gym/public/script.js`
- [Gym API](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/app.js): `goodwater-gym/app.js`
- [Exercise catalogue](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/data/exercises-dataset.json): `goodwater-gym/data/exercises-dataset.json`
- [Exercise localization](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-gym/scripts/localize-exercises.js): `goodwater-gym/scripts/localize-exercises.js`
- [Gym database](https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-gym/data): `goodwater-gym/data`

### Tasks

- [Task interface](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/public/script.js): `goodwater-task/public/script.js`
- [Offline queue](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/public/script.js): `goodwater-task/public/script.js`
- [Task API](https://github.com/timlecodeur/goodwater-apps/blob/main/goodwater-task/app.js): `goodwater-task/app.js`
- [Task database](https://github.com/timlecodeur/goodwater-apps/tree/main/goodwater-task/data): `goodwater-task/data`

### Other components

- **User**
- **User**
- **User**

## Connections

- User → Recipe interface: uses (evidence: `README.md`)
- Recipe interface → Recipes API: requests API (evidence: `goodwater-recipes/public/script.js`)
- Registration action → Recipes API: submits action (evidence: `goodwater-recipes/public/registration-action.js`)
- Recipes API → Recipe files: reads recipes (evidence: `goodwater-recipes/app.js`)
- Recipes API → Recipes database: queries data (evidence: `goodwater-recipes/app.js`)
- User → Workout interface: uses (evidence: `README.md`)
- Workout interface → Gym API: requests API (evidence: `goodwater-gym/public/script.js`)
- Gym API → Exercise catalogue: loads catalogue (evidence: `goodwater-gym/app.js`)
- Gym API → Gym database: stores workouts (evidence: `goodwater-gym/app.js`)
- Exercise localization → Exercise catalogue: localizes names (evidence: `goodwater-gym/scripts/localize-exercises.js`)
- User → Task interface: uses (evidence: `README.md`)
- Task interface → Task API: requests API (evidence: `goodwater-task/public/script.js`)
- Task interface → Offline queue: queues requests (evidence: `goodwater-task/public/script.js`)
- Task API → Task database: writes tasks (evidence: `goodwater-task/app.js`)
