Skip to content

Conversation Data Model

Description

Defines and manages the canonical Conversation entity — the top-level container for all customer interactions. A Conversation links Sessions, Activities, participants, and metadata into a single persistent record accessible across all platform components.

Canonical use case

A customer who calls, then follows up via chat, then emails is represented as a single Conversation spanning all three sessions, giving agents and supervisors a unified view of the customer's history.

Open Items

  • [ ] Canon alignment — populate canon_axiom_refs or confirm no existing axiom applies
  • [ ] Dependency assessment — set dependencies_assessed: true once SA has reviewed the full chain
  • [ ] effort_estimate — replace 0 with rough engineering days (order of magnitude)
  • [ ] public_description — write the public-facing description before publishing