# stinky-c/laundry-data architecture

> Architecture diagram of the GitHub repository stinky-c/laundry-data, 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/stinky-c/laundry-data
- Repository: https://github.com/stinky-c/laundry-data

## Overview

This Rust service periodically fetches laundry-machine status for configured rooms, turns responses into machine and physical-endpoint records plus laundry-log entries in PostgreSQL, and looks up missing room/location metadata through the same API. Startup loads configuration, connects to the database, applies migrations, and starts the HTTP and database controllers. The graph follows calls and channel transfers visible in the excerpts; the README is empty, and unsampled modules are not assumed to provide additional behavior.

Main entry points: [`src/main.rs`](https://github.com/stinky-c/laundry-data/blob/master/src/main.rs) (Service startup), [`src/logic/db.rs`](https://github.com/stinky-c/laundry-data/blob/master/src/logic/db.rs) (Location precheck), [`src/logic/laundrylog.rs`](https://github.com/stinky-c/laundry-data/blob/master/src/logic/laundrylog.rs) (Laundry log writer), [`src/logic/http.rs`](https://github.com/stinky-c/laundry-data/blob/master/src/logic/http.rs) (Room scrapers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime orchestration"]
  node_main["Service startup<br/>[main.rs]"]
  node_task_types["Channels and task types<br/>[types.rs]"]
end

subgraph group_http["HTTP collection"]
  node_http_controller["HTTP controller<br/>[http.rs]"]
  node_scrapers["Room scrapers<br/>[http.rs]"]
  node_url_helpers["API URL builder<br/>[utils.rs]"]
end

subgraph group_persistence["Database persistence"]
  node_db_controller["Database controller<br/>[db.rs]"]
  node_precheck["Location precheck<br/>[db.rs]"]
  node_log_entry["Laundry log writer<br/>[laundrylog.rs]"]
  node_sql_models["SQL statements<br/>[db.rs]"]
  node_db_helpers["Query and cache helpers<br/>[utils.rs]"]
  node_migrations["Database migrations"]
end

subgraph group_domain["Domain and configuration"]
  node_config["App configuration<br/>[config.rs]"]
  node_db_config["Database settings<br/>[db.rs]"]
  node_api_config["API endpoint settings<br/>[config.rs]"]
  node_pep_id["Endpoint ID hash<br/>[pep.rs]"]
  node_api_models["API data models<br/>[api.rs]"]
end

node_api_service{{"Laundry machine API"}}
node_postgres[("PostgreSQL database")]

node_main -->|"loads"| node_config
node_config -->|"includes"| node_db_config
node_config -->|"includes"| node_api_config
node_main -->|"connects"| node_postgres
node_main -->|"applies"| node_migrations
node_main -->|"starts"| node_scrapers
node_main -->|"starts"| node_http_controller
node_main -->|"starts"| node_db_controller
node_main -->|"creates channels"| node_task_types
node_scrapers -->|"builds URLs"| node_url_helpers
node_http_controller -->|"builds URLs"| node_url_helpers
node_scrapers -->|"fetches status"| node_api_service
node_scrapers -->|"sends responses"| node_db_controller
node_db_controller -->|"runs precheck"| node_precheck
node_precheck -->|"reads and inserts"| node_postgres
node_precheck -->|"requests metadata"| node_http_controller
node_http_controller -->|"fetches metadata"| node_api_service
node_db_controller -->|"writes machine logs"| node_log_entry
node_log_entry -->|"calculates ID"| node_pep_id
node_log_entry -->|"checks and inserts"| node_postgres
node_db_controller -->|"parses responses"| node_api_models
node_precheck -->|"uses statements"| node_sql_models
node_log_entry -->|"uses statements"| node_sql_models
node_precheck -->|"uses query helper"| node_db_helpers
node_log_entry -->|"uses cache"| node_db_helpers

click node_main "https://github.com/stinky-c/laundry-data/blob/master/src/main.rs"
click node_config "https://github.com/stinky-c/laundry-data/blob/master/src/models/config.rs"
click node_db_config "https://github.com/stinky-c/laundry-data/blob/master/src/db.rs"
click node_api_config "https://github.com/stinky-c/laundry-data/blob/master/src/models/config.rs"
click node_task_types "https://github.com/stinky-c/laundry-data/blob/master/src/types.rs"
click node_http_controller "https://github.com/stinky-c/laundry-data/blob/master/src/logic/http.rs"
click node_scrapers "https://github.com/stinky-c/laundry-data/blob/master/src/logic/http.rs"
click node_url_helpers "https://github.com/stinky-c/laundry-data/blob/master/src/utils.rs"
click node_db_controller "https://github.com/stinky-c/laundry-data/blob/master/src/logic/db.rs"
click node_precheck "https://github.com/stinky-c/laundry-data/blob/master/src/logic/db.rs"
click node_log_entry "https://github.com/stinky-c/laundry-data/blob/master/src/logic/laundrylog.rs"
click node_pep_id "https://github.com/stinky-c/laundry-data/blob/master/src/pep.rs"
click node_api_models "https://github.com/stinky-c/laundry-data/blob/master/src/models/api.rs"
click node_sql_models "https://github.com/stinky-c/laundry-data/blob/master/src/models/db.rs"
click node_db_helpers "https://github.com/stinky-c/laundry-data/blob/master/src/utils.rs"
click node_migrations "https://github.com/stinky-c/laundry-data/blob/master/migrations/V1__create_init.sql"

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_main,node_task_types toneBlue
class node_http_controller,node_scrapers,node_url_helpers,node_postgres toneAmber
class node_db_controller,node_precheck,node_log_entry,node_sql_models,node_db_helpers,node_migrations,node_api_service toneMint
class node_config,node_db_config,node_api_config,node_pep_id,node_api_models toneRose
```

## Components

### Runtime orchestration

- [Service startup](https://github.com/stinky-c/laundry-data/blob/master/src/main.rs): `src/main.rs`
- [Channels and task types](https://github.com/stinky-c/laundry-data/blob/master/src/types.rs): `src/types.rs`

### HTTP collection

- [HTTP controller](https://github.com/stinky-c/laundry-data/blob/master/src/logic/http.rs): `src/logic/http.rs`
- [Room scrapers](https://github.com/stinky-c/laundry-data/blob/master/src/logic/http.rs): `src/logic/http.rs`
- [API URL builder](https://github.com/stinky-c/laundry-data/blob/master/src/utils.rs): `src/utils.rs`

### Database persistence

- [Database controller](https://github.com/stinky-c/laundry-data/blob/master/src/logic/db.rs): `src/logic/db.rs`
- [Location precheck](https://github.com/stinky-c/laundry-data/blob/master/src/logic/db.rs): `src/logic/db.rs`
- [Laundry log writer](https://github.com/stinky-c/laundry-data/blob/master/src/logic/laundrylog.rs): `src/logic/laundrylog.rs`
- [SQL statements](https://github.com/stinky-c/laundry-data/blob/master/src/models/db.rs): `src/models/db.rs`
- [Query and cache helpers](https://github.com/stinky-c/laundry-data/blob/master/src/utils.rs): `src/utils.rs`
- [Database migrations](https://github.com/stinky-c/laundry-data/blob/master/migrations/V1__create_init.sql): `migrations/V1__create_init.sql`

### Domain and configuration

- [App configuration](https://github.com/stinky-c/laundry-data/blob/master/src/models/config.rs): `src/models/config.rs`
- [Database settings](https://github.com/stinky-c/laundry-data/blob/master/src/db.rs): `src/db.rs`
- [API endpoint settings](https://github.com/stinky-c/laundry-data/blob/master/src/models/config.rs): `src/models/config.rs`
- [Endpoint ID hash](https://github.com/stinky-c/laundry-data/blob/master/src/pep.rs): `src/pep.rs`
- [API data models](https://github.com/stinky-c/laundry-data/blob/master/src/models/api.rs): `src/models/api.rs`

### Other components

- **Laundry machine API**
- **PostgreSQL database**

## Connections

- Service startup → App configuration: loads (evidence: `src/main.rs`)
- App configuration → Database settings: includes (evidence: `src/models/config.rs`)
- App configuration → API endpoint settings: includes (evidence: `src/models/config.rs`)
- Service startup → PostgreSQL database: connects (evidence: `src/main.rs`)
- Service startup → Database migrations: applies (evidence: `src/main.rs`)
- Service startup → Room scrapers: starts (evidence: `src/main.rs`)
- Service startup → HTTP controller: starts (evidence: `src/main.rs`)
- Service startup → Database controller: starts (evidence: `src/main.rs`)
- Service startup → Channels and task types: creates channels (evidence: `src/main.rs`)
- Room scrapers → API URL builder: builds URLs (evidence: `src/logic/http.rs`)
- HTTP controller → API URL builder: builds URLs (evidence: `src/logic/http.rs`)
- Room scrapers → Laundry machine API: fetches status (evidence: `src/logic/http.rs`)
- Room scrapers → Database controller: sends responses (evidence: `src/logic/http.rs`)
- Database controller → Location precheck: runs precheck (evidence: `src/logic/db.rs`)
- Location precheck → PostgreSQL database: reads and inserts (evidence: `src/logic/db.rs`)
- Location precheck → HTTP controller: requests metadata (evidence: `src/logic/db.rs`)
- HTTP controller → Laundry machine API: fetches metadata (evidence: `src/logic/http.rs`)
- Database controller → Laundry log writer: writes machine logs (evidence: `src/logic/db.rs`)
- Laundry log writer → Endpoint ID hash: calculates ID (evidence: `src/logic/laundrylog.rs`)
- Laundry log writer → PostgreSQL database: checks and inserts (evidence: `src/logic/laundrylog.rs`)
- Database controller → API data models: parses responses (evidence: `src/logic/db.rs`)
- Location precheck → SQL statements: uses statements (evidence: `src/logic/db.rs`)
- Laundry log writer → SQL statements: uses statements (evidence: `src/logic/laundrylog.rs`)
- Location precheck → Query and cache helpers: uses query helper (evidence: `src/logic/db.rs`)
- Laundry log writer → Query and cache helpers: uses cache (evidence: `src/logic/laundrylog.rs`)
