mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 23:52:24 +00:00
feat(mood): add rated mood factors (ingestion + write contract)
Extend the structured mood taxonomy so a tag can carry a magnitude. A
rated factor is a MoodTag of kind RATED that the user scores per entry;
the score persists on MoodEntryTagLink.rating. Binary tags keep
kind BINARY and a null rating, so every existing row and read path stays
byte-identical.
Migration 0119 is additive: four marker columns on mood_tags (kind,
scale_min, scale_max, inverse), a nullable rating on mood_entry_tag_links,
and a seeded factors category with five MVP factors (work, social, sleep
quality, stress, conflict). Stress and conflict are inverse-scaled
(higher means worse); conflict is a 1..2 Yes/No factor.
Write contract: POST /api/mood-entries and the bulk route accept an
optional ratedFactors: [{ key, rating }] array parallel to the binary
tagKeys. The resolver builds the join rows field-by-field, drops unknown
and non-RATED keys silently, and rejects a rating outside the factor's
own scaleMin..scaleMax (422 on the single-entry path, per-entry skipped
on bulk). Create and list responses surface the persisted factors split
from binary keys so a client hydrates without a refetch. GET
/api/mood/tags now emits kind, scaleMin, scaleMax, and inverse so a
client can render factors versus tags.
This is the ingestion half; analytics over rated factors follow later.
Factor labels ship in all six locales.
This commit is contained in:
1 parent
793602f464
commit
81096b9553
20 files changed
+1100
-43
No files matched your search
@@ -0,0 +1,77 @@
|
||||
-- v1.12.0 — rated mood factors (ingestion half).
|
||||
--
|
||||
-- Additive on top of the binary mood-tag taxonomy (0101 / 0118). A rated
|
||||
-- factor is a `MoodTag` whose `kind = 'RATED'`: the user scores it 1..5
|
||||
-- (or the tag's own scale) per entry, and the score rides on the existing
|
||||
-- `mood_entry_tag_links` join via a new `rating` column. Binary tags keep
|
||||
-- `kind = 'BINARY'` and `rating = NULL`, so every pre-existing row and
|
||||
-- read path stays byte-identical.
|
||||
--
|
||||
-- Two `ALTER TABLE ADD COLUMN` blocks (all NOT NULL with a default, or
|
||||
-- nullable) keep this strictly additive — no backfill, no rewrite. Then
|
||||
-- seed the five MVP rated factors under a new `factors` category. The
|
||||
-- inserts use deterministic ids + ON CONFLICT upsert by `key` so a re-run
|
||||
-- is idempotent, mirroring 0101 / 0118 exactly. The seed only touches the
|
||||
-- new `factor_*` rows + `factors` category — the binary catalog is left
|
||||
-- alone.
|
||||
|
||||
-- ─── Discriminator + scale columns on the catalog tag ────────────────
|
||||
ALTER TABLE "mood_tags" ADD COLUMN "kind" TEXT NOT NULL DEFAULT 'BINARY';
|
||||
ALTER TABLE "mood_tags" ADD COLUMN "scale_min" INTEGER NOT NULL DEFAULT 1;
|
||||
ALTER TABLE "mood_tags" ADD COLUMN "scale_max" INTEGER NOT NULL DEFAULT 5;
|
||||
ALTER TABLE "mood_tags" ADD COLUMN "inverse" BOOLEAN NOT NULL DEFAULT false;
|
||||
|
||||
-- ─── Per-entry rating on the join ────────────────────────────────────
|
||||
ALTER TABLE "mood_entry_tag_links" ADD COLUMN "rating" INTEGER;
|
||||
|
||||
-- ─── New category: factors ───────────────────────────────────────────
|
||||
INSERT INTO "mood_tag_categories" ("id", "key", "label_key", "icon", "sort_order", "is_active")
|
||||
VALUES ('mtc_factors', 'factors', 'mood.tagCategory.factors', 'SlidersHorizontal', 6, true)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon", "sort_order" = EXCLUDED."sort_order";
|
||||
|
||||
-- ─── The five MVP rated factors ──────────────────────────────────────
|
||||
-- work (1..5)
|
||||
INSERT INTO "mood_tags"
|
||||
("id", "category_id", "key", "label_key", "icon", "sort_order", "is_active", "kind", "scale_min", "scale_max", "inverse")
|
||||
VALUES ('mt_factor_work', 'mtc_factors', 'factor_work', 'mood.tag.factorWork', 'Briefcase', 0, true, 'RATED', 1, 5, false)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"category_id" = EXCLUDED."category_id", "label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon",
|
||||
"sort_order" = EXCLUDED."sort_order", "kind" = EXCLUDED."kind", "scale_min" = EXCLUDED."scale_min",
|
||||
"scale_max" = EXCLUDED."scale_max", "inverse" = EXCLUDED."inverse";
|
||||
|
||||
-- social (1..5)
|
||||
INSERT INTO "mood_tags"
|
||||
("id", "category_id", "key", "label_key", "icon", "sort_order", "is_active", "kind", "scale_min", "scale_max", "inverse")
|
||||
VALUES ('mt_factor_social', 'mtc_factors', 'factor_social', 'mood.tag.factorSocial', 'Users', 1, true, 'RATED', 1, 5, false)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"category_id" = EXCLUDED."category_id", "label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon",
|
||||
"sort_order" = EXCLUDED."sort_order", "kind" = EXCLUDED."kind", "scale_min" = EXCLUDED."scale_min",
|
||||
"scale_max" = EXCLUDED."scale_max", "inverse" = EXCLUDED."inverse";
|
||||
|
||||
-- sleep quality (1..5)
|
||||
INSERT INTO "mood_tags"
|
||||
("id", "category_id", "key", "label_key", "icon", "sort_order", "is_active", "kind", "scale_min", "scale_max", "inverse")
|
||||
VALUES ('mt_factor_sleep_quality', 'mtc_factors', 'factor_sleep_quality', 'mood.tag.factorSleepQuality', 'Moon', 2, true, 'RATED', 1, 5, false)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"category_id" = EXCLUDED."category_id", "label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon",
|
||||
"sort_order" = EXCLUDED."sort_order", "kind" = EXCLUDED."kind", "scale_min" = EXCLUDED."scale_min",
|
||||
"scale_max" = EXCLUDED."scale_max", "inverse" = EXCLUDED."inverse";
|
||||
|
||||
-- stress (1..5, inverse — higher = worse)
|
||||
INSERT INTO "mood_tags"
|
||||
("id", "category_id", "key", "label_key", "icon", "sort_order", "is_active", "kind", "scale_min", "scale_max", "inverse")
|
||||
VALUES ('mt_factor_stress', 'mtc_factors', 'factor_stress', 'mood.tag.factorStress', 'Zap', 3, true, 'RATED', 1, 5, true)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"category_id" = EXCLUDED."category_id", "label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon",
|
||||
"sort_order" = EXCLUDED."sort_order", "kind" = EXCLUDED."kind", "scale_min" = EXCLUDED."scale_min",
|
||||
"scale_max" = EXCLUDED."scale_max", "inverse" = EXCLUDED."inverse";
|
||||
|
||||
-- conflict (1..2 Yes/No, inverse — 1 = no conflict, 2 = conflict)
|
||||
INSERT INTO "mood_tags"
|
||||
("id", "category_id", "key", "label_key", "icon", "sort_order", "is_active", "kind", "scale_min", "scale_max", "inverse")
|
||||
VALUES ('mt_factor_conflict', 'mtc_factors', 'factor_conflict', 'mood.tag.factorConflict', 'Swords', 4, true, 'RATED', 1, 2, true)
|
||||
ON CONFLICT ("key") DO UPDATE SET
|
||||
"category_id" = EXCLUDED."category_id", "label_key" = EXCLUDED."label_key", "icon" = EXCLUDED."icon",
|
||||
"sort_order" = EXCLUDED."sort_order", "kind" = EXCLUDED."kind", "scale_min" = EXCLUDED."scale_min",
|
||||
"scale_max" = EXCLUDED."scale_max", "inverse" = EXCLUDED."inverse";
|
||||
@@ -1993,6 +1993,22 @@ model MoodTag {
|
||||
sortOrder Int @default(0) @map("sort_order")
|
||||
isActive Boolean @default(true) @map("is_active")
|
||||
|
||||
/// v1.12.0 — capture-kind discriminator. `BINARY` (default) is a
|
||||
/// present/absent flag — every tag seeded by 0101 / 0118. `RATED` is a
|
||||
/// mood *factor* the user scores per entry (e.g. work, social, sleep
|
||||
/// quality); the score rides on `MoodEntryTagLink.rating`. Keeps one
|
||||
/// taxonomy + one ingestion path for both flavours.
|
||||
kind String @default("BINARY") @map("kind") // "BINARY" | "RATED"
|
||||
/// v1.12.0 — inclusive lower / upper bound of a RATED factor's scale
|
||||
/// (e.g. 1..5, or 1..2 for a Yes/No factor). Ignored for BINARY tags.
|
||||
/// The server validates each submitted rating against this range.
|
||||
scaleMin Int @default(1) @map("scale_min")
|
||||
scaleMax Int @default(5) @map("scale_max")
|
||||
/// v1.12.0 — inverse-scaled factor (e.g. stress / conflict) where a
|
||||
/// HIGHER rating means a WORSE day. Capture stays literal; the (later)
|
||||
/// analytics layer flips the sign so "up" always reads as "better".
|
||||
inverse Boolean @default(false) @map("inverse")
|
||||
|
||||
category MoodTagCategory @relation(fields: [categoryId], references: [id], onDelete: Cascade)
|
||||
links MoodEntryTagLink[]
|
||||
|
||||
@@ -2008,6 +2024,11 @@ model MoodEntryTagLink {
|
||||
moodEntryId String @map("mood_entry_id")
|
||||
moodTagId String @map("mood_tag_id")
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
/// v1.12.0 — per-entry score for a RATED `MoodTag`. NULL for BINARY
|
||||
/// links (the present/absent flag carries the signal). Bounded to the
|
||||
/// tag's `scaleMin..scaleMax` at ingest (server-validated, not a DB
|
||||
/// CHECK, so a future scale change never strands historical rows).
|
||||
rating Int? @map("rating")
|
||||
|
||||
moodEntry MoodEntry @relation(fields: [moodEntryId], references: [id], onDelete: Cascade)
|
||||
moodTag MoodTag @relation(fields: [moodTagId], references: [id], onDelete: Cascade)
|
||||
|
||||
Reference in new issue
Block a user