@fayz-ai/db 0.30.0 → 0.31.0

package/migrations/225_a_task_can_be_a_call.sql

@@ -0,0 +1,38 @@
+-- ============================================================================
+-- 225_a_task_can_be_a_call — the one task list carries calls and knows what
+-- record it is about.
+--
+-- The feira campaign's touch 3 wrote 105 calls as CRM activities, out of the
+-- tasks drawer, and the CRM grew its own list over them: two places for the
+-- same to-do (11-03). `tasks` stays the single store, with what a call needs:
+--
+--   * `kind`      — 'todo' (the default, what the drawer always had) or 'call';
+--   * `subject_type` / `subject_id` — the record it is about ('crm.deal', <id>),
+--     so the deal shows its open tasks and a done call lands on its timeline;
+--   * `phones`    — [{ "label", "number" }], the numbers to try, in order;
+--   * `outcome`   — what happened when it was done ('connected', 'no_answer',
+--     'left_message', 'scheduled', 'replied'), the vocabulary of CRM activities.
+--
+-- Idempotent and replay-safe.
+-- ============================================================================
+
+ALTER TABLE public.tasks ADD COLUMN IF NOT EXISTS kind text NOT NULL DEFAULT 'todo';
+ALTER TABLE public.tasks ADD COLUMN IF NOT EXISTS subject_type text;
+ALTER TABLE public.tasks ADD COLUMN IF NOT EXISTS subject_id uuid;
+ALTER TABLE public.tasks ADD COLUMN IF NOT EXISTS phones jsonb NOT NULL DEFAULT '[]'::jsonb;
+ALTER TABLE public.tasks ADD COLUMN IF NOT EXISTS outcome text;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'tasks_kind_check') THEN
+    ALTER TABLE public.tasks ADD CONSTRAINT tasks_kind_check CHECK (kind IN ('todo', 'call'));
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'tasks_outcome_check') THEN
+    ALTER TABLE public.tasks ADD CONSTRAINT tasks_outcome_check
+      CHECK (outcome IS NULL OR outcome IN ('connected', 'no_answer', 'left_message', 'replied', 'scheduled'));
+  END IF;
+END $$;
+
+CREATE INDEX IF NOT EXISTS tasks_subject_idx ON public.tasks (tenant_id, subject_type, subject_id);
+CREATE INDEX IF NOT EXISTS tasks_open_assignee_idx ON public.tasks (tenant_id, assigned_to_id, due_date)
+  WHERE status IN ('todo', 'in_progress');

package/migrations/225_stock_can_go_below_zero_when_the_house_says_so.sql

@@ -0,0 +1,49 @@
+-- ============================================================================
+-- 225 — stock can go below zero when the house says so
+--
+-- stock_apply refused any on_hand below zero. A house that sells before it
+-- produces (Artorius, with no production module yet) switches «Permitir estoque
+-- negativo» on in Configurações › Estoque, so a sale of a product it does not
+-- have yet is recorded, and the negative balance tells it what to produce.
+--
+-- The core does not read the inventory's settings. The inventory, which does,
+-- marks its own transaction with `fayz.stock_allow_negative = on` before it
+-- calls stock_apply (plugin-inventory 037); only then is a negative on_hand
+-- accepted. Every other caller is refused as before.
+--
+-- Idempotent and replay-safe: CREATE OR REPLACE, same signature.
+-- ============================================================================
+
+CREATE OR REPLACE FUNCTION public.stock_apply(p_tenant uuid, p_variant uuid, p_unit uuid, p_on_hand numeric DEFAULT 0, p_reserved numeric DEFAULT 0, p_source text DEFAULT 'inventory'::text)
+ RETURNS jsonb
+ LANGUAGE plpgsql
+ SECURITY DEFINER
+ SET search_path TO ''
+AS $function$
+DECLARE
+  v_on_hand  numeric;
+  v_reserved numeric;
+BEGIN
+  IF p_tenant IS NULL OR p_variant IS NULL THEN
+    RAISE EXCEPTION 'stock_apply: tenant and variant are required' USING ERRCODE = '22023';
+  END IF;
+
+  INSERT INTO public.stock_balances (tenant_id, variant_id, unit_id, on_hand, reserved, updated_by)
+  VALUES (p_tenant, p_variant, p_unit, coalesce(p_on_hand, 0), greatest(coalesce(p_reserved, 0), 0), p_source)
+  ON CONFLICT (tenant_id, variant_id, coalesce(unit_id, '00000000-0000-0000-0000-000000000000'::uuid)) DO UPDATE
+    SET on_hand    = public.stock_balances.on_hand + coalesce(p_on_hand, 0),
+        reserved   = greatest(public.stock_balances.reserved + coalesce(p_reserved, 0), 0),
+        updated_at = now(),
+        updated_by = p_source
+  RETURNING on_hand, reserved INTO v_on_hand, v_reserved;
+
+  -- Below zero is a data question, not a rounding one: the caller that asked for
+  -- it is the one that has to answer — unless the inventory, following the
+  -- house's «estoque negativo» switch, said it may (225).
+  IF v_on_hand < 0 AND coalesce(current_setting('fayz.stock_allow_negative', true), 'off') <> 'on' THEN
+    RAISE EXCEPTION 'stock_apply: % would take variant % below zero (%)', p_source, p_variant, v_on_hand
+      USING ERRCODE = '23514';
+  END IF;
+
+  RETURN jsonb_build_object('on_hand', v_on_hand, 'reserved', v_reserved, 'available', v_on_hand - v_reserved);
+END $function$;

package/package.json

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