Changes between Initial Version and Version 1 of CompanyBillingOverviewView

Timestamp:

05/10/26 14:33:51 (2 weeks ago)

Author:

185022

Comment:

--

CompanyBillingOverviewView

@@ +1 @@
+= Преглед: v_company_billing_overview =
+
+||= Датотека ||= `views/08_company_billing_view.sql` ||
+||= Шема ||= `kbnteam` ||
+||= Категорија ||= Договори, Фактурирање и Верност ||
+||= Поврзани индекси ||= `indexes/v_company_billing_overview_index.sql` ||
+
+== Опис ==
+Прикажува вкупни износи на фактури, бројот на нарачки на купувачи и бројот на договори по компанија. Користи два CTE: `company_contracts` го брои бројот на договори по компанија, а `invoice_totals` ги агрегира вкупните износи по фактура. Важен преглед за финансиски извештај и прикажување на фактури во администраторски панел.
+
+== Зависности ==
+||= Табела ||= Тип на употреба ||
+|| `kbnteam.invoice` || Главна табела ||
+|| `kbnteam.company_order` || JOIN — компаниска нарачка ||
+|| `kbnteam.customer_order` || LEFT JOIN — нарачки (за вкупен износ) ||
+|| `kbnteam.contract` || LEFT JOIN (CTE) — договори на компанијата ||
+|| `kbnteam.company` || JOIN — компанија ||
+
+== Излезни колони ==
+||= Колона ||= Извор ||= Опис ||
+|| `invoice_id` || `invoice` || Примарен клуч на фактурата ||
+|| `comp_order_id` || `invoice` || Поврзана компаниска нарачка ||
+|| `company_id` || `company` || ID на компанијата ||
+|| `company_name` || `company` || Назив на компанијата ||
+|| `company_address` || `company` || Адреса на компанијата ||
+|| `delivery_id` || `company_order` || ID на доставата ||
+|| `customer_order_count` || CTE `invoice_totals` || Број нарачки на купувачи ||
+|| `invoice_amount` || CTE `invoice_totals` || Вкупен износ на фактурата ||
+|| `contract_count` || CTE `company_contracts` || Број на договори на компанијата ||
+
+== SQL Дефиниција ==
+{{{
+#!sql
+CREATE OR REPLACE VIEW kbnteam.v_company_billing_overview AS
+WITH company_contracts AS (
+    SELECT
+        ct.company_id,
+        COUNT(*) AS contract_count
+    FROM kbnteam.contract ct
+    GROUP BY ct.company_id
+),
+invoice_totals AS (
+    SELECT
+        i.invoice_id,
+        i.comp_order_id,
+        co.company_id,
+        co.delivery_id,
+        COUNT(o.order_id) AS customer_order_count,
+        COALESCE(SUM(o.order_total), 0)::numeric(14,2) AS invoice_amount
+    FROM kbnteam.invoice i
+    JOIN kbnteam.company_order co ON co.comp_order_id = i.comp_order_id
+    LEFT JOIN kbnteam.customer_order o ON o.comp_order_id = co.comp_order_id
+    GROUP BY i.invoice_id, i.comp_order_id, co.company_id, co.delivery_id
+)
+SELECT
+    it.invoice_id,
+    it.comp_order_id,
+    cmp.company_id,
+    cmp.company_name,
+    cmp.company_address,
+    it.delivery_id,
+    it.customer_order_count,
+    it.invoice_amount,
+    COALESCE(cc.contract_count, 0) AS contract_count
+FROM invoice_totals it
+JOIN kbnteam.company cmp ON cmp.company_id = it.company_id
+LEFT JOIN company_contracts cc ON cc.company_id = cmp.company_id;
+}}}
+
+== Тестирање на перформанси ==
+
+=== Препорачано тест прашање ===
+{{{
+#!sql
+SET search_path TO kbnteam;
+SET statement_timeout = '60s';
+
+-- Тест 1: по компанија
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_company_billing_overview
+WHERE company_id = 1;
+
+-- Тест 2: по компаниска нарачка
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_company_billing_overview
+WHERE comp_order_id = 1;
+}}}
+
+=== Резултати пред индексирање ===
+||= Метрика ||= Тест 1 (company_id) ||= Тест 2 (comp_order_id) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| contract scan || ___ || ___ ||
+|| customer_order scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (пред индексирање)
+}}}
+
+=== Применети индекси ===
+{{{
+#!sql
+-- indexes/v_company_billing_overview_index.sql
+CREATE INDEX IF NOT EXISTS idx_contract_company_id
+ON kbnteam.contract (company_id);
+
+CREATE INDEX IF NOT EXISTS idx_customer_order_comp_order_id
+ON kbnteam.customer_order (comp_order_id);
+}}}
+
+=== Резултати по индексирање ===
+||= Метрика ||= Тест 1 (company_id) ||= Тест 2 (comp_order_id) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| contract scan || ___ || ___ ||
+|| customer_order scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (по индексирање)
+}}}
+
+=== Анализа на подобрување ===
+||= Индекс ||= Помага на ||= Очекувана промена ||
+|| `idx_contract_company_id` || CTE `company_contracts` GROUP BY || Seq Scan → Index Scan на `contract` ||
+|| `idx_customer_order_comp_order_id` || CTE `invoice_totals` LEFT JOIN || Seq Scan → Index Scan на `customer_order` ||
+
+||= Метрика ||= Пред ||= По ||= Δ Подобрување ||
+|| Execution Time (Тест 1) || ___ ms || ___ ms || ___ % ||
+|| Execution Time (Тест 2) || ___ ms || ___ ms || ___ % ||