Customer 360 Documentation Hub

Central index for architecture specifications, data source contracts, identity resolution designs, marketing activation workflows, UI guides, and operational runbooks across the LEO Customer 360 repository.

---

Quick Navigation by Component

Component	Service Documentation	Primary Scope
customer360-database/	Database Schema & Migrations	PostgreSQL 16 (customer360 schema), RLS policies, triggers, and Full Schema Diagram
customer360-dao/	Shared Data Access Package	SQLAlchemy 2.0 models, Pydantic schemas, tenant-scoped repositories, and FlowEngine
customer360-event-api/	Behavioral Event Ingestion API	FastAPI + Redis Streams + S3/MinIO Bronze .jsonl.gz ingestion (:8010) and UAT Performance Report
customer360-backend/	Dagster Orchestration Workspace	8 Dagster code locations: Identity Resolution, Segmentation, Analytics, AI Agents Runners, Data Synch, Campaign Activation, Email Engine, Notification Engine
customer360-api/	Core REST & MCP API	Authenticated Customer 360 REST endpoints and /mcp tool surface (:8008)
customer360-agent/	AI Campaign Planning Service	LiteLLM-backed campaign & Zalo ZNS draft planner (:8009)
customer360-promotions/	Promotions & Ad Serving API	Placements, creatives, sponsored content, and recommendations (:9009, leo_ads schema)
customer360-frontend/	Admin & Operator Web UI	Browser shell and operator dashboards (:8890)
deployments/ & k8s/	Infrastructure & Kubernetes	Terraform, VM deployment scripts, reverse proxy routing, and VKS/Kubernetes manifests

---

Architecture & Roadmap

Platform architecture, multi-tenant data model, end-to-end data journeys, and engineering roadmap.

• Technical Documentation — System architecture, data model, security boundaries, and service interactions
• Product & Engineering Roadmap — Delivered milestones and upcoming capabilities
• LEO Data Journey Maps — End-to-end customer lifecycle and touchpoint flows
• Architecture Diagrams — Visual system, data lake, and composable CDP diagrams

Data Sources & Event Tracking

Specifications for the five supported data ingestion modalities (sys_data_source.source_type 1–5) and Web SDK testing tools.

• Data Source Types Overview — Architectural taxonomy of all 5 ingestion types
• Type 1: Web JavaScript SDK Tracking — leo.proxy.js, cross-origin iframe, leo.observer.js, and consent controls
• Type 2: Data Connector API (Server-side Pull) — Scheduled connector sync specifications
• Type 3: Data Webhook API (Server-side Push) — Real-time HTTP webhook ingestion and HMAC verification
• Type 4: S3 File Connector (Batch Sync) — Batch CSV, JSONL, and Parquet synchronization
• Type 5: Mobile SDK Tracking — iOS/Android telemetry and mobile identifier ingestion
• CDP Web SDK Tracking Reference & Web SDK Demo Guide (VN)

Customer Identity Resolution (CIR) & AI Personas

Metadata-driven identity stitching, consolidation survivorship rules, and persona vector resolution.

• CIR Readiness & Improvement Notes — Matching taxonomy (exact, fuzzy, behavioral) vs. schema readiness
• CIR Technical Slides (VN) — Deep dive into cdp_raw_profiles_stage, cdp_master_profiles, and CustomerIdentityResolver
• CIR Flow Diagrams — Runtime and persona resolution Mermaid/SVG diagrams
• 11 AI Agent Types for Customer 360 — Taxonomy of scoring, analytical, and activation AI agents

Marketing, Segmentation & Campaign Orchestration

Omnichannel campaign workflows, human-approval governance gates, and channel delivery guides.

• Marketing Workflow Specification — Campaign approval, workflow version pinning, and execution states
• Agentic Campaign Operations — AI-assisted campaign operations and human-in-the-loop governance
• Email Marketing UAT Test Guide — End-to-end verification of email campaign delivery and tracking
• Campaign Performance Slides (VN) & Marketing Diagrams

Admin UI Page Guides (docs/pages/)

User and operator documentation for every screen in the Customer 360 Admin UI in both English and Vietnamese (indexed by the built-in documentation assistant):

• Overview & Analytics: Overview (VN) · Analytics (VN)
• Customer 360 & Identity: Profiles (VN) · Profile Detail (VN) · Attributes (VN) · Data Sources (VN)
• Personas & Segments: Personas (VN) · Persona Matched Profiles (VN) · Segments (VN) · Segment Detail (VN)
• Campaigns & Catalog: Campaigns (VN) · Campaign Detail (VN) · Campaign Editor (VN) · Content & Products (VN)
• Administration: AI Agents (VN) · Admin Users & RBAC (VN)

Action Plans & Feature Specifications (docs/action-plans/)

Engineering design documents and implementation plans for core platform capabilities:

• LEO CDP v2.0 Beta Master Plan
• Campaign Orchestration & Campaigns Dev Plan
• Agentic Email Marketing Flow
• Agentic Zalo Marketing Flow & Zalo ZNS Optimization
• Agentic Ad-Tech Audience Sync Flow
• Full Analytics with S3 & S3 Analytics Baseline
• CRM Profiles API Improvement · Events API Improvement · Segments API Improvement

Operations & Deployment

Local development, Docker Compose profiles, production deployment, and PostgreSQL maintenance runbooks.

• Docker Compose Guide — dev-docker-compose.yml, dev-no-sso-docker-compose.yml, and full docker-compose.yml
• Environment Configuration Notes
• Production Deployment Runbook
• Development Domain Configuration
• Database Operations & Backup Tools

Integration Q&A, Code Reviews & Research

• Cross-Team Integration & Issues (docs/issues/):
  • Team CDP Questions & Technical Responses (SCOPE ↔ LeoCDP)
  • SCOPE Open Questions Ledger
  • Beta API Stale Deploy Incident Analysis
• Code Reviews (docs/code-review/):
  • Security & Architecture Review Index
  • Docs Chatbot Agent Implementation Plan & UAT Report
• Research Papers & Notebooks:
  • Research Papers & Whitepapers — Identity resolution (SAE-CIR-EN, SAE-CIR-VN), Persona as a Dynamic Vector, Personalization, and Customer 360 Model Layer
  • Jupyter Notebooks — RAG evaluation and persona roadmap experiments
• Tooling:
  • CD Telegram Chatbot Plan · Pandoc Notes · LaTeX Template