@fayz-ai/db 0.18.0 → 0.18.2

package/migrations/134_todo_oficio_agrupa_os_seus_cadastros.sql

@@ -0,0 +1,123 @@
+-- ---------------------------------------------------------------------------
+-- 134_todo_oficio_agrupa_os_seus_cadastros.sql — Cadastros deixa de ser sorte.
+-- ---------------------------------------------------------------------------
+-- A 117 pôs as telas de cadastro sob uma rubrica e a 132 lhes deu a ordem e o
+-- vocabulário do V1. As duas mexeram em `beauty`, e só nele. O resultado é o
+-- que um tenant vê hoje:
+--
+--     Espaço Facial (beauty)   Cadastros ▸ Contatos · Equipamentos · …
+--     Crema Club    (school)   Serviço · Categorias de Serviço · Locais de
+--                              Atendimento · Grupos de Locais · Profissionais ·
+--                              Contatos · Fornecedores · Parcerias ·
+--                              Equipamentos · Origens
+--
+-- Onze linhas planas, empurrando Análises e Financeiro para fora da primeira
+-- tela. Não é escolha de ofício nenhum: é `createRegistryPlugin()` entrando em
+-- todo aplicativo — o que a 117 queria — e só um dos rails tendo sido ensinado
+-- a recolhê-las.
+--
+-- ── o que muda ──────────────────────────────────────────────────────────────
+--
+-- `school`, `shop` e `ticket` ganham a rubrica. `resto` já tinha uma com o
+-- nome certo, mas recolhendo só `/company` e `/staff` — as dez telas de
+-- `/registry/*` ficavam de fora dela, o que é pior que não ter: a casa lê
+-- "Cadastros" no menu e os cadastros estão do lado de fora.
+--
+-- `beauty` não é tocado. Ele tem a lista longa que a 132 escreveu para dizer a
+-- ORDEM do BeautySoft, e essa ordem é dele; reescrevê-la aqui seria trocar
+-- sete anos de hábito por uma uniformização que ninguém pediu.
+--
+-- `full` também não. Ele já tem `under: ["/registry"]`, e um prefixo largo
+-- sozinho é o pega-tudo — a mesma regra que a 132 documenta.
+--
+-- ── por que o prefixo curto basta ───────────────────────────────────────────
+--
+-- `under` casa por PREFIXO de rota: `/registry` serve `/registry/contacts` do
+-- mesmo jeito que `/financial` serve `/financial/payables`. A lista longa do
+-- salão existe para ordenar, não para alcançar. Onde não há ordem herdada para
+-- honrar, o prefixo curto diz a mesma coisa com uma linha, e um cadastro novo
+-- que um plugin publique amanhã entra na rubrica sozinho em vez de nascer solto
+-- embaixo dela.
+--
+-- `/company` e `/staff` entram junto porque são cadastro pela mesma pergunta —
+-- a ficha da casa e a de quem trabalha nela. É o que o `resto` já dizia.
+--
+-- ── posição ─────────────────────────────────────────────────────────────────
+--
+-- Antes de `reports`, como em `beauty` e em `resto`. Cadastro é o que se visita
+-- de vez em quando para corrigir uma ficha; fica no fim, perto do que também se
+-- abre por exceção — e longe de Painel, Conversas e do módulo do ofício, que
+-- são a primeira tela do dia.
+--
+-- Uma rubrica sem filho ativo não desenha (ver `applyRailPreset`), então uma
+-- conta que não instalou o registry não ganha um cabeçalho vazio.
+-- ---------------------------------------------------------------------------
+
+-- Insere a rubrica imediatamente antes de `reports`, preservando o resto do
+-- rail na ordem em que está. Feito em SQL sobre o array e não com um rail novo
+-- escrito à mão por aplicativo: o que muda é UMA entrada, e reescrever os
+-- quatro rails inteiros aqui é como a 083 criou uma árvore paralela que
+-- discordava dos plugins.
+WITH alvo AS (
+  SELECT id,
+         preset->'rail' AS rail,
+         -- A rubrica deste ofício. `resto` já tem uma e ela é SUBSTITUÍDA pela
+         -- versão que alcança `/registry`; os outros três recebem uma nova.
+         jsonb_build_object(
+           'label', 'Cadastros',
+           'icon', 'ClipboardList',
+           'under', jsonb_build_array('/registry', '/company', '/staff')
+         ) AS rubrica
+    FROM app.apps
+   WHERE id IN ('school', 'shop', 'ticket', 'resto')
+     AND preset ? 'rail'
+),
+limpo AS (
+  -- Fora a rubrica antiga, onde houver: manter as duas daria "Cadastros" duas
+  -- vezes no menu, e a primeira venceria a corrida pelas rotas.
+  SELECT a.id, a.rubrica,
+         COALESCE(
+           (SELECT jsonb_agg(e ORDER BY ord)
+              FROM jsonb_array_elements(a.rail) WITH ORDINALITY AS t(e, ord)
+             WHERE NOT (jsonb_typeof(e) = 'object' AND e->>'label' = 'Cadastros')),
+           '[]'::jsonb
+         ) AS rail
+    FROM alvo a
+),
+posicao AS (
+  SELECT l.id, l.rail, l.rubrica,
+         -- Onde `reports` está. Sem ele, a rubrica vai para o fim.
+         COALESCE(
+           (SELECT MIN(ord) - 1
+              FROM jsonb_array_elements(l.rail) WITH ORDINALITY AS t(e, ord)
+             WHERE jsonb_typeof(e) = 'string' AND e #>> '{}' = 'reports'),
+           jsonb_array_length(l.rail)
+         ) AS corte
+    FROM limpo l
+)
+UPDATE app.apps a
+   SET preset = jsonb_set(
+         a.preset, '{rail}',
+         (SELECT COALESCE(jsonb_agg(e ORDER BY ord), '[]'::jsonb)
+            FROM jsonb_array_elements(p.rail) WITH ORDINALITY AS t(e, ord)
+           WHERE ord <= p.corte)
+         || jsonb_build_array(p.rubrica)
+         || (SELECT COALESCE(jsonb_agg(e ORDER BY ord), '[]'::jsonb)
+               FROM jsonb_array_elements(p.rail) WITH ORDINALITY AS t(e, ord)
+              WHERE ord > p.corte)
+       ),
+       updated_at = now()
+  FROM posicao p
+ WHERE a.id = p.id;
+
+-- O módulo `registry` declarado, como a 132 fez para o salão: sem ele a conta
+-- pode não montar o plugin, e a rubrica não desenha por não ter filho.
+UPDATE app.apps
+   SET preset = jsonb_set(
+         preset, '{modules}',
+         (SELECT jsonb_agg(DISTINCT m)
+            FROM jsonb_array_elements(
+                   COALESCE(preset->'modules', '[]'::jsonb) || '["registry"]'::jsonb) AS m)),
+       updated_at = now()
+ WHERE id IN ('school', 'shop', 'ticket', 'resto')
+   AND preset ? 'modules';

package/migrations/135_a_pessoa_diz_em_quais_unidades_esta_disponivel.sql

@@ -0,0 +1,140 @@
+-- A supplier, customer or other non-login Person may be shared with selected
+-- units. The grants live in app.*, so the browser gets a narrow public door
+-- instead of direct access to the authorization schema.
+
+-- The importer already preserved these V1 fields in metadata. Lift them into
+-- the declared V2 fields without overwriting anything edited in V2.
+UPDATE public.people p
+   SET custom_fields = jsonb_strip_nulls(jsonb_build_object(
+         'serviceProviderType', nullif(p.metadata #>> '{contact,service_provider_type}', ''),
+         'registrationNumber', nullif(p.metadata #>> '{legal,state_registration}', '')
+       )) || p.custom_fields
+ WHERE p.kind = 'supplier'
+   AND (
+     (NOT (p.custom_fields ? 'serviceProviderType') AND nullif(p.metadata #>> '{contact,service_provider_type}', '') IS NOT NULL)
+     OR
+     (NOT (p.custom_fields ? 'registrationNumber') AND nullif(p.metadata #>> '{legal,state_registration}', '') IS NOT NULL)
+   );
+
+-- Suppliers imported before the normalized address book kept one legacy main
+-- address on people. Copy complete addresses once; partial addresses remain on
+-- the Person instead of inventing required postal/city/state values.
+INSERT INTO public.addresses (
+  tenant_id, owner_type, owner_id, kind, label, recipient, phone, postal_code,
+  street, number, complement, district, city, state, country, is_default, metadata
+)
+SELECT p.tenant_id, 'person', p.id, 'both', 'Principal', p.name, p.phone,
+       p.postal_code, p.address,
+       nullif(p.metadata #>> '{address,number}', ''),
+       nullif(p.metadata #>> '{address,complement}', ''),
+       nullif(p.metadata #>> '{address,neighborhood}', ''),
+       p.city, p.state, coalesce(nullif(p.country, ''), 'BR'), true,
+       jsonb_build_object('source', 'people_legacy_address')
+  FROM public.people p
+ WHERE p.kind = 'supplier'
+   AND nullif(p.postal_code, '') IS NOT NULL
+   AND nullif(p.address, '') IS NOT NULL
+   AND nullif(p.city, '') IS NOT NULL
+   AND nullif(p.state, '') IS NOT NULL
+   AND NOT EXISTS (
+     SELECT 1 FROM public.addresses a
+      WHERE a.owner_type = 'person' AND a.owner_id = p.id
+   );
+
+CREATE OR REPLACE FUNCTION public.people_available_unit_ids(p_person uuid)
+RETURNS uuid[]
+LANGUAGE plpgsql
+STABLE
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v_tenant uuid := public.people_assert_scope('people.manage');
+  v_units uuid[];
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM public.people p
+     WHERE p.tenant_id = v_tenant AND p.id = p_person AND p.merged_into_id IS NULL
+  ) THEN
+    RAISE EXCEPTION 'people_available_unit_ids: person not found in this tenant'
+      USING ERRCODE = 'P0002';
+  END IF;
+
+  SELECT coalesce(array_agg(g.subject_id ORDER BY g.subject_id), '{}'::uuid[])
+    INTO v_units
+    FROM app.resource_grants g
+   WHERE g.tenant_id = v_tenant
+     AND g.resource_type = 'people.person'
+     AND g.resource_id = p_person
+     AND g.relation = 'available_in'
+     AND g.subject_type = 'unit';
+
+  RETURN v_units;
+END $$;
+
+CREATE OR REPLACE FUNCTION public.people_set_available_units(
+  p_person uuid,
+  p_unit_ids uuid[] DEFAULT '{}'::uuid[]
+)
+RETURNS uuid[]
+LANGUAGE plpgsql
+SECURITY DEFINER
+SET search_path TO ''
+AS $$
+DECLARE
+  v_tenant uuid := public.people_assert_scope('people.manage');
+  v_unit_ids uuid[];
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM public.people p
+     WHERE p.tenant_id = v_tenant AND p.id = p_person AND p.merged_into_id IS NULL
+  ) THEN
+    RAISE EXCEPTION 'people_set_available_units: person not found in this tenant'
+      USING ERRCODE = 'P0002';
+  END IF;
+
+  SELECT coalesce(array_agg(DISTINCT requested.unit_id ORDER BY requested.unit_id), '{}'::uuid[])
+    INTO v_unit_ids
+    FROM unnest(coalesce(p_unit_ids, '{}'::uuid[])) AS requested(unit_id);
+
+  IF EXISTS (
+    SELECT 1
+      FROM unnest(v_unit_ids) AS requested(unit_id)
+      LEFT JOIN app.units u
+        ON u.id = requested.unit_id AND u.tenant_id = v_tenant
+     WHERE u.id IS NULL OR NOT app.has_unit(requested.unit_id)
+  ) THEN
+    RAISE EXCEPTION 'people_set_available_units: unit not found in this tenant'
+      USING ERRCODE = '42501';
+  END IF;
+
+  DELETE FROM app.resource_grants g
+   WHERE g.tenant_id = v_tenant
+     AND g.resource_type = 'people.person'
+     AND g.resource_id = p_person
+     AND g.relation = 'available_in'
+     AND g.subject_type = 'unit';
+
+  INSERT INTO app.resource_grants (
+    tenant_id, resource_type, resource_id, relation, subject_type, subject_id, created_by
+  )
+  SELECT v_tenant, 'people.person', p_person, 'available_in', 'unit', unit_id, auth.uid()
+    FROM unnest(v_unit_ids) AS requested(unit_id);
+
+  RETURN v_unit_ids;
+END $$;
+
+REVOKE ALL ON FUNCTION public.people_available_unit_ids(uuid) FROM PUBLIC;
+REVOKE ALL ON FUNCTION public.people_set_available_units(uuid, uuid[]) FROM PUBLIC;
+GRANT EXECUTE ON FUNCTION public.people_available_unit_ids(uuid) TO authenticated, service_role;
+GRANT EXECUTE ON FUNCTION public.people_set_available_units(uuid, uuid[]) TO authenticated, service_role;
+
+COMMENT ON FUNCTION public.people_available_unit_ids(uuid) IS
+  'Units where a Person record is available. Empty means organization-wide.';
+COMMENT ON FUNCTION public.people_set_available_units(uuid, uuid[]) IS
+  'Replaces the unit availability of a Person. Empty means organization-wide.';
+
+-- PostgREST may keep serving the previous function catalog after DDL. The
+-- explicit notification makes the new RPCs available as soon as this migration
+-- commits instead of waiting for a later cache refresh.
+NOTIFY pgrst, 'reload schema';

package/package.json

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