NowPage Live Collaboration

Section-level temporal drawers for any HC page. Real-time multi-user annotation, approval, and change tracking — on the published artifact itself.

1. What Is This?

Every HC page published via NowPage can optionally enable Pulse — a per-section collaboration layer. Collapsed by default, expandable to reveal: collaboration notes, change history, approval state, and input for new reactions. Multi-user, real-time, structured data.

Core principle: The page IS the collaboration surface. Not a separate doc. Not a comment thread. The published artifact carries its own provenance, reactions, and approval state.

Who it's for

• Consultants building deliverables live on client calls
• Teams reviewing specs/proposals asynchronously
• Publishers who want granular engagement data per section
• Anyone using NowPage Reveal pages as sales/alignment tools

The 21st Century Use Case

Jason is on an alignment call building a brief live on NowPage. The client isn't just watching — they click a section and type "this isn't quite right — we want X." Jason sees it in real time, adjusts. The client marks the section "approved." At the end, the brief IS the deliverable — annotated, approved, with full provenance. The client shares it. Their partner adds notes. The document keeps evolving.

This is not comments on a page. This is a new category of document — a living surface where content, collaboration, and data converge.

2. Architecture

Published HC Page (any NowPage domain)
  │
  ├── Section 1: [content]  △ 3 notes
  │   └── [drawer: collapsed by default]
  │       ├── Summary line (auto or manual)
  │       ├── Recent notes (last 3-5)
  │       ├── Input field + mic button
  │       └── [expand: full history with timestamps]
  │
  ├── Section 2: [content]  ✓ approved
  │   └── [drawer]
  │
  └── Section N: [content]  ? 1 question
      └── [drawer]

        ↓ all data flows to ↓

Supabase (page_collaboration table)
  │
  ├── Real-time subscriptions (live updates)
  ├── REST API (query, push, reconcile)
  └── Webhooks (on note/approval → external systems)
        ├── → Forge (reconciliation)
        ├── → CRM (lead engagement)
        └── → Analytics (section-level metrics)

3. Specification

3.1 Section-Level Temporal Drawer

• Collapsed (default): Small badge next to section heading. Note count + dominant reaction (△ notes, ✓ approved, ? questions, ✗ needs work). Zero visual noise if no activity.
• First expand: Summary + last 3-5 notes + input field + mic. No timestamps. Clean.
• Second expand: Full metadata — author, timestamp, changes. The audit trail.
• Three levels: casual reader → collaborator → auditor.

Display Modes (per page metadata)

3.2 Collaboration Actions

3.3 Identity

v1: Name entry on first visit. localStorage. No login. Good for 2-10 people.

v2: Optional NowPage account. Persistent identity. Avatar. Notifications.

3.4 Summarize + Push Lifecycle

Notes → Summarize (aggregate per section) → Push (send to Forge, CRM, webhook) → Implemented (ref back to what changed).

Status lifecycle: draft → pushed → implemented

3.5 Intelligence Board

Meta-page per domain: all notes across all pages, grouped by section. Stats, canonical log, filter by page/author/status/date. Auto-refreshes.

4. Data Model

-- Core collaboration table
CREATE TABLE page_collaboration (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  domain TEXT NOT NULL,
  page_slug TEXT NOT NULL,
  section TEXT NOT NULL,
  author TEXT NOT NULL,
  type TEXT DEFAULT 'note',  -- note|approve|question|needs_work|voice
  content TEXT DEFAULT '',
  parent_id UUID REFERENCES page_collaboration(id),  -- threaded replies v2
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Summary + push tracking
CREATE TABLE page_collaboration_summaries (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  domain TEXT NOT NULL,
  page_slug TEXT NOT NULL,
  section TEXT NOT NULL,
  summary TEXT NOT NULL,
  note_ids UUID[],
  status TEXT DEFAULT 'draft',  -- draft|pushed|implemented|rejected
  pushed_to TEXT,
  pushed_at TIMESTAMPTZ,
  implemented_at TIMESTAMPTZ,
  implemented_ref TEXT,
  created_by TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

5. Execution Phases

6. Cost

7. Definition of Done

• ☐ page_collaboration table in Supabase with RLS + realtime
• ☐ Embeddable JS widget works on any HTML page with zero config beyond a script tag
• ☐ Multi-user real-time: person A types, person B sees within 2 seconds
• ☐ 4 action types: note, approve, question, needs_work
• ☐ Voice-to-text via Web Speech API
• ☐ Progressive disclosure: badge → recent notes → full history
• ☐ Display modes: internal, external, locked
• ☐ NowPage pages with collab: true auto-include widget
• ☐ Intelligence Board with stats and canonical log
• ☐ Summarize + Push lifecycle: draft → pushed → implemented
• ☐ Section-level analytics API

8. Cascade