@fayz-ai/plugin-financial 0.2.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/dist/data/supabase.d.ts.map +1 -1
- package/dist/data/tables.d.ts +11 -0
- package/dist/data/tables.d.ts.map +1 -0
- package/dist/index.cjs +64 -52
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +64 -52
- package/dist/index.js.map +1 -1
- package/dist/migrations/index.d.ts +16 -0
- package/dist/migrations/index.d.ts.map +1 -0
- package/dist/registries.d.ts.map +1 -1
- package/package.json +10 -4
- package/src/README.md +5 -5
- package/src/contract.test.ts +1 -1
- package/src/data/supabase.ts +50 -47
- package/src/data/tables.ts +12 -0
- package/src/migrations/000_plg_rename.sql +30 -0
- package/src/migrations/001_financial_base.sql +30 -30
- package/src/migrations/002_chart_of_accounts.sql +10 -10
- package/src/migrations/003_card_brands.sql +4 -4
- package/src/migrations/004_order_to_cash.sql +28 -28
- package/src/migrations/005_seed_defaults.sql +6 -6
- package/src/migrations/006_rls_policies.sql +5 -5
- package/src/migrations/{006_extract_fee_amount.sql → 006b_extract_fee_amount.sql} +4 -4
- package/src/migrations/007_reconciliation.sql +9 -9
- package/src/migrations/007b_movement_payment_method_type.sql +6 -0
- package/src/migrations/008_split_payment_movements.sql +5 -5
- package/src/migrations/index.ts +544 -0
- package/src/registries.ts +8 -7
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
-- Financial Plugin: Base Tables
|
|
2
2
|
-- Pattern: uuid PK, tenant_id FK, timestamps, RLS via project_rls.sql auto-detection
|
|
3
3
|
|
|
4
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
4
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_payment_method_types (
|
|
5
5
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
6
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
6
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
7
7
|
name text NOT NULL,
|
|
8
8
|
transaction_type text NOT NULL,
|
|
9
9
|
is_active boolean NOT NULL DEFAULT true,
|
|
@@ -11,14 +11,14 @@ CREATE TABLE IF NOT EXISTS public.payment_method_types (
|
|
|
11
11
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
12
12
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
13
13
|
);
|
|
14
|
-
ALTER TABLE public.
|
|
15
|
-
CREATE INDEX IF NOT EXISTS
|
|
14
|
+
ALTER TABLE public.plg_financial_payment_method_types ENABLE ROW LEVEL SECURITY;
|
|
15
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_payment_method_types_tenant ON public.plg_financial_payment_method_types(tenant_id);
|
|
16
16
|
|
|
17
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
17
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_payment_methods (
|
|
18
18
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
19
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
19
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
20
20
|
name text NOT NULL,
|
|
21
|
-
payment_method_type_id uuid REFERENCES public.
|
|
21
|
+
payment_method_type_id uuid REFERENCES public.plg_financial_payment_method_types(id),
|
|
22
22
|
is_active boolean NOT NULL DEFAULT true,
|
|
23
23
|
discount_mode text,
|
|
24
24
|
discount_value numeric(12,2) DEFAULT 0,
|
|
@@ -31,12 +31,12 @@ CREATE TABLE IF NOT EXISTS public.payment_methods (
|
|
|
31
31
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
32
32
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
33
33
|
);
|
|
34
|
-
ALTER TABLE public.
|
|
35
|
-
CREATE INDEX IF NOT EXISTS
|
|
34
|
+
ALTER TABLE public.plg_financial_payment_methods ENABLE ROW LEVEL SECURITY;
|
|
35
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_payment_methods_tenant ON public.plg_financial_payment_methods(tenant_id);
|
|
36
36
|
|
|
37
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
37
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_bank_accounts (
|
|
38
38
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
39
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
39
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
40
40
|
name text NOT NULL,
|
|
41
41
|
account_type text NOT NULL DEFAULT 'bank_account',
|
|
42
42
|
bank_name text,
|
|
@@ -52,13 +52,13 @@ CREATE TABLE IF NOT EXISTS public.bank_accounts (
|
|
|
52
52
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
53
53
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
54
54
|
);
|
|
55
|
-
ALTER TABLE public.
|
|
56
|
-
CREATE INDEX IF NOT EXISTS
|
|
55
|
+
ALTER TABLE public.plg_financial_bank_accounts ENABLE ROW LEVEL SECURITY;
|
|
56
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_bank_accounts_tenant ON public.plg_financial_bank_accounts(tenant_id);
|
|
57
57
|
|
|
58
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
58
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_cash_register_sessions (
|
|
59
59
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
60
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
61
|
-
bank_account_id uuid NOT NULL REFERENCES public.
|
|
60
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
61
|
+
bank_account_id uuid NOT NULL REFERENCES public.plg_financial_bank_accounts(id),
|
|
62
62
|
status text NOT NULL DEFAULT 'open',
|
|
63
63
|
opened_at timestamptz NOT NULL DEFAULT now(),
|
|
64
64
|
opened_by_user_id uuid,
|
|
@@ -75,15 +75,15 @@ CREATE TABLE IF NOT EXISTS public.cash_register_sessions (
|
|
|
75
75
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
76
76
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
77
77
|
);
|
|
78
|
-
ALTER TABLE public.
|
|
79
|
-
CREATE INDEX IF NOT EXISTS
|
|
78
|
+
ALTER TABLE public.plg_financial_cash_register_sessions ENABLE ROW LEVEL SECURITY;
|
|
79
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_cash_register_sessions_tenant ON public.plg_financial_cash_register_sessions(tenant_id);
|
|
80
80
|
|
|
81
81
|
-- Financial movements (installments, payments) — plugin-specific, not archetype
|
|
82
|
-
-- Invoices themselves use
|
|
83
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
82
|
+
-- Invoices themselves use public.orders (kind='invoice_payable'/'invoice_receivable')
|
|
83
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_movements (
|
|
84
84
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
85
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
86
|
-
invoice_id uuid REFERENCES
|
|
85
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
86
|
+
invoice_id uuid REFERENCES public.orders(id),
|
|
87
87
|
direction text NOT NULL,
|
|
88
88
|
movement_kind text NOT NULL,
|
|
89
89
|
amount numeric(14,2) NOT NULL,
|
|
@@ -92,9 +92,9 @@ CREATE TABLE IF NOT EXISTS public.financial_movements (
|
|
|
92
92
|
due_date date NOT NULL,
|
|
93
93
|
payment_date date,
|
|
94
94
|
installment_number integer,
|
|
95
|
-
payment_method_id uuid REFERENCES public.
|
|
96
|
-
bank_account_id uuid REFERENCES public.
|
|
97
|
-
cash_session_id uuid REFERENCES public.
|
|
95
|
+
payment_method_id uuid REFERENCES public.plg_financial_payment_methods(id),
|
|
96
|
+
bank_account_id uuid REFERENCES public.plg_financial_bank_accounts(id),
|
|
97
|
+
cash_session_id uuid REFERENCES public.plg_financial_cash_register_sessions(id),
|
|
98
98
|
card_brand text,
|
|
99
99
|
card_installments integer,
|
|
100
100
|
notes text,
|
|
@@ -102,8 +102,8 @@ CREATE TABLE IF NOT EXISTS public.financial_movements (
|
|
|
102
102
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
103
103
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
104
104
|
);
|
|
105
|
-
ALTER TABLE public.
|
|
106
|
-
CREATE INDEX IF NOT EXISTS
|
|
107
|
-
CREATE INDEX IF NOT EXISTS
|
|
108
|
-
CREATE INDEX IF NOT EXISTS
|
|
109
|
-
CREATE INDEX IF NOT EXISTS
|
|
105
|
+
ALTER TABLE public.plg_financial_movements ENABLE ROW LEVEL SECURITY;
|
|
106
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_tenant ON public.plg_financial_movements(tenant_id);
|
|
107
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_invoice ON public.plg_financial_movements(invoice_id);
|
|
108
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_due ON public.plg_financial_movements(tenant_id, due_date);
|
|
109
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_bank ON public.plg_financial_movements(bank_account_id);
|
|
@@ -1,28 +1,28 @@
|
|
|
1
1
|
-- Financial Plugin: Chart of Accounts + Cost Centers
|
|
2
2
|
|
|
3
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
3
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_chart_of_accounts (
|
|
4
4
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
5
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
5
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
6
6
|
code text NOT NULL,
|
|
7
7
|
name text NOT NULL,
|
|
8
8
|
node_type text NOT NULL DEFAULT 'leaf',
|
|
9
|
-
parent_id uuid REFERENCES public.
|
|
9
|
+
parent_id uuid REFERENCES public.plg_financial_chart_of_accounts(id),
|
|
10
10
|
is_active boolean NOT NULL DEFAULT true,
|
|
11
11
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
12
12
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
13
13
|
);
|
|
14
|
-
ALTER TABLE public.
|
|
15
|
-
CREATE INDEX IF NOT EXISTS
|
|
16
|
-
CREATE INDEX IF NOT EXISTS
|
|
14
|
+
ALTER TABLE public.plg_financial_chart_of_accounts ENABLE ROW LEVEL SECURITY;
|
|
15
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_chart_of_accounts_tenant ON public.plg_financial_chart_of_accounts(tenant_id);
|
|
16
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_chart_of_accounts_parent ON public.plg_financial_chart_of_accounts(parent_id);
|
|
17
17
|
|
|
18
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
18
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_cost_centers (
|
|
19
19
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
20
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
20
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
21
21
|
code text NOT NULL,
|
|
22
22
|
name text NOT NULL,
|
|
23
23
|
is_active boolean NOT NULL DEFAULT true,
|
|
24
24
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
25
25
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
26
26
|
);
|
|
27
|
-
ALTER TABLE public.
|
|
28
|
-
CREATE INDEX IF NOT EXISTS
|
|
27
|
+
ALTER TABLE public.plg_financial_cost_centers ENABLE ROW LEVEL SECURITY;
|
|
28
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_cost_centers_tenant ON public.plg_financial_cost_centers(tenant_id);
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
-- Financial Plugin: Card Brands
|
|
2
2
|
|
|
3
|
-
CREATE TABLE IF NOT EXISTS public.
|
|
3
|
+
CREATE TABLE IF NOT EXISTS public.plg_financial_card_brands (
|
|
4
4
|
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
5
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
5
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
|
|
6
6
|
name text NOT NULL,
|
|
7
7
|
is_active boolean NOT NULL DEFAULT true,
|
|
8
8
|
created_at timestamptz NOT NULL DEFAULT now(),
|
|
9
9
|
updated_at timestamptz NOT NULL DEFAULT now()
|
|
10
10
|
);
|
|
11
|
-
ALTER TABLE public.
|
|
12
|
-
CREATE INDEX IF NOT EXISTS
|
|
11
|
+
ALTER TABLE public.plg_financial_card_brands ENABLE ROW LEVEL SECURITY;
|
|
12
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_card_brands_tenant ON public.plg_financial_card_brands(tenant_id);
|
|
@@ -1,45 +1,45 @@
|
|
|
1
1
|
-- Financial plugin — order-to-cash companion SQL.
|
|
2
2
|
-- The atomic "promote an order into an invoice + installment ledger" function
|
|
3
3
|
-- that CRM (approveQuote) and the agenda financial bridge both RPC. It belongs
|
|
4
|
-
-- to the financial plugin (it writes
|
|
4
|
+
-- to the financial plugin (it writes plg_financial_movements + reads orders), and it
|
|
5
5
|
-- ships WITH the plugin so enabling Payments provisions it. Idempotent.
|
|
6
|
-
-- Depends on:
|
|
6
|
+
-- Depends on: public.orders, public.plg_financial_movements (001_financial_base).
|
|
7
7
|
|
|
8
8
|
-- 1. Sequence generator (REC-00001 / PAG-00001 numbering)
|
|
9
|
-
CREATE TABLE IF NOT EXISTS
|
|
10
|
-
tenant_id uuid NOT NULL REFERENCES
|
|
9
|
+
CREATE TABLE IF NOT EXISTS public.sequences (
|
|
10
|
+
tenant_id uuid NOT NULL REFERENCES public.tenants(id),
|
|
11
11
|
kind text NOT NULL,
|
|
12
12
|
current_value bigint NOT NULL DEFAULT 0,
|
|
13
13
|
PRIMARY KEY (tenant_id, kind)
|
|
14
14
|
);
|
|
15
|
-
CREATE OR REPLACE FUNCTION
|
|
15
|
+
CREATE OR REPLACE FUNCTION public.next_sequence(p_tenant_id uuid, p_kind text)
|
|
16
16
|
RETURNS bigint LANGUAGE plpgsql AS $$
|
|
17
17
|
DECLARE v_next bigint;
|
|
18
18
|
BEGIN
|
|
19
|
-
INSERT INTO
|
|
19
|
+
INSERT INTO public.sequences (tenant_id, kind, current_value)
|
|
20
20
|
VALUES (p_tenant_id, p_kind, 1)
|
|
21
21
|
ON CONFLICT (tenant_id, kind)
|
|
22
|
-
DO UPDATE SET current_value =
|
|
22
|
+
DO UPDATE SET current_value = public.sequences.current_value + 1
|
|
23
23
|
RETURNING current_value INTO v_next;
|
|
24
24
|
RETURN v_next;
|
|
25
25
|
END;
|
|
26
26
|
$$;
|
|
27
27
|
|
|
28
|
-
-- 2. Order-to-cash columns on the spine orders (plugin extends
|
|
29
|
-
ALTER TABLE
|
|
28
|
+
-- 2. Order-to-cash columns on the spine orders (plugin extends public.orders)
|
|
29
|
+
ALTER TABLE public.orders
|
|
30
30
|
ADD COLUMN IF NOT EXISTS stage text,
|
|
31
31
|
ADD COLUMN IF NOT EXISTS direction text;
|
|
32
32
|
|
|
33
|
-
-- 3. RLS + grants for
|
|
34
|
-
ALTER TABLE public.
|
|
35
|
-
GRANT SELECT, INSERT, UPDATE, DELETE ON public.
|
|
33
|
+
-- 3. RLS + grants for plg_financial_movements (table from 001_financial_base.sql)
|
|
34
|
+
ALTER TABLE public.plg_financial_movements ENABLE ROW LEVEL SECURITY;
|
|
35
|
+
GRANT SELECT, INSERT, UPDATE, DELETE ON public.plg_financial_movements TO authenticated;
|
|
36
36
|
DO $$
|
|
37
37
|
BEGIN
|
|
38
|
-
IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename='
|
|
39
|
-
CREATE POLICY
|
|
40
|
-
CREATE POLICY
|
|
41
|
-
CREATE POLICY
|
|
42
|
-
CREATE POLICY
|
|
38
|
+
IF NOT EXISTS (SELECT 1 FROM pg_policies WHERE schemaname='public' AND tablename='plg_financial_movements' AND policyname='plg_financial_movements_select') THEN
|
|
39
|
+
CREATE POLICY plg_financial_movements_select ON public.plg_financial_movements FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
|
|
40
|
+
CREATE POLICY plg_financial_movements_insert ON public.plg_financial_movements FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
|
|
41
|
+
CREATE POLICY plg_financial_movements_update ON public.plg_financial_movements FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
|
|
42
|
+
CREATE POLICY plg_financial_movements_delete ON public.plg_financial_movements FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
|
|
43
43
|
END IF;
|
|
44
44
|
END $$;
|
|
45
45
|
|
|
@@ -54,10 +54,10 @@ CREATE OR REPLACE FUNCTION public.fn_invoice_from_order(
|
|
|
54
54
|
) RETURNS uuid
|
|
55
55
|
LANGUAGE plpgsql
|
|
56
56
|
SECURITY DEFINER
|
|
57
|
-
SET search_path = public
|
|
57
|
+
SET search_path = public
|
|
58
58
|
AS $$
|
|
59
59
|
DECLARE
|
|
60
|
-
v_order
|
|
60
|
+
v_order public.orders%ROWTYPE;
|
|
61
61
|
v_ref text;
|
|
62
62
|
v_seq bigint;
|
|
63
63
|
v_summary text;
|
|
@@ -73,27 +73,27 @@ DECLARE
|
|
|
73
73
|
v_due date;
|
|
74
74
|
i int;
|
|
75
75
|
BEGIN
|
|
76
|
-
SELECT * INTO v_order FROM
|
|
76
|
+
SELECT * INTO v_order FROM public.orders WHERE id = p_order_id;
|
|
77
77
|
IF NOT FOUND THEN RAISE EXCEPTION 'fn_invoice_from_order: order % not found', p_order_id; END IF;
|
|
78
78
|
IF v_order.tenant_id NOT IN (SELECT public.user_tenant_ids()) THEN
|
|
79
79
|
RAISE EXCEPTION 'fn_invoice_from_order: forbidden';
|
|
80
80
|
END IF;
|
|
81
81
|
|
|
82
|
-
SELECT id INTO v_existing FROM public.
|
|
82
|
+
SELECT id INTO v_existing FROM public.plg_financial_movements
|
|
83
83
|
WHERE invoice_id = p_order_id AND movement_kind = 'bill' LIMIT 1;
|
|
84
84
|
IF v_existing IS NOT NULL THEN RETURN p_order_id; END IF;
|
|
85
85
|
|
|
86
86
|
IF p_direction = 'debit' THEN v_kind := 'invoice_payable'; v_prefix := 'PAG';
|
|
87
87
|
ELSE v_kind := 'invoice_receivable'; v_prefix := 'REC'; END IF;
|
|
88
88
|
|
|
89
|
-
SELECT
|
|
89
|
+
SELECT public.next_sequence(v_order.tenant_id, v_kind) INTO v_seq;
|
|
90
90
|
v_ref := v_prefix || '-' || lpad(v_seq::text, 5, '0');
|
|
91
91
|
|
|
92
92
|
SELECT string_agg(name, ', ' ORDER BY sort_order) INTO v_summary
|
|
93
|
-
FROM
|
|
94
|
-
SELECT name INTO v_contact FROM
|
|
93
|
+
FROM public.order_items WHERE order_id = p_order_id;
|
|
94
|
+
SELECT name INTO v_contact FROM public.people WHERE id = v_order.party_id;
|
|
95
95
|
|
|
96
|
-
UPDATE
|
|
96
|
+
UPDATE public.orders SET
|
|
97
97
|
status = COALESCE(p_status, status),
|
|
98
98
|
stage = 'invoiced',
|
|
99
99
|
direction = p_direction,
|
|
@@ -114,7 +114,7 @@ BEGIN
|
|
|
114
114
|
FOR i IN 1..v_n LOOP
|
|
115
115
|
IF i = v_n THEN v_amt := round(v_total - v_alloc, 2);
|
|
116
116
|
ELSE v_amt := v_base; v_alloc := v_alloc + v_base; END IF;
|
|
117
|
-
INSERT INTO public.
|
|
117
|
+
INSERT INTO public.plg_financial_movements
|
|
118
118
|
(tenant_id, invoice_id, direction, movement_kind, amount, paid_amount, status, due_date, installment_number)
|
|
119
119
|
VALUES
|
|
120
120
|
(v_order.tenant_id, p_order_id, p_direction, 'bill', v_amt, 0, 'pending',
|
|
@@ -134,7 +134,7 @@ WITH bill AS (
|
|
|
134
134
|
SUM(amount) FILTER (WHERE status <> 'cancelled') AS billed,
|
|
135
135
|
SUM(paid_amount) FILTER (WHERE status <> 'cancelled') AS paid,
|
|
136
136
|
bool_or(status NOT IN ('paid','cancelled') AND due_date < current_date) AS has_overdue
|
|
137
|
-
FROM public.
|
|
137
|
+
FROM public.plg_financial_movements
|
|
138
138
|
WHERE movement_kind = 'bill'
|
|
139
139
|
GROUP BY invoice_id
|
|
140
140
|
)
|
|
@@ -154,7 +154,7 @@ SELECT
|
|
|
154
154
|
ELSE 'open'
|
|
155
155
|
END AS status,
|
|
156
156
|
o.created_at, o.updated_at
|
|
157
|
-
FROM
|
|
157
|
+
FROM public.orders o
|
|
158
158
|
LEFT JOIN bill b ON b.invoice_id = o.id
|
|
159
159
|
WHERE o.kind IN ('invoice_receivable','invoice_payable') OR b.invoice_id IS NOT NULL;
|
|
160
160
|
ALTER VIEW public.v_invoice_balances SET (security_invoker = true);
|
|
@@ -8,11 +8,11 @@ DO $$
|
|
|
8
8
|
DECLARE t_id uuid;
|
|
9
9
|
BEGIN
|
|
10
10
|
FOR t_id IN (
|
|
11
|
-
SELECT id FROM
|
|
12
|
-
WHERE id NOT IN (SELECT DISTINCT tenant_id FROM public.
|
|
11
|
+
SELECT id FROM public.tenants
|
|
12
|
+
WHERE id NOT IN (SELECT DISTINCT tenant_id FROM public.plg_financial_payment_method_types)
|
|
13
13
|
)
|
|
14
14
|
LOOP
|
|
15
|
-
INSERT INTO public.
|
|
15
|
+
INSERT INTO public.plg_financial_payment_method_types (tenant_id, name, transaction_type) VALUES
|
|
16
16
|
(t_id, 'Cash', 'cash'),
|
|
17
17
|
(t_id, 'PIX', 'pix'),
|
|
18
18
|
(t_id, 'Credit Card', 'credit_card'),
|
|
@@ -26,11 +26,11 @@ DO $$
|
|
|
26
26
|
DECLARE t_id uuid;
|
|
27
27
|
BEGIN
|
|
28
28
|
FOR t_id IN (
|
|
29
|
-
SELECT id FROM
|
|
30
|
-
WHERE id NOT IN (SELECT DISTINCT tenant_id FROM public.
|
|
29
|
+
SELECT id FROM public.tenants
|
|
30
|
+
WHERE id NOT IN (SELECT DISTINCT tenant_id FROM public.plg_financial_card_brands)
|
|
31
31
|
)
|
|
32
32
|
LOOP
|
|
33
|
-
INSERT INTO public.
|
|
33
|
+
INSERT INTO public.plg_financial_card_brands (tenant_id, name) VALUES
|
|
34
34
|
(t_id, 'Visa'), (t_id, 'Mastercard'), (t_id, 'American Express'),
|
|
35
35
|
(t_id, 'Elo'), (t_id, 'Hipercard'), (t_id, 'Diners Club'),
|
|
36
36
|
(t_id, 'Discover'), (t_id, 'JCB'), (t_id, 'Aura'), (t_id, 'Hiper');
|
|
@@ -3,10 +3,10 @@
|
|
|
3
3
|
-- The base migrations (001/002/003) ENABLE row-level security but relied on an
|
|
4
4
|
-- external `project_rls.sql` auto-detection step to create the actual policies.
|
|
5
5
|
-- That step does not run in the Drizzle/companion pipeline, so every table
|
|
6
|
-
-- except
|
|
6
|
+
-- except plg_financial_movements was RLS-enabled with NO policy → all inserts denied
|
|
7
7
|
-- ("new row violates row-level security policy"). This creates the canonical
|
|
8
8
|
-- per-tenant policies idempotently. Re-running is a no-op (IF NOT EXISTS guards;
|
|
9
|
-
--
|
|
9
|
+
-- plg_financial_movements policies from 004 are skipped).
|
|
10
10
|
--
|
|
11
11
|
-- Canonical RLS form: tenant_id IN (SELECT public.user_tenant_ids()).
|
|
12
12
|
|
|
@@ -14,9 +14,9 @@ DO $$
|
|
|
14
14
|
DECLARE t text;
|
|
15
15
|
BEGIN
|
|
16
16
|
FOR t IN SELECT unnest(ARRAY[
|
|
17
|
-
'
|
|
18
|
-
'
|
|
19
|
-
'
|
|
17
|
+
'plg_financial_payment_method_types','plg_financial_payment_methods','plg_financial_bank_accounts',
|
|
18
|
+
'plg_financial_cash_register_sessions','plg_financial_movements',
|
|
19
|
+
'plg_financial_chart_of_accounts','plg_financial_cost_centers','plg_financial_card_brands'
|
|
20
20
|
])
|
|
21
21
|
LOOP
|
|
22
22
|
EXECUTE format('ALTER TABLE public.%I ENABLE ROW LEVEL SECURITY', t);
|
|
@@ -5,14 +5,14 @@
|
|
|
5
5
|
-- the running balance reflects the NET cash that actually lands in the account.
|
|
6
6
|
-- gross = paid_amount (settles the receivable/payable)
|
|
7
7
|
-- net cash = paid_amount - fee_amount (credits only; v1 has no fee on debits)
|
|
8
|
-
ALTER TABLE public.
|
|
8
|
+
ALTER TABLE public.plg_financial_movements
|
|
9
9
|
ADD COLUMN IF NOT EXISTS fee_amount numeric(14,2) NOT NULL DEFAULT 0;
|
|
10
10
|
|
|
11
|
-
COMMENT ON COLUMN public.
|
|
11
|
+
COMMENT ON COLUMN public.plg_financial_movements.fee_amount IS
|
|
12
12
|
'Processing/MDR fee deducted at settlement. Net cash impact = paid_amount - fee_amount (credit). v1: same-day net, no D+N settlement-date modeling.';
|
|
13
13
|
|
|
14
|
-
CREATE INDEX IF NOT EXISTS
|
|
15
|
-
ON public.
|
|
14
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_statement
|
|
15
|
+
ON public.plg_financial_movements (bank_account_id, payment_date)
|
|
16
16
|
WHERE status IN ('paid', 'partial');
|
|
17
17
|
|
|
18
18
|
-- Transfers between accounts = a debit row (source) + credit row (destination),
|
|
@@ -2,31 +2,31 @@
|
|
|
2
2
|
-- Reconciliation (conciliação): bank-statement lines ↔ internal movements
|
|
3
3
|
-- ---------------------------------------------------------------------------
|
|
4
4
|
-- An integration (e.g. open banking) imports bank-statement lines as
|
|
5
|
-
--
|
|
5
|
+
-- plg_financial_movements tagged with (external_source, external_id). The matching
|
|
6
6
|
-- UI then links each imported line to the internal movement it settles, or
|
|
7
7
|
-- accepts it standalone. These columns make a movement carry its bank-line
|
|
8
8
|
-- identity and its reconciliation state.
|
|
9
9
|
-- external_source / external_id : the bank line's provider + unique id
|
|
10
10
|
-- reconciled_at : when the line was matched/accepted (NULL = pending)
|
|
11
11
|
-- matched_movement_id : the internal movement this line reconciles (NULL = standalone)
|
|
12
|
-
ALTER TABLE public.
|
|
12
|
+
ALTER TABLE public.plg_financial_movements
|
|
13
13
|
ADD COLUMN IF NOT EXISTS external_id text,
|
|
14
14
|
ADD COLUMN IF NOT EXISTS external_source text,
|
|
15
15
|
ADD COLUMN IF NOT EXISTS reconciled_at timestamptz,
|
|
16
16
|
ADD COLUMN IF NOT EXISTS matched_movement_id uuid
|
|
17
|
-
REFERENCES public.
|
|
17
|
+
REFERENCES public.plg_financial_movements(id) ON DELETE SET NULL;
|
|
18
18
|
|
|
19
|
-
COMMENT ON COLUMN public.
|
|
19
|
+
COMMENT ON COLUMN public.plg_financial_movements.external_source IS
|
|
20
20
|
'Provider of an imported bank-statement line (e.g. plugbank, inter). NULL for app-native movements.';
|
|
21
|
-
COMMENT ON COLUMN public.
|
|
21
|
+
COMMENT ON COLUMN public.plg_financial_movements.external_id IS
|
|
22
22
|
'Provider-unique id of the imported bank line. Forms the import idempotency key with external_source.';
|
|
23
23
|
|
|
24
24
|
-- Idempotency: a given bank line imports at most once per tenant.
|
|
25
|
-
CREATE UNIQUE INDEX IF NOT EXISTS
|
|
26
|
-
ON public.
|
|
25
|
+
CREATE UNIQUE INDEX IF NOT EXISTS uq_plg_financial_movements_external
|
|
26
|
+
ON public.plg_financial_movements (tenant_id, external_source, external_id)
|
|
27
27
|
WHERE external_id IS NOT NULL AND external_source IS NOT NULL;
|
|
28
28
|
|
|
29
29
|
-- Fast lookup of imported-but-unreconciled lines for the matching screen.
|
|
30
|
-
CREATE INDEX IF NOT EXISTS
|
|
31
|
-
ON public.
|
|
30
|
+
CREATE INDEX IF NOT EXISTS idx_plg_financial_movements_unreconciled
|
|
31
|
+
ON public.plg_financial_movements (tenant_id, payment_date)
|
|
32
32
|
WHERE external_source IS NOT NULL AND reconciled_at IS NULL;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
-- payment_method_type_id existed on pre-pool installs (added out-of-band on
|
|
2
|
+
-- the salon/beauty DB) but was never captured in the file series; 008 requires
|
|
3
|
+
-- it on plg_financial_movements. No-op where the column already exists.
|
|
4
|
+
|
|
5
|
+
ALTER TABLE public.plg_financial_movements
|
|
6
|
+
ADD COLUMN IF NOT EXISTS payment_method_type_id uuid REFERENCES public.plg_financial_payment_method_types(id);
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
-- two payments on one installment show as two extract rows instead of one summed row.
|
|
4
4
|
-- Bills stay pure obligations; v_invoice_balances already filters movement_kind='bill',
|
|
5
5
|
-- so the new payment rows don't affect invoice balances. Backfill is idempotent.
|
|
6
|
-
-- Requires fee_amount (
|
|
6
|
+
-- Requires fee_amount (006b_extract_fee_amount.sql).
|
|
7
7
|
|
|
8
|
-
INSERT INTO public.
|
|
8
|
+
INSERT INTO public.plg_financial_movements
|
|
9
9
|
(tenant_id, invoice_id, direction, movement_kind, amount, paid_amount, fee_amount, status,
|
|
10
10
|
due_date, payment_date, installment_number, payment_method_id, payment_method_type_id,
|
|
11
11
|
bank_account_id, cash_session_id, card_brand, card_installments, notes, metadata)
|
|
@@ -16,14 +16,14 @@ SELECT
|
|
|
16
16
|
b.payment_method_id, b.payment_method_type_id, b.bank_account_id, b.cash_session_id,
|
|
17
17
|
b.card_brand, b.card_installments, b.notes,
|
|
18
18
|
jsonb_build_object('backfilledFromBill', b.id)
|
|
19
|
-
FROM public.
|
|
19
|
+
FROM public.plg_financial_movements b
|
|
20
20
|
WHERE b.movement_kind = 'bill' AND b.paid_amount > 0
|
|
21
21
|
AND NOT EXISTS (
|
|
22
|
-
SELECT 1 FROM public.
|
|
22
|
+
SELECT 1 FROM public.plg_financial_movements p
|
|
23
23
|
WHERE p.movement_kind = 'payment' AND p.metadata->>'backfilledFromBill' = b.id::text
|
|
24
24
|
);
|
|
25
25
|
|
|
26
|
-
UPDATE public.
|
|
26
|
+
UPDATE public.plg_financial_movements
|
|
27
27
|
SET payment_date = NULL, bank_account_id = NULL, payment_method_id = NULL,
|
|
28
28
|
payment_method_type_id = NULL, cash_session_id = NULL, card_brand = NULL, card_installments = NULL
|
|
29
29
|
WHERE movement_kind = 'bill';
|