Data catalog

Every dataset behind the Wardrobe Diary: what it holds, who can read it, where it comes from and how good it is. Licence: CC BY 4.0.

Semantic layer version 0.4.1 (2026-10-28) · JSON-LD · source (YAML) · CC BY 4.0

Data quality

The rules the data must meet. The results below are computed in your browser from the public data when the page loads, with the same code that checks the data every night.

Checking…

Rule	Dataset	Requirement	Severity	Result
`unique-ids`	Garments	Every garment id is unique.	error	–
`known-category`	Garments	Every category is one of the 13 standard categories.	error	–
`dates-ordered`	Garments	purchased ≤ divested when both are set.	error	–
`non-negative`	Garments	price ≥ 0, timesUsedInit ≥ 0, weightG > 0 when set.	error	–
`known-tags`	Garments	Every tag is in the vocabulary.	error	–
`worn-exists`	Wear log	Every worn id is an existing garment.	error	–
`wears-in-ownership`	Wear log	Wears fall within the garment's ownership period. Known exceptions are ignored by the metrics (Q-9).	warning	–
`public-matches-source`	Public wardrobe data	The public copy equals garments + days + comparison.	error	–
`materials-coverage`	Garments	Share of active garments with a weight and readable materials (reported, no threshold).	info	–

Datasets

Classification: public readable by anyone (published by choice) · owner-only only the signed-in owner · private not exposed by the app. All data describes one identifiable person, who publishes the public parts by choice.

Garments owner-only

Every garment owned at some point since tracking began, with its details. The source of truth for garment details (decision D-4).

Where: Firestore users/{uid}/garments/{garmentId}
Contract: ODCS data contract
Represents: Garment
Published via: Public wardrobe data
Lineage: from Google Sheet (retired): Sheet → Firestore migration and sync (until 2026-10-09) – D-4
from owner: edited in the app (/manage) (since 2026-10-09)

Field	Type	Required	Definition	Constraints
`id`	text	yes	Garment id, from the original Sheet's Photo id (e.g. Jackets_and_hoodies-006); also the photo file name.	pattern <Category_words>-NNN; unique
`category`	text	yes	The garment's category. (Category)	one of the 13 standard categories
`item`	text	yes	Name (brand, model, colour; numbered when identical items exist).
`details`	text		Free-text details such as size or model code.
`photo`	text	yes	Photo file name without .png in public storage.
`photoVersion`	text		Set when the photo is replaced; part of the photo URL so caches show the new one.
`price`	money-eur		What was paid, rounded to whole cents. (Price)	≥ 0
`purchased`	date		Purchase date.	≤ divested
`divested`	date		Last day owned; empty while active. (Divested)
`timesUsedInit`	integer	yes	Wears before tracking began (estimate). (Pre-tracking wears)	≥ 0
`materials`	text		The materials label as written. (Materials)
`weightG`	mass-g		Weight in grams.	> 0
`tags`	list of text		Descriptive tags. (Tag)	each one of: second-hand, hanko, bicycle, motorcycle, winter, summer
`detailsUnavailable`	boolean		Divested only: missing materials or weight can no longer be filled in (left off the review list).

Garment history owner-only

Every saved version of every garment (an audit trail), including the version before each change.

Where: Firestore users/{uid}/garments/{garmentId}/history/{autoId}
Contract: ODCS data contract
Lineage: from Garments: written in the same transaction as each garment save

Field	Type	Required	Definition
`savedAt`	timestamp	yes	When the version was saved.
`before`	garment		The previous version; empty when the garment was created in the app.
`after`	garment	yes	The saved version.
`note`	text		What happened, e.g. "Photo replaced".

Deleted garments owner-only

Garments deleted in the app (only never-worn ones can be), kept as a record.

Where: Firestore users/{uid}/deletedGarments/{garmentId}
Contract: ODCS data contract

Field	Type	Required	Definition	Constraints
`deletedAt`	timestamp	yes	When it was deleted.
`garment`	garment	yes	The garment as it was.

Wear log owner-only

One record per day with wears - the garments worn that day. Days with nothing worn have no record.

Where: Firestore users/{uid}/days/{YYYY-MM-DD}
Contract: ODCS data contract
Represents: Wear day
Published via: Public wardrobe data
Lineage: from Google Sheet (retired): daily checkbox columns, migrated (until 2026-10-09)
from owner: logged in the app (/log) (since 2026-10-10) – R-15

Field	Type	Required	Definition	Constraints
`date`	date	yes	The day (document id).	≥ 2018-01-01; not in the future
`worn`	list of garment ids	yes	The garments worn that day.	each an existing garment id; no duplicates

Settings owner-only

App settings, e.g. settings/app.sheetRetired, the cut-over date after which the retired Sheet may no longer be synced, and the rotation series marked for the Log page.

Where: Firestore users/{uid}/settings/app
Contract: ODCS data contract

Field	Type	Required	Definition	Constraints
`sheetRetired`	date		Cut-over date (2026-10-09).
`rotationSeries`	string[]		Rotation series marked by the owner, each as category\|name without the number, e.g. Socks\|SOC U 4P Black (39-42). (Rotation series)

Comparison items owner-only

Other everyday spending shown next to the clothing categories in the monthly cost chart.

Where: Firestore users/{uid}/settings/comparison (items)
Contract: ODCS data contract
Represents: Comparison item
Published via: Public wardrobe data
Lineage: from Google Sheet (retired): one-off import of the Comparison tab (values only) (until 2026-10-12)
from owner: edited in the app (/manage/comparison) (since 2026-10-12)

Field	Type	Required	Definition	Constraints
`id`	text	yes	Item id (from its name).
`type`	text		Kind of spending, e.g. Content, Physical service.
`item`	text	yes	Name.
`details`	text		Free-text details.
`photo`	text		Photo file name (Comparison-<Name>) without .png; empty when none.
`photoVersion`	text		Set when a photo is uploaded.
`monthlyCost`	money-eur	yes	Monthly cost (entered).	≥ 0
`useFrequency`	share	yes	Share of days used (entered). (Use frequency)	0–1

Dictation log owner-only

Every item description dictated or typed on the Log page ("Describe an item"), the garments the matcher proposed and the one the owner added (if any), to measure how well matching works and compare matchers.

Where: Firestore users/{uid}/voiceLog/{autoId}
Contract: ODCS data contract
Lineage: from owner: dictated on the Log page; proposals by web/src/lib/voiceMatch.ts (since 2026-10-18)

Field	Type	Required	Definition
`at`	text	yes	When it was entered (ISO time).
`date`	date	yes	The day being logged.
`text`	text	yes	The description as dictated or typed.
`proposals`	list of garment ids	yes	The proposed garments, best first.
`chosen`	text		The garment added from the proposals, or empty if none was.
`rank`	integer		The chosen garment's position in the proposals (0 = best).
`mode`	text		match (best matches) or browse (only a garment type was said: that type's garments by photo, most worn lately first).
`matcher`	text	yes	Which matcher made the proposals, e.g. voiceMatch v1.

Public wardrobe data public

The world-readable copy for public pages and the MCP server: all garments, the full day-by-day log (as indexes into the garment list) and the comparison items, in one document, so any metric can be computed for any range with one read (decision D-1).

Where: Firestore users/{uid}/public/data
Contract: ODCS data contract
Access: Firestore REST (JSON): firestore.googleapis.com/v1/projects/threddit-297417/databas…
web app: wardrobediary.io/dashboard
MCP server (Streamable HTTP): wardrobediary.io/mcp
Lineage: from Garments, Wear log, Comparison items: updated in the same write as every change in the app (transactions / batches) – D-1

Field	Type	Required	Definition
`version`	integer	yes	Format version (1).
`garments`	list of garment	yes	All garments with all their fields (same as dataset garments).
`days`	map date → list of integer	yes	The wear log as positions in the garments list.
`comparison`	list of comparison item		The comparison items.

Photos public

Garment photos (228 × 228 PNG), category images and comparison photos.

Where: Firebase Storage bucket threddit-297417.appspot.com

Nightly backups private

A full JSON export of garments (with history), days, deleted garments and settings, every night, with git history keeping every day.

Where: private GitHub repository hoverfalt/wardrobe-diary-backups (wardrobe.json); local backups/ folder
Updated: daily at 02:17 UTC
Lineage: from Garments, Garment history, Wear log, Deleted garments, Settings, Dictation log: tools/backup.py with a read-only service account – R-28

Google Sheet (retired) private retired

The original data entry, 2018-01-01 to 2026-10-09 - one row per garment, one checkbox column per day. Retired at the cut-over; kept read-only for reference.

Where: Google Sheet 1IQgCth6qPDHv_mqh8wSg9MaphLPR5dlTv0pi2QgAJLM, tab Threddit (and Comparison)