Skip to content

Unified Communications Platform: V1 Reference

Purpose

UCP is an internal insurance-broker communications platform. It governs and executes outbound Email, SMS, and WhatsApp communications, while preserving approval, suppression, audit, and rendered-message evidence.

This is a shared product and engineering reference for UCP. It describes the V1 behaviour, contracts, dashboard usage and operational context that are useful when understanding or rebuilding the platform. It works best alongside the running application, the backend OpenAPI endpoint at /api/docs, and the source links in the appendices.

Reading order for a new dashboard user

  1. Dashboard operator guide
  2. Authentication, roles and shell
  3. Campaign lifecycle and audience
  4. Templates and email presentation
  5. Messages, history and customer lookup
  6. Reports and notifications

Reading order for a frontend developer

  1. Product scope
  2. Authentication, roles and shell
  3. Frontend rebuild playbook
  4. Route and page reference
  5. API contract reference
  6. Campaign lifecycle and audience
  7. Scheduling, polling and execution
  8. V2 handover contract

Reference principles

  • V1 code and deployed behaviour provide the evidence behind this site.
  • A page design and a business rule are different things; the narrative pages identify the behaviour behind the current screens.
  • UCP execution state and later provider evidence are related but not interchangeable.
  • Message history is designed to retain rendered content, relevant configuration, recipients and audit/execution context.
  • The reference leaves future interface and delivery choices open while making the existing dependencies visible in enough detail to operate V1 and rebuild its core behaviours.