Files
famapp/docs/tasks/86-journal-module.md
T
ginnoir 76f68548b2 docs: complete Phase 9 backlog triage (issues map, briefs, ADRs)
Map design IDs to Gitea #1-#37, add tasks 80-88, stub ADRs 0004-0006,
and point STATUS at the P1 batch order.
2026-07-04 01:23:30 -05:00

1.7 KiB
Raw Blame History

86 — Journal module

Goal

Ship a per-user journal module with entries, mood tracking, insights, and journal API endpoints on the existing API foundation.

Why

P1 personal journaling with mood/stress/pills tracking and stats, without blocking on P2 work.

Depends on

  • 85 (shared rich-text editor)
  • 87 (API surface for existing modules — journal adds endpoints the same way)
  • ADR 0005-journal-research.md (Gitea #20)

Scope

  • Research ADR 0005 (mood/journal libs; build-vs-adopt).
  • Schema + CRUD (per-user entries).
  • Index: last 510 entries compact, browse all, small calendar of days with entries.
  • Entry detail and create: date (default today) and time (default now) required; everything else optional.
  • Fields: rich note text (shared editor); numerical stress; mood with color/emoji options and multi-select; took-my-pills-today boolean.
  • Module-level mood-tracker view over time.
  • Per-user insights/stats (trends, streaks, correlations — propose specifics in ADR/implementation).
  • Journal API endpoints (additive on 87).
  • Playwright: new tests/e2e/journal.spec.ts — minimal entry → recent list → detail → mood tracker loads.

Out of scope

  • Household-shared journals (per-user only).
  • LLM agent tools for journal (88 can add later).

Acceptance criteria

  • ADR 0005 accepted.
  • Create entry with only date/time.
  • Index, detail, mood tracker, and insights views work.
  • Journal API endpoints documented and callable with token auth.
  • E2E happy path green.

Notes

  • Gitea epic: #19; children #20#27
  • Depends on #7 (rich-text) and #15 (API surface)