@fayz-ai/db 0.18.2 → 0.20.0

package/migrations/140_a_unidade_se_escreve_pela_mesma_porta_que_se_le.sql

@@ -0,0 +1,130 @@
+-- ============================================================================
+-- 140 — a unidade se escreve pela mesma porta por onde se lê
+--
+-- `v_units` é a ponte pública de `app.units`: a tela de unidades LÊ tudo por
+-- ela — nome, tipo, telefone, cidade, código, lat/lng — porque `app.units`
+-- guarda o endereço em `metadata` e o PostgREST não alcança o schema `app`.
+--
+-- Escrever, não. A view é auto-atualizável só nas colunas que são referência
+-- simples (name, parent_id, is_active, metadata); `kind` é um
+-- `coalesce(metadata->>'legacy_kind', kind)` e `is_headquarters` é um
+-- `kind = 'hq'` — expressões, e o Postgres recusa:
+--
+--     cannot update column "kind" of view "v_units"
+--
+-- O CRUD genérico manda o formulário inteiro num UPDATE só, então TROCAR O
+-- NOME de uma unidade falhava por causa do campo ao lado. E o mesmo valia para
+-- telefone, cidade, código e coordenadas: escrever qualquer um deles pedia uma
+-- RPC que nunca existiu (só `unit_create`, e só para criar).
+--
+-- O gatilho INSTEAD OF fecha o círculo: a view passa a aceitar a MESMA forma
+-- que devolve, e a tradução para `app.units` + `metadata` mora no banco, ao
+-- lado da tradução de leitura, em vez de virar um caso especial no cliente.
+--
+-- SEM `security definer`, de propósito: a função roda como quem chamou, e a RLS
+-- de `app.units` (units.manage) continua sendo a cerca. A view só deixou de
+-- mentir sobre o que aceita; ela não ganhou permissão nenhuma.
+--
+-- `kind` tem duas casas porque `app.units.kind` só admite hq|branch: 'region'
+-- — que agrupa unidades e onde ninguém trabalha — mora em
+-- `metadata->>'legacy_kind'`, e é isso que a leitura já coalescia.
+-- ============================================================================
+
+CREATE OR REPLACE FUNCTION app.trg_v_units_write() RETURNS trigger
+  LANGUAGE plpgsql
+  SET search_path TO ''
+AS $$
+DECLARE
+  -- As chaves de `metadata` que ESTA view governa. Apagadas antes da mesclagem
+  -- para que limpar um campo na tela apague a chave, em vez de gravar "" —
+  -- `metadata->>'city'` devolvendo string vazia é pior que devolvendo NULL.
+  k_managed  constant text[] := ARRAY['email','phone','address','city','state','country',
+                                      'postal_code','notes','code','latitude','longitude','created_by'];
+  v_meta     jsonb;
+  v_overlay  jsonb;
+  v_kind     text;
+  v_legacy   text;
+  v_tenant   uuid;
+  v_id       uuid;
+BEGIN
+  IF TG_OP = 'DELETE' THEN
+    DELETE FROM app.units u WHERE u.id = OLD.id;
+    RETURN OLD;
+  END IF;
+
+  -- Num UPDATE parcial o Postgres preenche NEW com a linha antiga, então o que
+  -- ninguém tocou é reescrito igual. É por isso que a base é NEW.metadata: ela
+  -- já É a metadata antiga quando o cliente não mandou nenhuma.
+  v_meta := coalesce(NEW.metadata, '{}'::jsonb);
+
+  -- 'hq' não é um tipo que se escolhe na lista: é o interruptor "matriz". Um
+  -- valor fora de hq|branch (hoje 'region') não cabe na coluna e vai para
+  -- legacy_kind, que é de onde a leitura o tira.
+  v_legacy := nullif(btrim(coalesce(NEW.kind, '')), '');
+  IF coalesce(NEW.is_headquarters, false) OR v_legacy = 'hq' THEN
+    v_kind := 'hq';
+  ELSE
+    v_kind := 'branch';
+  END IF;
+  IF v_legacy IN ('hq', 'branch') OR v_legacy IS NULL THEN v_legacy := NULL; END IF;
+
+  v_overlay := jsonb_strip_nulls(jsonb_build_object(
+    'email',       nullif(btrim(coalesce(NEW.email, '')), ''),
+    'phone',       nullif(btrim(coalesce(NEW.phone, '')), ''),
+    'address',     nullif(btrim(coalesce(NEW.address, '')), ''),
+    'city',        nullif(btrim(coalesce(NEW.city, '')), ''),
+    'state',       nullif(btrim(coalesce(NEW.state, '')), ''),
+    'country',     nullif(btrim(coalesce(NEW.country, '')), ''),
+    'postal_code', nullif(btrim(coalesce(NEW.postal_code, '')), ''),
+    'notes',       nullif(btrim(coalesce(NEW.notes, '')), ''),
+    'code',        nullif(btrim(coalesce(NEW.code, '')), ''),
+    'latitude',    CASE WHEN NEW.latitude  IS NULL THEN NULL ELSE NEW.latitude::text  END,
+    'longitude',   CASE WHEN NEW.longitude IS NULL THEN NULL ELSE NEW.longitude::text END,
+    'created_by',  CASE WHEN NEW.created_by IS NULL THEN NULL ELSE NEW.created_by::text END
+  ));
+
+  v_meta := (v_meta - k_managed) || v_overlay;
+
+  IF v_legacy IS NULL THEN v_meta := v_meta - 'legacy_kind';
+  ELSE v_meta := jsonb_set(v_meta, '{legacy_kind}', to_jsonb(v_legacy)); END IF;
+
+  IF NEW.tags IS NULL OR cardinality(NEW.tags) = 0 THEN v_meta := v_meta - 'tags';
+  ELSE v_meta := jsonb_set(v_meta, '{tags}', to_jsonb(NEW.tags)); END IF;
+
+  IF NEW.custom_fields IS NULL OR NEW.custom_fields = '{}'::jsonb THEN v_meta := v_meta - 'custom_fields';
+  ELSE v_meta := jsonb_set(v_meta, '{custom_fields}', NEW.custom_fields); END IF;
+
+  IF TG_OP = 'INSERT' THEN
+    v_tenant := coalesce(NEW.tenant_id, app.current_tenant_id());
+    INSERT INTO app.units (id, tenant_id, kind, name, parent_unit_id, active, metadata)
+    VALUES (coalesce(NEW.id, gen_random_uuid()), v_tenant, v_kind, btrim(NEW.name),
+            NEW.parent_id, coalesce(NEW.is_active, true), v_meta)
+    RETURNING id INTO v_id;
+  ELSE
+    UPDATE app.units u
+       SET kind = v_kind,
+           name = btrim(NEW.name),
+           parent_unit_id = NEW.parent_id,
+           active = coalesce(NEW.is_active, true),
+           metadata = v_meta,
+           updated_at = now()
+     WHERE u.id = OLD.id
+    RETURNING u.id INTO v_id;
+    IF v_id IS NULL THEN
+      RAISE EXCEPTION 'v_units: unit % not found or not yours to change', OLD.id USING ERRCODE = '42501';
+    END IF;
+  END IF;
+
+  -- O RETURNING do cliente lê a VIEW de novo; devolver NEW cru daria a ele os
+  -- valores que ele mandou, e não os que o banco guardou.
+  SELECT * INTO NEW FROM public.v_units WHERE id = v_id;
+  RETURN NEW;
+END $$;
+
+COMMENT ON FUNCTION app.trg_v_units_write() IS
+  'Escreve v_units em app.units: kind fora de hq|branch vai para metadata.legacy_kind, o endereço vai para metadata (140).';
+
+DROP TRIGGER IF EXISTS v_units_write ON public.v_units;
+CREATE TRIGGER v_units_write
+  INSTEAD OF INSERT OR UPDATE OR DELETE ON public.v_units
+  FOR EACH ROW EXECUTE FUNCTION app.trg_v_units_write();

package/migrations/141_o_endereco_da_unidade_mora_na_tabela_de_enderecos.sql

@@ -0,0 +1,203 @@
+-- ============================================================================
+-- 141 — o endereço da unidade mora na tabela de endereços
+--
+-- A unidade guardava o endereço em cinco chaves planas de `metadata`
+-- (address, city, state, country, postal_code), e endereço já é uma TABELA:
+-- `public.addresses`, a mesma da ficha da pessoa, que sempre aceitou
+-- `owner_type = 'unit'` — havia inclusive linha gravada assim.
+--
+-- Duas verdades para a mesma coisa cobram o preço de sempre. Uma conta migrada
+-- do V1 escreveu em `metadata.address` o objeto INTEIRO serializado, e a tela
+-- de unidade mostrava, dentro de um input de uma linha:
+--
+--     {"city": "Rio de Janeiro", "state": "RJ", "number": "60", "street": ...}
+--
+-- Aqui a view passa a LER o endereço de `public.addresses` e o gatilho de
+-- escrita (140) para de tocar naquelas cinco chaves. O formulário ganha o
+-- mesmo bloco da pessoa — com CEP que consulta sozinho, número, complemento e
+-- bairro —, limitado a UM: uma loja tem um endereço.
+--
+-- Uma unidade, um endereço: a linha nasce `kind = 'main'` e padrão, e
+-- `addresses_one_default_idx` (UNIQUE em owner_type, owner_id, kind WHERE
+-- is_default) é quem garante que não apareça um segundo.
+-- ============================================================================
+
+-- ── 1. o que estava em metadata vira linha ──────────────────────────────────
+-- Dois formatos no mesmo campo: o objeto serializado que o porte do V1 deixou,
+-- e a string simples de quem digitou na tela. `jsonb_typeof` separa os dois —
+-- e um texto que não é JSON faria o cast estourar, então ele é tentado dentro
+-- de um bloco que devolve NULL em vez de derrubar a migration.
+CREATE OR REPLACE FUNCTION app.parse_legacy_address(p_raw text) RETURNS jsonb
+  LANGUAGE plpgsql IMMUTABLE
+  SET search_path TO ''
+AS $$
+DECLARE v jsonb;
+BEGIN
+  IF p_raw IS NULL OR btrim(p_raw) = '' THEN RETURN NULL; END IF;
+  BEGIN v := p_raw::jsonb; EXCEPTION WHEN OTHERS THEN RETURN NULL; END;
+  IF jsonb_typeof(v) <> 'object' THEN RETURN NULL; END IF;
+  RETURN v;
+END $$;
+
+INSERT INTO public.addresses
+  (tenant_id, owner_type, owner_id, kind, postal_code, street, number, complement, district, city, state, country, is_default, metadata)
+SELECT u.tenant_id, 'unit', u.id, 'main',
+       p.postal_code, p.street, p.number, p.complement, p.district, p.city, p.state,
+       coalesce(nullif(btrim(coalesce(u.metadata ->> 'country', '')), ''), 'BR'),
+       true,
+       jsonb_build_object('backfilled_from', 'app.units.metadata')
+  FROM app.units u
+  CROSS JOIN LATERAL (
+    SELECT j,
+           coalesce(nullif(btrim(coalesce(j ->> 'postal_code', u.metadata ->> 'postal_code', '')), ''), '')            AS postal_code,
+           -- Sem objeto, o campo plano JÁ É a rua. Com objeto, a rua é a chave
+           -- `street` — e nunca o objeto inteiro, que é como 52 unidades
+           -- ganharam uma linha vazia na primeira volta desta migration.
+           coalesce(nullif(btrim(coalesce(j ->> 'street',
+             CASE WHEN j IS NULL THEN u.metadata ->> 'address' END, '')), ''), '')                                     AS street,
+           nullif(btrim(coalesce(j ->> 'number', '')), '')                                                            AS number,
+           nullif(btrim(coalesce(j ->> 'complement', '')), '')                                                        AS complement,
+           nullif(btrim(coalesce(j ->> 'neighborhood', j ->> 'district', '')), '')                                    AS district,
+           coalesce(nullif(btrim(coalesce(j ->> 'city', u.metadata ->> 'city', '')), ''), '')                          AS city,
+           coalesce(nullif(btrim(coalesce(j ->> 'state', u.metadata ->> 'state', '')), ''), '')                        AS state
+      FROM (SELECT app.parse_legacy_address(u.metadata ->> 'address') AS j) q
+  ) p
+ WHERE NOT EXISTS (
+         SELECT 1 FROM public.addresses a WHERE a.owner_type = 'unit' AND a.owner_id = u.id)
+   -- Só quem tem o que migrar. O porte do V1 deixou objetos com TODAS as
+   -- chaves nulas; uma linha vazia para eles seria endereço inventado.
+   AND (p.street <> '' OR p.city <> '');
+
+-- ── 2. a view lê o endereço de onde ele mora ────────────────────────────────
+CREATE OR REPLACE VIEW public.v_units WITH (security_invoker='true') AS
+ SELECT u.id,
+        u.tenant_id,
+        coalesce(u.metadata ->> 'legacy_kind', u.kind) AS kind,
+        u.name,
+        u.metadata ->> 'email'         AS email,
+        u.metadata ->> 'phone'         AS phone,
+        -- A linha da rua como uma lista a mostra: "Rua X, 60". O número é
+        -- coluna própria em `addresses` e não se perde ao voltar para cá.
+        nullif(btrim(coalesce(a.street, '') ||
+               CASE WHEN nullif(btrim(coalesce(a.number, '')), '') IS NULL
+                    THEN '' ELSE ', ' || btrim(a.number) END), '') AS address,
+        a.city,
+        a.state,
+        coalesce(a.country, u.metadata ->> 'country', 'BR') AS country,
+        a.postal_code,
+        (u.kind = 'hq')                AS is_headquarters,
+        u.active                       AS is_active,
+        coalesce((SELECT array_agg(t) FROM jsonb_array_elements_text(
+                   CASE WHEN jsonb_typeof(u.metadata -> 'tags') = 'array'
+                        THEN u.metadata -> 'tags' ELSE '[]'::jsonb END) t), '{}'::text[]) AS tags,
+        u.metadata ->> 'notes'         AS notes,
+        u.metadata,
+        CASE WHEN jsonb_typeof(u.metadata -> 'custom_fields') = 'object'
+             THEN u.metadata -> 'custom_fields' ELSE '{}'::jsonb END AS custom_fields,
+        CASE WHEN u.metadata ->> 'created_by' ~* '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'
+             THEN (u.metadata ->> 'created_by')::uuid END AS created_by,
+        u.created_at,
+        u.updated_at,
+        u.parent_unit_id               AS parent_id,
+        u.metadata ->> 'code'          AS code,
+        CASE WHEN u.metadata ->> 'latitude'  ~ '^-?[0-9]+(\.[0-9]+)?$'
+             THEN (u.metadata ->> 'latitude')::numeric  END AS latitude,
+        CASE WHEN u.metadata ->> 'longitude' ~ '^-?[0-9]+(\.[0-9]+)?$'
+             THEN (u.metadata ->> 'longitude')::numeric END AS longitude
+   FROM app.units u
+   -- LEFT: uma unidade sem endereço continua aparecendo na lista. Um JOIN
+   -- comum a faria sumir da tela por não ter CEP.
+   LEFT JOIN LATERAL (
+     SELECT x.* FROM public.addresses x
+      WHERE x.owner_type = 'unit' AND x.owner_id = u.id
+      ORDER BY x.is_default DESC, x.created_at
+      LIMIT 1
+   ) a ON true;
+
+COMMENT ON VIEW public.v_units IS
+  'Units in the shape the units screen reads (#214), com o endereço vindo de public.addresses (141).';
+
+-- ── 3. quem escreve o endereço é a tabela de endereços ──────────────────────
+CREATE OR REPLACE FUNCTION app.trg_v_units_write() RETURNS trigger
+  LANGUAGE plpgsql
+  SET search_path TO ''
+AS $$
+DECLARE
+  -- O endereço saiu desta lista (141): as colunas de endereço da view agora são
+  -- LEITURA de public.addresses, e aceitá-las aqui recriaria a segunda verdade.
+  -- Telefone, e-mail, código e coordenadas continuam sendo da unidade.
+  k_managed  constant text[] := ARRAY['email','phone','notes','code','latitude','longitude','created_by'];
+  v_meta     jsonb;
+  v_overlay  jsonb;
+  v_kind     text;
+  v_legacy   text;
+  v_tenant   uuid;
+  v_id       uuid;
+BEGIN
+  IF TG_OP = 'DELETE' THEN
+    DELETE FROM public.addresses a WHERE a.owner_type = 'unit' AND a.owner_id = OLD.id;
+    DELETE FROM app.units u WHERE u.id = OLD.id;
+    RETURN OLD;
+  END IF;
+
+  v_meta := coalesce(NEW.metadata, '{}'::jsonb);
+
+  v_legacy := nullif(btrim(coalesce(NEW.kind, '')), '');
+  IF coalesce(NEW.is_headquarters, false) OR v_legacy = 'hq' THEN
+    v_kind := 'hq';
+  ELSE
+    v_kind := 'branch';
+  END IF;
+  IF v_legacy IN ('hq', 'branch') OR v_legacy IS NULL THEN v_legacy := NULL; END IF;
+
+  v_overlay := jsonb_strip_nulls(jsonb_build_object(
+    'email',      nullif(btrim(coalesce(NEW.email, '')), ''),
+    'phone',      nullif(btrim(coalesce(NEW.phone, '')), ''),
+    'notes',      nullif(btrim(coalesce(NEW.notes, '')), ''),
+    'code',       nullif(btrim(coalesce(NEW.code, '')), ''),
+    'latitude',   CASE WHEN NEW.latitude  IS NULL THEN NULL ELSE NEW.latitude::text  END,
+    'longitude',  CASE WHEN NEW.longitude IS NULL THEN NULL ELSE NEW.longitude::text END,
+    'created_by', CASE WHEN NEW.created_by IS NULL THEN NULL ELSE NEW.created_by::text END
+  ));
+
+  -- As cinco chaves velhas de endereço saem de vez: elas já viraram linha em
+  -- public.addresses, e deixá-las no metadata seria guardar uma cópia que
+  -- ninguém mais atualiza.
+  v_meta := (v_meta - k_managed - ARRAY['address','city','state','country','postal_code']) || v_overlay;
+
+  IF v_legacy IS NULL THEN v_meta := v_meta - 'legacy_kind';
+  ELSE v_meta := jsonb_set(v_meta, '{legacy_kind}', to_jsonb(v_legacy)); END IF;
+
+  IF NEW.tags IS NULL OR cardinality(NEW.tags) = 0 THEN v_meta := v_meta - 'tags';
+  ELSE v_meta := jsonb_set(v_meta, '{tags}', to_jsonb(NEW.tags)); END IF;
+
+  IF NEW.custom_fields IS NULL OR NEW.custom_fields = '{}'::jsonb THEN v_meta := v_meta - 'custom_fields';
+  ELSE v_meta := jsonb_set(v_meta, '{custom_fields}', NEW.custom_fields); END IF;
+
+  IF TG_OP = 'INSERT' THEN
+    v_tenant := coalesce(NEW.tenant_id, app.current_tenant_id());
+    INSERT INTO app.units (id, tenant_id, kind, name, parent_unit_id, active, metadata)
+    VALUES (coalesce(NEW.id, gen_random_uuid()), v_tenant, v_kind, btrim(NEW.name),
+            NEW.parent_id, coalesce(NEW.is_active, true), v_meta)
+    RETURNING id INTO v_id;
+  ELSE
+    UPDATE app.units u
+       SET kind = v_kind,
+           name = btrim(NEW.name),
+           parent_unit_id = NEW.parent_id,
+           active = coalesce(NEW.is_active, true),
+           metadata = v_meta,
+           updated_at = now()
+     WHERE u.id = OLD.id
+    RETURNING u.id INTO v_id;
+    IF v_id IS NULL THEN
+      RAISE EXCEPTION 'v_units: unit % not found or not yours to change', OLD.id USING ERRCODE = '42501';
+    END IF;
+  END IF;
+
+  SELECT * INTO NEW FROM public.v_units WHERE id = v_id;
+  RETURN NEW;
+END $$;
+
+COMMENT ON FUNCTION app.trg_v_units_write() IS
+  'Escreve v_units em app.units; o endereço é de public.addresses e não passa por aqui (141).';

package/migrations/142_a_coordenada_e_do_endereco_nao_da_unidade.sql

@@ -0,0 +1,157 @@
+-- ============================================================================
+-- 142 — a coordenada é do endereço, não da unidade
+--
+-- Latitude e longitude ficaram no `metadata` da unidade quando o endereço saiu
+-- de lá (141), e não é ali que elas moram: um par de coordenadas é a POSIÇÃO
+-- DE UM ENDEREÇO. Separadas dele, a primeira mudança de rua deixa o ponteiro
+-- apontando para a loja antiga — e nada no banco reclama.
+--
+-- E o mesmo par serve a quem não é unidade: o endereço de entrega de um
+-- cliente quer coordenada pelo mesmo motivo que a loja quer.
+--
+-- A view continua publicando `latitude`/`longitude` — quem sugere "a unidade
+-- mais perto de mim" lê de lá —, só que agora tirando-as da linha de endereço.
+-- ============================================================================
+
+ALTER TABLE public.addresses
+  ADD COLUMN IF NOT EXISTS latitude  numeric,
+  ADD COLUMN IF NOT EXISTS longitude numeric;
+
+COMMENT ON COLUMN public.addresses.latitude IS
+  'Opcional. Só junto de longitude — meia coordenada não localiza nada (142).';
+
+-- O que estava na unidade vai para a linha de endereço dela. Cast guardado: o
+-- valor veio de um campo de texto e uma string torta derrubaria a migration.
+UPDATE public.addresses a
+   SET latitude  = (u.metadata ->> 'latitude')::numeric,
+       longitude = (u.metadata ->> 'longitude')::numeric
+  FROM app.units u
+ WHERE a.owner_type = 'unit' AND a.owner_id = u.id
+   AND a.latitude IS NULL AND a.longitude IS NULL
+   AND u.metadata ->> 'latitude'  ~ '^-?[0-9]+(\.[0-9]+)?$'
+   AND u.metadata ->> 'longitude' ~ '^-?[0-9]+(\.[0-9]+)?$';
+
+UPDATE app.units u
+   SET metadata = u.metadata - 'latitude' - 'longitude'
+ WHERE u.metadata ? 'latitude' OR u.metadata ? 'longitude';
+
+CREATE OR REPLACE VIEW public.v_units WITH (security_invoker='true') AS
+ SELECT u.id,
+        u.tenant_id,
+        coalesce(u.metadata ->> 'legacy_kind', u.kind) AS kind,
+        u.name,
+        u.metadata ->> 'email'         AS email,
+        u.metadata ->> 'phone'         AS phone,
+        nullif(btrim(coalesce(a.street, '') ||
+               CASE WHEN nullif(btrim(coalesce(a.number, '')), '') IS NULL
+                    THEN '' ELSE ', ' || btrim(a.number) END), '') AS address,
+        a.city,
+        a.state,
+        coalesce(a.country, 'BR')      AS country,
+        a.postal_code,
+        (u.kind = 'hq')                AS is_headquarters,
+        u.active                       AS is_active,
+        coalesce((SELECT array_agg(t) FROM jsonb_array_elements_text(
+                   CASE WHEN jsonb_typeof(u.metadata -> 'tags') = 'array'
+                        THEN u.metadata -> 'tags' ELSE '[]'::jsonb END) t), '{}'::text[]) AS tags,
+        u.metadata ->> 'notes'         AS notes,
+        u.metadata,
+        CASE WHEN jsonb_typeof(u.metadata -> 'custom_fields') = 'object'
+             THEN u.metadata -> 'custom_fields' ELSE '{}'::jsonb END AS custom_fields,
+        CASE WHEN u.metadata ->> 'created_by' ~* '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'
+             THEN (u.metadata ->> 'created_by')::uuid END AS created_by,
+        u.created_at,
+        u.updated_at,
+        u.parent_unit_id               AS parent_id,
+        u.metadata ->> 'code'          AS code,
+        a.latitude,
+        a.longitude
+   FROM app.units u
+   LEFT JOIN LATERAL (
+     SELECT x.* FROM public.addresses x
+      WHERE x.owner_type = 'unit' AND x.owner_id = u.id
+      ORDER BY x.is_default DESC, x.created_at
+      LIMIT 1
+   ) a ON true;
+
+COMMENT ON VIEW public.v_units IS
+  'Units in the shape the units screen reads (#214); endereço e coordenada vêm de public.addresses (141, 142).';
+
+CREATE OR REPLACE FUNCTION app.trg_v_units_write() RETURNS trigger
+  LANGUAGE plpgsql
+  SET search_path TO ''
+AS $$
+DECLARE
+  -- Endereço (141) e coordenada (142) saíram daqui: são colunas de
+  -- public.addresses, e aceitá-las recriaria a segunda verdade.
+  k_managed  constant text[] := ARRAY['email','phone','notes','code','created_by'];
+  k_moved    constant text[] := ARRAY['address','city','state','country','postal_code','latitude','longitude'];
+  v_meta     jsonb;
+  v_overlay  jsonb;
+  v_kind     text;
+  v_legacy   text;
+  v_tenant   uuid;
+  v_id       uuid;
+BEGIN
+  IF TG_OP = 'DELETE' THEN
+    DELETE FROM public.addresses a WHERE a.owner_type = 'unit' AND a.owner_id = OLD.id;
+    DELETE FROM app.units u WHERE u.id = OLD.id;
+    RETURN OLD;
+  END IF;
+
+  v_meta := coalesce(NEW.metadata, '{}'::jsonb);
+
+  v_legacy := nullif(btrim(coalesce(NEW.kind, '')), '');
+  IF coalesce(NEW.is_headquarters, false) OR v_legacy = 'hq' THEN
+    v_kind := 'hq';
+  ELSE
+    v_kind := 'branch';
+  END IF;
+  IF v_legacy IN ('hq', 'branch') OR v_legacy IS NULL THEN v_legacy := NULL; END IF;
+
+  v_overlay := jsonb_strip_nulls(jsonb_build_object(
+    'email',      nullif(btrim(coalesce(NEW.email, '')), ''),
+    'phone',      nullif(btrim(coalesce(NEW.phone, '')), ''),
+    'notes',      nullif(btrim(coalesce(NEW.notes, '')), ''),
+    'code',       nullif(btrim(coalesce(NEW.code, '')), ''),
+    'created_by', CASE WHEN NEW.created_by IS NULL THEN NULL ELSE NEW.created_by::text END
+  ));
+
+  v_meta := (v_meta - k_managed - k_moved) || v_overlay;
+
+  IF v_legacy IS NULL THEN v_meta := v_meta - 'legacy_kind';
+  ELSE v_meta := jsonb_set(v_meta, '{legacy_kind}', to_jsonb(v_legacy)); END IF;
+
+  IF NEW.tags IS NULL OR cardinality(NEW.tags) = 0 THEN v_meta := v_meta - 'tags';
+  ELSE v_meta := jsonb_set(v_meta, '{tags}', to_jsonb(NEW.tags)); END IF;
+
+  IF NEW.custom_fields IS NULL OR NEW.custom_fields = '{}'::jsonb THEN v_meta := v_meta - 'custom_fields';
+  ELSE v_meta := jsonb_set(v_meta, '{custom_fields}', NEW.custom_fields); END IF;
+
+  IF TG_OP = 'INSERT' THEN
+    v_tenant := coalesce(NEW.tenant_id, app.current_tenant_id());
+    INSERT INTO app.units (id, tenant_id, kind, name, parent_unit_id, active, metadata)
+    VALUES (coalesce(NEW.id, gen_random_uuid()), v_tenant, v_kind, btrim(NEW.name),
+            NEW.parent_id, coalesce(NEW.is_active, true), v_meta)
+    RETURNING id INTO v_id;
+  ELSE
+    UPDATE app.units u
+       SET kind = v_kind,
+           name = btrim(NEW.name),
+           parent_unit_id = NEW.parent_id,
+           active = coalesce(NEW.is_active, true),
+           metadata = v_meta,
+           updated_at = now()
+     WHERE u.id = OLD.id
+    RETURNING u.id INTO v_id;
+    IF v_id IS NULL THEN
+      RAISE EXCEPTION 'v_units: unit % not found or not yours to change', OLD.id USING ERRCODE = '42501';
+    END IF;
+  END IF;
+
+  SELECT * INTO NEW FROM public.v_units WHERE id = v_id;
+  RETURN NEW;
+END $$;
+
+COMMENT ON FUNCTION app.trg_v_units_write() IS
+  'Escreve v_units em app.units; endereço e coordenada são de public.addresses (141, 142).';

package/migrations/143_o_preset_para_de_nomear_telas_que_nao_existem.sql

@@ -0,0 +1,29 @@
+-- ============================================================================
+-- 143 — o preset para de nomear telas que não existem
+--
+-- As telas de Campanhas e Templates do plugin de conversas foram removidas:
+-- tomavam duas linhas de rail num plugin que declara que nem a própria caixa
+-- de entrada merece uma, e apareciam DUAS VEZES no rail — uma reivindicada
+-- pela entrada `conversations` do preset, outra na sobra do fim, porque o
+-- `dedupeByRoute` não alcança as `pages` do aplicativo.
+--
+-- O preset do StudioControl ainda falava delas: escondia
+-- `/conversations/campaigns` e renomeava `/conversations/templates` para
+-- "Comunicação". Esconder e rotular uma rota que não existe mais não quebra
+-- nada, e é exatamente por isso que fica: ninguém descobre por erro, só por
+-- leitura — e quem ler daqui a um ano vai procurar a tela.
+-- ============================================================================
+
+UPDATE app.apps
+   SET preset = jsonb_set(
+         preset,
+         '{hide}',
+         coalesce((
+           SELECT jsonb_agg(h) FROM jsonb_array_elements(preset -> 'hide') h
+            WHERE h #>> '{}' <> '/conversations/campaigns'
+         ), '[]'::jsonb))
+ WHERE preset -> 'hide' @> '["/conversations/campaigns"]'::jsonb;
+
+UPDATE app.apps
+   SET preset = jsonb_set(preset, '{labels}', (preset -> 'labels') - '/conversations/templates')
+ WHERE preset -> 'labels' ? '/conversations/templates';

package/migrations/144_marketing_e_um_botao_nao_uma_gaveta.sql

@@ -0,0 +1,46 @@
+-- ============================================================================
+-- 144 — Marketing é um botão, não uma gaveta
+--
+-- No StoreControl a linha de Marketing era uma RUBRICA:
+--
+--     {"icon": "Megaphone", "label": "Marketing", "under": ["/marketing", "/conversations"]}
+--
+-- Uma rubrica é uma sanfona: clicar abre uma lista e o destino fica a dois
+-- cliques. Mas `/marketing` já está em `whole` — ele abre INTEIRO, com as
+-- próprias abas por dentro (é a regra "um assunto, uma linha"). Uma gaveta por
+-- fora de uma tela que já se organiza por dentro é o mesmo menu desenhado duas
+-- vezes, e a segunda vez em outra gramática.
+--
+-- E o que a rubrica agrupava não existe mais: `/conversations` perdeu as linhas
+-- de Campanhas e Templates, então a gaveta ficou com um destino só de verdade —
+-- o caso que o próprio rail já sabe colapsar ("uma rubrica com um destino só
+-- não é uma rubrica"), mas colapsava mantendo o ícone e o rótulo da gaveta em
+-- vez do da tela.
+--
+-- Todo aplicativo: os outros presets já traziam `"marketing"` como linha
+-- simples, e esta migration deixa o StoreControl igual — sem depender de o
+-- colapso acontecer por sorte de configuração.
+-- ============================================================================
+
+UPDATE app.apps
+   SET preset = jsonb_set(
+         preset,
+         '{rail}',
+         (SELECT jsonb_agg(
+                   CASE WHEN jsonb_typeof(e) = 'object' AND e ->> 'label' = 'Marketing'
+                        THEN '"marketing"'::jsonb
+                        ELSE e END
+                   ORDER BY ord)
+            FROM jsonb_array_elements(preset -> 'rail') WITH ORDINALITY AS t(e, ord)))
+ WHERE preset ? 'rail'
+   AND EXISTS (
+         SELECT 1 FROM jsonb_array_elements(preset -> 'rail') e
+          WHERE jsonb_typeof(e) = 'object' AND e ->> 'label' = 'Marketing');
+
+-- `/marketing` abre inteiro em todo preset que tenha rail — é o que faz a
+-- linha única levar direto à tela com as abas dentro, em vez de a uma sanfona.
+UPDATE app.apps
+   SET preset = jsonb_set(preset, '{whole}',
+         coalesce(preset -> 'whole', '[]'::jsonb) || '["/marketing"]'::jsonb)
+ WHERE preset ? 'rail'
+   AND NOT coalesce(preset -> 'whole', '[]'::jsonb) @> '["/marketing"]'::jsonb;

package/migrations/145_campanhas_e_templates_somem_em_toda_conta.sql

@@ -0,0 +1,36 @@
+-- ============================================================================
+-- 145 — Campanhas e Templates somem em toda conta
+--
+-- As duas telas foram REMOVIDAS do plugin de conversas, mas remover código só
+-- vale para quem roda o código: cada aplicativo resolve `@fayz-ai/*` do npm na
+-- versão que instalou, e os que estão no ar continuam desenhando as duas linhas
+-- — às vezes DUAS VEZES, dentro de Agenda, de Marketing ou soltas no fim do
+-- rail, conforme a rubrica de cada ofício. Esperar o release para parar de
+-- mostrar uma tela que não deveria existir é esperar tempo demais.
+--
+-- O `hide` do preset não depende de versão: ele mora no banco, o rail o lê a
+-- cada carga, e uma rota calada não é reivindicada por rubrica nenhuma nem
+-- sobra para o fim (ver `applyRailPreset`). Vale para TODO preset, inclusive os
+-- que não tinham `hide`.
+--
+-- E fica depois do release também. Esconder uma rota que não existe mais não
+-- custa nada, e é a garantia de que um aplicativo parado numa versão velha —
+-- ou um `pages` de app que declare a rota de novo por fora do `dedupeByRoute` —
+-- não traga as duas linhas de volta sem ninguém perceber.
+--
+-- (Reverte a parte da 143 que tirou `/conversations/campaigns` do `hide` do
+-- StudioControl: lá a leitura foi "a tela não existe mais, a linha do preset é
+-- letra morta". Não era — era a única coisa segurando a tela nos apps no ar.)
+-- ============================================================================
+
+UPDATE app.apps
+   SET preset = jsonb_set(
+         coalesce(preset, '{}'::jsonb),
+         '{hide}',
+         (SELECT coalesce(jsonb_agg(DISTINCT h), '[]'::jsonb)
+            FROM jsonb_array_elements(
+                   coalesce(preset -> 'hide', '[]'::jsonb)
+                   || '["/conversations/campaigns", "/conversations/templates"]'::jsonb) h))
+ WHERE preset IS NOT NULL
+   AND NOT (coalesce(preset -> 'hide', '[]'::jsonb)
+            @> '["/conversations/campaigns", "/conversations/templates"]'::jsonb);

package/migrations/146_a_clinica_ve_as_proprias_analises.sql

@@ -0,0 +1,31 @@
+-- ============================================================================
+-- 146 — a clínica vê as próprias análises
+--
+-- O preset do StudioControl (clínica e estética: Espaço Renova Rio, Clínica
+-- Sol) dizia duas coisas que não podem ser verdade ao mesmo tempo:
+--
+--   rail: [… "financial", "reports", {Cadastros}]
+--   hide: ["/analytics", …]
+--
+-- O rail nomeia a linha de Análises no lugar certo — entre Financeiro e
+-- Cadastros — e o `hide` a silencia antes de qualquer rubrica poder
+-- reivindicá-la (`applyRailPreset` poda primeiro). Ganha o `hide`, e a casa
+-- que mais precisa olhar ocupação, ticket e retorno ficava sem a tela.
+--
+-- O `hide` veio de quando Análises era uma gaveta de relatórios crus; hoje é
+-- uma tela só, com abas por dentro. Tirar a linha do `hide` é o suficiente:
+-- o rail já sabe onde ela vai.
+-- ============================================================================
+
+UPDATE app.apps
+   SET preset = jsonb_set(
+         preset,
+         '{hide}',
+         coalesce((
+           SELECT jsonb_agg(h) FROM jsonb_array_elements(preset -> 'hide') h
+            WHERE h #>> '{}' <> '/analytics'
+         ), '[]'::jsonb))
+ WHERE preset -> 'hide' @> '["/analytics"]'::jsonb
+   -- Só onde o rail JÁ diz onde a linha mora. Num preset sem `reports` no rail
+   -- ela cairia solta no fim, que é pior que não aparecer.
+   AND preset -> 'rail' @> '["reports"]'::jsonb;