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

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 {

package/src/views/LandingPageComposer.tsx

@@ -0,0 +1,201 @@
+import React from 'react'
+import { Sparkles } from 'lucide-react'
+import {
+  Modal, ModalContent, ModalHeader, ModalTitle, ModalBody, ModalFooter,
+  Button, Input, Badge, SegmentedControl,
+  Select, SelectTrigger, SelectValue, SelectContent, SelectItem,
+} from '@fayz-ai/ui'
+import { useTranslation } from '@fayz-ai/core'
+import { useMarketingStore } from '../MarketingContext'
+import type { LandingPage, LandingPageStatus } from '../types'
+
+/** 'Consulta capilar' → 'consulta-capilar' — the shape CRM tag slugs take. */
+function slugify(value: string): string {
+  return value
+    .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+    .toLowerCase().trim()
+    .replace(/[^a-z0-9:]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+export function LandingPageComposer({
+  open, page, onClose,
+}: { open: boolean; page?: LandingPage | null; onClose: () => void }) {
+  const t = useTranslation()
+  const sites = useMarketingStore((s) => s.sites)
+  const leadTags = useMarketingStore((s) => s.leadTags)
+  const saveLandingPage = useMarketingStore((s) => s.saveLandingPage)
+
+  const [siteId, setSiteId] = React.useState('')
+  const [name, setName] = React.useState('')
+  const [route, setRoute] = React.useState('')
+  const [status, setStatus] = React.useState<LandingPageStatus>('live')
+  const [prompt, setPrompt] = React.useState('')
+  const [tags, setTags] = React.useState<string[]>([])
+  const [newTag, setNewTag] = React.useState('')
+  const [saving, setSaving] = React.useState(false)
+
+  React.useEffect(() => {
+    if (!open) return
+    setSiteId(page?.siteId ?? sites[0]?.id ?? '')
+    setName(page?.name ?? '')
+    setRoute(page?.route ?? '')
+    setStatus(page?.status ?? 'live')
+    setPrompt(page?.prompt ?? '')
+    setTags(page?.leadTags ?? [])
+    setNewTag('')
+  }, [open, page, sites])
+
+  const site = sites.find((s) => s.id === siteId)
+  const previewPath = route.trim() ? (route.trim().startsWith('/') ? route.trim() : `/${route.trim()}`) : ''
+
+  // The catalog plus whatever this page already carries: a slug used by a
+  // campaign before anyone curated the vocabulary is still a real tag.
+  const options = React.useMemo(() => {
+    const byslug = new Map(leadTags.map((tag) => [tag.slug, tag.name]))
+    for (const slug of tags) if (!byslug.has(slug)) byslug.set(slug, slug)
+    return [...byslug].map(([slug, label]) => ({ slug, label }))
+  }, [leadTags, tags])
+
+  function toggleTag(slug: string) {
+    setTags((current) => (current.includes(slug) ? current.filter((s) => s !== slug) : [...current, slug]))
+  }
+
+  function addTag() {
+    const slug = slugify(newTag)
+    if (!slug) return
+    setTags((current) => (current.includes(slug) ? current : [...current, slug]))
+    setNewTag('')
+  }
+
+  async function handleSave() {
+    if (!siteId || !name.trim() || !route.trim()) return
+    setSaving(true)
+    try {
+      await saveLandingPage({
+        id: page?.id,
+        siteId,
+        name: name.trim(),
+        route: route.trim(),
+        leadTags: tags,
+        status,
+        prompt: status === 'planned' ? prompt.trim() || undefined : undefined,
+      })
+      onClose()
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  return (
+    <Modal open={open} onOpenChange={(o) => { if (!o) onClose() }}>
+      <ModalContent size="md">
+        <ModalHeader>
+          <ModalTitle>{page ? t('marketing.landing.edit') : t('marketing.landing.new')}</ModalTitle>
+        </ModalHeader>
+        <ModalBody className="space-y-4">
+          <label className="block space-y-1.5">
+            <span className="text-sm font-medium text-foreground">{t('marketing.landing.site')}</span>
+            <Select value={siteId} onValueChange={setSiteId}>
+              <SelectTrigger><SelectValue placeholder={t('marketing.landing.sitePlaceholder')} /></SelectTrigger>
+              <SelectContent>
+                {sites.map((s) => (
+                  <SelectItem key={s.id} value={s.id}>
+                    {s.url ? `${s.name} · ${s.url.replace(/^https?:\/\//, '')}` : s.name}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          </label>
+
+          <label className="block space-y-1.5">
+            <span className="text-sm font-medium text-foreground">{t('marketing.landing.name')}</span>
+            <Input value={name} onChange={(e) => setName(e.target.value)} placeholder={t('marketing.landing.namePlaceholder')} />
+          </label>
+
+          <label className="block space-y-1.5">
+            <span className="text-sm font-medium text-foreground">{t('marketing.landing.route')}</span>
+            <Input value={route} onChange={(e) => setRoute(e.target.value)} placeholder="/lp-capilar" />
+            {site?.url && previewPath ? (
+              <span className="block text-xs text-muted-foreground">
+                {site.url.replace(/\/+$/, '')}{previewPath}
+              </span>
+            ) : null}
+          </label>
+
+          <div className="space-y-1.5">
+            <span className="text-sm font-medium text-foreground">{t('marketing.landing.status')}</span>
+            <SegmentedControl
+              value={status}
+              onChange={(v) => setStatus(v as LandingPageStatus)}
+              options={[
+                { value: 'live', label: t('marketing.landing.statusLive') },
+                { value: 'planned', label: t('marketing.landing.statusPlanned') },
+              ]}
+            />
+          </div>
+
+          {status === 'planned' ? (
+            <div className="space-y-1.5">
+              <div className="flex items-center justify-between gap-2">
+                <span className="text-sm font-medium text-foreground">{t('marketing.landing.prompt')}</span>
+                {site?.editorUrl ? (
+                  <button
+                    type="button"
+                    onClick={() => window.open(site.editorUrl!, '_blank', 'noopener,noreferrer')}
+                    className="inline-flex items-center gap-1 text-xs font-medium text-primary hover:underline"
+                  >
+                    <Sparkles className="h-3.5 w-3.5" /> {t('marketing.landing.buildWithFayz')}
+                  </button>
+                ) : null}
+              </div>
+              <textarea
+                value={prompt}
+                onChange={(e) => setPrompt(e.target.value)}
+                rows={3}
+                placeholder={t('marketing.landing.promptPlaceholder')}
+                className="w-full rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground outline-none focus:ring-2 focus:ring-ring"
+              />
+            </div>
+          ) : null}
+
+          {/* One field, not a chip list plus a form: the catalog and the free
+              slug live in the same box, like any tag picker. */}
+          <div className="space-y-1.5">
+            <span className="text-sm font-medium text-foreground">{t('marketing.landing.leadTag')}</span>
+            <div className="flex flex-wrap items-center gap-1.5 rounded-md border border-border bg-background px-2 py-2 focus-within:ring-2 focus-within:ring-ring">
+              {options.map((opt) => {
+                const active = tags.includes(opt.slug)
+                return (
+                  <Badge
+                    key={opt.slug}
+                    variant={active ? 'default' : 'outline'}
+                    className="cursor-pointer text-xs"
+                    onClick={() => toggleTag(opt.slug)}
+                  >
+                    {opt.label}
+                  </Badge>
+                )
+              })}
+              <input
+                value={newTag}
+                onChange={(e) => setNewTag(e.target.value)}
+                onKeyDown={(e) => { if (e.key === 'Enter') { e.preventDefault(); addTag() } }}
+                onBlur={addTag}
+                placeholder={t('marketing.landing.leadTagPlaceholder')}
+                className="min-w-[8rem] flex-1 border-0 bg-transparent px-1 text-xs text-foreground outline-none placeholder:text-muted-foreground"
+              />
+            </div>
+            <span className="block text-xs text-muted-foreground">{t('marketing.landing.leadTagHint')}</span>
+          </div>
+        </ModalBody>
+        <ModalFooter>
+          <Button variant="outline" onClick={onClose}>{t('marketing.composer.cancel')}</Button>
+          <Button onClick={handleSave} disabled={saving || !siteId || !name.trim() || !route.trim()}>
+            {page ? t('marketing.landing.save') : t('marketing.landing.create')}
+          </Button>
+        </ModalFooter>
+      </ModalContent>
+    </Modal>
+  )
+}