Changes between Initial Version and Version 1 of DriverDeliveriesView

Timestamp:

05/10/26 14:29:29 (2 weeks ago)

Author:

185022

Comment:

--

DriverDeliveriesView

@@ +1 @@
+= Преглед: v_driver_deliveries =
+
+||= Датотека ||= `views/04_driver_deliveries_view.sql` ||
+||= Шема ||= `kbnteam` ||
+||= Категорија ||= Нарачки и Достави ||
+||= Поврзани индекси ||= `indexes/v_driver_deliveries_index.sql` ||
+||= Сложеност ||= Висока — 2 CTE + 13 табели ||
+
+== Опис ==
+Прикажува доделување на достави и поврзаниот содржај на нарачките наменет за возачите. Го следи истиот шаблон за агрегирање на ставки (CTE `order_meals` и `order_drinks`) како `v_orders_full`, но е ориентиран кон доставата наместо кон нарачката. Корисен за екранот на возачот во мобилната/веб апликација.
+
+== Зависности ==
+||= Табела ||= Тип на употреба ||
+|| `kbnteam.delivery` || Главна табела ||
+|| `kbnteam.delivery_status` || JOIN — статус на достава ||
+|| `kbnteam.driver` || LEFT JOIN — возач ||
+|| `kbnteam.api_user` || LEFT JOIN (×2) — детали за возач и купувач ||
+|| `kbnteam.restaurant` || LEFT JOIN — ресторан на возачот ||
+|| `kbnteam.company_order` || LEFT JOIN — компаниска нарачка ||
+|| `kbnteam.company` || LEFT JOIN — компанија ||
+|| `kbnteam.customer_order` || LEFT JOIN — нарачка ||
+|| `kbnteam.customer` || LEFT JOIN — купувач ||
+|| `kbnteam.order_meal` || LEFT JOIN (CTE) — оброци ||
+|| `kbnteam.meal` || JOIN (CTE) — назив на оброк ||
+|| `kbnteam.order_drink` || LEFT JOIN (CTE) — пијачи ||
+|| `kbnteam.drink` || JOIN (CTE) — назив на пијач ||
+
+== SQL Дефиниција ==
+{{{
+#!sql
+CREATE OR REPLACE VIEW kbnteam.v_driver_deliveries AS
+WITH order_meals AS (
+    SELECT
+        x.order_id,
+        string_agg(x.meal_name, ', ' ORDER BY x.meal_name) AS meals
+    FROM (
+        SELECT DISTINCT
+            om.order_id,
+            m.meal_name
+        FROM kbnteam.order_meal om
+        JOIN kbnteam.meal m ON m.meal_id = om.meal_id
+    ) x
+    GROUP BY x.order_id
+),
+order_drinks AS (
+    SELECT
+        x.order_id,
+        string_agg(x.drink_name, ', ' ORDER BY x.drink_name) AS drinks
+    FROM (
+        SELECT DISTINCT
+            od.order_id,
+            d.drink_name
+        FROM kbnteam.order_drink od
+        JOIN kbnteam.drink d ON d.drink_id = od.drink_id
+    ) x
+    GROUP BY x.order_id
+)
+SELECT
+    d.delivery_id,
+    d.delivery_date,
+    d.delivery_notes,
+    ds.d_status_name,
+    drv.user_id AS driver_user_id,
+    du.user_first_name AS driver_first_name,
+    du.user_last_name AS driver_last_name,
+    du.user_phone_no AS driver_phone,
+    r.rest_id,
+    r.rest_name,
+    co.comp_order_id,
+    cmp.company_id,
+    cmp.company_name,
+    o.order_id,
+    o.order_datetime,
+    o.order_total,
+    cu.user_id AS customer_user_id,
+    au.user_first_name AS customer_first_name,
+    au.user_last_name AS customer_last_name,
+    au.user_email AS customer_email,
+    COALESCE(om.meals, '') AS meals,
+    COALESCE(od.drinks, '') AS drinks
+FROM kbnteam.delivery d
+JOIN kbnteam.delivery_status ds ON ds.d_status_id = d.d_status_id
+LEFT JOIN kbnteam.driver drv ON drv.user_id = d.driver_user_id
+LEFT JOIN kbnteam.api_user du ON du.user_id = drv.user_id
+LEFT JOIN kbnteam.restaurant r ON r.rest_id = drv.rest_id
+LEFT JOIN kbnteam.company_order co ON co.delivery_id = d.delivery_id
+LEFT JOIN kbnteam.company cmp ON cmp.company_id = co.company_id
+LEFT JOIN kbnteam.customer_order o ON o.comp_order_id = co.comp_order_id
+LEFT JOIN kbnteam.customer cu ON cu.user_id = o.customer_user_id
+LEFT JOIN kbnteam.api_user au ON au.user_id = cu.user_id
+LEFT JOIN order_meals om ON om.order_id = o.order_id
+LEFT JOIN order_drinks od ON od.order_id = o.order_id;
+}}}
+
+== Тестирање на перформанси ==
+
+=== Препорачано тест прашање ===
+{{{
+#!sql
+SET search_path TO kbnteam;
+SET statement_timeout = '60s';
+
+-- Тест 1: по возач и датум на достава
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_driver_deliveries
+WHERE driver_user_id = 1
+  AND delivery_date >= CURRENT_DATE - INTERVAL '30 days';
+
+-- Тест 2: по компаниска нарачка
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_driver_deliveries
+WHERE comp_order_id = 1;
+}}}
+
+=== Резултати пред индексирање ===
+||= Метрика ||= Тест 1 (возач + датум) ||= Тест 2 (comp_order) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| delivery scan || ___ || ___ ||
+|| order_meal scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (пред индексирање)
+}}}
+
+=== Применети индекси ===
+{{{
+#!sql
+-- indexes/v_driver_deliveries_index.sql
+CREATE INDEX IF NOT EXISTS idx_delivery_driver_user_id_delivery_date
+ON kbnteam.delivery (driver_user_id, delivery_date);
+
+CREATE INDEX IF NOT EXISTS idx_order_meal_order_id_meal_id
+ON kbnteam.order_meal (order_id, meal_id);
+
+CREATE INDEX IF NOT EXISTS idx_order_drink_order_id_drink_id
+ON kbnteam.order_drink (order_id, drink_id);
+
+CREATE INDEX IF NOT EXISTS idx_customer_order_comp_order_id
+ON kbnteam.customer_order (comp_order_id);
+}}}
+
+=== Резултати по индексирање ===
+||= Метрика ||= Тест 1 (возач + датум) ||= Тест 2 (comp_order) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| delivery scan || ___ || ___ ||
+|| order_meal scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (по индексирање)
+}}}
+
+=== Анализа на подобрување ===
+||= Индекс ||= Помага на ||= Очекувана промена ||
+|| `idx_delivery_driver_user_id_delivery_date` || Тест 1 — филтрирање по возач и датум || Seq Scan → Index Scan ||
+|| `idx_customer_order_comp_order_id` || Тест 2 и JOIN со `company_order` || Seq Scan → Index Scan ||
+|| `idx_order_meal_order_id_meal_id` || CTE агрегација || Seq Scan → Index Scan ||
+|| `idx_order_drink_order_id_drink_id` || CTE агрегација || Seq Scan → Index Scan ||
+
+||= Метрика ||= Пред ||= По ||= Δ Подобрување ||
+|| Execution Time (Тест 1) || ___ ms || ___ ms || ___ % ||
+|| Execution Time (Тест 2) || ___ ms || ___ ms || ___ % ||