@fayz-ai/plugin-marketing 0.9.0-next.0 → 0.9.0

package/src/data/tables.ts

@@ -6,6 +6,21 @@ export const T = {
   contentPosts: 'plg_marketing_content_posts',
   channels: 'plg_marketing_channels',
   campaigns: 'plg_marketing_campaigns',
+  landingPages: 'plg_marketing_landing_pages',
+} as const
+
+/** The tenant's sites are its fayz projects (@fayz-ai/db 020) — the same rows
+ *  Settings → Sites manages. Marketing only READS them: a landing page points
+ *  at one and adds a route. */
+export const SITES_TABLE = 'fayz_projects'
+
+/** Where the lead-tag catalog lives. Marketing only READS it (to offer the
+ *  tags in the landing-page form); plugin-crm owns the table. Overridable via
+ *  the plugin's `leadTags` option for apps that keep tags somewhere else. */
+export const LEAD_TAGS_SOURCE = {
+  table: 'plg_crm_tags',
+  valueField: 'slug',
+  labelField: 'name',
 } as const
 
 // Read views (bridge views over spine + plugin tables; see 006_analytics_views.sql)
@@ -13,4 +28,6 @@ export const V = {
   channels: 'v_marketing_channels',
   campaigns: 'v_marketing_campaigns',
   attribution: 'v_marketing_attribution',
+  landingPages: 'v_marketing_landing_pages',
+  leadTagEvents: 'v_marketing_lead_tag_events',
 } as const

package/src/data/types.ts

@@ -2,10 +2,14 @@ import type {
   Campaign,
   CampaignStatus,
   ChannelPerformance,
+  DateRangeKey,
   FunnelStage,
+  LandingPage,
   LandingPagePerf,
+  LandingPageStatus,
   MarketingOverview,
   MarketingQuery,
+  MarketingSite,
 } from '../types'
 
 // ---------------------------------------------------------------------------
@@ -25,6 +29,17 @@ export interface SaveCampaignInput {
   spend: number
 }
 
+export interface SaveLandingPageInput {
+  id?: string
+  siteId: string
+  name: string
+  route: string
+  leadTags?: string[]
+  status?: LandingPageStatus
+  prompt?: string
+  isActive?: boolean
+}
+
 export interface MarketingDataProvider {
   overview(query: MarketingQuery): Promise<MarketingOverview>
   channelPerformance(query: MarketingQuery): Promise<ChannelPerformance[]>
@@ -34,6 +49,12 @@ export interface MarketingDataProvider {
   deleteCampaign(id: string): Promise<void>
   funnel(query: MarketingQuery): Promise<FunnelStage[]>
   landingPages(query: MarketingQuery): Promise<LandingPagePerf[]>
+  saveLandingPage(input: SaveLandingPageInput): Promise<LandingPage>
+  deleteLandingPage(id: string): Promise<void>
+  /** Sites the tenant owns — the "site" half of a landing page. */
+  listSites(): Promise<MarketingSite[]>
+  /** Lead-tag catalog offered in the landing-page form (read-only). */
+  listLeadTags(): Promise<Array<{ slug: string; name: string }>>
   /** Drop any provider-side read cache (external writes, e.g. agent RPCs). */
   invalidateCache?(): void
 }
@@ -52,6 +73,25 @@ export interface AttributionBridge {
   funnel(query: MarketingQuery): Promise<FunnelStage[]>
 }
 
+/**
+ * Visit analytics for landing pages. The pages themselves are rows the tenant
+ * owns here; the VISITS live wherever the site is deployed, so this reads them
+ * back by (app id, route, period) — the contract the hosting platform's
+ * analytics endpoint is expected to take. Nothing implements it yet: without a
+ * bridge the surface shows the pages with visits pending ("—") rather than
+ * fake zeros.
+ */
 export interface SitesPerformanceBridge {
-  landingPages(query: MarketingQuery): Promise<LandingPagePerf[]>
+  visitsByRoute(query: {
+    range: DateRangeKey
+    pages: Array<{
+      id: string
+      /** app manifest id of the deploy (fayz_projects.app_id) */
+      appId?: string
+      /** platform project id (fayz_projects.fayz_project_id) */
+      fayzProjectId?: string
+      siteUrl?: string
+      route: string
+    }>
+  }): Promise<Array<{ id: string; visits: number }>>
 }

package/src/index.ts

@@ -24,7 +24,7 @@ import { createMockContentPlannerProvider } from './data/contentMock'
 import { createSupabaseContentPlannerProvider } from './data/contentSupabase'
 import { createMarketingStore } from './store'
 import { createContentPlannerStore } from './views/content/contentStore'
-import { MIGRATION_000_PLG_RENAME, MIGRATION_001_CONTENT_PLANNER, MIGRATION_002_MULTI_PLATFORM, MIGRATION_003_RECORDING_OPS, MIGRATION_004_RANKLAYER, MIGRATION_005_ANALYTICS_BASE, MIGRATION_006_ANALYTICS_VIEWS, MIGRATION_007_AGENT_RPCS } from './migrations'
+import { MIGRATION_000_PLG_RENAME, MIGRATION_001_CONTENT_PLANNER, MIGRATION_002_MULTI_PLATFORM, MIGRATION_003_RECORDING_OPS, MIGRATION_004_RANKLAYER, MIGRATION_005_ANALYTICS_BASE, MIGRATION_006_ANALYTICS_VIEWS, MIGRATION_007_AGENT_RPCS, MIGRATION_008_LANDING_PAGES } from './migrations'
 import { ranklayerConnectorDef } from './integrations/ranklayer/connectorDef'
 import { DEFAULT_CURRENCY, type MarketingCurrency } from './format'
 import { MARKETING_PRESETS, type MarketingDomain, type MarketingDomainModules } from './presets'
@@ -64,8 +64,11 @@ export interface MarketingPluginOptions {
   settingsRegistries?: PluginRegistryDef[]
   /** Optional DI to read real conversions (mounted later). */
   attributionBridge?: AttributionBridge
-  /** Optional DI to read real landing-page performance (mounted later). */
+  /** Optional DI to read real landing-page visits (mounted later). */
   sitesBridge?: SitesPerformanceBridge
+  /** Where the lead-tag catalog is read from for the landing-page form.
+   *  Defaults to plugin-crm's plg_crm_tags (slug/name). */
+  leadTags?: { table?: string; valueField?: string; labelField?: string }
 }
 
 const DEFAULT_LABELS: MarketingLabels = {
@@ -106,6 +109,7 @@ function createSafeProvider(
       conversion: config.conversion,
       attributionBridge: options?.attributionBridge,
       sitesBridge: options?.sitesBridge,
+      leadTags: options?.leadTags,
     }),
     () => createMockMarketingProvider({ channels: config.channels, conversion: config.conversion, domain }),
   )
@@ -335,6 +339,12 @@ export function createMarketingPlugin(options?: MarketingPluginOptions): PluginM
         sql: MIGRATION_007_AGENT_RPCS,
         description: 'agent_marketing_create_campaign — guarded, audited server-plane campaign create',
       },
+      {
+        id: 'marketing-008-landing-pages',
+        version: '1.5.0',
+        sql: MIGRATION_008_LANDING_PAGES,
+        description: 'Sites + landing pages (site + route + lead tag) with tenant RLS, v_marketing_landing_pages and v_marketing_lead_tag_events',
+      },
     ],
     // RankLayer SEO connector — renders in the Integrações settings tab. Scaffold
     // (control plane only); the real sync lands via an external PR (RANKLAYER.md).

package/src/integrations/ranklayer/connectorDef.tsx

@@ -72,12 +72,16 @@ function RankLayerExtraPanel() {
   )
 }
 
+// Inlined as a data URI so the mark can never fail to load from an app's domain.
+const RANKLAYER_MARK = 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIzMiIgaGVpZ2h0PSIzMiIgdmlld0JveD0iMCAwIDMyIDMyIj48cmVjdCB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHJ4PSI3IiBmaWxsPSIjMUYyNDMxIi8+PHBvbHlnb24gcG9pbnRzPSIxNiw1LjYgMjYuNCwxMS42IDE2LDE3LjYgNS42LDExLjYiIGZpbGw9IiNGRkZGRkYiIHN0cm9rZT0iI0ZGRkZGRiIgc3Ryb2tlLXdpZHRoPSIxLjI1IiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+PGcgb3BhY2l0eT0iMC41NSI+PHBvbHlnb24gcG9pbnRzPSI1LjYsMTYuNCAxNiwyMi40IDI2LjQsMTYuNCAyNi40LDE4LjIgMTYsMjQuMiA1LjYsMTguMiIgZmlsbD0iI0ZGRkZGRiIgc3Ryb2tlPSIjRkZGRkZGIiBzdHJva2Utd2lkdGg9IjEuMjUiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz48L2c+PGcgb3BhY2l0eT0iMC4yOCI+PHBvbHlnb24gcG9pbnRzPSI1LjYsMjEuMiAxNiwyNy4yIDI2LjQsMjEuMiAyNi40LDIzIDE2LDI5IDUuNiwyMyIgZmlsbD0iI0ZGRkZGRiIgc3Ryb2tlPSIjRkZGRkZGIiBzdHJva2Utd2lkdGg9IjEuMjUiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz48L2c+PC9zdmc+'
+
 export const ranklayerConnectorDef: ConnectorDefinition = {
   id: 'ranklayer',
   hostPluginId: 'marketing',
   name: 'RankLayer',
   description: 'Publicação de conteúdo e páginas de SEO por serviço/bairro para ser encontrado no Google e em assistentes de IA.',
   icon: 'Search',
+  logoUrl: RANKLAYER_MARK,
   authKind: 'api-key',
   fields: [
     { key: 'apiKey', label: 'API Key', type: 'password', placeholder: '••••••••' },

package/src/locales/en.ts

@@ -8,6 +8,7 @@ export const en: Record<string, string> = {
   'marketing.metric.cvr': 'CVR',
   'marketing.metric.totalVisits': 'Total visits',
   'marketing.metric.pages': 'Pages',
+  'marketing.metric.leads': 'Leads',
   'marketing.metric.avgConversion': 'Avg. conversion',
   // columns
   'marketing.col.campaign': 'Campaign',
@@ -22,6 +23,8 @@ export const en: Record<string, string> = {
   'marketing.col.conversions': 'Conversions',
   'marketing.col.type': 'Type',
   'marketing.col.page': 'Page',
+  'marketing.col.route': 'Route',
+  'marketing.col.leadTag': 'Tag',
   // overview
   'marketing.overview.byChannelSuffix': 'by channel',
   'marketing.overview.recent': 'Recent campaigns',
@@ -53,7 +56,27 @@ export const en: Record<string, string> = {
   'marketing.funnel.overall': 'Overall conversion rate',
   'marketing.funnel.ofPrev': 'of prev',
   // landing pages
-  'marketing.landing.subtitle': 'Per-page visits → conversions performance',
+  'marketing.landing.new': 'New page',
+  'marketing.landing.edit': 'Edit page',
+  'marketing.landing.delete': 'Delete page',
+  'marketing.landing.save': 'Save',
+  'marketing.landing.empty': 'No pages yet.',
+  'marketing.landing.site': 'Site',
+  'marketing.landing.sitePlaceholder': 'Pick a site',
+  'marketing.landing.name': 'Name',
+  'marketing.landing.namePlaceholder': 'Hair consult LP',
+  'marketing.landing.route': 'Route',
+  'marketing.landing.create': 'Create page',
+  'marketing.landing.status': 'Does this page exist on the site yet?',
+  'marketing.landing.statusLive': 'Already live',
+  'marketing.landing.statusPlanned': 'Not yet',
+  'marketing.landing.prompt': 'Page prompt',
+  'marketing.landing.promptPlaceholder': 'Describe the page: offer, audience, sections, call to action…',
+  'marketing.landing.buildWithFayz': 'Build page with Fayz',
+  'marketing.landing.leadTag': 'Lead tags',
+  'marketing.landing.leadTagPlaceholder': 'new tag…',
+  'marketing.landing.leadTagHint': 'Leads from this page enter the CRM with these tags.',
+  'marketing.landing.visitsPending': 'Visits come from the platform hosting the site; that source is not connected yet.',
   // settings
   'marketing.settings.conversionModel': 'Conversion model',
   'marketing.settings.conversionModelDesc': "What counts as a conversion in this workspace and where it's attributed from.",

package/src/locales/pt-BR.ts

@@ -8,6 +8,7 @@ export const ptBR: Record<string, string> = {
   'marketing.metric.cvr': 'CVR',
   'marketing.metric.totalVisits': 'Total de visitas',
   'marketing.metric.pages': 'Páginas',
+  'marketing.metric.leads': 'Leads',
   'marketing.metric.avgConversion': 'Conversão média',
   // columns
   'marketing.col.campaign': 'Campanha',
@@ -22,6 +23,8 @@ export const ptBR: Record<string, string> = {
   'marketing.col.conversions': 'Conversões',
   'marketing.col.type': 'Tipo',
   'marketing.col.page': 'Página',
+  'marketing.col.route': 'Rota',
+  'marketing.col.leadTag': 'Tag',
   // overview
   'marketing.overview.byChannelSuffix': 'por canal',
   'marketing.overview.recent': 'Campanhas recentes',
@@ -53,7 +56,27 @@ export const ptBR: Record<string, string> = {
   'marketing.funnel.overall': 'Taxa de conversão geral',
   'marketing.funnel.ofPrev': 'do anterior',
   // landing pages
-  'marketing.landing.subtitle': 'Desempenho de visitas → conversões por página',
+  'marketing.landing.new': 'Nova página',
+  'marketing.landing.edit': 'Editar página',
+  'marketing.landing.delete': 'Excluir página',
+  'marketing.landing.save': 'Salvar',
+  'marketing.landing.empty': 'Nenhuma página cadastrada ainda.',
+  'marketing.landing.site': 'Site',
+  'marketing.landing.sitePlaceholder': 'Selecione o site',
+  'marketing.landing.name': 'Nome',
+  'marketing.landing.namePlaceholder': 'LP Capilar',
+  'marketing.landing.route': 'Rota',
+  'marketing.landing.create': 'Criar página',
+  'marketing.landing.status': 'Esta página já existe no site?',
+  'marketing.landing.statusLive': 'Já existe',
+  'marketing.landing.statusPlanned': 'Ainda não existe',
+  'marketing.landing.prompt': 'Prompt da página',
+  'marketing.landing.promptPlaceholder': 'Descreva a página: oferta, público, seções, chamada para ação…',
+  'marketing.landing.buildWithFayz': 'Criar página com Fayz',
+  'marketing.landing.leadTag': 'Tags dos leads',
+  'marketing.landing.leadTagPlaceholder': 'nova tag…',
+  'marketing.landing.leadTagHint': 'Os leads desta página entram no CRM com estas tags.',
+  'marketing.landing.visitsPending': 'As visitas vêm da plataforma que hospeda o site; essa origem ainda não está conectada.',
   // settings
   'marketing.settings.conversionModel': 'Modelo de conversão',
   'marketing.settings.conversionModelDesc': 'O que conta como conversão neste workspace e de onde é atribuída.',

package/src/migrations/008_landing_pages.sql

@@ -0,0 +1,112 @@
+-- Marketing Plugin: landing pages.
+-- Prefix: plg_marketing_
+-- A landing page IS a site plus a route (espacorenovario.com.br + /lp-capilar).
+-- The SITE is not modelled here: it is the tenant's fayz project
+-- (public.fayz_projects, @fayz-ai/db 020) — the same rows Settings → Sites
+-- manages — so `app_id` / `fayz_project_id` / `preview_url` come from there.
+-- Visit analytics are read from the platform that hosts the deploy (app id +
+-- route + period); that source is not wired yet, so visits render as pending.
+-- `lead_tags` is the cross with the CRM: leads that arrive through the page
+-- carry those tag slugs in people.tags (v_marketing_lead_tag_events counts them).
+-- `status`='planned' + `prompt` is a page that does NOT exist on the site yet:
+-- the brief is written here and the page gets built with Fayz later.
+-- Canonical RLS form: tenant_id IN (SELECT public.user_tenant_ids()).
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_landing_pages (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  site_id uuid NOT NULL REFERENCES public.fayz_projects(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  route text NOT NULL,
+  lead_tags text[] NOT NULL DEFAULT '{}',
+  status text NOT NULL DEFAULT 'live' CHECK (status IN ('live', 'planned')),
+  prompt text,
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+-- Self-healing for pools that ran an earlier cut of this migration (single
+-- lead_tag column, no status/prompt). No-op on a fresh table. The views are
+-- rebuilt at the bottom; dropping them first is what lets the column go.
+DROP VIEW IF EXISTS public.v_marketing_landing_pages;
+
+ALTER TABLE public.plg_marketing_landing_pages
+  ADD COLUMN IF NOT EXISTS lead_tags text[] NOT NULL DEFAULT '{}',
+  ADD COLUMN IF NOT EXISTS status text NOT NULL DEFAULT 'live',
+  ADD COLUMN IF NOT EXISTS prompt text;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'plg_marketing_landing_pages' AND column_name = 'lead_tag'
+  ) THEN
+    UPDATE public.plg_marketing_landing_pages
+       SET lead_tags = ARRAY[lead_tag]
+     WHERE lead_tag IS NOT NULL AND lead_tags = '{}';
+    ALTER TABLE public.plg_marketing_landing_pages DROP COLUMN lead_tag;
+  END IF;
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'plg_marketing_landing_pages_status_check'
+  ) THEN
+    ALTER TABLE public.plg_marketing_landing_pages
+      ADD CONSTRAINT plg_marketing_landing_pages_status_check CHECK (status IN ('live', 'planned'));
+  END IF;
+END $$;
+
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_landing_pages_tenant ON public.plg_marketing_landing_pages(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_landing_pages_site ON public.plg_marketing_landing_pages(site_id);
+-- One row per route within a site: the route IS the page's identity.
+CREATE UNIQUE INDEX IF NOT EXISTS u_plg_marketing_landing_pages_site_route
+  ON public.plg_marketing_landing_pages(site_id, route);
+
+DO $$
+DECLARE t text := 'plg_marketing_landing_pages';
+BEGIN
+  EXECUTE format('ALTER TABLE public.%I ENABLE ROW LEVEL SECURITY', t);
+  EXECUTE format('GRANT SELECT, INSERT, UPDATE, DELETE ON public.%I TO authenticated', t);
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_select') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_select', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_insert') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_insert', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_update') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_update', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_delete') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_delete', t);
+  END IF;
+END $$;
+
+-- Read view: the page joined to its site, so the surface renders the full URL
+-- (and the analytics keys) without a second round trip.
+CREATE VIEW public.v_marketing_landing_pages WITH (security_invoker=true) AS
+SELECT lp.id, lp.tenant_id, lp.site_id, lp.name, lp.route, lp.lead_tags, lp.status, lp.prompt, lp.is_active,
+       s.name AS site_name, s.preview_url AS site_url, s.app_id, s.fayz_project_id, s.editor_url,
+       lp.created_at, lp.updated_at
+FROM public.plg_marketing_landing_pages lp
+JOIN public.fayz_projects s ON s.id = lp.site_id;
+GRANT SELECT ON public.v_marketing_landing_pages TO authenticated;
+
+-- Lead events keyed by tag — the cross that turns "leads tagged lp-capilar"
+-- into that page's conversions. One row per (lead, tag); `person_id` is what
+-- keeps a lead carrying two of a page's tags from counting twice. Archived
+-- leads are OUT: plugin-crm archives by flipping people.is_active to false, and
+-- a page's number has to match what the funnel shows. Apps whose leads live
+-- elsewhere may CREATE OR REPLACE this view keeping the contract:
+--   (tenant_id uuid, tag text, person_id uuid, occurred_at timestamptz, value numeric)
+DROP VIEW IF EXISTS public.v_marketing_lead_tag_events;
+CREATE VIEW public.v_marketing_lead_tag_events WITH (security_invoker=true) AS
+SELECT p.tenant_id,
+       tag,
+       p.id AS person_id,
+       p.created_at AS occurred_at,
+       NULLIF(p.metadata->>'value', '')::numeric AS value
+FROM public.people p
+CROSS JOIN LATERAL unnest(COALESCE(p.tags, '{}'::text[])) AS tag
+WHERE p.kind = 'lead'
+  AND COALESCE(p.is_active, true);
+GRANT SELECT ON public.v_marketing_lead_tag_events TO authenticated;

package/src/migrations/index.ts

@@ -1,4 +1,4 @@
-// AUTO-GENERATED from 000_plg_rename.sql, 001_content_planner.sql, 002_multi_platform.sql, 003_recording_ops.sql, 004_ranklayer.sql, 005_analytics_base.sql, 006_analytics_views.sql, 007_agent_rpcs.sql — regenerate with scripts/embed-migrations.mjs
+// AUTO-GENERATED from 000_plg_rename.sql, 001_content_planner.sql, 002_multi_platform.sql, 003_recording_ops.sql, 004_ranklayer.sql, 005_analytics_base.sql, 006_analytics_views.sql, 007_agent_rpcs.sql, 008_landing_pages.sql — regenerate with scripts/embed-migrations.mjs
 // SQL files are the source of truth; this inline copy lets the manifest declare
 // migrations as data. Do not edit by hand — run the embed script instead.
 
@@ -474,6 +474,120 @@ GRANT EXECUTE ON FUNCTION public.agent_marketing_create_campaign(uuid, uuid, jso
   TO authenticated, service_role;
 `
 
+export const MIGRATION_008_LANDING_PAGES = `-- Marketing Plugin: landing pages.
+-- Prefix: plg_marketing_
+-- A landing page IS a site plus a route (espacorenovario.com.br + /lp-capilar).
+-- The SITE is not modelled here: it is the tenant's fayz project
+-- (public.fayz_projects, @fayz-ai/db 020) — the same rows Settings → Sites
+-- manages — so \`app_id\` / \`fayz_project_id\` / \`preview_url\` come from there.
+-- Visit analytics are read from the platform that hosts the deploy (app id +
+-- route + period); that source is not wired yet, so visits render as pending.
+-- \`lead_tags\` is the cross with the CRM: leads that arrive through the page
+-- carry those tag slugs in people.tags (v_marketing_lead_tag_events counts them).
+-- \`status\`='planned' + \`prompt\` is a page that does NOT exist on the site yet:
+-- the brief is written here and the page gets built with Fayz later.
+-- Canonical RLS form: tenant_id IN (SELECT public.user_tenant_ids()).
+
+CREATE TABLE IF NOT EXISTS public.plg_marketing_landing_pages (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  site_id uuid NOT NULL REFERENCES public.fayz_projects(id) ON DELETE CASCADE,
+  name text NOT NULL,
+  route text NOT NULL,
+  lead_tags text[] NOT NULL DEFAULT '{}',
+  status text NOT NULL DEFAULT 'live' CHECK (status IN ('live', 'planned')),
+  prompt text,
+  is_active boolean NOT NULL DEFAULT true,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+-- Self-healing for pools that ran an earlier cut of this migration (single
+-- lead_tag column, no status/prompt). No-op on a fresh table. The views are
+-- rebuilt at the bottom; dropping them first is what lets the column go.
+DROP VIEW IF EXISTS public.v_marketing_landing_pages;
+
+ALTER TABLE public.plg_marketing_landing_pages
+  ADD COLUMN IF NOT EXISTS lead_tags text[] NOT NULL DEFAULT '{}',
+  ADD COLUMN IF NOT EXISTS status text NOT NULL DEFAULT 'live',
+  ADD COLUMN IF NOT EXISTS prompt text;
+
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public' AND table_name = 'plg_marketing_landing_pages' AND column_name = 'lead_tag'
+  ) THEN
+    UPDATE public.plg_marketing_landing_pages
+       SET lead_tags = ARRAY[lead_tag]
+     WHERE lead_tag IS NOT NULL AND lead_tags = '{}';
+    ALTER TABLE public.plg_marketing_landing_pages DROP COLUMN lead_tag;
+  END IF;
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'plg_marketing_landing_pages_status_check'
+  ) THEN
+    ALTER TABLE public.plg_marketing_landing_pages
+      ADD CONSTRAINT plg_marketing_landing_pages_status_check CHECK (status IN ('live', 'planned'));
+  END IF;
+END $$;
+
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_landing_pages_tenant ON public.plg_marketing_landing_pages(tenant_id);
+CREATE INDEX IF NOT EXISTS idx_plg_marketing_landing_pages_site ON public.plg_marketing_landing_pages(site_id);
+-- One row per route within a site: the route IS the page's identity.
+CREATE UNIQUE INDEX IF NOT EXISTS u_plg_marketing_landing_pages_site_route
+  ON public.plg_marketing_landing_pages(site_id, route);
+
+DO $$
+DECLARE t text := 'plg_marketing_landing_pages';
+BEGIN
+  EXECUTE format('ALTER TABLE public.%I ENABLE ROW LEVEL SECURITY', t);
+  EXECUTE format('GRANT SELECT, INSERT, UPDATE, DELETE ON public.%I TO authenticated', t);
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_select') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_select', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_insert') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_insert', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_update') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_update', t);
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename=t AND policyname=t||'_delete') THEN
+    EXECUTE format('CREATE POLICY %I ON public.%I FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()))', t||'_delete', t);
+  END IF;
+END $$;
+
+-- Read view: the page joined to its site, so the surface renders the full URL
+-- (and the analytics keys) without a second round trip.
+CREATE VIEW public.v_marketing_landing_pages WITH (security_invoker=true) AS
+SELECT lp.id, lp.tenant_id, lp.site_id, lp.name, lp.route, lp.lead_tags, lp.status, lp.prompt, lp.is_active,
+       s.name AS site_name, s.preview_url AS site_url, s.app_id, s.fayz_project_id, s.editor_url,
+       lp.created_at, lp.updated_at
+FROM public.plg_marketing_landing_pages lp
+JOIN public.fayz_projects s ON s.id = lp.site_id;
+GRANT SELECT ON public.v_marketing_landing_pages TO authenticated;
+
+-- Lead events keyed by tag — the cross that turns "leads tagged lp-capilar"
+-- into that page's conversions. One row per (lead, tag); \`person_id\` is what
+-- keeps a lead carrying two of a page's tags from counting twice. Archived
+-- leads are OUT: plugin-crm archives by flipping people.is_active to false, and
+-- a page's number has to match what the funnel shows. Apps whose leads live
+-- elsewhere may CREATE OR REPLACE this view keeping the contract:
+--   (tenant_id uuid, tag text, person_id uuid, occurred_at timestamptz, value numeric)
+DROP VIEW IF EXISTS public.v_marketing_lead_tag_events;
+CREATE VIEW public.v_marketing_lead_tag_events WITH (security_invoker=true) AS
+SELECT p.tenant_id,
+       tag,
+       p.id AS person_id,
+       p.created_at AS occurred_at,
+       NULLIF(p.metadata->>'value', '')::numeric AS value
+FROM public.people p
+CROSS JOIN LATERAL unnest(COALESCE(p.tags, '{}'::text[])) AS tag
+WHERE p.kind = 'lead'
+  AND COALESCE(p.is_active, true);
+GRANT SELECT ON public.v_marketing_lead_tag_events TO authenticated;
+`
+
 export const MIGRATIONS: Array<{ id: string; sql: string }> = [
   { id: "000_plg_rename", sql: MIGRATION_000_PLG_RENAME },
   { id: "001_content_planner", sql: MIGRATION_001_CONTENT_PLANNER },
@@ -483,4 +597,5 @@ export const MIGRATIONS: Array<{ id: string; sql: string }> = [
   { id: "005_analytics_base", sql: MIGRATION_005_ANALYTICS_BASE },
   { id: "006_analytics_views", sql: MIGRATION_006_ANALYTICS_VIEWS },
   { id: "007_agent_rpcs", sql: MIGRATION_007_AGENT_RPCS },
+  { id: "008_landing_pages", sql: MIGRATION_008_LANDING_PAGES },
 ]

package/src/registries.ts

@@ -41,7 +41,9 @@ const channelEntity: EntityDef = {
 
 /** Build the marketing settings registries. Channels are tenant-editable rows
  *  in plg_marketing_channels; the Supabase provider lazily seeds them from the
- *  resolved domain preset (seedData doubles as walkable mock data). */
+ *  resolved domain preset (seedData doubles as walkable mock data). Sites are
+ *  NOT here on purpose: they are the tenant's fayz projects, managed by the
+ *  shell in Settings → Sites, and marketing only points a page at one. */
 export function buildMarketingRegistries(channels: AcquisitionChannel[]): PluginRegistryDef[] {
   return [
     {

package/src/store.ts

@@ -1,12 +1,14 @@
 import { createStore, type StoreApi } from 'zustand/vanilla'
-import type { MarketingDataProvider, SaveCampaignInput } from './data/types'
+import type { MarketingDataProvider, SaveCampaignInput, SaveLandingPageInput } from './data/types'
 import type {
   Campaign,
   ChannelPerformance,
   DateRangeKey,
   FunnelStage,
+  LandingPage,
   LandingPagePerf,
   MarketingOverview,
+  MarketingSite,
 } from './types'
 
 export interface MarketingUIState {
@@ -16,6 +18,8 @@ export interface MarketingUIState {
   campaigns: Campaign[]
   funnel: FunnelStage[]
   landingPages: LandingPagePerf[]
+  sites: MarketingSite[]
+  leadTags: Array<{ slug: string; name: string }>
   loading: boolean
 
   load(): Promise<void>
@@ -24,6 +28,8 @@ export interface MarketingUIState {
   setRange(range: DateRangeKey): Promise<void>
   saveCampaign(input: SaveCampaignInput): Promise<Campaign>
   deleteCampaign(id: string): Promise<void>
+  saveLandingPage(input: SaveLandingPageInput): Promise<LandingPage>
+  deleteLandingPage(id: string): Promise<void>
 }
 
 export function createMarketingStore(provider: MarketingDataProvider): StoreApi<MarketingUIState> {
@@ -34,20 +40,24 @@ export function createMarketingStore(provider: MarketingDataProvider): StoreApi<
     campaigns: [],
     funnel: [],
     landingPages: [],
+    sites: [],
+    leadTags: [],
     loading: false,
 
     async load() {
       const range = get().range
       set({ loading: true })
       try {
-        const [overview, channels, campaigns, funnel, landingPages] = await Promise.all([
+        const [overview, channels, campaigns, funnel, landingPages, sites, leadTags] = await Promise.all([
           provider.overview({ range }),
           provider.channelPerformance({ range }),
           provider.listCampaigns({ range }),
           provider.funnel({ range }),
           provider.landingPages({ range }),
+          provider.listSites(),
+          provider.listLeadTags(),
         ])
-        set({ overview, channels, campaigns, funnel, landingPages, loading: false })
+        set({ overview, channels, campaigns, funnel, landingPages, sites, leadTags, loading: false })
       } catch (err) {
         // A failed load must never wedge the surface in `loading` forever.
         set({ loading: false })
@@ -75,5 +85,18 @@ export function createMarketingStore(provider: MarketingDataProvider): StoreApi<
       await provider.deleteCampaign(id)
       await get().load()
     },
+
+    async saveLandingPage(input) {
+      const saved = await provider.saveLandingPage(input)
+      provider.invalidateCache?.()
+      await get().load()
+      return saved
+    },
+
+    async deleteLandingPage(id) {
+      await provider.deleteLandingPage(id)
+      provider.invalidateCache?.()
+      await get().load()
+    },
   }))
 }

package/src/types.ts

@@ -76,14 +76,53 @@ export interface FunnelStage {
   color: string
 }
 
-export interface LandingPagePerf {
+/** A site the tenant owns — a row of public.fayz_projects, managed in
+ *  Settings → Sites. `appId`/`fayzProjectId` are the deploy's ids on the
+ *  hosting platform: the keys the visit-analytics call needs (app + route +
+ *  period). Marketing reads these; it does not own them. */
+export interface MarketingSite {
   id: string
   name: string
-  type: 'Funnel' | 'Landing page' | 'Website'
-  visits: number
+  /** live site URL, e.g. 'https://espacorenovario.com.br' */
+  url?: string
+  appId?: string
+  fayzProjectId?: string
+  /** Fayz editor for this project — where a planned page gets built. */
+  editorUrl?: string
+}
+
+/** 'live' = the route already exists on the site. 'planned' = it does not yet;
+ *  `prompt` is the brief for building it with Fayz. */
+export type LandingPageStatus = 'live' | 'planned'
+
+/** A landing page IS a site + a route. `leadTags` is the CRM cross: leads that
+ *  come in through the page carry those tag slugs. */
+export interface LandingPage {
+  id: string
+  siteId: string
+  name: string
+  /** path within the site, always leading-slashed, e.g. '/lp-capilar' */
+  route: string
+  leadTags: string[]
+  status: LandingPageStatus
+  /** what the page should be — only meaningful while status is 'planned' */
+  prompt?: string
+  isActive: boolean
+}
+
+export interface LandingPagePerf extends LandingPage {
+  siteName: string
+  siteUrl?: string
+  appId?: string
+  editorUrl?: string
+  /** full public URL (site + route); the bare route when the site has no URL */
+  url: string
+  /** null while no visit source is connected — renders as "—", not as zero. */
+  visits: number | null
+  /** leads carrying `leadTag` within the queried period */
   conversions: number
-  /** conversions / visits * 100 */
-  cvr: number
+  /** conversions / visits * 100 — null when visits are unknown */
+  cvr: number | null
 }
 
 export interface MarketingOverview {