Skip to content

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

  • Sessioncontent.sessions. One self-contained content unit, typed by template_type: audioGuided, breathing, chipExercise, valuesSort, experiment, insight, reframe, sentenceCompletion. (breathing replaced the legacy breathing478.) An insight is a session (template_type=insight, a psychoeducation card stack) — there is no separate "deck" entity.
  • Coach conversationcontent.coach_conversations. A slotted daily chat experience. Slot ∈ morning | afternoon | night (3 per day) plus a one-time welcome. A linear drip of typed chat items; the only branching is intra-conversation (a reply-chip tag selects a tag_match branch). Deep-links out to sessions (session_card) and sounds (sound_card). MVP scope: conversations are the daily three slots + welcome only, scheduled in coach-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 in tag_match branches + crisis sessions + the app's global header tool; the structured weekly check-in is an app CTA/sheet, not a conversation; coach_modules are parked (vestigial at runtime). Dynamic coach reactivity is deferred (naluma-app #680).
  • Coach modulecontent.coach_modules. A reusable opening/closing chat block (pool/conditional, rotate/random) referenced by a conversation's opening_module_id/closing_module_id.
  • Sound / Sound albumcontent.sounds / content.sound_albums. Ambient audio. Tracks are referenced by id (UUID), albums by slug.
  • 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 by coach-schedule.csv — see coach-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)