@fayz-ai/db 0.17.0 → 0.18.1

package/migrations/130_o_aviso_leva_a_algum_lugar.sql

@@ -0,0 +1,31 @@
+-- ============================================================================
+-- O aviso leva a ALGUM LUGAR
+--
+-- `public.notifications` guarda título, corpo, tipo e lido — e mais nada. Um
+-- aviso que diz "a conta de Fulana está aberta" e não leva até ela obriga a
+-- recepção a procurar o nome numa lista, que é o caminho que o aviso existia
+-- para evitar.
+--
+-- Duas colunas: para ONDE ir, e SOBRE O QUE é (o par polimórfico que o resto do
+-- schema já usa em `documents.subject_type/subject_id`). Com o assunto dá para
+-- não avisar duas vezes sobre o mesmo atendimento.
+-- ============================================================================
+
+ALTER TABLE public.notifications
+  ADD COLUMN IF NOT EXISTS link text,
+  ADD COLUMN IF NOT EXISTS subject_type text,
+  ADD COLUMN IF NOT EXISTS subject_id uuid;
+
+COMMENT ON COLUMN public.notifications.link IS
+  'Rota do app para onde o aviso leva (ex.: #/checkin). Sem isto o aviso informa e abandona.';
+COMMENT ON COLUMN public.notifications.subject_type IS
+  'Sobre o que é o aviso (appointment, order…), no mesmo par polimórfico de documents.';
+
+-- Um aviso por assunto e por pessoa: o mesmo atendimento finalizado duas vezes
+-- (reabrir e fechar de novo) não enche o sino.
+CREATE UNIQUE INDEX IF NOT EXISTS notifications_subject_user_uidx
+  ON public.notifications (user_id, subject_type, subject_id, type)
+  WHERE subject_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS notifications_user_unread_idx
+  ON public.notifications (user_id, created_at DESC) WHERE NOT read;

package/migrations/131_o_salao_fala_o_vocabulario_do_v1.sql

@@ -0,0 +1,81 @@
+-- ---------------------------------------------------------------------------
+-- 117_o_salao_fala_o_vocabulario_do_v1.sql — o rail do StudioControl passa a
+-- dizer o que o BeautySoft dizia.
+-- ---------------------------------------------------------------------------
+-- Estes clientes usam o V1 ha anos e vao receber o V2 com a mesma equipe, sem
+-- treinamento. Um rail que espalha Confirmacoes e Check-in como linhas soltas
+-- onde la eles sao filhos de Agenda, e que deixa Fornecedores fora de Cadastros
+-- tendo Cadastros logo abaixo, faz cada pessoa reaprender um menu que ela ja
+-- sabe de cor. Esse custo nao aparece em teste nenhum; aparece no chamado.
+--
+-- -- O que foi medido, dos dois lados, em 21/09/2026 --------------------------
+--
+-- V1 (Espaco Facial, unidade Treinamento, perfil dono):
+--
+--     Dashboard . Agenda v . Clientes v . Estoque . CRM . Financeiro .
+--     Cadastros v . Configuracoes . Relatorios
+--
+--     Agenda    v  Agendamentos . Confirmacoes . Check-in . Comunicacao
+--     Cadastros v  Contatos . Contas . Equipamentos . Fornecedores .
+--                  Funcionarios . Locais Operacionais . Origens . Parcerias .
+--                  Servicos . Profissionais . Recursos Humanos
+--
+-- V2 (`beauty`, lido do proprio rail):
+--
+--     / . /agenda . /agenda/confirmations . /checkin . /sales . /customers .
+--     /suppliers . /financial . /inventory . /marketing . /analytics .
+--     /clients . /registry . /settings
+--
+--     /registry v  services . categories . locations . location-groups .
+--                  staff . contacts . suppliers . partnerships . equipment
+--
+-- Tres diferencas de FORMA saltam dessa comparacao, e sao o que este arquivo
+-- conserta:
+--
+--   1. "Clientes" sai DUAS vezes  -- `/customers` e `/clients` sao a mesma
+--      linha do ponto de vista de quem usa. O ofício fica com `/clients`, que
+--      e a ficha que o salao abre; `/customers` some do rail.
+--   2. "Fornecedores" sai DUAS vezes -- solto em `/suppliers` e dentro de
+--      Cadastros em `/registry/suppliers`. No V1 ele mora em Cadastros e so.
+--   3. Agenda, Confirmacoes e Check-in sao tres linhas soltas onde o V1 tem
+--      uma gaveta.
+--
+-- -- O que o preset pode e o que ele nao pode --------------------------------
+-- Ele AGRUPA e ORDENA; quem NOMEIA e o plugin (083/101). Entao este arquivo
+-- nao escreve "Agendamentos" nem "Funcionarios" em lugar nenhum: diz quais
+-- PREFIXOS DE ROTA moram sob cada rubrica, e os rotulos continuam sendo os que
+-- cada plugin declara. Foi essa separacao que parou a briga entre a arvore de
+-- SQL e o catalogo, e ela nao vai ser reaberta por causa de um rotulo.
+--
+-- Fica, por isso, uma divergencia de VOCABULARIO que so o app resolve, anotada
+-- aqui para nao se perder: o V1 chama "Funcionarios" o que `/registry/staff`
+-- chama "Equipe", "Locais Operacionais" o que `/registry/locations` chama
+-- "Locais de Atendimento", e "CRM" o que `/sales` chama "Vendas".
+--
+-- `/resources` ja entra no `under` de Cadastros: a tabela de recursos (salas,
+-- macas, cadeiras) esta sendo criada agora, e no V1 esse cadastro mora em
+-- Cadastros. Prefixo que ainda nao serve rota nenhuma nao custa nada -- a
+-- rubrica simplesmente nao o recolhe ate a tela existir.
+--
+-- `hide` tira do rail o vocabulario que o V1 nao tem. NAO desliga modulo
+-- nenhum: as telas continuam existindo, roteadas e alcancaveis -- o que sai e
+-- a LINHA.
+-- ---------------------------------------------------------------------------
+
+UPDATE app.apps SET preset = (preset - 'rail' - 'hide') || $$
+{
+  "rail": [
+    "dashboard",
+    { "label": "Agenda", "icon": "Calendar",
+      "under": ["/agenda", "/checkin", "/conversations"] },
+    { "label": "Clientes", "icon": "Users", "under": ["/clients"] },
+    "inventory",
+    "crm",
+    "financial",
+    { "label": "Cadastros", "icon": "ClipboardList",
+      "under": ["/registry", "/resources", "/company", "/staff"] },
+    "reports"
+  ],
+  "hide": ["/customers", "/suppliers", "/marketing", "/analytics", "/tasks"]
+}
+$$::jsonb WHERE id = 'beauty';

package/migrations/132_o_cadastro_do_salao_fala_como_o_v1.sql

@@ -0,0 +1,91 @@
+-- ---------------------------------------------------------------------------
+-- 118_o_cadastro_do_salao_fala_como_o_v1.sql — o Cadastros do Espaço Facial.
+-- ---------------------------------------------------------------------------
+-- A 117 pôs as telas de cadastro sob UMA rubrica, e foi metade do caminho. A
+-- outra metade é o que a recepcionista lê quando abre o menu: ela vem de sete
+-- anos de BeautySoft, e lá a lista se chama assim, nesta ordem —
+--
+--     Contatos · Contas · Equipamentos · Fornecedores · Funcionários ·
+--     Locais Operacionais · Origens · Parcerias · Serviços ·
+--     Profissionais · Recursos Humanos
+--
+-- Três coisas faltavam para dizer isso, e as três agora são dado:
+--
+--   ORDEM     `under` passa a ser lida como sequência, não como conjunto. O
+--             V1 abre em Contatos e fecha em Serviços; a ordem de POSIÇÃO dos
+--             plugins não tem como saber disso. Um prefixo largo no fim
+--             (`/registry`) continua sendo o pega-tudo.
+--
+--   NOME      `labels` é um dicionário rota → nome. Não é a árvore paralela
+--             que a 083 matou: não há rota, ícone nem posição aqui, então não
+--             há como uma entrada desenhar uma linha que não existe. É só o
+--             ofício dizendo que na casa DELE `/registry/staff` se chama
+--             "Funcionários" — renomear isso no plugin renomearia a mesma tela
+--             no restaurante e na loja.
+--
+--   ORIGENS   a rota existe desde sempre, com rótulo vazio, e por isso nunca
+--             desenhou: uma linha sem nome não tem como aparecer. Nomeada pelo
+--             preset, ela volta ao menu sem o aplicativo mudar uma linha.
+--
+-- ── O que continua faltando, e por que não está aqui ───────────────────────
+--   Contas             existe DENTRO do Financeiro, como aba do módulo, não
+--                      como rota própria. Puxá-la para cá a tiraria de lá.
+--   Profissionais      o V1 separa quem TRABALHA na casa (Funcionários) de
+--                      quem ATENDE (Profissionais). O V2 tem uma pessoa só.
+--                      Eixo não modelado — não se inventa rubrica para ele.
+--   Recursos Humanos   é o plugin `workforce`, que este aplicativo não monta.
+--
+-- `modules` ganha `registry` junto: quem NÃO é oferecido não entra, mesmo
+-- instalado — e uma rubrica sobre telas que não existem some em silêncio, que
+-- foi exatamente o que aconteceu no aplicativo central.
+--
+-- Idempotente: reescreve `rail`, `hide` e `labels` por inteiro.
+-- ---------------------------------------------------------------------------
+
+UPDATE app.apps
+   SET preset = (preset - 'rail' - 'hide' - 'labels') || $$
+{
+  "rail": [
+    "dashboard",
+    { "label": "Agenda", "icon": "Calendar",
+      "under": ["/agenda", "/checkin", "/conversations"] },
+    { "label": "Clientes", "icon": "Users", "under": ["/clients"] },
+    "inventory",
+    "crm",
+    "financial",
+    { "label": "Cadastros", "icon": "ClipboardList",
+      "under": ["/registry/contacts",
+                "/registry/equipment",
+                "/registry/suppliers",
+                "/registry/staff",
+                "/registry/locations",
+                "/registry/location-groups",
+                "/registry/origins",
+                "/registry/partnerships",
+                "/registry/services",
+                "/registry/categories",
+                "/registry", "/resources", "/company", "/staff"] },
+    "reports"
+  ],
+  "hide": ["/customers", "/suppliers", "/marketing", "/analytics", "/tasks"],
+  "labels": {
+    "/": "Dashboard",
+    "/sales": "CRM",
+    "/registry/staff": "Funcionários",
+    "/registry/locations": "Locais Operacionais",
+    "/registry/origins": "Origens",
+    "/registry/services": "Serviços",
+    "/registry/categories": "Categorias"
+  }
+}
+$$::jsonb WHERE id = 'beauty';
+
+-- O ofício passa a OFERECER os Cadastros. Sem isto o plugin fica instalado e
+-- calado: `resolvePluginRuntime` só liga por padrão quem está na oferta.
+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))
+ WHERE id = 'beauty';

package/migrations/133_a_agenda_do_salao_perde_o_que_nao_e_dela.sql

@@ -0,0 +1,69 @@
+-- ---------------------------------------------------------------------------
+-- 119_a_agenda_do_salao_perde_o_que_nao_e_dela.sql
+-- ---------------------------------------------------------------------------
+-- O grupo Agenda tinha recolhido `/conversations` inteiro, e com ele vieram
+-- duas telas que não são da recepção: Campanhas (disparo em massa) e Templates
+-- (modelos de mensagem). No V1 o grupo tem QUATRO linhas —
+--
+--     Agendamentos · Confirmações · Check-in · Comunicação
+--
+-- — e "Comunicação" é a régua: o que sai sozinho em torno de um horário
+-- marcado. Campanha é do marketing e não pertence ao grupo; o que mais se
+-- parece com a régua hoje é a tela de modelos, então ela passa a se chamar
+-- Comunicação até a régua existir de fato.
+--
+-- ── Clientes volta ao rail ─────────────────────────────────────────────────
+-- A 117 escondeu `/customers` porque o salão tinha `/clients`, e o aplicativo
+-- central não tem — a rubrica ficava sem filho e sumia, e a conta abria sem a
+-- tela mais usada do dia. `/customers` É a lista de clientes aqui; o `hide`
+-- existia para não mostrar o mesmo módulo com dois nomes, e sem o segundo nome
+-- ele não tem o que resolver.
+--
+-- `/customers` se chama "Listar" e não "Clientes": a rubrica já diz Clientes,
+-- e o índice de um grupo herda o nome do pai — saía "Clientes > Clientes".
+-- Ao lado dele entra "Inserir", que é o par do V1.
+--
+-- Idempotente: reescreve `rail`, `hide` e `labels` por inteiro.
+-- ---------------------------------------------------------------------------
+
+UPDATE app.apps
+   SET preset = (preset - 'rail' - 'hide' - 'labels') || $$
+{
+  "rail": [
+    "dashboard",
+    { "label": "Agenda", "icon": "Calendar",
+      "under": ["/agenda", "/checkin", "/conversations"] },
+    { "label": "Clientes", "icon": "Users", "under": ["/clients", "/customers"] },
+    "inventory",
+    "crm",
+    "financial",
+    { "label": "Cadastros", "icon": "ClipboardList",
+      "under": ["/registry/contacts",
+                "/registry/equipment",
+                "/registry/suppliers",
+                "/registry/staff",
+                "/registry/locations",
+                "/registry/location-groups",
+                "/registry/origins",
+                "/registry/partnerships",
+                "/registry/services",
+                "/registry/categories",
+                "/registry", "/resources", "/company", "/staff"] },
+    "reports"
+  ],
+  "hide": ["/suppliers", "/marketing", "/analytics", "/tasks",
+           "/conversations/campaigns"],
+  "labels": {
+    "/": "Dashboard",
+    "/sales": "CRM",
+    "/customers": "Listar",
+    "/customers/new": "Inserir",
+    "/conversations/templates": "Comunicação",
+    "/registry/staff": "Funcionários",
+    "/registry/locations": "Locais Operacionais",
+    "/registry/origins": "Origens",
+    "/registry/services": "Serviços",
+    "/registry/categories": "Categorias"
+  }
+}
+$$::jsonb WHERE id = 'beauty';

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/package.json

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