@fayz-ai/plugin-marketing 0.8.2 → 0.9.0-next.1

package/src/data/supabase.ts

@@ -3,6 +3,7 @@ import type {
   AttributionBridge,
   MarketingDataProvider,
   SaveCampaignInput,
+  SaveLandingPageInput,
   SitesPerformanceBridge,
 } from './types'
 import type {
@@ -12,11 +13,13 @@ import type {
   ConversionModel,
   DateRangeKey,
   FunnelStage,
+  LandingPage,
   LandingPagePerf,
   MarketingOverview,
   MarketingQuery,
+  MarketingSite,
 } from '../types'
-import { T, V } from './tables'
+import { LEAD_TAGS_SOURCE, SITES_TABLE, T, V } from './tables'
 
 // ---------------------------------------------------------------------------
 // Supabase marketing provider. Channels/campaigns are real CRUD rows
@@ -32,6 +35,8 @@ export interface SupabaseMarketingProviderOptions {
   conversion: ConversionModel
   attributionBridge?: AttributionBridge
   sitesBridge?: SitesPerformanceBridge
+  /** Where the lead-tag catalog is read from (defaults to plugin-crm's). */
+  leadTags?: { table?: string; valueField?: string; labelField?: string }
 }
 
 const RANGE_DAYS: Record<DateRangeKey, number> = { '7d': 7, '30d': 30, '90d': 90 }
@@ -54,6 +59,56 @@ function normKey(value: string | null | undefined): string {
   return (value ?? '').toLowerCase().replace(/[^a-z0-9]/g, '')
 }
 
+/** Fallback editor link when the project row has no explicit editor_url —
+ *  same convention the shell's "Seu site" widget uses. */
+const FAYZ_EDITOR_BASE = 'https://fayz.ai/editor'
+
+/** '/lp-capilar' ← 'lp-capilar' | 'lp-capilar/' | '' */
+function normalizeRoute(route: string): string {
+  const trimmed = route.trim().replace(/\/+$/, '')
+  if (!trimmed || trimmed === '/') return '/'
+  return trimmed.startsWith('/') ? trimmed : `/${trimmed}`
+}
+
+/** The site's URL is whatever the fayz project recorded (may be missing while
+ *  the deploy has no public URL yet) — then the page shows just its route. */
+function pageUrl(siteUrl: string | null | undefined, route: string): string {
+  const path = normalizeRoute(route)
+  if (!siteUrl) return path
+  const base = siteUrl.trim().replace(/\/+$/, '')
+  const withScheme = /^https?:\/\//.test(base) ? base : `https://${base}`
+  return `${withScheme}${path === '/' ? '' : path}`
+}
+
+function landingPageFromRow(row: Record<string, any>): LandingPage {
+  return {
+    id: row.id,
+    siteId: row.site_id,
+    name: row.name,
+    route: row.route,
+    leadTags: row.lead_tags ?? [],
+    status: row.status === 'planned' ? 'planned' : 'live',
+    prompt: row.prompt ?? undefined,
+    isActive: row.is_active !== false,
+  }
+}
+
+interface LandingPageRow {
+  id: string
+  site_id: string
+  name: string
+  route: string
+  lead_tags: string[] | null
+  status: string
+  prompt: string | null
+  is_active: boolean
+  site_name: string
+  site_url: string | null
+  app_id: string | null
+  fayz_project_id: string | null
+  editor_url: string | null
+}
+
 interface AttributionRow {
   kind: 'lead' | 'conversion'
   source: string
@@ -66,6 +121,7 @@ export function createSupabaseMarketingProvider(
   options: SupabaseMarketingProviderOptions,
 ): MarketingDataProvider {
   const { channels, conversion, attributionBridge, sitesBridge } = options
+  const leadTagsSource = { ...LEAD_TAGS_SOURCE, ...options.leadTags }
 
   const channelByNorm = new Map<string, string>()
   for (const ch of channels) {
@@ -237,6 +293,66 @@ export function createSupabaseMarketingProvider(
     return query.channelId ? list.filter((c) => c.channelId === query.channelId) : list
   }
 
+  function fetchLandingPages(tenantId: string): Promise<LandingPageRow[]> {
+    return memo(`lp:${tenantId}`, async () => {
+      const { data, error } = await getClient()
+        .from(V.landingPages)
+        .select('id, site_id, name, route, lead_tags, status, prompt, is_active, site_name, site_url, app_id, fayz_project_id, editor_url')
+        .eq('tenant_id', tenantId)
+        .order('name')
+      // A pool that hasn't run migration 008 has no view — that must cost the
+      // page its rows, not take the whole Marketing surface down with it.
+      if (error) return []
+      return (data ?? []) as LandingPageRow[]
+    })
+  }
+
+  /** Leads carrying each page's tags within the window — the CRM cross. Keyed
+   *  by tag → lead ids so a page with several tags counts each lead once. */
+  function fetchLeadsByTag(
+    tenantId: string,
+    tags: string[],
+    since: Date,
+  ): Promise<Map<string, Set<string>>> {
+    const key = `lptags:${tenantId}:${since.getTime()}:${tags.join(',')}`
+    return memo(key, async () => {
+      const { data, error } = await getClient()
+        .from(V.leadTagEvents)
+        .select('tag, person_id')
+        .eq('tenant_id', tenantId)
+        .in('tag', tags)
+        .gte('occurred_at', since.toISOString())
+      if (error) return new Map<string, Set<string>>()
+      const byTag = new Map<string, Set<string>>()
+      for (const row of data ?? []) {
+        const set = byTag.get(row.tag) ?? new Set<string>()
+        set.add(row.person_id)
+        byTag.set(row.tag, set)
+      }
+      return byTag
+    })
+  }
+
+  /** Visits come from wherever the site is deployed. No bridge ⇒ unknown, and
+   *  the surface says so instead of showing zeros. */
+  async function fetchVisits(
+    range: DateRangeKey,
+    rows: LandingPageRow[],
+  ): Promise<Map<string, number>> {
+    if (!sitesBridge) return new Map()
+    const result = await sitesBridge.visitsByRoute({
+      range,
+      pages: rows.map((r) => ({
+        id: r.id,
+        appId: r.app_id ?? undefined,
+        fayzProjectId: r.fayz_project_id ?? undefined,
+        siteUrl: r.site_url ?? undefined,
+        route: r.route,
+      })),
+    })
+    return new Map(result.map((r) => [r.id, r.visits]))
+  }
+
   function campaignFromRow(row: Record<string, any>): Campaign {
     return {
       id: row.id,
@@ -394,8 +510,104 @@ export function createSupabaseMarketingProvider(
     },
 
     async landingPages(query: MarketingQuery): Promise<LandingPagePerf[]> {
-      if (sitesBridge) return sitesBridge.landingPages(query)
-      return []
+      const tenantId = requireTenantId()
+      const { since } = windowFor(query.range)
+      const rows = await fetchLandingPages(tenantId)
+      if (!rows.length) return []
+
+      const tags = [...new Set(rows.flatMap((r) => r.lead_tags ?? []))]
+      const [leadsByTag, visitsById] = await Promise.all([
+        tags.length ? fetchLeadsByTag(tenantId, tags, since) : Promise.resolve(new Map<string, Set<string>>()),
+        fetchVisits(query.range, rows),
+      ])
+
+      return rows.map((r) => {
+        const visits = visitsById.get(r.id) ?? null
+        const leads = new Set<string>()
+        for (const tag of r.lead_tags ?? []) {
+          for (const personId of leadsByTag.get(tag) ?? []) leads.add(personId)
+        }
+        const conversions = leads.size
+        return {
+          ...landingPageFromRow(r),
+          siteName: r.site_name,
+          siteUrl: r.site_url ?? undefined,
+          appId: r.app_id ?? undefined,
+          editorUrl: r.editor_url ?? (r.fayz_project_id ? `${FAYZ_EDITOR_BASE}/${r.fayz_project_id}` : undefined),
+          url: pageUrl(r.site_url, r.route),
+          visits,
+          conversions,
+          cvr: visits && visits > 0 ? (conversions / visits) * 100 : null,
+        }
+      })
+    },
+
+    async saveLandingPage(input: SaveLandingPageInput): Promise<LandingPage> {
+      const tenantId = requireTenantId()
+      const payload = {
+        tenant_id: tenantId,
+        site_id: input.siteId,
+        name: input.name,
+        route: normalizeRoute(input.route),
+        lead_tags: input.leadTags ?? [],
+        status: input.status ?? 'live',
+        prompt: input.prompt?.trim() || null,
+        is_active: input.isActive ?? true,
+        updated_at: new Date().toISOString(),
+      }
+      const query = input.id
+        ? getClient().from(T.landingPages).update(payload).eq('id', input.id)
+        : getClient().from(T.landingPages).insert(payload)
+      const { data, error } = await query.select('*').single()
+      if (error) throw error
+      cache.clear()
+      return landingPageFromRow(data)
+    },
+
+    async deleteLandingPage(id: string): Promise<void> {
+      const { error } = await getClient().from(T.landingPages).delete().eq('id', id)
+      if (error) throw error
+      cache.clear()
+    },
+
+    async listSites(): Promise<MarketingSite[]> {
+      const tenantId = requireTenantId()
+      return memo(`sites:${tenantId}`, async () => {
+        // Owned by the shell (Settings → Sites); marketing just picks one.
+        const { data, error } = await getClient()
+          .from(SITES_TABLE)
+          .select('id, name, preview_url, app_id, fayz_project_id, editor_url')
+          .eq('tenant_id', tenantId)
+          .order('is_default', { ascending: false })
+          .order('name')
+        if (error) return []
+        return (data ?? []).map((r: any) => ({
+          id: r.id,
+          name: r.name,
+          url: r.preview_url ?? undefined,
+          appId: r.app_id ?? undefined,
+          fayzProjectId: r.fayz_project_id ?? undefined,
+          editorUrl: r.editor_url ?? (r.fayz_project_id ? `${FAYZ_EDITOR_BASE}/${r.fayz_project_id}` : undefined),
+        }))
+      })
+    },
+
+    async listLeadTags(): Promise<Array<{ slug: string; name: string }>> {
+      const tenantId = requireTenantId()
+      const { table, valueField, labelField } = leadTagsSource
+      return memo(`leadtags:${tenantId}`, async () => {
+        // The catalog belongs to another plugin — an app without it (or with a
+        // different tag store) must not break the landing-page form.
+        const { data, error } = await getClient()
+          .from(table)
+          .select(`${valueField}, ${labelField}`)
+          .eq('tenant_id', tenantId)
+          .order(labelField)
+        if (error) return []
+        return (data ?? [])
+          .map((r: any) => ({ slug: r[valueField] as string, name: (r[labelField] as string) ?? r[valueField] }))
+          .filter((tag: { slug: string }) => Boolean(tag.slug))
+      })
     },
   }
 }

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;