From 1c0610baec9a6ae364f41eae6d1da950378a265b Mon Sep 17 00:00:00 2001
From: Sreeram <sreeram@noorahealth.org>
Date: Fri, 3 Oct 2025 03:15:46 +0530
Subject: [PATCH] Used GPT to generate a schema overview and visualization that
 can help us understand the models better

---
 DATABASE SCHEMA OVERVIEW.md                   | 1234 +++++++++++++
 ...0.39.10\342\200\257AM.png" => Overivew.png |  Bin
 database_visualization.html                   | 1609 +++++++++++++++++
 3 files changed, 2843 insertions(+)
 create mode 100644 DATABASE SCHEMA OVERVIEW.md
 rename "Screenshot 2025-03-28 at 10.39.10\342\200\257AM.png" => Overivew.png (100%)
 create mode 100644 database_visualization.html

diff --git a/DATABASE SCHEMA OVERVIEW.md b/DATABASE SCHEMA OVERVIEW.md
new file mode 100644
index 00000000000..e835b500ec4
--- /dev/null
+++ b/DATABASE SCHEMA OVERVIEW.md	
@@ -0,0 +1,1234 @@
+# RapidPro Database Schema Documentation
+
+This document provides a comprehensive overview of RapidPro's PostgreSQL database schema, focusing on business-critical tables that are useful for analytics, campaign tracking, and contact interaction analysis.
+
+> 💡 **Interactive Visualization**: For an interactive, visual exploration of this schema with clickable tables and relationships, open the `database_visualization.html` file in your browser.
+
+## Table of Contents
+
+1. [Core Tables](#core-tables)
+   - [Organizations](#organizations-orgs_org)
+   - [Contacts](#contacts-contacts_contact)
+   - [Contact Groups](#contact-groups-contacts_contactgroup)
+   - [Contact URNs](#contact-urns-contacts_contacturn)
+   - [Contact Fields](#contact-fields-contacts_contactfield)
+2. [Messaging Tables](#messaging-tables)
+   - [Messages](#messages-msgs_msg)
+   - [Broadcasts](#broadcasts-msgs_broadcast)
+   - [Labels](#labels-msgs_label)
+   - [Opt-Ins](#opt-ins-msgs_optin)
+   - [Media](#media-msgs_media)
+3. [Flow Tables](#flow-tables)
+   - [Flows](#flows-flows_flow)
+   - [Flow Runs](#flow-runs-flows_flowrun)
+   - [Flow Sessions](#flow-sessions-flows_flowsession)
+   - [Flow Starts](#flow-starts-flows_flowstart)
+   - [Flow Labels](#flow-labels-flows_flowlabel)
+4. [Campaign Tables](#campaign-tables)
+   - [Campaigns](#campaigns-campaigns_campaign)
+   - [Campaign Events](#campaign-events-campaigns_campaignevent)
+5. [Channel Tables](#channel-tables)
+   - [Channels](#channels-channels_channel)
+   - [Channel Events](#channel-events-channels_channelevent)
+6. [Ticketing Tables](#ticketing-tables)
+   - [Tickets](#tickets-tickets_ticket)
+   - [Ticket Events](#ticket-events-tickets_ticketevent)
+   - [Topics](#topics-tickets_topic)
+   - [Teams](#teams-tickets_team)
+7. [Automation Tables](#automation-tables)
+   - [Triggers](#triggers-triggers_trigger)
+   - [Schedules](#schedules-schedules_schedule)
+   - [Globals](#globals-globals_global)
+8. [Template Tables](#template-tables)
+   - [Templates](#templates-templates_template)
+   - [Template Translations](#template-translations-templates_templatetranslation)
+9. [AI & Classifier Tables](#ai--classifier-tables)
+   - [Classifiers](#classifiers-classifiers_classifier)
+   - [Intents](#intents-classifiers_intent)
+
+---
+
+## Core Tables
+
+### Organizations (`orgs_org`)
+
+The root organizational entity that contains all other data. Each organization represents a separate workspace.
+
+| Column           | Type         | Description                                                                  |
+| ---------------- | ------------ | ---------------------------------------------------------------------------- |
+| `id`             | integer      | Primary key                                                                  |
+| `uuid`           | uuid         | Unique identifier for the organization                                       |
+| `name`           | varchar(128) | Organization name                                                            |
+| `parent_id`      | integer      | Foreign key to parent org (for child workspaces)                             |
+| `timezone`       | varchar      | Organization timezone (e.g., 'America/New_York')                             |
+| `date_format`    | char(1)      | Date format preference: 'D' (day-first), 'M' (month-first), 'Y' (year-first) |
+| `language`       | varchar(64)  | Default language code                                                        |
+| `flow_languages` | text[]       | Array of language codes used in flows                                        |
+| `country_id`     | integer      | Foreign key to default country (locations_adminboundary)                     |
+| `is_anon`        | boolean      | Whether contact identifiers are anonymized                                   |
+| `is_flagged`     | boolean      | Whether org is flagged for suspicious activity                               |
+| `is_suspended`   | boolean      | Whether org is currently suspended                                           |
+| `suspended_on`   | timestamp    | When org was suspended                                                       |
+| `released_on`    | timestamp    | When org was released (deleted)                                              |
+| `config`         | jsonb        | Configuration settings                                                       |
+| `features`       | text[]       | Array of enabled features                                                    |
+| `limits`         | jsonb        | Resource limits                                                              |
+| `created_on`     | timestamp    | When org was created                                                         |
+| `modified_on`    | timestamp    | Last modification time                                                       |
+
+**Key Relationships:**
+
+- Parent to `contacts_contact`, `flows_flow`, `msgs_msg`, `campaigns_campaign`, `channels_channel`, `tickets_ticket`
+
+---
+
+### Contacts (`contacts_contact`)
+
+Represents individuals/entities that can be messaged and tracked.
+
+| Column                 | Type         | Description                                                |
+| ---------------------- | ------------ | ---------------------------------------------------------- |
+| `id`                   | integer      | Primary key                                                |
+| `uuid`                 | uuid         | Unique identifier                                          |
+| `org_id`               | integer      | Foreign key to orgs_org                                    |
+| `name`                 | varchar(128) | Contact's name                                             |
+| `language`             | varchar(3)   | Contact's preferred language (ISO-639-3)                   |
+| `status`               | char(1)      | 'A' (Active), 'B' (Blocked), 'S' (Stopped), 'V' (Archived) |
+| `fields`               | jsonb        | Custom field values, keyed by field UUID                   |
+| `current_flow_id`      | integer      | Foreign key to flow contact is currently in                |
+| `current_session_uuid` | uuid         | UUID of active session if waiting                          |
+| `ticket_count`         | integer      | Number of open tickets                                     |
+| `last_seen_on`         | timestamp    | Last time contact interacted                               |
+| `created_on`           | timestamp    | When contact was created                                   |
+| `modified_on`          | timestamp    | Last modification time                                     |
+| `created_by_id`        | integer      | User who created the contact                               |
+| `modified_by_id`       | integer      | User who last modified                                     |
+
+**Key Relationships:**
+
+- Many-to-Many with `contacts_contactgroup` (via contacts_contactgroup_contacts)
+- One-to-Many with `contacts_contacturn` (contact URNs)
+- One-to-Many with `msgs_msg` (messages)
+- One-to-Many with `flows_flowrun` (flow runs)
+- One-to-Many with `tickets_ticket` (tickets)
+
+**Status Values:**
+
+- **A (Active)**: Contact is active and can participate in flows and campaigns
+- **B (Blocked)**: Contact is blocked; messages will be ignored
+- **S (Stopped)**: Contact opted out; messages ignored until they message again
+- **V (Archived)**: Contact is archived (soft deleted)
+
+---
+
+### Contact Groups (`contacts_contactgroup`)
+
+Groups of contacts, either manually managed or query-based (smart groups).
+
+| Column        | Type         | Description                                                       |
+| ------------- | ------------ | ----------------------------------------------------------------- |
+| `id`          | integer      | Primary key                                                       |
+| `uuid`        | uuid         | Unique identifier                                                 |
+| `org_id`      | integer      | Foreign key to orgs_org                                           |
+| `name`        | varchar(128) | Group name                                                        |
+| `group_type`  | char(1)      | 'M' (Manual), 'Q' (Smart/Query), 'A/B/S/V' (System status groups) |
+| `status`      | char(1)      | 'I' (Initializing), 'V' (Evaluating), 'R' (Ready)                 |
+| `query`       | text         | Query string for smart groups                                     |
+| `is_system`   | boolean      | Whether this is a system group                                    |
+| `is_active`   | boolean      | Whether group is active                                           |
+| `created_on`  | timestamp    | When group was created                                            |
+| `modified_on` | timestamp    | Last modification time                                            |
+
+**Group Types:**
+
+- **M (Manual)**: Membership is manually managed
+- **Q (Smart)**: Membership based on query evaluation
+- **A (DB Active)**: System group for status=Active contacts
+- **B (DB Blocked)**: System group for status=Blocked contacts
+- **S (DB Stopped)**: System group for status=Stopped contacts
+- **V (DB Archived)**: System group for status=Archived contacts
+
+**Key Relationships:**
+
+- Many-to-Many with `contacts_contact` (via contacts_contactgroup_contacts)
+- Many-to-Many with `contacts_contactfield` (query_fields - fields used in smart group query)
+- One-to-Many with `campaigns_campaign` (campaigns targeting this group)
+
+---
+
+### Contact URNs (`contacts_contacturn`)
+
+Universal Resource Names - unique identifiers for contacts (phone numbers, social media handles, etc.)
+
+| Column        | Type         | Description                                        |
+| ------------- | ------------ | -------------------------------------------------- |
+| `id`          | integer      | Primary key                                        |
+| `org_id`      | integer      | Foreign key to orgs_org                            |
+| `contact_id`  | integer      | Foreign key to contacts_contact                    |
+| `channel_id`  | integer      | Foreign key to channels_channel (channel affinity) |
+| `identity`    | varchar(255) | Full URN (scheme:path)                             |
+| `scheme`      | varchar(128) | URN scheme (tel, mailto, whatsapp, telegram, etc.) |
+| `path`        | varchar(255) | URN path (the actual identifier)                   |
+| `display`     | varchar(255) | Display name (optional)                            |
+| `priority`    | integer      | Priority (1000=highest, used for ordering)         |
+| `auth_tokens` | jsonb        | Authentication tokens (channel-specific)           |
+
+**Common Schemes:**
+
+- **tel**: Phone numbers (E.164 format recommended)
+- **mailto**: Email addresses
+- **whatsapp**: WhatsApp identifiers
+- **telegram**: Telegram user IDs
+- **facebook**: Facebook Messenger IDs
+- **instagram**: Instagram IDs
+- **twitter**: Twitter handles
+- **twitterid**: Twitter user IDs
+
+**Key Relationships:**
+
+- Many-to-One with `contacts_contact`
+- Many-to-One with `channels_channel`
+- One-to-Many with `msgs_msg` (messages sent/received via this URN)
+
+---
+
+### Contact Fields (`contacts_contactfield`)
+
+Custom fields defined for contacts to store additional attributes.
+
+| Column          | Type        | Description                                                  |
+| --------------- | ----------- | ------------------------------------------------------------ |
+| `id`            | integer     | Primary key                                                  |
+| `uuid`          | uuid        | Unique identifier                                            |
+| `org_id`        | integer     | Foreign key to orgs_org                                      |
+| `key`           | varchar(36) | Field key (lowercase, alphanumeric + underscore)             |
+| `name`          | varchar(36) | Display name                                                 |
+| `value_type`    | char(1)     | 'T' (Text), 'N' (Number), 'D' (Datetime), 'S/I/W' (Location) |
+| `is_system`     | boolean     | Whether this is a system field (created_on, last_seen_on)    |
+| `is_proxy`      | boolean     | Whether field is a proxy for a contact property              |
+| `show_in_table` | boolean     | Whether to show in contact tables                            |
+| `priority`      | integer     | Display priority                                             |
+| `agent_access`  | char(1)     | 'N' (None/Hidden), 'V' (View), 'E' (Edit)                    |
+| `is_active`     | boolean     | Whether field is active                                      |
+| `created_on`    | timestamp   | When field was created                                       |
+| `modified_on`   | timestamp   | Last modification time                                       |
+
+**Value Types:**
+
+- **T (Text)**: Free text values
+- **N (Number)**: Numeric values
+- **D (Datetime)**: Date and time values
+- **S (State)**: Location state
+- **I (District)**: Location district
+- **W (Ward)**: Location ward
+
+**System Fields:**
+
+- **created_on**: When contact was created
+- **last_seen_on**: Last interaction time
+
+---
+
+## Messaging Tables
+
+### Messages (`msgs_msg`)
+
+All messages sent to or received from contacts.
+
+| Column           | Type         | Description                                                                   |
+| ---------------- | ------------ | ----------------------------------------------------------------------------- |
+| `id`             | bigint       | Primary key                                                                   |
+| `uuid`           | uuid         | Unique identifier                                                             |
+| `org_id`         | integer      | Foreign key to orgs_org                                                       |
+| `channel_id`     | integer      | Foreign key to channels_channel                                               |
+| `contact_id`     | integer      | Foreign key to contacts_contact                                               |
+| `contact_urn_id` | integer      | Foreign key to contacts_contacturn                                            |
+| `broadcast_id`   | integer      | Foreign key to msgs_broadcast (if from broadcast)                             |
+| `flow_id`        | integer      | Foreign key to flows_flow (if from flow)                                      |
+| `ticket_id`      | integer      | Foreign key to tickets_ticket (if ticket reply)                               |
+| `text`           | text         | Message text content                                                          |
+| `attachments`    | text[]       | Array of attachment URLs                                                      |
+| `quick_replies`  | text[]       | Array of quick reply options                                                  |
+| `locale`         | varchar(6)   | Language locale (e.g., 'eng', 'spa-MX')                                       |
+| `direction`      | char(1)      | 'I' (Incoming), 'O' (Outgoing)                                                |
+| `status`         | char(1)      | Message status (see below)                                                    |
+| `msg_type`       | char(1)      | 'T' (Text), 'O' (Opt-In), 'V' (Voice/IVR)                                     |
+| `visibility`     | char(1)      | 'V' (Visible), 'A' (Archived), 'D' (Deleted by user), 'X' (Deleted by sender) |
+| `high_priority`  | boolean      | Whether message should be sent with high priority                             |
+| `created_on`     | timestamp    | When message was created (event time for flow messages)                       |
+| `modified_on`    | timestamp    | Last modification time                                                        |
+| `sent_on`        | timestamp    | When message was sent                                                         |
+| `msg_count`      | integer      | Number of actual channel messages sent                                        |
+| `error_count`    | integer      | Number of send attempts that errored                                          |
+| `next_attempt`   | timestamp    | When next retry will occur                                                    |
+| `failed_reason`  | char(1)      | Reason for failure (if failed)                                                |
+| `external_id`    | varchar(255) | External ID from channel provider                                             |
+
+**Status Values (Outgoing):**
+
+- **I (Initializing)**: Created but not yet queued
+- **Q (Queued)**: Queued to courier for sending
+- **W (Wired)**: Sent request to channel
+- **S (Sent)**: Channel confirmed sent
+- **D (Delivered)**: Channel confirmed delivered
+- **R (Read)**: Channel confirmed read
+- **E (Errored)**: Temporary error, will retry
+- **F (Failed)**: Permanent failure
+
+**Status Values (Incoming):**
+
+- **P (Pending)**: Received but not yet handled
+- **H (Handled)**: Processed by flow engine
+
+**Key Relationships:**
+
+- Many-to-One with `contacts_contact`
+- Many-to-One with `channels_channel`
+- Many-to-One with `msgs_broadcast`
+- Many-to-One with `flows_flow`
+- Many-to-Many with `msgs_label` (via msgs_msg_labels)
+
+---
+
+### Broadcasts (`msgs_broadcast`)
+
+Messages sent to multiple recipients at once.
+
+| Column          | Type       | Description                                                                                  |
+| --------------- | ---------- | -------------------------------------------------------------------------------------------- |
+| `id`            | integer    | Primary key                                                                                  |
+| `org_id`        | integer    | Foreign key to orgs_org                                                                      |
+| `status`        | char(1)    | 'P' (Pending), 'Q' (Queued), 'S' (Started), 'C' (Completed), 'F' (Failed), 'I' (Interrupted) |
+| `contact_count` | integer    | Total number of recipients (null until queued)                                               |
+| `translations`  | jsonb      | Message content by language                                                                  |
+| `base_language` | varchar(3) | Base language (ISO-639-3)                                                                    |
+| `optin_id`      | integer    | Foreign key to msgs_optin (if opt-in broadcast)                                              |
+| `template_id`   | integer    | Foreign key to templates_template (if template message)                                      |
+| `urns`          | text[]     | Array of URN strings to send to                                                              |
+| `query`         | text       | Query string for dynamic recipients                                                          |
+| `exclusions`    | jsonb      | Exclusion criteria                                                                           |
+| `schedule_id`   | integer    | Foreign key to schedules_schedule (if scheduled)                                             |
+| `parent_id`     | integer    | Foreign key to parent broadcast (for scheduled broadcasts)                                   |
+| `is_active`     | boolean    | Whether broadcast is active                                                                  |
+| `created_on`    | timestamp  | When broadcast was created                                                                   |
+| `created_by_id` | integer    | User who created                                                                             |
+
+**Key Relationships:**
+
+- Many-to-Many with `contacts_contact` (via msgs_broadcast_contacts)
+- Many-to-Many with `contacts_contactgroup` (via msgs_broadcast_groups)
+- One-to-Many with `msgs_msg` (messages created from broadcast)
+
+---
+
+### Labels (`msgs_label`)
+
+Tags that can be applied to messages for organization.
+
+| Column        | Type        | Description             |
+| ------------- | ----------- | ----------------------- |
+| `id`          | integer     | Primary key             |
+| `uuid`        | uuid        | Unique identifier       |
+| `org_id`      | integer     | Foreign key to orgs_org |
+| `name`        | varchar(64) | Label name              |
+| `is_active`   | boolean     | Whether label is active |
+| `created_on`  | timestamp   | When label was created  |
+| `modified_on` | timestamp   | Last modification time  |
+
+**Key Relationships:**
+
+- Many-to-Many with `msgs_msg` (via msgs_msg_labels)
+
+---
+
+### Opt-Ins (`msgs_optin`)
+
+Contact opt-in status for specific messaging topics (required for some channels).
+
+| Column        | Type        | Description              |
+| ------------- | ----------- | ------------------------ |
+| `id`          | integer     | Primary key              |
+| `uuid`        | uuid        | Unique identifier        |
+| `org_id`      | integer     | Foreign key to orgs_org  |
+| `name`        | varchar(64) | Opt-in name              |
+| `is_active`   | boolean     | Whether opt-in is active |
+| `created_on`  | timestamp   | When created             |
+| `modified_on` | timestamp   | Last modification time   |
+
+---
+
+### Media (`msgs_media`)
+
+Uploaded media files that can be used as attachments on messages.
+
+| Column          | Type          | Description                                             |
+| --------------- | ------------- | ------------------------------------------------------- |
+| `uuid`          | uuid          | Primary key / unique identifier                         |
+| `org_id`        | integer       | Foreign key to orgs_org                                 |
+| `url`           | varchar(2048) | Public URL to access the media                          |
+| `content_type`  | varchar(255)  | MIME type (image/jpeg, audio/mp3, video/mp4, etc.)      |
+| `path`          | varchar(2048) | Storage path                                            |
+| `size`          | integer       | File size in bytes                                      |
+| `duration`      | integer       | Duration in milliseconds (for audio/video)              |
+| `width`         | integer       | Width in pixels (for images/video)                      |
+| `height`        | integer       | Height in pixels (for images/video)                     |
+| `status`        | char(1)       | 'P' (Pending), 'R' (Ready), 'F' (Failed)                |
+| `original_id`   | uuid          | Foreign key to original media (if this is an alternate) |
+| `created_by_id` | integer       | Foreign key to auth_user                                |
+| `created_on`    | timestamp     | When media was uploaded                                 |
+
+**Key Relationships:**
+
+- Many-to-One with `orgs_org`
+- Referenced by `msgs_msg` via attachments array
+
+---
+
+## Flow Tables
+
+### Flows (`flows_flow`)
+
+Automated conversation flows (decision trees) that contacts can go through.
+
+| Column                  | Type         | Description                                                    |
+| ----------------------- | ------------ | -------------------------------------------------------------- |
+| `id`                    | integer      | Primary key                                                    |
+| `uuid`                  | uuid         | Unique identifier                                              |
+| `org_id`                | integer      | Foreign key to orgs_org                                        |
+| `name`                  | varchar(128) | Flow name                                                      |
+| `flow_type`             | char(1)      | 'M' (Message), 'V' (Voice/IVR), 'B' (Background), 'S' (Survey) |
+| `is_active`             | boolean      | Whether flow is active                                         |
+| `is_archived`           | boolean      | Whether flow is archived                                       |
+| `is_system`             | boolean      | Whether this is a system flow                                  |
+| `base_language`         | varchar(3)   | Authoring language (ISO-639-3)                                 |
+| `version_number`        | varchar(8)   | Flow spec version                                              |
+| `expires_after_minutes` | integer      | Inactivity timeout in minutes                                  |
+| `ignore_triggers`       | boolean      | Whether to ignore keyword triggers while in flow               |
+| `has_issues`            | boolean      | Whether flow has validation issues                             |
+| `info`                  | jsonb        | Flow metadata (results, dependencies, etc.)                    |
+| `created_on`            | timestamp    | When flow was created                                          |
+| `modified_on`           | timestamp    | Last modification time                                         |
+| `saved_on`              | timestamp    | Last time definition was saved                                 |
+| `saved_by_id`           | integer      | User who last saved                                            |
+
+**Flow Types:**
+
+- **M (Message)**: Standard messaging flow
+- **V (Voice)**: IVR/voice call flow
+- **B (Background)**: Flow that runs without user interaction
+- **S (Survey)**: Surveyor app flow (offline data collection)
+
+**Key Relationships:**
+
+- One-to-Many with `flows_flowrun` (runs of this flow)
+- One-to-Many with `flows_flowstart` (times this flow was started)
+- One-to-Many with `campaigns_campaignevent` (campaign events using this flow)
+- One-to-Many with `triggers_trigger` (triggers that start this flow)
+
+---
+
+### Flow Runs (`flows_flowrun`)
+
+Individual instances of contacts going through flows.
+
+| Column              | Type        | Description                                                                                  |
+| ------------------- | ----------- | -------------------------------------------------------------------------------------------- |
+| `id`                | bigint      | Primary key                                                                                  |
+| `uuid`              | uuid        | Unique identifier                                                                            |
+| `org_id`            | integer     | Foreign key to orgs_org                                                                      |
+| `flow_id`           | integer     | Foreign key to flows_flow                                                                    |
+| `contact_id`        | integer     | Foreign key to contacts_contact                                                              |
+| `session_uuid`      | uuid        | UUID of session this run belongs to                                                          |
+| `start_id`          | integer     | Foreign key to flows_flowstart                                                               |
+| `status`            | char(1)     | 'A' (Active), 'W' (Waiting), 'C' (Completed), 'I' (Interrupted), 'X' (Expired), 'F' (Failed) |
+| `responded`         | boolean     | Whether contact has sent a message during run                                                |
+| `results`           | jsonb       | Results collected, keyed by result name                                                      |
+| `path`              | jsonb       | Path taken through flow (legacy)                                                             |
+| `path_nodes`        | uuid[]      | Array of node UUIDs visited                                                                  |
+| `path_times`        | timestamp[] | Array of timestamps for each node                                                            |
+| `current_node_uuid` | uuid        | Current position in flow (if active/waiting)                                                 |
+| `created_on`        | timestamp   | When run started                                                                             |
+| `modified_on`       | timestamp   | Last modification time                                                                       |
+| `exited_on`         | timestamp   | When run exited                                                                              |
+
+**Status Values:**
+
+- **A (Active)**: Run is actively progressing
+- **W (Waiting)**: Run is waiting for user input
+- **C (Completed)**: Run completed successfully
+- **I (Interrupted)**: Run was interrupted
+- **X (Expired)**: Run expired due to inactivity
+- **F (Failed)**: Run failed due to error
+
+**Key Relationships:**
+
+- Many-to-One with `flows_flow`
+- Many-to-One with `contacts_contact`
+- Many-to-One with `flows_flowstart`
+
+---
+
+### Flow Sessions (`flows_flowsession`)
+
+Sessions that may contain multiple flow runs (e.g., parent-child flows).
+
+| Column            | Type          | Description                                                                    |
+| ----------------- | ------------- | ------------------------------------------------------------------------------ |
+| `id`              | bigint        | Primary key                                                                    |
+| `uuid`            | uuid          | Unique identifier                                                              |
+| `contact_id`      | integer       | Foreign key to contacts_contact                                                |
+| `status`          | char(1)       | 'W' (Waiting), 'C' (Completed), 'I' (Interrupted), 'X' (Expired), 'F' (Failed) |
+| `session_type`    | char(1)       | 'M' (Message), 'V' (Voice)                                                     |
+| `output`          | jsonb         | Engine output (if stored in DB)                                                |
+| `output_url`      | varchar(2048) | S3 URL to output (if stored externally)                                        |
+| `current_flow_id` | integer       | Foreign key to waiting run's flow                                              |
+| `created_on`      | timestamp     | When session started                                                           |
+| `ended_on`        | timestamp     | When session ended                                                             |
+
+---
+
+### Flow Starts (`flows_flowstart`)
+
+Records of flows being started (manually or automatically).
+
+| Column          | Type      | Description                                                                                  |
+| --------------- | --------- | -------------------------------------------------------------------------------------------- |
+| `id`            | integer   | Primary key                                                                                  |
+| `uuid`          | uuid      | Unique identifier                                                                            |
+| `org_id`        | integer   | Foreign key to orgs_org                                                                      |
+| `flow_id`       | integer   | Foreign key to flows_flow                                                                    |
+| `start_type`    | char(1)   | 'M' (Manual), 'A' (API), 'Z' (Zapier), 'T' (Trigger)                                         |
+| `status`        | char(1)   | 'P' (Pending), 'Q' (Queued), 'S' (Started), 'C' (Completed), 'F' (Failed), 'I' (Interrupted) |
+| `contact_count` | integer   | Number of contacts started (null until queued)                                               |
+| `urns`          | text[]    | Array of URN strings                                                                         |
+| `query`         | text      | Query string for dynamic recipients                                                          |
+| `exclusions`    | jsonb     | Exclusion criteria                                                                           |
+| `params`        | jsonb     | Parameters to pass to flow                                                                   |
+| `created_on`    | timestamp | When start was created                                                                       |
+| `created_by_id` | integer   | User who created                                                                             |
+
+**Key Relationships:**
+
+- Many-to-One with `flows_flow`
+- Many-to-Many with `contacts_contact` (via flows_flowstart_contacts)
+- Many-to-Many with `contacts_contactgroup` (via flows_flowstart_groups)
+- One-to-Many with `flows_flowrun` (runs created by this start)
+
+---
+
+### Flow Labels (`flows_flowlabel`)
+
+Labels/tags for organizing and categorizing flows.
+
+| Column        | Type        | Description             |
+| ------------- | ----------- | ----------------------- |
+| `id`          | integer     | Primary key             |
+| `uuid`        | uuid        | Unique identifier       |
+| `org_id`      | integer     | Foreign key to orgs_org |
+| `name`        | varchar(64) | Label name              |
+| `is_active`   | boolean     | Whether label is active |
+| `created_on`  | timestamp   | When label was created  |
+| `modified_on` | timestamp   | Last modification time  |
+
+**Key Relationships:**
+
+- Many-to-Many with `flows_flow` (via flows_flow_labels)
+
+---
+
+## Campaign Tables
+
+### Campaigns (`campaigns_campaign`)
+
+Automated message sequences based on dates in contact fields.
+
+| Column        | Type         | Description                                         |
+| ------------- | ------------ | --------------------------------------------------- |
+| `id`          | integer      | Primary key                                         |
+| `uuid`        | uuid         | Unique identifier                                   |
+| `org_id`      | integer      | Foreign key to orgs_org                             |
+| `name`        | varchar(255) | Campaign name                                       |
+| `group_id`    | integer      | Foreign key to contacts_contactgroup (target group) |
+| `is_archived` | boolean      | Whether campaign is archived                        |
+| `is_active`   | boolean      | Whether campaign is active                          |
+| `created_on`  | timestamp    | When campaign was created                           |
+| `modified_on` | timestamp    | Last modification time                              |
+
+**Key Relationships:**
+
+- Many-to-One with `contacts_contactgroup`
+- One-to-Many with `campaigns_campaignevent` (events in campaign)
+
+---
+
+### Campaign Events (`campaigns_campaignevent`)
+
+Individual events within a campaign (send message or start flow).
+
+| Column           | Type       | Description                                                         |
+| ---------------- | ---------- | ------------------------------------------------------------------- |
+| `id`             | integer    | Primary key                                                         |
+| `uuid`           | uuid       | Unique identifier                                                   |
+| `campaign_id`    | integer    | Foreign key to campaigns_campaign                                   |
+| `event_type`     | char(1)    | 'F' (Flow), 'M' (Message)                                           |
+| `status`         | char(1)    | 'S' (Scheduling), 'R' (Ready)                                       |
+| `fire_version`   | integer    | Incremented when schedule changes                                   |
+| `relative_to_id` | integer    | Foreign key to contacts_contactfield (date field to base timing on) |
+| `offset`         | integer    | Offset from relative_to date                                        |
+| `unit`           | char(1)    | 'M' (Minutes), 'H' (Hours), 'D' (Days), 'W' (Weeks)                 |
+| `delivery_hour`  | integer    | Hour of day to deliver (-1 for same hour as date)                   |
+| `flow_id`        | integer    | Foreign key to flows_flow (if type=F)                               |
+| `translations`   | jsonb      | Message translations by language (if type=M)                        |
+| `base_language`  | varchar(3) | Base language for message (if type=M)                               |
+| `start_mode`     | char(1)    | 'I' (Interrupt), 'S' (Skip), 'P' (Passive)                          |
+| `is_active`      | boolean    | Whether event is active                                             |
+| `created_on`     | timestamp  | When event was created                                              |
+
+**Example:**
+
+- **relative_to**: "birthday" field
+- **offset**: -7
+- **unit**: 'D' (Days)
+- **delivery_hour**: 9
+- **Result**: Send message 7 days before birthday at 9am
+
+**Key Relationships:**
+
+- Many-to-One with `campaigns_campaign`
+- Many-to-One with `contacts_contactfield`
+- Many-to-One with `flows_flow` (if flow event)
+
+---
+
+## Channel Tables
+
+### Channels (`channels_channel`)
+
+Communication channels for sending/receiving messages.
+
+| Column         | Type         | Description                                                  |
+| -------------- | ------------ | ------------------------------------------------------------ |
+| `id`           | integer      | Primary key                                                  |
+| `uuid`         | uuid         | Unique identifier                                            |
+| `org_id`       | integer      | Foreign key to orgs_org                                      |
+| `channel_type` | varchar(3)   | Channel type code (e.g., 'WAC', 'TW', 'TG')                  |
+| `name`         | varchar(64)  | Channel name                                                 |
+| `address`      | varchar(255) | Channel address (phone number, username, etc.)               |
+| `country`      | varchar(2)   | ISO country code                                             |
+| `config`       | jsonb        | Channel configuration                                        |
+| `schemes`      | text[]       | Supported URN schemes                                        |
+| `role`         | varchar(4)   | Roles: S (Send), R (Receive), C (Call), A (Answer), U (USSD) |
+| `log_policy`   | char(1)      | 'N' (None), 'E' (Errors), 'A' (All)                          |
+| `tps`          | integer      | Transactions per second limit                                |
+| `is_active`    | boolean      | Whether channel is active                                    |
+| `is_enabled`   | boolean      | Whether channel is enabled for sending                       |
+| `created_on`   | timestamp    | When channel was created                                     |
+| `modified_on`  | timestamp    | Last modification time                                       |
+| `last_seen`    | timestamp    | Last sync time (Android channels)                            |
+
+**Common Channel Types:**
+
+- **WAC**: WhatsApp Cloud API
+- **TW**: Twilio
+- **TG**: Telegram
+- **FBA**: Facebook Messenger
+- **IG**: Instagram
+- **A**: Android (direct phone connection)
+
+**Key Relationships:**
+
+- One-to-Many with `msgs_msg` (messages through channel)
+- One-to-Many with `channels_channelevent` (channel events)
+- One-to-Many with `contacts_contacturn` (URN affinities)
+
+---
+
+### Channel Events (`channels_channelevent`)
+
+Non-message events from channels (calls, opt-ins, etc.)
+
+| Column           | Type        | Description                        |
+| ---------------- | ----------- | ---------------------------------- |
+| `id`             | integer     | Primary key                        |
+| `uuid`           | uuid        | Unique identifier                  |
+| `org_id`         | integer     | Foreign key to orgs_org            |
+| `channel_id`     | integer     | Foreign key to channels_channel    |
+| `contact_id`     | integer     | Foreign key to contacts_contact    |
+| `contact_urn_id` | integer     | Foreign key to contacts_contacturn |
+| `event_type`     | varchar(16) | Type of event (see below)          |
+| `status`         | char(1)     | 'P' (Pending), 'H' (Handled)       |
+| `extra`          | jsonb       | Additional event data              |
+| `occurred_on`    | timestamp   | When event occurred                |
+| `created_on`     | timestamp   | When event was recorded            |
+
+**Event Types:**
+
+- **mo_call**: Incoming call
+- **mo_miss**: Missed incoming call
+- **mt_call**: Outgoing call
+- **mt_miss**: Missed outgoing call
+- **new_conversation**: New conversation started
+- **referral**: User came via referral
+- **optin**: User opted in
+- **optout**: User opted out
+- **stop_contact**: Contact asked to stop
+- **welcome_message**: Welcome message trigger
+
+---
+
+## Ticketing Tables
+
+### Tickets (`tickets_ticket`)
+
+Support tickets for human-agent interaction with contacts.
+
+| Column             | Type      | Description                                   |
+| ------------------ | --------- | --------------------------------------------- |
+| `id`               | integer   | Primary key                                   |
+| `uuid`             | uuid      | Unique identifier                             |
+| `org_id`           | integer   | Foreign key to orgs_org                       |
+| `contact_id`       | integer   | Foreign key to contacts_contact               |
+| `topic_id`         | integer   | Foreign key to tickets_topic                  |
+| `assignee_id`      | integer   | Foreign key to auth_user (assigned agent)     |
+| `status`           | char(1)   | 'O' (Open), 'C' (Closed)                      |
+| `opened_on`        | timestamp | When ticket was opened                        |
+| `opened_in_id`     | integer   | Foreign key to flows_flow (if opened in flow) |
+| `opened_by_id`     | integer   | User who opened (if manual)                   |
+| `replied_on`       | timestamp | When first reply was sent                     |
+| `closed_on`        | timestamp | When ticket was closed                        |
+| `modified_on`      | timestamp | Last modification time                        |
+| `last_activity_on` | timestamp | Last activity (for sorting)                   |
+
+**Key Relationships:**
+
+- Many-to-One with `contacts_contact`
+- Many-to-One with `tickets_topic`
+- Many-to-One with auth_user (assignee)
+- One-to-Many with `tickets_ticketevent` (ticket history)
+- One-to-Many with `msgs_msg` (messages in ticket conversation)
+
+---
+
+### Ticket Events (`tickets_ticketevent`)
+
+History of ticket state changes.
+
+| Column          | Type      | Description                                                                                 |
+| --------------- | --------- | ------------------------------------------------------------------------------------------- |
+| `id`            | integer   | Primary key                                                                                 |
+| `org_id`        | integer   | Foreign key to orgs_org                                                                     |
+| `ticket_id`     | integer   | Foreign key to tickets_ticket                                                               |
+| `contact_id`    | integer   | Foreign key to contacts_contact                                                             |
+| `event_type`    | char(1)   | 'O' (Opened), 'A' (Assigned), 'N' (Note), 'T' (Topic Changed), 'C' (Closed), 'R' (Reopened) |
+| `note`          | text      | Note text (if event_type=N)                                                                 |
+| `topic_id`      | integer   | New topic (if event_type=T)                                                                 |
+| `assignee_id`   | integer   | New assignee (if event_type=A)                                                              |
+| `created_on`    | timestamp | When event occurred                                                                         |
+| `created_by_id` | integer   | User who created event                                                                      |
+
+---
+
+### Topics (`tickets_topic`)
+
+Categories for organizing tickets.
+
+| Column       | Type        | Description                       |
+| ------------ | ----------- | --------------------------------- |
+| `id`         | integer     | Primary key                       |
+| `uuid`       | uuid        | Unique identifier                 |
+| `org_id`     | integer     | Foreign key to orgs_org           |
+| `name`       | varchar(64) | Topic name                        |
+| `is_default` | boolean     | Whether this is the default topic |
+| `is_system`  | boolean     | Whether this is a system topic    |
+| `is_active`  | boolean     | Whether topic is active           |
+| `created_on` | timestamp   | When topic was created            |
+
+**Key Relationships:**
+
+- One-to-Many with `tickets_ticket`
+- Many-to-Many with `tickets_team` (teams that can access this topic)
+
+---
+
+### Teams (`tickets_team`)
+
+Groups of agent users organized by topic access.
+
+| Column       | Type         | Description                        |
+| ------------ | ------------ | ---------------------------------- |
+| `id`         | integer      | Primary key                        |
+| `uuid`       | uuid         | Unique identifier                  |
+| `org_id`     | integer      | Foreign key to orgs_org            |
+| `name`       | varchar(128) | Team name                          |
+| `all_topics` | boolean      | Whether team can access all topics |
+| `is_default` | boolean      | Whether this is the default team   |
+| `is_system`  | boolean      | Whether this is a system team      |
+| `is_active`  | boolean      | Whether team is active             |
+| `created_on` | timestamp    | When team was created              |
+
+**Key Relationships:**
+
+- Many-to-Many with `tickets_topic` (via tickets_team_topics)
+- One-to-Many with orgs_orgmembership (team members)
+
+---
+
+## Automation Tables
+
+### Triggers (`triggers_trigger`)
+
+Automated flow starters based on events.
+
+| Column         | Type         | Description                                           |
+| -------------- | ------------ | ----------------------------------------------------- |
+| `id`           | integer      | Primary key                                           |
+| `org_id`       | integer      | Foreign key to orgs_org                               |
+| `trigger_type` | char(1)      | Type of trigger (see below)                           |
+| `flow_id`      | integer      | Foreign key to flows_flow                             |
+| `channel_id`   | integer      | Foreign key to channels_channel (if channel-specific) |
+| `keywords`     | text[]       | Keywords to match (if type=K)                         |
+| `match_type`   | char(1)      | 'F' (First word), 'O' (Only word)                     |
+| `referrer_id`  | varchar(255) | Referrer ID (if type=R)                               |
+| `schedule_id`  | integer      | Foreign key to schedules_schedule (if type=S)         |
+| `priority`     | integer      | Priority (higher = more specific = runs first)        |
+| `is_archived`  | boolean      | Whether trigger is archived                           |
+| `is_active`    | boolean      | Whether trigger is active                             |
+| `created_on`   | timestamp    | When trigger was created                              |
+
+**Trigger Types:**
+
+- **K (Keyword)**: Message starts with keyword
+- **S (Schedule)**: Scheduled time
+- **V (Inbound Call)**: Incoming call
+- **M (Missed Call)**: Missed call
+- **N (New Conversation)**: New conversation
+- **R (Referral)**: Referral
+- **T (Closed Ticket)**: Ticket closed
+- **C (Catch All)**: Catch-all for unhandled messages
+- **I (Opt In)**: Opt-in event
+- **O (Opt Out)**: Opt-out event
+
+**Key Relationships:**
+
+- Many-to-One with `flows_flow`
+- Many-to-One with `channels_channel`
+- Many-to-One with `schedules_schedule`
+- Many-to-Many with `contacts_contactgroup` (groups/exclude_groups)
+
+---
+
+### Schedules (`schedules_schedule`)
+
+Scheduling configuration for recurring events.
+
+| Column                  | Type       | Description                                                              |
+| ----------------------- | ---------- | ------------------------------------------------------------------------ |
+| `id`                    | integer    | Primary key                                                              |
+| `org_id`                | integer    | Foreign key to orgs_org                                                  |
+| `repeat_period`         | char(1)    | 'O' (Never/Once), 'D' (Daily), 'W' (Weekly), 'M' (Monthly), 'Y' (Yearly) |
+| `repeat_hour_of_day`    | integer    | Hour to fire (0-23)                                                      |
+| `repeat_minute_of_hour` | integer    | Minute to fire (0-59)                                                    |
+| `repeat_day_of_month`   | integer    | Day of month (1-31, for monthly)                                         |
+| `repeat_days_of_week`   | varchar(7) | Days of week (MTWRFSU, for weekly)                                       |
+| `is_paused`             | boolean    | Whether schedule is paused                                               |
+| `last_fire`             | timestamp  | Last time schedule fired                                                 |
+| `next_fire`             | timestamp  | Next scheduled fire time                                                 |
+
+**Key Relationships:**
+
+- One-to-One with `msgs_broadcast` (scheduled broadcasts)
+- One-to-One with `triggers_trigger` (scheduled triggers)
+
+---
+
+### Globals (`globals_global`)
+
+Global variables accessible in flows and messages.
+
+| Column        | Type        | Description                                         |
+| ------------- | ----------- | --------------------------------------------------- |
+| `id`          | integer     | Primary key                                         |
+| `uuid`        | uuid        | Unique identifier                                   |
+| `org_id`      | integer     | Foreign key to orgs_org                             |
+| `key`         | varchar(36) | Variable key (lowercase, alphanumeric + underscore) |
+| `name`        | varchar(36) | Display name                                        |
+| `value`       | text        | Global value                                        |
+| `is_active`   | boolean     | Whether global is active                            |
+| `created_on`  | timestamp   | When global was created                             |
+| `modified_on` | timestamp   | Last modification time                              |
+
+**Usage:**
+Globals can be referenced in flows and messages using `@globals.key_name` syntax.
+
+---
+
+## Template Tables
+
+### Templates (`templates_template`)
+
+Message templates with variable substitution, primarily used for WhatsApp Business API.
+
+| Column                | Type         | Description                              |
+| --------------------- | ------------ | ---------------------------------------- |
+| `id`                  | integer      | Primary key                              |
+| `uuid`                | uuid         | Unique identifier                        |
+| `org_id`              | integer      | Foreign key to orgs_org                  |
+| `name`                | varchar(512) | Template name                            |
+| `base_translation_id` | integer      | Foreign key to base template translation |
+| `is_active`           | boolean      | Whether template is active               |
+| `created_on`          | timestamp    | When template was created                |
+| `modified_on`         | timestamp    | Last modification time                   |
+
+**Key Relationships:**
+
+- One-to-Many with `templates_templatetranslation` (translations in different languages)
+- Referenced by flows via template dependencies
+
+---
+
+### Template Translations (`templates_templatetranslation`)
+
+Language and channel-specific versions of templates.
+
+| Column           | Type        | Description                                                      |
+| ---------------- | ----------- | ---------------------------------------------------------------- |
+| `id`             | integer     | Primary key                                                      |
+| `template_id`    | integer     | Foreign key to templates_template                                |
+| `channel_id`     | integer     | Foreign key to channels_channel                                  |
+| `locale`         | varchar(6)  | Language locale (e.g., 'eng', 'eng-US')                          |
+| `status`         | char(1)     | 'P' (Pending), 'A' (Approved), 'R' (Rejected), 'U' (Unsupported) |
+| `content`        | text        | Template content with variable placeholders                      |
+| `variable_count` | integer     | Number of variables in template                                  |
+| `namespace`      | varchar(36) | WhatsApp namespace                                               |
+| `external_id`    | varchar(64) | External ID from channel provider                                |
+| `is_active`      | boolean     | Whether translation is active                                    |
+
+**Key Relationships:**
+
+- Many-to-One with `templates_template`
+- Many-to-One with `channels_channel`
+
+---
+
+## AI & Classifier Tables
+
+### Classifiers (`classifiers_classifier`)
+
+NLU/AI classifiers for intent recognition and entity extraction.
+
+| Column            | Type         | Description                                  |
+| ----------------- | ------------ | -------------------------------------------- |
+| `id`              | integer      | Primary key                                  |
+| `uuid`            | uuid         | Unique identifier                            |
+| `org_id`          | integer      | Foreign key to orgs_org                      |
+| `name`            | varchar(255) | Classifier name                              |
+| `classifier_type` | varchar(16)  | Type of classifier (wit, bothub, luis, etc.) |
+| `config`          | jsonb        | Classifier configuration and credentials     |
+| `is_active`       | boolean      | Whether classifier is active                 |
+| `created_on`      | timestamp    | When classifier was created                  |
+| `modified_on`     | timestamp    | Last modification time                       |
+
+**Common Classifier Types:**
+
+- **wit**: Wit.ai
+- **bothub**: Bothub
+- **luis**: Microsoft LUIS
+
+**Key Relationships:**
+
+- One-to-Many with `classifiers_intent` (intents this classifier recognizes)
+- Referenced by flows via classifier dependencies
+
+---
+
+### Intents (`classifiers_intent`)
+
+Intent definitions for classifiers.
+
+| Column          | Type         | Description                           |
+| --------------- | ------------ | ------------------------------------- |
+| `id`            | integer      | Primary key                           |
+| `classifier_id` | integer      | Foreign key to classifiers_classifier |
+| `name`          | varchar(64)  | Intent name                           |
+| `external_id`   | varchar(255) | External ID from classifier provider  |
+| `is_active`     | boolean      | Whether intent is active              |
+| `created_on`    | timestamp    | When intent was created               |
+
+**Key Relationships:**
+
+- Many-to-One with `classifiers_classifier`
+
+---
+
+## Common Query Patterns
+
+### Get all messages for a contact
+
+```sql
+SELECT
+    m.id,
+    m.text,
+    m.direction,
+    m.status,
+    m.created_on,
+    c.name as channel_name
+FROM msgs_msg m
+LEFT JOIN channels_channel c ON m.channel_id = c.id
+WHERE m.contact_id = {contact_id}
+  AND m.visibility = 'V'
+ORDER BY m.created_on DESC;
+```
+
+### Get flow run statistics with detailed status breakdown
+
+```sql
+SELECT
+    f.name as flow_name,
+    f.uuid as flow_uuid,
+    fr.status,
+    COUNT(*) as run_count,
+    COUNT(DISTINCT fr.contact_id) as unique_contacts,
+    AVG(EXTRACT(EPOCH FROM (fr.exited_on - fr.created_on))/60) as avg_duration_minutes,
+    COUNT(CASE WHEN fr.responded THEN 1 END) as responded_count,
+    MIN(fr.created_on) as first_run,
+    MAX(fr.created_on) as last_run
+FROM flows_flowrun fr
+JOIN flows_flow f ON fr.flow_id = f.id
+WHERE fr.created_on >= NOW() - INTERVAL '30 days'
+  AND fr.exited_on IS NOT NULL
+  AND f.is_active = TRUE
+GROUP BY f.id, f.name, f.uuid, fr.status
+ORDER BY run_count DESC;
+```
+
+### Get detailed flow run results
+
+```sql
+-- Extract specific result values from flow runs
+SELECT
+    f.name as flow_name,
+    c.name as contact_name,
+    fr.status,
+    fr.results->>'result_key' as result_value,
+    fr.created_on,
+    fr.exited_on,
+    EXTRACT(EPOCH FROM (fr.exited_on - fr.created_on))/60 as duration_minutes
+FROM flows_flowrun fr
+JOIN flows_flow f ON fr.flow_id = f.id
+JOIN contacts_contact c ON fr.contact_id = c.id
+WHERE f.uuid = 'flow-uuid-here'
+  AND fr.results IS NOT NULL
+  AND fr.created_on >= NOW() - INTERVAL '7 days'
+ORDER BY fr.created_on DESC;
+```
+
+### Get campaign event performance
+
+```sql
+SELECT
+    c.name as campaign_name,
+    ce.event_type,
+    COUNT(DISTINCT cf.contact_id) as contacts_scheduled,
+    AVG(ce.offset) as avg_offset
+FROM campaigns_campaign c
+JOIN campaigns_campaignevent ce ON c.id = ce.campaign_id
+LEFT JOIN contacts_contactfire cf ON cf.scope LIKE 'C:' || ce.id || '%'
+WHERE c.is_archived = FALSE
+GROUP BY c.name, ce.event_type;
+```
+
+### Get contact engagement metrics
+
+```sql
+SELECT
+    c.id,
+    c.name,
+    c.created_on,
+    c.last_seen_on,
+    COUNT(DISTINCT m.id) as message_count,
+    COUNT(DISTINCT fr.id) as flow_run_count,
+    COUNT(DISTINCT t.id) as ticket_count
+FROM contacts_contact c
+LEFT JOIN msgs_msg m ON c.id = m.contact_id
+  AND m.created_on >= NOW() - INTERVAL '90 days'
+LEFT JOIN flows_flowrun fr ON c.id = fr.contact_id
+  AND fr.created_on >= NOW() - INTERVAL '90 days'
+LEFT JOIN tickets_ticket t ON c.id = t.contact_id
+WHERE c.org_id = {org_id}
+  AND c.is_active = TRUE
+  AND c.status = 'A'
+GROUP BY c.id
+ORDER BY message_count DESC;
+```
+
+### Get broadcast effectiveness
+
+```sql
+SELECT
+    b.id,
+    b.created_on,
+    b.contact_count,
+    b.status,
+    COUNT(m.id) as messages_sent,
+    COUNT(CASE WHEN m.status IN ('S', 'D', 'R') THEN 1 END) as messages_delivered,
+    COUNT(CASE WHEN m.status = 'F' THEN 1 END) as messages_failed
+FROM msgs_broadcast b
+LEFT JOIN msgs_msg m ON b.id = m.broadcast_id
+WHERE b.org_id = {org_id}
+  AND b.created_on >= NOW() - INTERVAL '30 days'
+GROUP BY b.id
+ORDER BY b.created_on DESC;
+```
+
+---
+
+## Important Notes
+
+### UUID Fields
+
+Most tables use UUIDs as unique identifiers for API access and exports. The `id` field is the internal integer primary key used for database relationships.
+
+### Timestamps
+
+All timestamps are stored in UTC. Use the org's timezone from `orgs_org.timezone` to convert to local time.
+
+### Soft Deletes
+
+Most tables use `is_active` for soft deletes rather than actually deleting rows. Always filter by `is_active = TRUE` unless you specifically want to include deleted items.
+
+### JSONB Fields
+
+Fields like `config`, `fields`, `results`, and `extra` use PostgreSQL's JSONB type for flexible schema storage. You can query these using PostgreSQL's JSON operators:
+
+- `->` for object field access
+- `->>` for text result
+- `@>` for containment
+- `?` for key existence
+
+Example:
+
+```sql
+-- Find contacts with a specific field value
+SELECT * FROM contacts_contact
+WHERE fields @> '{"field_uuid": {"text": "value"}}'::jsonb;
+```
+
+### Foreign Key Naming
+
+Most foreign keys follow the pattern `tablename_id` (e.g., `org_id`, `contact_id`). Some many-to-many relationships use junction tables (e.g., `contacts_contactgroup_contacts`).
+
+### Count Tables
+
+Many tables have associated count tables (e.g., `orgs_orgcount`, `contacts_contactgroupcount`) that maintain aggregated counts for performance. These are updated by database triggers and background tasks.
+
+---
+
+## Database Indexes
+
+RapidPro includes numerous indexes optimized for common query patterns. Key indexes include:
+
+- **Contact lookups**: By org, status, modified_on
+- **Message retrieval**: By org, contact, created_on, status
+- **Flow runs**: By flow, contact, status, modified_on
+- **Tickets**: By org, status, last_activity_on
+- **URN lookups**: By identity + org (unique), scheme
+
+When writing custom queries, use `EXPLAIN ANALYZE` to ensure you're using appropriate indexes.
+
+---
+
+This schema represents a mature messaging platform with comprehensive tracking of contact interactions, automated workflows, campaign management, and support ticketing. The design emphasizes:
+
+1. **Scalability**: Proper indexing and partitioning strategies
+2. **Flexibility**: JSONB fields for variable data
+3. **Auditability**: Comprehensive timestamps and modification tracking
+4. **Multi-tenancy**: Org-level isolation
+5. **Extensibility**: Custom fields and dynamic groups
+
+For building dashboards, focus on the relationships between:
+
+- **Contacts** ↔ **Messages** ↔ **Channels** (engagement metrics)
+- **Contacts** ↔ **Flow Runs** ↔ **Flows** (automation effectiveness)
+- **Campaigns** ↔ **Campaign Events** ↔ **Contacts** (campaign performance)
+- **Tickets** ↔ **Agents** ↔ **Topics** (support metrics)
+- **Templates** ↔ **Channels** ↔ **Messages** (template usage)
+- **Classifiers** ↔ **Flows** (AI/NLU integration)
+
+## Additional Analytics Queries
+
+### Flow engagement by group
+
+```sql
+SELECT
+    cg.name as group_name,
+    f.name as flow_name,
+    COUNT(DISTINCT fr.contact_id) as unique_participants,
+    COUNT(*) as total_runs,
+    COUNT(CASE WHEN fr.status = 'C' THEN 1 END) as completed_runs,
+    COUNT(CASE WHEN fr.status = 'X' THEN 1 END) as expired_runs,
+    AVG(CASE WHEN fr.exited_on IS NOT NULL THEN
+        EXTRACT(EPOCH FROM (fr.exited_on - fr.created_on))/60
+    END) as avg_duration_minutes
+FROM flows_flowrun fr
+JOIN flows_flow f ON fr.flow_id = f.id
+JOIN contacts_contact c ON fr.contact_id = c.id
+JOIN contacts_contactgroup_contacts cgc ON c.id = cgc.contact_id
+JOIN contacts_contactgroup cg ON cgc.contactgroup_id = cg.id
+WHERE fr.created_on >= NOW() - INTERVAL '30 days'
+  AND cg.group_type IN ('M', 'Q')
+  AND cg.is_active = TRUE
+GROUP BY cg.id, cg.name, f.id, f.name
+ORDER BY total_runs DESC;
+```
+
+### Campaign effectiveness
+
+```sql
+SELECT
+    c.name as campaign_name,
+    ce.event_type,
+    cf.name as trigger_field,
+    CASE ce.unit
+        WHEN 'M' THEN 'Minutes'
+        WHEN 'H' THEN 'Hours'
+        WHEN 'D' THEN 'Days'
+        WHEN 'W' THEN 'Weeks'
+    END as time_unit,
+    ce.offset as time_offset,
+    COUNT(DISTINCT fs.id) as flow_starts_triggered,
+    SUM(fs.contact_count) as total_contacts_reached
+FROM campaigns_campaign c
+JOIN campaigns_campaignevent ce ON c.id = ce.campaign_id
+JOIN contacts_contactfield cf ON ce.relative_to_id = cf.id
+LEFT JOIN flows_flowstart fs ON fs.flow_id = ce.flow_id
+    AND fs.start_type = 'T'
+    AND fs.created_on >= NOW() - INTERVAL '90 days'
+WHERE c.is_archived = FALSE
+  AND ce.is_active = TRUE
+GROUP BY c.id, c.name, ce.id, ce.event_type, cf.name, ce.unit, ce.offset
+ORDER BY c.name, ce.offset;
+```
+
+### Template usage and approval status
+
+```sql
+SELECT
+    t.name as template_name,
+    ch.name as channel_name,
+    tt.locale,
+    tt.status as approval_status,
+    tt.variable_count,
+    COUNT(DISTINCT m.id) as times_used,
+    MIN(m.created_on) as first_used,
+    MAX(m.created_on) as last_used
+FROM templates_template t
+JOIN templates_templatetranslation tt ON t.id = tt.template_id
+JOIN channels_channel ch ON tt.channel_id = ch.id
+LEFT JOIN msgs_msg m ON m.text LIKE '%' || t.name || '%'
+    AND m.channel_id = ch.id
+    AND m.created_on >= NOW() - INTERVAL '90 days'
+WHERE t.is_active = TRUE
+  AND tt.is_active = TRUE
+GROUP BY t.id, t.name, ch.name, tt.locale, tt.status, tt.variable_count
+ORDER BY times_used DESC;
+```
diff --git "a/Screenshot 2025-03-28 at 10.39.10\342\200\257AM.png" b/Overivew.png
similarity index 100%
rename from "Screenshot 2025-03-28 at 10.39.10\342\200\257AM.png"
rename to Overivew.png
diff --git a/database_visualization.html b/database_visualization.html
new file mode 100644
index 00000000000..4072ac60a42
--- /dev/null
+++ b/database_visualization.html
@@ -0,0 +1,1609 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>RapidPro Database Schema - Interactive Visualization</title>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/cytoscape/3.26.0/cytoscape.min.js"></script>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            padding: 10px;
+            margin: 0;
+        }
+
+        .container {
+            max-width: 100%;
+            margin: 0 auto;
+            background: white;
+            border-radius: 16px;
+            box-shadow: 0 25px 80px rgba(0, 0, 0, 0.35);
+            overflow: visible;
+            display: flex;
+            flex-direction: column;
+            min-height: calc(200vh - 20px);
+        }
+
+        .header {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            padding: 30px;
+            text-align: center;
+            flex-shrink: 0;
+        }
+
+        .header h1 {
+            font-size: 2.5em;
+            margin-bottom: 10px;
+            font-weight: 700;
+            text-shadow: 0 2px 10px rgba(0, 0, 0, 0.2);
+        }
+
+        .header p {
+            font-size: 1.05em;
+            opacity: 0.95;
+        }
+
+        .controls {
+            background: linear-gradient(to bottom, #f8f9fa, #e9ecef);
+            padding: 20px 30px;
+            border-bottom: 2px solid #dee2e6;
+            display: flex;
+            gap: 20px;
+            flex-wrap: wrap;
+            align-items: center;
+            justify-content: space-between;
+            flex-shrink: 0;
+        }
+
+        .controls-left {
+            display: flex;
+            gap: 20px;
+            flex-wrap: wrap;
+            align-items: center;
+        }
+
+        .controls-right {
+            display: flex;
+            align-items: center;
+            gap: 15px;
+        }
+
+        .tips-box {
+            background: white;
+            padding: 12px 18px;
+            border-radius: 8px;
+            border: 2px solid #dee2e6;
+            font-size: 0.85em;
+            color: #6c757d;
+            max-width: 350px;
+        }
+
+        .tips-box strong {
+            color: #495057;
+        }
+
+        .control-group {
+            display: flex;
+            flex-direction: column;
+            gap: 6px;
+        }
+
+        .control-group label {
+            font-size: 0.8em;
+            font-weight: 700;
+            color: #495057;
+            text-transform: uppercase;
+            letter-spacing: 0.8px;
+        }
+
+        select,
+        button {
+            padding: 12px 22px;
+            border: 2px solid #dee2e6;
+            border-radius: 8px;
+            font-size: 1em;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            background: white;
+            font-weight: 500;
+        }
+
+        select {
+            min-width: 220px;
+        }
+
+        select:hover {
+            border-color: #667eea;
+        }
+
+        .category-multiselect {
+            position: relative;
+            min-width: 250px;
+        }
+
+        .multiselect-dropdown {
+            background: white;
+            border: 2px solid #dee2e6;
+            border-radius: 8px;
+            padding: 10px 15px;
+            cursor: pointer;
+            transition: all 0.3s ease;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+
+        .multiselect-dropdown:hover {
+            border-color: #667eea;
+        }
+
+        .multiselect-options {
+            position: absolute;
+            top: 100%;
+            left: 0;
+            right: 0;
+            background: white;
+            border: 2px solid #667eea;
+            border-radius: 8px;
+            margin-top: 5px;
+            padding: 10px;
+            display: none;
+            z-index: 1000;
+            max-height: 300px;
+            overflow-y: auto;
+            box-shadow: 0 8px 20px rgba(0, 0, 0, 0.15);
+        }
+
+        .multiselect-options.show {
+            display: block;
+        }
+
+        .multiselect-option {
+            padding: 8px 10px;
+            display: flex;
+            align-items: center;
+            cursor: pointer;
+            border-radius: 6px;
+            transition: background 0.2s;
+        }
+
+        .multiselect-option:hover {
+            background: #f8f9fa;
+        }
+
+        .multiselect-option input[type="checkbox"] {
+            margin-right: 10px;
+            width: 18px;
+            height: 18px;
+            cursor: pointer;
+        }
+
+        .multiselect-option label {
+            cursor: pointer;
+            user-select: none;
+            flex: 1;
+        }
+
+        button {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            border: none;
+            font-weight: 700;
+            text-transform: uppercase;
+            letter-spacing: 0.8px;
+        }
+
+        button:hover {
+            transform: translateY(-3px);
+            box-shadow: 0 8px 20px rgba(102, 126, 234, 0.5);
+        }
+
+        button:active {
+            transform: translateY(-1px);
+        }
+
+        .main-content {
+            display: grid;
+            grid-template-columns: 1fr 500px;
+            gap: 0;
+            min-height: 1400px;
+            height: auto;
+        }
+
+        #cy {
+            width: 100%;
+            height: 100%;
+            background: #fafafa;
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+        }
+
+        .sidebar-right {
+            background: white;
+            padding: 30px;
+            overflow-y: visible;
+            border-left: 2px solid #dee2e6;
+            position: sticky;
+            top: 0;
+            height: fit-content;
+            max-height: 100vh;
+            overflow-y: auto;
+        }
+
+        .sidebar-right h3 {
+            color: #667eea;
+            margin-bottom: 18px;
+            font-size: 1.8em;
+            font-weight: 700;
+        }
+
+        .sidebar-right .empty-state {
+            text-align: center;
+            padding: 60px 20px;
+            color: #6c757d;
+        }
+
+        .sidebar-right .empty-state svg {
+            width: 100px;
+            height: 100px;
+            margin-bottom: 25px;
+            opacity: 0.3;
+        }
+
+        .sidebar-right .empty-state p {
+            font-size: 1.05em;
+            line-height: 1.6;
+        }
+
+        .info-panel {
+            padding: 25px 30px;
+            background: white;
+            border-top: 2px solid #dee2e6;
+            overflow: visible;
+            flex-shrink: 0;
+        }
+
+        .info-panel h3 {
+            color: #667eea;
+            margin-bottom: 18px;
+            font-size: 1.5em;
+            font-weight: 700;
+        }
+
+        .table-info {
+            display: none;
+        }
+
+        .table-info.active {
+            display: block;
+            animation: fadeIn 0.4s ease;
+        }
+
+        .table-info-compact {
+            margin-bottom: 20px;
+        }
+
+        @keyframes fadeIn {
+            from {
+                opacity: 0;
+                transform: translateY(15px);
+            }
+
+            to {
+                opacity: 1;
+                transform: translateY(0);
+            }
+        }
+
+        .table-info h4 {
+            color: #495057;
+            margin-bottom: 12px;
+            font-size: 1.6em;
+            font-weight: 700;
+        }
+
+        .table-info .db-name {
+            color: #6c757d;
+            font-size: 1em;
+            font-family: 'Courier New', monospace;
+            background: #f8f9fa;
+            padding: 6px 12px;
+            border-radius: 6px;
+            display: inline-block;
+            margin-bottom: 12px;
+        }
+
+        .table-info p {
+            color: #495057;
+            line-height: 1.6;
+            margin-bottom: 15px;
+            font-size: 1.05em;
+        }
+
+        .table-info .columns {
+            margin-top: 20px;
+        }
+
+        .table-info .columns h5 {
+            color: #495057;
+            margin-bottom: 15px;
+            font-size: 1.3em;
+            font-weight: 700;
+        }
+
+        .table-info .columns table {
+            width: 100%;
+            border-collapse: collapse;
+            background: white;
+            border-radius: 10px;
+            overflow: hidden;
+            box-shadow: 0 3px 12px rgba(0, 0, 0, 0.1);
+            font-size: 1em;
+        }
+
+        .table-info .columns table th {
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            padding: 12px 14px;
+            text-align: left;
+            font-weight: 700;
+            font-size: 0.95em;
+            text-transform: uppercase;
+            letter-spacing: 0.8px;
+        }
+
+        .table-info .columns table td {
+            padding: 12px 14px;
+            border-bottom: 1px solid #e9ecef;
+            color: #495057;
+            font-size: 0.95em;
+        }
+
+        .table-info .columns table tr:last-child td {
+            border-bottom: none;
+        }
+
+        .table-info .columns table tr:hover {
+            background: #f8f9fa;
+        }
+
+        .table-info .columns .col-name {
+            font-family: 'Courier New', monospace;
+            font-weight: 600;
+            color: #667eea;
+            font-size: 1em;
+        }
+
+        .table-info .columns .col-type {
+            color: #f59e0b;
+            font-size: 0.95em;
+            font-weight: 600;
+        }
+
+        .legend {
+            display: flex;
+            gap: 15px;
+            flex-wrap: wrap;
+            justify-content: center;
+        }
+
+        .legend-item {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            padding: 8px 15px;
+            background: white;
+            border-radius: 8px;
+            border: 2px solid #dee2e6;
+            transition: all 0.3s ease;
+            font-weight: 600;
+            font-size: 0.9em;
+        }
+
+        .legend-item:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+        }
+
+        .legend-color {
+            width: 22px;
+            height: 22px;
+            border-radius: 5px;
+            box-shadow: 0 2px 6px rgba(0, 0, 0, 0.2);
+            flex-shrink: 0;
+        }
+
+        .diagram-container {
+            position: relative;
+            width: 100%;
+            height: 100%;
+            min-height: 1400px;
+        }
+
+        .diagram-stats {
+            position: absolute;
+            top: 15px;
+            left: 15px;
+            display: flex;
+            gap: 10px;
+            z-index: 10;
+            pointer-events: none;
+        }
+
+        .diagram-stats .stat-badge {
+            pointer-events: auto;
+        }
+
+        .stat-badge {
+            background: rgba(255, 255, 255, 0.95);
+            backdrop-filter: blur(10px);
+            padding: 10px 18px;
+            border-radius: 10px;
+            box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+            border: 2px solid #dee2e6;
+            font-size: 1em;
+            font-weight: 600;
+            color: #495057;
+        }
+
+        .stat-badge .number {
+            color: #667eea;
+            font-size: 1.4em;
+            font-weight: 800;
+            margin-right: 6px;
+        }
+
+        .relationships-info {
+            margin-top: 20px;
+            padding: 15px;
+            background: #f8f9fa;
+            border-radius: 10px;
+            border: 2px solid #dee2e6;
+        }
+
+        .relationships-info h5 {
+            color: #495057;
+            margin-bottom: 12px;
+            font-weight: 700;
+            font-size: 1.2em;
+        }
+
+        .relationships-info ul {
+            list-style: none;
+            padding: 0;
+            max-height: 300px;
+            overflow-y: auto;
+        }
+
+        .relationships-info li {
+            padding: 8px 0;
+            color: #6c757d;
+            border-bottom: 1px solid #e9ecef;
+            font-size: 1em;
+        }
+
+        .relationships-info li:last-child {
+            border-bottom: none;
+        }
+
+        .rel-arrow {
+            color: #667eea;
+            font-weight: bold;
+            margin: 0 5px;
+        }
+
+        .selected-categories {
+            display: flex;
+            flex-wrap: wrap;
+            gap: 5px;
+            margin-top: 10px;
+        }
+
+        .category-tag {
+            display: inline-flex;
+            align-items: center;
+            gap: 5px;
+            padding: 4px 10px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            border-radius: 15px;
+            font-size: 0.8em;
+            font-weight: 600;
+        }
+
+        .category-tag .remove {
+            cursor: pointer;
+            font-weight: bold;
+            opacity: 0.8;
+        }
+
+        .category-tag .remove:hover {
+            opacity: 1;
+        }
+    </style>
+</head>
+
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>🗄️ RapidPro Database Schema</h1>
+            <p>Interactive visualization of all business-critical tables and their relationships</p>
+        </div>
+
+        <div class="controls">
+            <div class="controls-left">
+            <div class="control-group">
+                <label for="layout-select">Layout Style</label>
+                <select id="layout-select">
+                    <option value="cose">Force-Directed (COSE)</option>
+                    <option value="circle">Circle</option>
+                    <option value="concentric">Concentric</option>
+                    <option value="grid">Grid</option>
+                    <option value="breadthfirst">Breadth-First</option>
+                </select>
+            </div>
+
+            <div class="control-group">
+                    <label>Filter by Categories</label>
+                    <div class="category-multiselect">
+                        <div class="multiselect-dropdown" id="category-dropdown">
+                            <span id="selected-text">All Tables</span>
+                            <span>▼</span>
+                        </div>
+                        <div class="multiselect-options" id="category-options">
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-all" value="all" checked>
+                                <label for="cat-all">All Tables</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-core" value="core">
+                                <label for="cat-core">Core (Contacts & Orgs)</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-messaging" value="messaging">
+                                <label for="cat-messaging">Messaging</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-flows" value="flows">
+                                <label for="cat-flows">Flows</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-campaigns" value="campaigns">
+                                <label for="cat-campaigns">Campaigns</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-channels" value="channels">
+                                <label for="cat-channels">Channels</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-tickets" value="tickets">
+                                <label for="cat-tickets">Ticketing</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-automation" value="automation">
+                                <label for="cat-automation">Automation</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-templates" value="templates">
+                                <label for="cat-templates">Templates</label>
+                            </div>
+                            <div class="multiselect-option">
+                                <input type="checkbox" id="cat-ai" value="ai">
+                                <label for="cat-ai">AI & Classifiers</label>
+                            </div>
+                        </div>
+                    </div>
+            </div>
+
+            <button onclick="resetView()">Reset View</button>
+            <button onclick="fitToScreen()">Fit to Screen</button>
+        </div>
+
+            <div class="controls-right">
+                <div class="tips-box">
+                    💡 <strong>Click</strong> any table to view details • <strong>Filter</strong> categories • <strong>Change</strong> layouts
+                </div>
+            </div>
+        </div>
+
+        <div class="main-content">
+
+            <div class="diagram-container">
+                <div class="diagram-stats">
+                    <div class="stat-badge">
+                        <span class="number" id="total-tables">0</span> Tables
+                    </div>
+                    <div class="stat-badge">
+                        <span class="number" id="total-relationships">0</span> Relationships
+                    </div>
+                    <div class="stat-badge">
+                        <span class="number" id="visible-tables">0</span> Visible
+                    </div>
+                </div>
+        <div id="cy"></div>
+            </div>
+
+            <div class="sidebar-right">
+                <div id="table-info" class="table-info">
+                    <div class="empty-state">
+                        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2" />
+                        </svg>
+                        <p><strong>Click on a table</strong><br>to view its details</p>
+                </div>
+                    <div class="table-info-compact" style="display: none;">
+                        <h4 id="table-name"></h4>
+                        <div class="db-name" id="table-db-name"></div>
+                        <p id="table-description"></p>
+                </div>
+                    <div class="columns" style="display: none;">
+                        <h5>📊 Table Columns</h5>
+                        <table id="columns-table">
+                            <thead>
+                                <tr>
+                                    <th>Column</th>
+                                    <th>Type</th>
+                                    <th>Description</th>
+                                </tr>
+                            </thead>
+                            <tbody id="table-columns"></tbody>
+                        </table>
+                    </div>
+                    <div class="relationships-info" id="relationships-info" style="display: none;">
+                        <h5>🔗 Relationships</h5>
+                        <ul id="relationships-list"></ul>
+                    </div>
+                </div>
+                </div>
+            </div>
+
+        <div class="info-panel">
+            <h3 style="text-align: center; margin-bottom: 20px;">🎨 Table Categories Legend</h3>
+            <div class="legend">
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #667eea;"></div>
+                    <span>Core</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #06b6d4;"></div>
+                    <span>Messaging</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #10b981;"></div>
+                    <span>Flows</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #f59e0b;"></div>
+                    <span>Campaigns</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #8b5cf6;"></div>
+                    <span>Channels</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #ec4899;"></div>
+                    <span>Ticketing</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #6366f1;"></div>
+                    <span>Automation</span>
+                </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #ef4444;"></div>
+                    <span>Templates</span>
+            </div>
+                <div class="legend-item">
+                    <div class="legend-color" style="background: #14b8a6;"></div>
+                    <span>AI & Classifiers</span>
+                </div>
+            </div>
+            
+            <h3 style="text-align: center; margin-top: 30px; margin-bottom: 15px;">📚 Additional Resources</h3>
+            <p style="color: #6c757d; font-size: 0.9em; line-height: 1.6; text-align: center;">
+                For detailed documentation of all tables, columns, and query examples, see the 
+                <strong>DATABASE SCHEMA OVERVIEW.md</strong> file.
+            </p>
+        </div>
+    </div>
+
+    <script>
+        // Define the comprehensive database schema
+        const tables = {
+            // Core
+            org: {
+                name: 'orgs_org',
+                label: 'Organizations',
+                category: 'core',
+                description: 'Root organizational entity. Each org is a separate workspace containing all data.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier for external access' },
+                    { name: 'name', type: 'varchar(128)', description: 'Organization name' },
+                    { name: 'timezone', type: 'varchar', description: 'Organization timezone (e.g., America/New_York)' },
+                    { name: 'language', type: 'varchar(64)', description: 'Default language code' },
+                    { name: 'is_anon', type: 'boolean', description: 'Whether contact identifiers are anonymized' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether org is active' },
+                    { name: 'created_on', type: 'timestamp', description: 'When org was created' }
+                ]
+            },
+            contact: {
+                name: 'contacts_contact',
+                label: 'Contacts',
+                category: 'core',
+                description: 'Individuals/entities that can be messaged and tracked.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(128)', description: "Contact's name" },
+                    { name: 'status', type: 'char(1)', description: 'A=Active, B=Blocked, S=Stopped, V=Archived' },
+                    { name: 'language', type: 'varchar(3)', description: "Contact's preferred language (ISO-639-3)" },
+                    { name: 'fields', type: 'jsonb', description: 'Custom field values, keyed by field UUID' },
+                    { name: 'current_flow_id', type: 'integer', description: 'Flow contact is currently in' },
+                    { name: 'last_seen_on', type: 'timestamp', description: 'Last time contact interacted' }
+                ]
+            },
+            contactgroup: {
+                name: 'contacts_contactgroup',
+                label: 'Contact Groups',
+                category: 'core',
+                description: 'Groups of contacts (manual or query-based smart groups).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(128)', description: 'Group name' },
+                    { name: 'group_type', type: 'char(1)', description: 'M=Manual, Q=Smart/Query, A/B/S/V=System status groups' },
+                    { name: 'status', type: 'char(1)', description: 'I=Initializing, V=Evaluating, R=Ready' },
+                    { name: 'query', type: 'text', description: 'Query string for smart groups' }
+                ]
+            },
+            contacturn: {
+                name: 'contacts_contacturn',
+                label: 'Contact URNs',
+                category: 'core',
+                description: 'Unique identifiers for contacts (phone numbers, social media handles, etc.).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'identity', type: 'varchar(255)', description: 'Full URN (scheme:path)' },
+                    { name: 'scheme', type: 'varchar(128)', description: 'URN scheme (tel, whatsapp, telegram, etc.)' },
+                    { name: 'path', type: 'varchar(255)', description: 'URN path (the actual identifier)' },
+                    { name: 'priority', type: 'integer', description: 'Priority (1000=highest)' }
+                ]
+            },
+            contactfield: {
+                name: 'contacts_contactfield',
+                label: 'Contact Fields',
+                category: 'core',
+                description: 'Custom fields for storing additional contact attributes.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'key', type: 'varchar(36)', description: 'Field key (lowercase, alphanumeric + underscore)' },
+                    { name: 'name', type: 'varchar(36)', description: 'Display name' },
+                    { name: 'value_type', type: 'char(1)', description: 'T=Text, N=Number, D=Datetime, S/I/W=Location' },
+                    { name: 'is_system', type: 'boolean', description: 'Whether this is a system field' }
+                ]
+            },
+
+            // Messaging
+            msg: {
+                name: 'msgs_msg',
+                label: 'Messages',
+                category: 'messaging',
+                description: 'All messages sent to or received from contacts.',
+                columns: [
+                    { name: 'id', type: 'bigint', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'channel_id', type: 'integer', description: 'Foreign key to channels_channel' },
+                    { name: 'text', type: 'text', description: 'Message text content' },
+                    { name: 'direction', type: 'char(1)', description: 'I=Incoming, O=Outgoing' },
+                    { name: 'status', type: 'char(1)', description: 'I/Q/W/S/D/R=Outgoing states, P/H=Incoming states' },
+                    { name: 'msg_type', type: 'char(1)', description: 'T=Text, O=Opt-In, V=Voice/IVR' },
+                    { name: 'created_on', type: 'timestamp', description: 'When message was created' },
+                    { name: 'sent_on', type: 'timestamp', description: 'When message was sent' }
+                ]
+            },
+            broadcast: {
+                name: 'msgs_broadcast',
+                label: 'Broadcasts',
+                category: 'messaging',
+                description: 'Messages sent to multiple recipients at once.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'status', type: 'char(1)', description: 'P=Pending, Q=Queued, S=Started, C=Completed, F=Failed' },
+                    { name: 'contact_count', type: 'integer', description: 'Total number of recipients' },
+                    { name: 'translations', type: 'jsonb', description: 'Message content by language' },
+                    { name: 'base_language', type: 'varchar(3)', description: 'Base language (ISO-639-3)' },
+                    { name: 'created_on', type: 'timestamp', description: 'When broadcast was created' }
+                ]
+            },
+            label: {
+                name: 'msgs_label',
+                label: 'Labels',
+                category: 'messaging',
+                description: 'Tags for organizing messages.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(64)', description: 'Label name' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether label is active' }
+                ]
+            },
+            optin: {
+                name: 'msgs_optin',
+                label: 'Opt-Ins',
+                category: 'messaging',
+                description: 'Contact opt-in status for specific messaging topics.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(64)', description: 'Opt-in name' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether opt-in is active' }
+                ]
+            },
+            media: {
+                name: 'msgs_media',
+                label: 'Media',
+                category: 'messaging',
+                description: 'Uploaded media files used as message attachments.',
+                columns: [
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'url', type: 'varchar(2048)', description: 'Public URL to media' },
+                    { name: 'content_type', type: 'varchar(255)', description: 'MIME type (image/jpeg, audio/mp3, etc.)' },
+                    { name: 'size', type: 'integer', description: 'File size in bytes' },
+                    { name: 'duration', type: 'integer', description: 'Duration in milliseconds (for audio/video)' },
+                    { name: 'status', type: 'char(1)', description: 'P=Pending, R=Ready, F=Failed' }
+                ]
+            },
+
+            // Flows
+            flow: {
+                name: 'flows_flow',
+                label: 'Flows',
+                category: 'flows',
+                description: 'Automated conversation flows (decision trees).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(128)', description: 'Flow name' },
+                    { name: 'flow_type', type: 'char(1)', description: 'M=Message, V=Voice/IVR, B=Background, S=Survey' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether flow is active' },
+                    { name: 'is_archived', type: 'boolean', description: 'Whether flow is archived' },
+                    { name: 'version_number', type: 'varchar(8)', description: 'Flow spec version' },
+                    { name: 'expires_after_minutes', type: 'integer', description: 'Inactivity timeout in minutes' }
+                ]
+            },
+            flowrun: {
+                name: 'flows_flowrun',
+                label: 'Flow Runs',
+                category: 'flows',
+                description: 'Individual instances of contacts going through flows.',
+                columns: [
+                    { name: 'id', type: 'bigint', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'flow_id', type: 'integer', description: 'Foreign key to flows_flow' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'status', type: 'char(1)', description: 'A=Active, W=Waiting, C=Completed, I=Interrupted, X=Expired, F=Failed' },
+                    { name: 'responded', type: 'boolean', description: 'Whether contact has sent a message during run' },
+                    { name: 'results', type: 'jsonb', description: 'Results collected, keyed by result name' },
+                    { name: 'created_on', type: 'timestamp', description: 'When run started' },
+                    { name: 'exited_on', type: 'timestamp', description: 'When run exited' }
+                ]
+            },
+            flowsession: {
+                name: 'flows_flowsession',
+                label: 'Flow Sessions',
+                category: 'flows',
+                description: 'Sessions containing multiple flow runs (parent-child flows).',
+                columns: [
+                    { name: 'id', type: 'bigint', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'status', type: 'char(1)', description: 'W=Waiting, C=Completed, I=Interrupted, X=Expired, F=Failed' },
+                    { name: 'session_type', type: 'char(1)', description: 'M=Message, V=Voice' },
+                    { name: 'created_on', type: 'timestamp', description: 'When session started' },
+                    { name: 'ended_on', type: 'timestamp', description: 'When session ended' }
+                ]
+            },
+            flowstart: {
+                name: 'flows_flowstart',
+                label: 'Flow Starts',
+                category: 'flows',
+                description: 'Records of flows being started (manually or automatically).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'flow_id', type: 'integer', description: 'Foreign key to flows_flow' },
+                    { name: 'start_type', type: 'char(1)', description: 'M=Manual, A=API, Z=Zapier, T=Trigger' },
+                    { name: 'status', type: 'char(1)', description: 'P=Pending, Q=Queued, S=Started, C=Completed, F=Failed' },
+                    { name: 'contact_count', type: 'integer', description: 'Number of contacts started' },
+                    { name: 'created_on', type: 'timestamp', description: 'When start was created' }
+                ]
+            },
+            flowlabel: {
+                name: 'flows_flowlabel',
+                label: 'Flow Labels',
+                category: 'flows',
+                description: 'Labels/tags for organizing and categorizing flows.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(64)', description: 'Label name' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether label is active' }
+                ]
+            },
+
+            // Campaigns
+            campaign: {
+                name: 'campaigns_campaign',
+                label: 'Campaigns',
+                category: 'campaigns',
+                description: 'Automated message sequences based on dates in contact fields.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(255)', description: 'Campaign name' },
+                    { name: 'group_id', type: 'integer', description: 'Target group for campaign' },
+                    { name: 'is_archived', type: 'boolean', description: 'Whether campaign is archived' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether campaign is active' }
+                ]
+            },
+            campaignevent: {
+                name: 'campaigns_campaignevent',
+                label: 'Campaign Events',
+                category: 'campaigns',
+                description: 'Individual events within campaigns (send message or start flow).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'campaign_id', type: 'integer', description: 'Foreign key to campaigns_campaign' },
+                    { name: 'event_type', type: 'char(1)', description: 'F=Flow, M=Message' },
+                    { name: 'relative_to_id', type: 'integer', description: 'Date field to base timing on' },
+                    { name: 'offset', type: 'integer', description: 'Offset from relative_to date' },
+                    { name: 'unit', type: 'char(1)', description: 'M=Minutes, H=Hours, D=Days, W=Weeks' },
+                    { name: 'flow_id', type: 'integer', description: 'Flow to start (if type=F)' }
+                ]
+            },
+
+            // Channels
+            channel: {
+                name: 'channels_channel',
+                label: 'Channels',
+                category: 'channels',
+                description: 'Communication channels for sending/receiving messages.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'channel_type', type: 'varchar(3)', description: 'Channel type code (WAC, TW, TG, etc.)' },
+                    { name: 'name', type: 'varchar(64)', description: 'Channel name' },
+                    { name: 'address', type: 'varchar(255)', description: 'Channel address (phone number, etc.)' },
+                    { name: 'schemes', type: 'text[]', description: 'Supported URN schemes' },
+                    { name: 'role', type: 'varchar(4)', description: 'Roles: S=Send, R=Receive, C=Call, A=Answer' }
+                ]
+            },
+            channelevent: {
+                name: 'channels_channelevent',
+                label: 'Channel Events',
+                category: 'channels',
+                description: 'Non-message events from channels (calls, opt-ins, etc.).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'channel_id', type: 'integer', description: 'Foreign key to channels_channel' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'event_type', type: 'varchar(16)', description: 'Type of event (mo_call, mt_call, optin, etc.)' },
+                    { name: 'occurred_on', type: 'timestamp', description: 'When event occurred' }
+                ]
+            },
+
+            // Ticketing
+            ticket: {
+                name: 'tickets_ticket',
+                label: 'Tickets',
+                category: 'tickets',
+                description: 'Support tickets for human-agent interaction with contacts.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'contact_id', type: 'integer', description: 'Foreign key to contacts_contact' },
+                    { name: 'topic_id', type: 'integer', description: 'Foreign key to tickets_topic' },
+                    { name: 'assignee_id', type: 'integer', description: 'Foreign key to auth_user (assigned agent)' },
+                    { name: 'status', type: 'char(1)', description: 'O=Open, C=Closed' },
+                    { name: 'opened_on', type: 'timestamp', description: 'When ticket was opened' },
+                    { name: 'closed_on', type: 'timestamp', description: 'When ticket was closed' }
+                ]
+            },
+            ticketevent: {
+                name: 'tickets_ticketevent',
+                label: 'Ticket Events',
+                category: 'tickets',
+                description: 'History of ticket state changes.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'ticket_id', type: 'integer', description: 'Foreign key to tickets_ticket' },
+                    { name: 'event_type', type: 'char(1)', description: 'O=Opened, A=Assigned, N=Note, T=Topic Changed, C=Closed' },
+                    { name: 'note', type: 'text', description: 'Note text (if event_type=N)' },
+                    { name: 'created_on', type: 'timestamp', description: 'When event occurred' }
+                ]
+            },
+            topic: {
+                name: 'tickets_topic',
+                label: 'Topics',
+                category: 'tickets',
+                description: 'Categories for organizing tickets.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(64)', description: 'Topic name' },
+                    { name: 'is_default', type: 'boolean', description: 'Whether this is the default topic' }
+                ]
+            },
+            team: {
+                name: 'tickets_team',
+                label: 'Teams',
+                category: 'tickets',
+                description: 'Groups of agent users organized by topic access.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(128)', description: 'Team name' },
+                    { name: 'all_topics', type: 'boolean', description: 'Whether team can access all topics' }
+                ]
+            },
+
+            // Automation
+            trigger: {
+                name: 'triggers_trigger',
+                label: 'Triggers',
+                category: 'automation',
+                description: 'Automated flow starters based on events (keywords, schedules, etc.).',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'trigger_type', type: 'char(1)', description: 'K=Keyword, S=Schedule, V=Inbound Call, etc.' },
+                    { name: 'flow_id', type: 'integer', description: 'Foreign key to flows_flow' },
+                    { name: 'keywords', type: 'text[]', description: 'Keywords to match (if type=K)' },
+                    { name: 'is_archived', type: 'boolean', description: 'Whether trigger is archived' }
+                ]
+            },
+            schedule: {
+                name: 'schedules_schedule',
+                label: 'Schedules',
+                category: 'automation',
+                description: 'Scheduling configuration for recurring events.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'repeat_period', type: 'char(1)', description: 'O=Once, D=Daily, W=Weekly, M=Monthly, Y=Yearly' },
+                    { name: 'repeat_hour_of_day', type: 'integer', description: 'Hour to fire (0-23)' },
+                    { name: 'next_fire', type: 'timestamp', description: 'Next scheduled fire time' }
+                ]
+            },
+            global: {
+                name: 'globals_global',
+                label: 'Globals',
+                category: 'automation',
+                description: 'Global variables accessible in flows and messages.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'key', type: 'varchar(36)', description: 'Variable key (lowercase, alphanumeric + underscore)' },
+                    { name: 'name', type: 'varchar(36)', description: 'Display name' },
+                    { name: 'value', type: 'text', description: 'Global value' }
+                ]
+            },
+
+            // Templates
+            template: {
+                name: 'templates_template',
+                label: 'Templates',
+                category: 'templates',
+                description: 'Message templates (primarily for WhatsApp) with variable substitution.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(512)', description: 'Template name' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether template is active' }
+                ]
+            },
+            templatetranslation: {
+                name: 'templates_templatetranslation',
+                label: 'Template Translations',
+                category: 'templates',
+                description: 'Language-specific versions of templates.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'template_id', type: 'integer', description: 'Foreign key to templates_template' },
+                    { name: 'channel_id', type: 'integer', description: 'Foreign key to channels_channel' },
+                    { name: 'locale', type: 'varchar(6)', description: 'Language locale (e.g., eng, eng-US)' },
+                    { name: 'status', type: 'char(1)', description: 'P=Pending, A=Approved, R=Rejected' },
+                    { name: 'content', type: 'text', description: 'Template content with variables' },
+                    { name: 'variable_count', type: 'integer', description: 'Number of variables in template' }
+                ]
+            },
+
+            // AI & Classifiers
+            classifier: {
+                name: 'classifiers_classifier',
+                label: 'Classifiers',
+                category: 'ai',
+                description: 'NLU/AI classifiers for intent recognition and entity extraction.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'uuid', type: 'uuid', description: 'Unique identifier' },
+                    { name: 'org_id', type: 'integer', description: 'Foreign key to orgs_org' },
+                    { name: 'name', type: 'varchar(255)', description: 'Classifier name' },
+                    { name: 'classifier_type', type: 'varchar(16)', description: 'Type of classifier (wit, bothub, luis, etc.)' },
+                    { name: 'config', type: 'jsonb', description: 'Classifier configuration' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether classifier is active' }
+                ]
+            },
+            intent: {
+                name: 'classifiers_intent',
+                label: 'Intents',
+                category: 'ai',
+                description: 'Intent definitions for classifiers.',
+                columns: [
+                    { name: 'id', type: 'integer', description: 'Primary key' },
+                    { name: 'classifier_id', type: 'integer', description: 'Foreign key to classifiers_classifier' },
+                    { name: 'name', type: 'varchar(64)', description: 'Intent name' },
+                    { name: 'external_id', type: 'varchar(255)', description: 'External ID from classifier provider' },
+                    { name: 'is_active', type: 'boolean', description: 'Whether intent is active' },
+                    { name: 'created_on', type: 'timestamp', description: 'When intent was created' }
+                ]
+            }
+        };
+
+        // Define comprehensive relationships
+        const relationships = [
+            // Core relationships
+            { from: 'org', to: 'contact', label: 'has many' },
+            { from: 'org', to: 'contactgroup', label: 'has many' },
+            { from: 'org', to: 'contactfield', label: 'has many' },
+            { from: 'contact', to: 'contacturn', label: 'has many' },
+            { from: 'contact', to: 'contactgroup', label: 'belongs to many' },
+
+            // Messaging relationships
+            { from: 'org', to: 'msg', label: 'has many' },
+            { from: 'org', to: 'broadcast', label: 'has many' },
+            { from: 'org', to: 'label', label: 'has many' },
+            { from: 'org', to: 'optin', label: 'has many' },
+            { from: 'org', to: 'media', label: 'has many' },
+            { from: 'contact', to: 'msg', label: 'has many' },
+            { from: 'contacturn', to: 'msg', label: 'has many' },
+            { from: 'channel', to: 'msg', label: 'has many' },
+            { from: 'broadcast', to: 'msg', label: 'creates' },
+            { from: 'broadcast', to: 'contact', label: 'targets' },
+            { from: 'broadcast', to: 'contactgroup', label: 'targets' },
+            { from: 'msg', to: 'label', label: 'has many' },
+
+            // Flow relationships
+            { from: 'org', to: 'flow', label: 'has many' },
+            { from: 'org', to: 'flowlabel', label: 'has many' },
+            { from: 'flow', to: 'flowrun', label: 'has many' },
+            { from: 'flow', to: 'flowstart', label: 'has many' },
+            { from: 'flow', to: 'flowlabel', label: 'has many' },
+            { from: 'contact', to: 'flowrun', label: 'has many' },
+            { from: 'contact', to: 'flowsession', label: 'has many' },
+            { from: 'flowrun', to: 'msg', label: 'generates' },
+            { from: 'flowstart', to: 'flowrun', label: 'creates' },
+            { from: 'flowstart', to: 'contact', label: 'starts' },
+            { from: 'flowstart', to: 'contactgroup', label: 'starts' },
+            { from: 'flowsession', to: 'flowrun', label: 'contains' },
+            { from: 'flow', to: 'contactgroup', label: 'depends on' },
+            { from: 'flow', to: 'contactfield', label: 'depends on' },
+
+            // Campaign relationships
+            { from: 'org', to: 'campaign', label: 'has many' },
+            { from: 'campaign', to: 'campaignevent', label: 'has many' },
+            { from: 'campaign', to: 'contactgroup', label: 'targets' },
+            { from: 'campaignevent', to: 'contactfield', label: 'based on' },
+            { from: 'campaignevent', to: 'flow', label: 'starts' },
+
+            // Channel relationships
+            { from: 'org', to: 'channel', label: 'has many' },
+            { from: 'channel', to: 'channelevent', label: 'has many' },
+            { from: 'channel', to: 'contacturn', label: 'affinity' },
+            { from: 'contact', to: 'channelevent', label: 'has many' },
+
+            // Ticketing relationships
+            { from: 'org', to: 'ticket', label: 'has many' },
+            { from: 'org', to: 'topic', label: 'has many' },
+            { from: 'org', to: 'team', label: 'has many' },
+            { from: 'contact', to: 'ticket', label: 'has many' },
+            { from: 'ticket', to: 'topic', label: 'belongs to' },
+            { from: 'ticket', to: 'ticketevent', label: 'has many' },
+            { from: 'ticket', to: 'msg', label: 'has many' },
+            { from: 'team', to: 'topic', label: 'accesses' },
+
+            // Automation relationships
+            { from: 'org', to: 'trigger', label: 'has many' },
+            { from: 'org', to: 'schedule', label: 'has many' },
+            { from: 'org', to: 'global', label: 'has many' },
+            { from: 'trigger', to: 'flow', label: 'starts' },
+            { from: 'trigger', to: 'channel', label: 'listens to' },
+            { from: 'trigger', to: 'contactgroup', label: 'filters by' },
+            { from: 'schedule', to: 'broadcast', label: 'schedules' },
+            { from: 'schedule', to: 'trigger', label: 'schedules' },
+
+            // Template relationships
+            { from: 'org', to: 'template', label: 'has many' },
+            { from: 'template', to: 'templatetranslation', label: 'has many' },
+            { from: 'templatetranslation', to: 'channel', label: 'belongs to' },
+            { from: 'flow', to: 'template', label: 'depends on' },
+
+            // AI & Classifier relationships
+            { from: 'org', to: 'classifier', label: 'has many' },
+            { from: 'classifier', to: 'intent', label: 'has many' },
+            { from: 'flow', to: 'classifier', label: 'depends on' }
+        ];
+
+        // Color scheme by category
+        const categoryColors = {
+            core: '#667eea',
+            messaging: '#06b6d4',
+            flows: '#10b981',
+            campaigns: '#f59e0b',
+            channels: '#8b5cf6',
+            tickets: '#ec4899',
+            automation: '#6366f1',
+            templates: '#ef4444',
+            ai: '#14b8a6'
+        };
+
+        // Build cytoscape elements
+        const elements = {
+            nodes: Object.keys(tables).map(key => ({
+                data: {
+                    id: key,
+                    label: tables[key].label,
+                    tableName: tables[key].name,
+                    category: tables[key].category,
+                    description: tables[key].description,
+                    columns: tables[key].columns,
+                    color: categoryColors[tables[key].category]
+                }
+            })),
+            edges: relationships.map((rel, idx) => ({
+                data: {
+                    id: `e${idx}`,
+                    source: rel.from,
+                    target: rel.to,
+                    label: rel.label
+                }
+            }))
+        };
+
+        // Initialize Cytoscape
+        let cy = cytoscape({
+            container: document.getElementById('cy'),
+            elements: elements,
+            style: [
+                {
+                    selector: 'node',
+                    style: {
+                        'background-color': 'data(color)',
+                        'label': 'data(label)',
+                        'color': '#fff',
+                        'text-valign': 'center',
+                        'text-halign': 'center',
+                        'font-size': '16px',
+                        'font-weight': 'bold',
+                        'width': 120,
+                        'height': 120,
+                        'text-wrap': 'wrap',
+                        'text-max-width': '110px',
+                        'border-width': 5,
+                        'border-color': '#fff',
+                        'overlay-opacity': 0,
+                        'transition-property': 'border-color, border-width',
+                        'transition-duration': '0.2s'
+                    }
+                },
+                {
+                    selector: 'node:selected',
+                    style: {
+                        'border-color': '#f59e0b',
+                        'border-width': 8
+                    }
+                },
+                {
+                    selector: 'node:active',
+                    style: {
+                        'overlay-opacity': 0
+                    }
+                },
+                {
+                    selector: 'edge',
+                    style: {
+                        'width': 3,
+                        'line-color': '#cbd5e1',
+                        'target-arrow-color': '#cbd5e1',
+                        'target-arrow-shape': 'triangle',
+                        'curve-style': 'bezier',
+                        'label': 'data(label)',
+                        'font-size': '11px',
+                        'color': '#64748b',
+                        'text-rotation': 'autorotate',
+                        'text-background-color': '#fff',
+                        'text-background-opacity': 0.9,
+                        'text-background-padding': '4px',
+                        'overlay-opacity': 0,
+                        'transition-property': 'line-color, width',
+                        'transition-duration': '0.2s'
+                    }
+                },
+                {
+                    selector: 'edge:selected',
+                    style: {
+                        'line-color': '#f59e0b',
+                        'target-arrow-color': '#f59e0b',
+                        'width': 6
+                    }
+                },
+                {
+                    selector: '.hidden',
+                    style: {
+                        'display': 'none'
+                    }
+                },
+                {
+                    selector: '.highlighted',
+                    style: {
+                        'border-color': '#10b981',
+                        'border-width': 6
+                    }
+                },
+                {
+                    selector: '.dimmed',
+                    style: {
+                        'opacity': 0.3
+                    }
+                }
+            ],
+            layout: {
+                name: 'cose',
+                animate: true,
+                animationDuration: 500,
+                nodeRepulsion: 15000,
+                idealEdgeLength: 150,
+                edgeElasticity: 100,
+                nestingFactor: 1.2
+            }
+        });
+
+        // Update stats
+        function updateStats() {
+            document.getElementById('total-tables').textContent = Object.keys(tables).length;
+            document.getElementById('total-relationships').textContent = relationships.length;
+            document.getElementById('visible-tables').textContent = cy.nodes(':visible').length;
+        }
+
+        updateStats();
+
+        // Multiselect dropdown functionality
+        const dropdown = document.getElementById('category-dropdown');
+        const optionsContainer = document.getElementById('category-options');
+        const checkboxes = optionsContainer.querySelectorAll('input[type="checkbox"]');
+        const selectedText = document.getElementById('selected-text');
+        let selectedCategories = ['all'];
+
+        dropdown.addEventListener('click', function(e) {
+            e.stopPropagation();
+            optionsContainer.classList.toggle('show');
+        });
+
+        document.addEventListener('click', function() {
+            optionsContainer.classList.remove('show');
+        });
+
+        optionsContainer.addEventListener('click', function(e) {
+            e.stopPropagation();
+        });
+
+        checkboxes.forEach(checkbox => {
+            checkbox.addEventListener('change', function() {
+                if (this.value === 'all') {
+                    if (this.checked) {
+                        checkboxes.forEach(cb => {
+                            if (cb.value !== 'all') cb.checked = false;
+                        });
+                        selectedCategories = ['all'];
+                    }
+                } else {
+                    document.getElementById('cat-all').checked = false;
+                    selectedCategories = Array.from(checkboxes)
+                        .filter(cb => cb.checked && cb.value !== 'all')
+                        .map(cb => cb.value);
+                    
+                    if (selectedCategories.length === 0) {
+                        document.getElementById('cat-all').checked = true;
+                        selectedCategories = ['all'];
+                    }
+                }
+                
+                updateCategoryFilter();
+                updateSelectedText();
+            });
+        });
+
+        function updateSelectedText() {
+            if (selectedCategories.includes('all') || selectedCategories.length === 0) {
+                selectedText.textContent = 'All Tables';
+            } else if (selectedCategories.length === 1) {
+                const checkbox = document.getElementById(`cat-${selectedCategories[0]}`);
+                selectedText.textContent = checkbox.nextElementSibling.textContent;
+            } else {
+                selectedText.textContent = `${selectedCategories.length} categories selected`;
+            }
+        }
+
+        function updateCategoryFilter() {
+            if (selectedCategories.includes('all') || selectedCategories.length === 0) {
+                cy.elements().removeClass('hidden');
+            } else {
+                cy.nodes().addClass('hidden');
+                selectedCategories.forEach(category => {
+                cy.nodes(`[category = "${category}"]`).removeClass('hidden');
+                });
+
+                // Show edges only if both nodes are visible
+                cy.edges().forEach(edge => {
+                    const source = edge.source();
+                    const target = edge.target();
+                    if (!source.hasClass('hidden') && !target.hasClass('hidden')) {
+                        edge.removeClass('hidden');
+                    } else {
+                        edge.addClass('hidden');
+                    }
+                });
+            }
+
+            updateStats();
+        }
+
+        // Event listeners
+        cy.on('tap', 'node', function (evt) {
+            const node = evt.target;
+            const data = node.data();
+
+            // Update table info panel
+            document.getElementById('table-name').textContent = data.label;
+            document.getElementById('table-db-name').textContent = data.tableName;
+            document.getElementById('table-description').textContent = data.description;
+
+            // Populate columns table
+            const columnsTableBody = document.getElementById('table-columns');
+            columnsTableBody.innerHTML = data.columns.map(col => `
+                <tr>
+                    <td class="col-name">${col.name}</td>
+                    <td class="col-type">${col.type}</td>
+                    <td>${col.description}</td>
+                </tr>
+            `).join('');
+
+            // Show relationships
+            const nodeRelationships = relationships.filter(r => r.from === node.id() || r.to === node.id());
+            const relationshipsList = document.getElementById('relationships-list');
+            if (nodeRelationships.length > 0) {
+                relationshipsList.innerHTML = nodeRelationships.map(rel => {
+                    if (rel.from === node.id()) {
+                        return `<li><strong>${data.label}</strong> <span class="rel-arrow">→</span> ${tables[rel.to].label} <em>(${rel.label})</em></li>`;
+                    } else {
+                        return `<li>${tables[rel.from].label} <span class="rel-arrow">→</span> <strong>${data.label}</strong> <em>(${rel.label})</em></li>`;
+                    }
+                }).join('');
+                document.getElementById('relationships-info').style.display = 'block';
+            } else {
+                document.getElementById('relationships-info').style.display = 'none';
+            }
+
+            // Remove empty state and show content
+            const tableInfo = document.getElementById('table-info');
+            tableInfo.querySelector('.empty-state').style.display = 'none';
+            tableInfo.querySelector('.table-info-compact').style.display = 'block';
+            tableInfo.querySelector('.columns').style.display = 'block';
+            tableInfo.classList.add('active');
+
+            // Highlight connected nodes
+            cy.nodes().removeClass('highlighted dimmed');
+            cy.edges().removeClass('highlighted dimmed');
+
+            const connectedNodes = node.neighborhood('node');
+            const connectedEdges = node.connectedEdges();
+
+            cy.nodes().not(node).not(connectedNodes).addClass('dimmed');
+            cy.edges().not(connectedEdges).addClass('dimmed');
+            connectedNodes.addClass('highlighted');
+        });
+
+        // Clear selection on background tap
+        cy.on('tap', function (evt) {
+            if (evt.target === cy) {
+                cy.nodes().removeClass('highlighted dimmed');
+                cy.edges().removeClass('highlighted dimmed');
+            }
+        });
+
+        // Layout change
+        document.getElementById('layout-select').addEventListener('change', function () {
+            cy.layout({
+                name: this.value,
+                animate: true,
+                animationDuration: 500
+            }).run();
+        });
+
+        // Reset view
+        function resetView() {
+            cy.elements().removeClass('hidden highlighted dimmed');
+            
+            // Reset category checkboxes
+            checkboxes.forEach(cb => {
+                if (cb.value === 'all') {
+                    cb.checked = true;
+                } else {
+                    cb.checked = false;
+                }
+            });
+            selectedCategories = ['all'];
+            updateSelectedText();
+            
+            document.getElementById('layout-select').value = 'cose';
+            cy.layout({
+                name: 'cose',
+                animate: true
+            }).run();
+            updateStats();
+        }
+
+        // Fit to screen
+        function fitToScreen() {
+            cy.fit(cy.elements(':visible'), 50);
+        }
+
+        // Initial fit
+        setTimeout(() => {
+            fitToScreen();
+        }, 700);
+    </script>
+</body>
+
+</html>
+