Content Glossary (canonical)¶
The single source of vocabulary for naluma-app-content. These terms match
naluma-app and the content.* schema in naluma-directus. Use them everywhere
— filenames, columns, docs, commits.
Content classes¶
- Session —
content.sessions. One self-contained content unit, typed bytemplate_type:audioGuided,breathing,chipExercise,valuesSort,experiment,insight,reframe,sentenceCompletion. (breathingreplaced the legacybreathing478.) An insight is a session (template_type=insight, a psychoeducation card stack) — there is no separate "deck" entity. - Coach conversation —
content.coach_conversations. A slotted daily chat experience. Slot ∈morning | afternoon | night(3 per day) plus a one-timewelcome. A linear drip of typed chat items; the only branching is intra-conversation (a reply-chip tag selects atag_matchbranch). Deep-links out to sessions (session_card) and sounds (sound_card). MVP scope: conversations are the daily three slots +welcomeonly, scheduled incoach-conversations/coach-schedule.csv(the source of truth for the full 12-week programme). On-demand (crisis/checking-compulsion), recurring weekly check-ins, and maintenance standalone conversations are retired from MVP: spike support lives intag_matchbranches + crisis sessions + the app's global header tool; the structured weekly check-in is an app CTA/sheet, not a conversation;coach_modulesare parked (vestigial at runtime). Dynamic coach reactivity is deferred (naluma-app #680). - Coach module —
content.coach_modules. A reusable opening/closing chat block (pool/conditional,rotate/random) referenced by a conversation'sopening_module_id/closing_module_id. - Sound / Sound album —
content.sounds/content.sound_albums. Ambient audio. Tracks are referenced byid(UUID), albums byslug. - Building block (repo-internal source term, not a Directus entity) — a row
of raw coaching material (insight / reflection / exercise / crisis / sound-
therapy) that maps downstream to a session, a coach module, or inline
conversation content. Previously in
coach-conversations/building-blocks.csv(now superseded bycoach-schedule.csv— seecoach-conversations/SUPERSEDED.md).
Legacy → canonical¶
| Legacy (Notion / old repo) | Canonical |
|---|---|
| "Session" composed row / "Conversation DB" | Coach conversation |
| "Component" / "Session DB" row | Building block → session / coach module |
"insight card" / "insight card deck" / decks/ |
insight session |
breathing478 |
breathing |
conversation-db.csv |
coach-conversations.csv (now superseded by coach-schedule.csv) |
session-db.csv |
building-blocks.csv (now superseded by coach-schedule.csv) |