Changes between Initial Version and Version 1 of CustomerContractMealsView

Timestamp:

05/10/26 14:38:02 (2 weeks ago)

Author:

185022

Comment:

--

CustomerContractMealsView

@@ +1 @@
+= Преглед: v_customer_contract_meals =
+
+||= Датотека ||= `views/10_customer_contract_meals_view.sql` ||
+||= Шема ||= `kbnteam` ||
+||= Категорија ||= Оперативна поддршка ||
+||= Поврзани индекси ||= Ги користи индексите од `indexes/v_menu_meal_index.sql` ||
+
+== Опис ==
+Ги наведува оброците достапни на купувач под активни договори. Го прикажува целосното мени на ресторанот поврзан со договорот на компанијата на купувачот, вклучувајќи состојки и алергени преку CTE агрегации. Прегледот автоматски ги филтрира само активни договори и ги проверува тековните датуми на договори.
+
+'''Клучни филтри:'''
+* `contract_status_name = 'active'` (case-insensitive)
+* `CURRENT_DATE BETWEEN contract_start_date AND contract_end_date`
+
+== Зависности ==
+||= Табела ||= Тип на употреба ||
+|| `kbnteam.customer` || Главна табела ||
+|| `kbnteam.api_user` || JOIN — детали за купувачот ||
+|| `kbnteam.company` || JOIN — компанија ||
+|| `kbnteam.contract` || JOIN — договор ||
+|| `kbnteam.contract_status` || JOIN — статус на договор (филтер: 'active') ||
+|| `kbnteam.restaurant` || JOIN — ресторан ||
+|| `kbnteam.meal` || JOIN — оброци на ресторанот ||
+|| `kbnteam.category` || JOIN — категорија ||
+|| `kbnteam.meal_ingredient` || LEFT JOIN (CTE) — состојки ||
+|| `kbnteam.ingredient` || JOIN (CTE) — назив на состојка ||
+|| `kbnteam.alergen_ingredient` || JOIN (CTE) — алерген-состојка ||
+|| `kbnteam.alergen` || JOIN (CTE) — назив на алерген ||
+
+== SQL Дефиниција ==
+{{{
+#!sql
+CREATE OR REPLACE VIEW kbnteam.v_customer_contract_meals AS
+WITH meal_ingredients AS (
+    SELECT
+        x.meal_id,
+        string_agg(x.ingr_name, ', ' ORDER BY x.ingr_name) AS ingredients
+    FROM (
+        SELECT DISTINCT
+            mi.meal_id,
+            i.ingr_name
+        FROM kbnteam.meal_ingredient mi
+        JOIN kbnteam.ingredient i ON i.ingr_id = mi.ingr_id
+    ) x
+    GROUP BY x.meal_id
+),
+meal_allergens AS (
+    SELECT
+        x.meal_id,
+        string_agg(x.alergen_name, ', ' ORDER BY x.alergen_name) AS allergens
+    FROM (
+        SELECT DISTINCT
+            mi.meal_id,
+            a.alergen_name
+        FROM kbnteam.meal_ingredient mi
+        JOIN kbnteam.alergen_ingredient ai ON ai.ingr_id = mi.ingr_id
+        JOIN kbnteam.alergen a ON a.alergen_id = ai.alergen_id
+    ) x
+    GROUP BY x.meal_id
+)
+SELECT
+    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,
+    cu.company_id,
+    cmp.company_name,
+    ct.contract_id,
+    r.rest_id,
+    r.rest_name,
+    m.meal_id,
+    m.meal_name,
+    m.meal_description,
+    m.meal_price,
+    m.meal_weight,
+    c.cat_id,
+    c.cat_name,
+    COALESCE(mi.ingredients, '') AS ingredients,
+    COALESCE(ma.allergens, '') AS allergens
+FROM kbnteam.customer cu
+JOIN kbnteam.api_user au ON au.user_id = cu.user_id
+JOIN kbnteam.company cmp ON cmp.company_id = cu.company_id
+JOIN kbnteam.contract ct ON ct.company_id = cu.company_id
+JOIN kbnteam.contract_status cs ON cs.contract_status_id = ct.contract_status_id
+JOIN kbnteam.restaurant r ON r.rest_id = ct.rest_id
+JOIN kbnteam.meal m ON m.rest_id = r.rest_id
+JOIN kbnteam.category c ON c.cat_id = m.cat_id
+LEFT JOIN meal_ingredients mi ON mi.meal_id = m.meal_id
+LEFT JOIN meal_allergens ma ON ma.meal_id = m.meal_id
+WHERE lower(cs.contract_status_name) = 'active'
+  AND CURRENT_DATE BETWEEN ct.contract_start_date AND ct.contract_end_date;
+}}}
+
+== Тестирање на перформанси ==
+
+=== Препорачано тест прашање ===
+{{{
+#!sql
+SET search_path TO kbnteam;
+SET statement_timeout = '60s';
+
+-- Тест: по купувач (типичен App use-case)
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_customer_contract_meals
+WHERE customer_user_id = 1;
+
+-- Тест 2: по ресторан
+EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
+SELECT * FROM kbnteam.v_customer_contract_meals
+WHERE rest_id = 1;
+}}}
+
+=== Применети индекси (од v_menu_meal_index.sql) ===
+{{{
+#!sql
+CREATE INDEX IF NOT EXISTS idx_meal_cat_id_meal_id
+ON kbnteam.meal (cat_id, meal_id);
+
+CREATE INDEX IF NOT EXISTS idx_meal_ingredient_meal_id_ingr_id
+ON kbnteam.meal_ingredient (meal_id, ingr_id);
+
+CREATE INDEX IF NOT EXISTS idx_alergen_ingredient_ingr_id_alergen_id
+ON kbnteam.alergen_ingredient (ingr_id, alergen_id);
+}}}
+
+=== Резултати пред индексирање ===
+||= Метрика ||= Тест 1 (customer) ||= Тест 2 (rest_id) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| meal scan || ___ || ___ ||
+|| meal_ingredient scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (пред индексирање)
+}}}
+
+=== Резултати по индексирање ===
+||= Метрика ||= Тест 1 (customer) ||= Тест 2 (rest_id) ||
+|| Planning Time || ___ ms || ___ ms ||
+|| Execution Time || ___ ms || ___ ms ||
+|| Rows Returned || ___ || ___ ||
+|| meal scan || ___ || ___ ||
+|| meal_ingredient scan || ___ || ___ ||
+
+{{{
+-- Излезот од EXPLAIN ANALYZE овде (по индексирање)
+}}}
+
+=== Анализа на подобрување ===
+||= Метрика ||= Пред ||= По ||= Δ Подобрување ||
+|| Execution Time (Тест 1) || ___ ms || ___ ms || ___ % ||
+|| Execution Time (Тест 2) || ___ ms || ___ ms || ___ % ||