@fayz-ai/db 0.21.0 → 0.22.2

package/migrations/168_a_empresa_do_v1_cabe_na_unidade.sql

@@ -0,0 +1,366 @@
+-- A empresa do V1 cabe na unidade.
+--
+-- O cadastro de empresa do V1 (Configurações → Empresa) é uma tela só com a
+-- filial inteira: logo, sigla, classificação na rede, dois de cada contato,
+-- canais de divulgação, configuração por filial e a identidade fiscal. No V2
+-- a unidade tinha nome, tipo, um telefone e um e-mail — o resto não tinha onde
+-- morar, e a tela de unidades não tinha o que mostrar.
+--
+-- Plano aprovado em docs/port/empresa.schema.json (port-schema). Três casas:
+--
+--   app.units                       o que é DA FILIAL (colunas novas)
+--   public.company_legal_entities   o que é DO CNPJ (razão social, IE, IM, CNAE…)
+--   app.units.settings              o que é CONFIGURAÇÃO por filial (127)
+--
+-- A ligação filial → CNPJ é app.units.company_legal_entity_id. A coluna
+-- company_legal_entities.unit_id é o espelho e continua sendo preenchida, mas
+-- quem decide é a unidade: duas filiais com o mesmo CNPJ apontam para a MESMA
+-- pessoa jurídica (é o que o V1 faz com a matriz que emite pelas lojas).
+--
+-- E a porta é uma só: v_units passa a ler e escrever as três casas, para a
+-- tela salvar a empresa inteira num gesto, como no V1 (140: a unidade se
+-- escreve pela mesma porta que se lê).
+--
+-- Endereço e coordenada continuam em public.addresses (141/142). A lista da
+-- vez continua em plg_agenda_turn_queues. Idempotente.
+
+-- ═══════════════════════════════════════════════════════════════════════════
+-- 1. O que é da filial
+-- ═══════════════════════════════════════════════════════════════════════════
+
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS logo_url text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS abbreviation text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS coordinator_person_id uuid;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS store_type text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS store_category text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS phone_2 text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS mobile_1 text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS mobile_2 text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS email_2 text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS instagram_handle text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS facebook_handle text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS tiktok_handle text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS website text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS whatsapp_number text;
+ALTER TABLE app.units ADD COLUMN IF NOT EXISTS marketing_phone text;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'units_coordinator_person_fk') THEN
+    ALTER TABLE app.units
+      ADD CONSTRAINT units_coordinator_person_fk
+      FOREIGN KEY (coordinator_person_id) REFERENCES public.people(id) ON DELETE SET NULL;
+  END IF;
+END $$;
+
+COMMENT ON COLUMN app.units.logo_url IS 'V1: companies.logo_url — logo da filial.';
+COMMENT ON COLUMN app.units.abbreviation IS 'V1: companies.abbreviation — sigla curta. Não é metadata.code (código interno).';
+COMMENT ON COLUMN app.units.coordinator_person_id IS 'V1: companies.coordinator (texto) — no V2 aponta para a pessoa.';
+COMMENT ON COLUMN app.units.store_type IS 'V1: companies.store_type — "Rua", "Shopping"; texto com sugestões dos valores já usados.';
+COMMENT ON COLUMN app.units.store_category IS 'V1: companies.store_category — "A", "B", "C"; alimenta filtros de relatório de rede.';
+COMMENT ON COLUMN app.units.phone_2 IS 'V1: companies.phone_2 (phone_1 = metadata.phone).';
+COMMENT ON COLUMN app.units.mobile_1 IS 'V1: companies.mobile_1';
+COMMENT ON COLUMN app.units.mobile_2 IS 'V1: companies.mobile_2';
+COMMENT ON COLUMN app.units.email_2 IS 'V1: companies.email_2 (email_1 = metadata.email).';
+COMMENT ON COLUMN app.units.instagram_handle IS 'V1: companies.instagram_handle — canal de divulgação.';
+COMMENT ON COLUMN app.units.facebook_handle IS 'V1: companies.facebook_handle';
+COMMENT ON COLUMN app.units.tiktok_handle IS 'V1: companies.tiktok_handle';
+COMMENT ON COLUMN app.units.website IS 'V1: companies.website';
+COMMENT ON COLUMN app.units.whatsapp_number IS 'V1: companies.whatsapp_number — WhatsApp de divulgação, não o canal do agente.';
+COMMENT ON COLUMN app.units.marketing_phone IS 'V1: companies.marketing_phone';
+
+-- ═══════════════════════════════════════════════════════════════════════════
+-- 2. O que é do CNPJ
+-- ═══════════════════════════════════════════════════════════════════════════
+
+ALTER TABLE public.company_legal_entities ADD COLUMN IF NOT EXISTS cnae text;
+ALTER TABLE public.company_legal_entities ADD COLUMN IF NOT EXISTS ibge_city_code text;
+ALTER TABLE public.company_legal_entities ADD COLUMN IF NOT EXISTS fiscal_email text;
+
+COMMENT ON COLUMN public.company_legal_entities.cnae IS 'V1: companies.cnae — CNAE principal.';
+COMMENT ON COLUMN public.company_legal_entities.ibge_city_code IS 'V1: companies.codigo_ibge — o emissor de NFS-e roteia pela prefeitura.';
+COMMENT ON COLUMN public.company_legal_entities.fiscal_email IS 'V1: companies.fiscal_email — retorno da prefeitura/SEFAZ, não o contato.';
+
+-- ═══════════════════════════════════════════════════════════════════════════
+-- 3. O que é configuração por filial (127)
+-- ═══════════════════════════════════════════════════════════════════════════
+-- `timezone` já existia como chave do tenant; passa a descer até a filial
+-- (uma rede com loja em Manaus). O valor do tenant continua sendo o padrão.
+
+SELECT app.seed_setting_keys($$[
+  { "key": "timezone", "type": "string", "default": "America/Sao_Paulo", "scope": "unit",
+    "description": "Fuso horário. O da casa é o padrão; a filial pode ter o seu (V1: companies.timezone)." },
+  { "key": "daylight_saving", "type": "boolean", "default": false, "scope": "unit",
+    "description": "Aplicar horário de verão nesta filial (V1: companies.apply_daylight_saving)." },
+  { "key": "phone.auto_ddd", "type": "boolean", "default": false, "scope": "unit",
+    "description": "Telefone digitado sem DDD recebe o DDD da filial (V1: companies.auto_ddd)." },
+  { "key": "booking.online_enabled", "type": "boolean", "default": true, "scope": "unit",
+    "description": "A filial aparece no agendamento online (V1: companies.show_in_online_booking)." },
+  { "key": "pos.require_open_cash_session", "type": "boolean", "default": false, "scope": "unit",
+    "description": "Maquininha e Balcão recusam a cobrança de quem não abriu o próprio caixinha nesta filial (V1: companies.pos_exige_caixinha)." }
+]$$::jsonb);
+
+-- O valor que a tela mostra é o EFETIVO (filial → casa → padrão); o que se
+-- grava na filial é só a diferença. Salvar a empresa sem mexer na
+-- configuração não cria 5 exceções por filial.
+CREATE OR REPLACE FUNCTION app.unit_setting_put(p_unit uuid, p_settings jsonb, p_key text, p_value jsonb)
+RETURNS jsonb
+LANGUAGE plpgsql
+STABLE
+SET search_path TO ''
+AS $function$
+DECLARE
+  v_tenant uuid;
+  v_house  jsonb;
+BEGIN
+  IF p_value IS NULL OR p_value = 'null'::jsonb THEN RETURN p_settings; END IF;
+  SELECT u.tenant_id INTO v_tenant FROM app.units u WHERE u.id = p_unit;
+  v_house := app.unit_setting_value(v_tenant, NULL, p_key);
+  IF v_house IS NOT DISTINCT FROM p_value THEN
+    RETURN app.jsonb_set_path(coalesce(p_settings, '{}'::jsonb), string_to_array(p_key, '.'), NULL);
+  END IF;
+  RETURN app.jsonb_set_path(coalesce(p_settings, '{}'::jsonb), string_to_array(p_key, '.'), p_value);
+END $function$;
+
+REVOKE ALL ON FUNCTION app.unit_setting_put(uuid, jsonb, text, jsonb) FROM PUBLIC, anon;
+GRANT EXECUTE ON FUNCTION app.unit_setting_put(uuid, jsonb, text, jsonb) TO authenticated, service_role;
+
+-- ═══════════════════════════════════════════════════════════════════════════
+-- 4. A porta: v_units lê e escreve as três casas
+-- ═══════════════════════════════════════════════════════════════════════════
+-- CREATE OR REPLACE só acrescenta coluna NO FIM — as 26 de antes ficam na
+-- mesma ordem.
+
+CREATE OR REPLACE VIEW public.v_units WITH (security_invoker = true) AS
+ SELECT u.id,
+    u.tenant_id,
+    COALESCE(u.metadata ->> 'legacy_kind'::text, u.kind) AS kind,
+    u.name,
+    u.metadata ->> 'email'::text AS email,
+    u.metadata ->> 'phone'::text AS phone,
+    NULLIF(btrim(COALESCE(a.street, ''::text) ||
+        CASE
+            WHEN NULLIF(btrim(COALESCE(a.number, ''::text)), ''::text) IS NULL THEN ''::text
+            ELSE ', '::text || btrim(a.number)
+        END), ''::text) AS address,
+    a.city,
+    a.state,
+    COALESCE(a.country, 'BR'::text) AS country,
+    a.postal_code,
+    u.kind = 'hq'::text AS is_headquarters,
+    u.active AS is_active,
+    COALESCE(( SELECT array_agg(t.value) AS array_agg
+           FROM jsonb_array_elements_text(
+                CASE
+                    WHEN jsonb_typeof(u.metadata -> 'tags'::text) = 'array'::text THEN u.metadata -> 'tags'::text
+                    ELSE '[]'::jsonb
+                END) t(value)), '{}'::text[]) AS tags,
+    u.metadata ->> 'notes'::text AS notes,
+    u.metadata,
+        CASE
+            WHEN jsonb_typeof(u.metadata -> 'custom_fields'::text) = 'object'::text THEN u.metadata -> 'custom_fields'::text
+            ELSE '{}'::jsonb
+        END AS custom_fields,
+        CASE
+            WHEN (u.metadata ->> 'created_by'::text) ~* '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$'::text THEN (u.metadata ->> 'created_by'::text)::uuid
+            ELSE NULL::uuid
+        END AS created_by,
+    u.created_at,
+    u.updated_at,
+    u.parent_unit_id AS parent_id,
+    u.metadata ->> 'code'::text AS code,
+    a.latitude,
+    a.longitude,
+    -- 168: o que é da filial
+    u.logo_url,
+    u.abbreviation,
+    u.coordinator_person_id,
+    u.store_type,
+    u.store_category,
+    u.phone_2,
+    u.mobile_1,
+    u.mobile_2,
+    u.email_2,
+    u.instagram_handle,
+    u.facebook_handle,
+    u.tiktok_handle,
+    u.website,
+    u.whatsapp_number,
+    u.marketing_phone,
+    -- 168: o que é do CNPJ
+    u.company_legal_entity_id AS legal_entity_id,
+    le.legal_name,
+    le.document_number AS cnpj,
+    le.state_registration,
+    le.municipal_registration,
+    le.tax_regime,
+    le.cnae,
+    le.ibge_city_code,
+    le.fiscal_email,
+    -- 168: configuração efetiva (filial → casa → padrão)
+    app.unit_setting_value(u.tenant_id, u.id, 'timezone') #>> '{}' AS timezone,
+    (app.unit_setting_value(u.tenant_id, u.id, 'daylight_saving'))::text::boolean AS daylight_saving,
+    (app.unit_setting_value(u.tenant_id, u.id, 'phone.auto_ddd'))::text::boolean AS auto_ddd,
+    (app.unit_setting_value(u.tenant_id, u.id, 'booking.online_enabled'))::text::boolean AS online_booking_enabled,
+    (app.unit_setting_value(u.tenant_id, u.id, 'pos.require_open_cash_session'))::text::boolean AS require_open_cash_session,
+    -- endereço por partes, para o formulário (address acima é a linha pronta)
+    a.street AS address_street,
+    a.number AS address_number,
+    a.complement AS address_complement,
+    a.district AS address_district
+   FROM app.units u
+     LEFT JOIN LATERAL ( SELECT x.street, x.number, x.complement, x.district, x.city, x.state,
+            x.country, x.postal_code, x.latitude, x.longitude
+           FROM public.addresses x
+          WHERE x.owner_type = 'unit'::text AND x.owner_id = u.id
+          ORDER BY x.is_default DESC, x.created_at
+         LIMIT 1) a ON true
+     LEFT JOIN public.company_legal_entities le
+       ON le.id = u.company_legal_entity_id AND le.tenant_id = u.tenant_id;
+
+CREATE OR REPLACE FUNCTION app.trg_v_units_write()
+ RETURNS trigger
+ LANGUAGE plpgsql
+ SET search_path TO ''
+AS $function$
+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;
+  v_le       uuid;
+  v_doc      text;
+  v_settings jsonb;
+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, u.tenant_id INTO v_id, v_tenant;
+    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;
+
+  -- 168: o que é da filial
+  UPDATE app.units u
+     SET logo_url              = nullif(btrim(coalesce(NEW.logo_url, '')), ''),
+         abbreviation          = nullif(btrim(coalesce(NEW.abbreviation, '')), ''),
+         coordinator_person_id = NEW.coordinator_person_id,
+         store_type            = nullif(btrim(coalesce(NEW.store_type, '')), ''),
+         store_category        = nullif(btrim(coalesce(NEW.store_category, '')), ''),
+         phone_2               = nullif(btrim(coalesce(NEW.phone_2, '')), ''),
+         mobile_1              = nullif(btrim(coalesce(NEW.mobile_1, '')), ''),
+         mobile_2              = nullif(btrim(coalesce(NEW.mobile_2, '')), ''),
+         email_2               = nullif(btrim(coalesce(NEW.email_2, '')), ''),
+         instagram_handle      = nullif(btrim(coalesce(NEW.instagram_handle, '')), ''),
+         facebook_handle       = nullif(btrim(coalesce(NEW.facebook_handle, '')), ''),
+         tiktok_handle         = nullif(btrim(coalesce(NEW.tiktok_handle, '')), ''),
+         website               = nullif(btrim(coalesce(NEW.website, '')), ''),
+         whatsapp_number       = nullif(btrim(coalesce(NEW.whatsapp_number, '')), ''),
+         marketing_phone       = nullif(btrim(coalesce(NEW.marketing_phone, '')), '')
+   WHERE u.id = v_id;
+
+  -- 168: configuração — só a diferença do padrão da casa desce para a filial
+  SELECT u.settings INTO v_settings FROM app.units u WHERE u.id = v_id;
+  v_settings := app.unit_setting_put(v_id, v_settings, 'timezone', to_jsonb(nullif(btrim(coalesce(NEW.timezone, '')), '')));
+  v_settings := app.unit_setting_put(v_id, v_settings, 'daylight_saving', to_jsonb(NEW.daylight_saving));
+  v_settings := app.unit_setting_put(v_id, v_settings, 'phone.auto_ddd', to_jsonb(NEW.auto_ddd));
+  v_settings := app.unit_setting_put(v_id, v_settings, 'booking.online_enabled', to_jsonb(NEW.online_booking_enabled));
+  v_settings := app.unit_setting_put(v_id, v_settings, 'pos.require_open_cash_session', to_jsonb(NEW.require_open_cash_session));
+  UPDATE app.units u SET settings = v_settings WHERE u.id = v_id AND u.settings IS DISTINCT FROM v_settings;
+
+  -- 168: o que é do CNPJ. A filial aponta para uma pessoa jurídica; se ela
+  -- ainda não aponta e o CNPJ digitado já existe na casa, liga na existente
+  -- em vez de criar a segunda.
+  v_doc := nullif(regexp_replace(coalesce(NEW.cnpj, ''), '\D', '', 'g'), '');
+  SELECT u.company_legal_entity_id INTO v_le FROM app.units u WHERE u.id = v_id;
+  IF v_le IS NULL AND v_doc IS NOT NULL THEN
+    SELECT le.id INTO v_le FROM public.company_legal_entities le
+     WHERE le.tenant_id = v_tenant AND le.document_number = v_doc
+     ORDER BY le.created_at LIMIT 1;
+  END IF;
+  IF v_le IS NULL AND (nullif(btrim(coalesce(NEW.legal_name, '')), '') IS NOT NULL OR v_doc IS NOT NULL) THEN
+    INSERT INTO public.company_legal_entities (tenant_id, kind, legal_name, trade_name, document_number, unit_id)
+    VALUES (v_tenant, CASE WHEN length(v_doc) = 11 THEN 'individual' ELSE 'company' END,
+            coalesce(nullif(btrim(coalesce(NEW.legal_name, '')), ''), btrim(NEW.name)), btrim(NEW.name), v_doc, v_id)
+    RETURNING id INTO v_le;
+  END IF;
+  IF v_le IS NOT NULL THEN
+    UPDATE public.company_legal_entities le
+       SET legal_name             = coalesce(nullif(btrim(coalesce(NEW.legal_name, '')), ''), le.legal_name),
+           trade_name             = coalesce(le.trade_name, btrim(NEW.name)),
+           document_number        = v_doc,
+           kind                   = CASE WHEN length(v_doc) = 11 THEN 'individual' ELSE 'company' END,
+           state_registration     = nullif(btrim(coalesce(NEW.state_registration, '')), ''),
+           municipal_registration = nullif(btrim(coalesce(NEW.municipal_registration, '')), ''),
+           tax_regime             = nullif(btrim(coalesce(NEW.tax_regime, '')), ''),
+           cnae                   = nullif(btrim(coalesce(NEW.cnae, '')), ''),
+           ibge_city_code         = nullif(btrim(coalesce(NEW.ibge_city_code, '')), ''),
+           fiscal_email           = nullif(btrim(coalesce(NEW.fiscal_email, '')), ''),
+           unit_id                = coalesce(le.unit_id, v_id),
+           updated_at             = now()
+     WHERE le.id = v_le;
+    UPDATE app.units u SET company_legal_entity_id = v_le
+     WHERE u.id = v_id AND u.company_legal_entity_id IS DISTINCT FROM v_le;
+  END IF;
+
+  SELECT * INTO NEW FROM public.v_units WHERE id = v_id;
+  RETURN NEW;
+END $function$;
+
+-- 157: a função do trigger não se chama de fora.
+REVOKE ALL ON FUNCTION app.trg_v_units_write() FROM PUBLIC, anon, authenticated;
+GRANT EXECUTE ON FUNCTION app.trg_v_units_write() TO service_role;

package/migrations/169_a_configuracao_da_filial_se_le_pela_porta_da_sessao.sql

@@ -0,0 +1,65 @@
+-- A configuração da filial se lê pela porta da sessão.
+--
+-- 168 pôs na v_units a configuração efetiva chamando app.unit_setting_value —
+-- que é SECURITY DEFINER, recebe tenant e unidade como argumento e por isso
+-- NÃO é executável por authenticated (abrir seria ler a configuração de
+-- qualquer tenant). Como a v_units é security_invoker, a view inteira passou a
+-- negar 42501 para quem usa o app.
+--
+-- A saída não é abrir a função: são duas de leitura que tiram tenant da
+-- SESSÃO e conferem o alcance da unidade, e devolvem nulo para o resto.
+-- Idempotente.
+
+CREATE OR REPLACE FUNCTION app.my_unit_setting(p_unit uuid, p_key text)
+RETURNS jsonb
+LANGUAGE sql
+STABLE SECURITY DEFINER
+SET search_path TO ''
+AS $function$
+  SELECT CASE
+    WHEN EXISTS (SELECT 1 FROM app.units u
+                  WHERE u.id = p_unit AND u.tenant_id = app.current_tenant_id())
+     AND app.has_unit(p_unit)
+    THEN app.unit_setting_value(app.current_tenant_id(), p_unit, p_key)
+  END;
+$function$;
+
+CREATE OR REPLACE FUNCTION app.my_house_setting(p_key text)
+RETURNS jsonb
+LANGUAGE sql
+STABLE SECURITY DEFINER
+SET search_path TO ''
+AS $function$
+  SELECT CASE WHEN app.current_tenant_id() IS NOT NULL
+    THEN app.unit_setting_value(app.current_tenant_id(), NULL, p_key) END;
+$function$;
+
+REVOKE ALL ON FUNCTION app.my_unit_setting(uuid, text) FROM PUBLIC, anon;
+REVOKE ALL ON FUNCTION app.my_house_setting(text) FROM PUBLIC, anon;
+GRANT EXECUTE ON FUNCTION app.my_unit_setting(uuid, text) TO authenticated, service_role;
+GRANT EXECUTE ON FUNCTION app.my_house_setting(text) TO authenticated, service_role;
+
+CREATE OR REPLACE FUNCTION app.unit_setting_put(p_unit uuid, p_settings jsonb, p_key text, p_value jsonb)
+RETURNS jsonb
+LANGUAGE plpgsql
+STABLE
+SET search_path TO ''
+AS $function$
+BEGIN
+  IF p_value IS NULL OR p_value = 'null'::jsonb THEN RETURN p_settings; END IF;
+  IF app.my_house_setting(p_key) IS NOT DISTINCT FROM p_value THEN
+    RETURN app.jsonb_set_path(coalesce(p_settings, '{}'::jsonb), string_to_array(p_key, '.'), NULL);
+  END IF;
+  RETURN app.jsonb_set_path(coalesce(p_settings, '{}'::jsonb), string_to_array(p_key, '.'), p_value);
+END $function$;
+
+-- Mesma view da 168, só trocando a função de leitura das 5 configurações.
+DO $$
+DECLARE v_def text;
+BEGIN
+  v_def := pg_get_viewdef('public.v_units'::regclass, true);
+  IF position('app.unit_setting_value(' in v_def) > 0 THEN
+    v_def := replace(v_def, 'app.unit_setting_value(u.tenant_id, u.id, ', 'app.my_unit_setting(u.id, ');
+    EXECUTE 'CREATE OR REPLACE VIEW public.v_units WITH (security_invoker = true) AS ' || v_def;
+  END IF;
+END $$;

package/migrations/171_a_validade_informada_nao_se_apaga_sozinha.sql

@@ -0,0 +1,55 @@
+-- ---------------------------------------------------------------------------
+-- 171 — a validade informada não se apaga sozinha.
+--
+-- A 166 trocou "validade em dias" por "validade em meses, com um interruptor",
+-- e pôs um gatilho para manter os dois espelhos de acordo. O gatilho está
+-- certo no UPDATE e errado no INSERT:
+--
+--     BEFORE INSERT OR UPDATE OF validity_enabled, validity_months
+--
+-- A lista `OF` só recorta o UPDATE. No INSERT ele dispara sempre — e como
+-- `validity_enabled` nasce `false` por DEFAULT, o ramo `ELSIF NOT
+-- NEW.validity_enabled` zera `validity_days` de QUALQUER linha nova. Uma linha
+-- que chega dizendo «validade: 180 dias» é gravada sem validade nenhuma.
+--
+-- Quem escreve `validity_days` direto é o porte do V1, que é de onde vêm os
+-- pacotes todos. A suíte do ledger pegou: `900.00/180` virou nulo.
+--
+-- O conserto é ler a intenção de quem insere em vez de impor o default. Se a
+-- linha chega com dias e sem meses, ela QUIS validade — então os meses se
+-- derivam e o interruptor liga, que é exatamente o que o backfill da própria
+-- 166 fez com as linhas antigas. Apagar continua sendo possível, mas só quando
+-- alguém desliga o interruptor de propósito.
+--
+-- Idempotente: só repõe a função.
+-- ---------------------------------------------------------------------------
+
+CREATE OR REPLACE FUNCTION public.service_packages_sync_validity()
+RETURNS trigger
+LANGUAGE plpgsql
+SECURITY INVOKER
+SET search_path = ''
+AS $$
+BEGIN
+  -- A linha nova que traz dias e não traz meses: é validade declarada, não
+  -- resíduo. Mesma conta do backfill da 166.
+  IF TG_OP = 'INSERT'
+     AND NOT NEW.validity_enabled
+     AND NEW.validity_days IS NOT NULL
+     AND NEW.validity_months IS NULL THEN
+    NEW.validity_enabled := true;
+    NEW.validity_months  := GREATEST(1, round(NEW.validity_days / 30.0)::integer);
+    RETURN NEW;
+  END IF;
+
+  IF NEW.validity_enabled AND NEW.validity_months IS NOT NULL THEN
+    NEW.validity_days := NEW.validity_months * 30;
+  ELSIF NOT NEW.validity_enabled THEN
+    NEW.validity_days := NULL;
+    NEW.validity_months := NULL;
+  END IF;
+  RETURN NEW;
+END $$;
+
+COMMENT ON FUNCTION public.service_packages_sync_validity() IS
+  'Mantém validity_days e validity_months de acordo. No INSERT, dias informados sem meses são validade DECLARADA: ligam o interruptor em vez de serem apagados pelo default (171).';

package/migrations/172_o_pacote_pode_repetir_o_servico.sql

@@ -0,0 +1,23 @@
+-- ---------------------------------------------------------------------------
+-- 172 — o pacote pode repetir o mesmo serviço em linhas diferentes.
+--
+-- `service_package_items_unique (package_id, product_id)` veio do porte e
+-- barrava o que a grade do pacote precisa fazer: duplicar uma linha (o mesmo
+-- serviço com outro valor no pacote — a primeira sessão cheia, as demais com
+-- desconto) e trocar o serviço de uma linha para um que já está em outra.
+-- O erro chegava cru na tela: «duplicate key value violates unique constraint».
+--
+-- Nada lia a unicidade: nenhum ON CONFLICT, e quem consome o pacote (venda,
+-- saldo de sessões) itera as linhas. A soma da 166 já é por linha.
+--
+-- O índice da constraint era o único que começava por `package_id`; a lista
+-- do pacote filtra por ele, então um índice simples entra no lugar.
+--
+-- Idempotente e sem tocar em dado.
+-- ---------------------------------------------------------------------------
+
+ALTER TABLE public.service_package_items
+  DROP CONSTRAINT IF EXISTS service_package_items_unique;
+
+CREATE INDEX IF NOT EXISTS service_package_items_package_idx
+  ON public.service_package_items (tenant_id, package_id);

package/package.json

@@ -3,7 +3,7 @@
   "fayz": {
     "status": "beta"
   },
-  "version": "0.21.0",
+  "version": "0.22.2",
   "description": "Fayz SDK database layer — Drizzle schema primitives, spine references, and migration helpers shared across plugins.",
   "type": "module",
   "sideEffects": false,