= Преглед: v_orders_full =

||= Својство ||= Вредност ||
|| Шема || `kbnteam` ||
|| Категорија || Нарачки и достави ||
|| Индексна поддршка || [wiki:OrdersFullIndex v_orders_full_index] ||

== Опис ==

Прикажува нарачки со податоци за клиентот, компанијата, статусот, доставата и нарачаните јадења и пијалоци.

Јадењата и пијалоците се прикажуваат во подредени листи без повторувања. Податоците за доставувачот се поврзани со доставата. Се прикажуваат и нарачките за кои сè уште нема достава.

Еден ред за секоја клиентска нарачка. Недостасувачките податоци за достава се NULL, а празните листи со производи се празен текст.

== Зависности ==

||= Табела / преглед ||= Употреба ||
|| `kbnteam.order_meal` || Јадења вклучени во нарачките. ||
|| `kbnteam.meal` || Јадења, цени и поврзаност со категорија и ресторан. ||
|| `kbnteam.order_drink` || Пијалоци вклучени во нарачките. ||
|| `kbnteam.drink` || Пијалоци, количини, цени и ресторан. ||
|| `kbnteam.customer_order` || Клиентски нарачки, датуми, статуси и износи. ||
|| `kbnteam.order_status` || Називи на статусите на нарачките. ||
|| `kbnteam.customer` || Клиенти и компаниите на кои припаѓаат. ||
|| `kbnteam.api_user` || Лични и контактни податоци за корисниците. ||
|| `kbnteam.company_order` || Поврзување на компаниските нарачки со компанијата и доставата. ||
|| `kbnteam.company` || Податоци за компаниите. ||
|| `kbnteam.delivery` || Достави, датуми, забелешки и назначени доставувачи. ||
|| `kbnteam.delivery_status` || Називи на статусите на доставите. ||

== Излезни колони ==

||= Колона ||= Извор / пресметка ||= Опис ||
|| `order_id` || `customer_order.order_id` || Идентификатор на клиентската нарачка. ||
|| `order_datetime` || `customer_order.order_datetime` || Датум и време на нарачката. ||
|| `order_total` || `customer_order.order_total` || Вкупен износ на нарачката. ||
|| `o_status_name` || `order_status.o_status_name` || Статус на нарачката. ||
|| `customer_user_id` || `customer.user_id` || Идентификатор на клиентот. ||
|| `customer_company_id` || `customer.company_id` || Компанија на клиентот. ||
|| `customer_first_name` || `api_user.user_first_name` || Име на клиентот. ||
|| `customer_last_name` || `api_user.user_last_name` || Презиме на клиентот. ||
|| `customer_email` || `api_user.user_email` || Е-пошта на клиентот. ||
|| `comp_order_id` || `company_order.comp_order_id` || Идентификатор на компаниската нарачка. ||
|| `order_company_id` || `company_order.company_id` || Компанија на компаниската нарачка. ||
|| `company_name` || `company.company_name` || Назив на компанијата. ||
|| `delivery_id` || `delivery.delivery_id` || Идентификатор на доставата. ||
|| `delivery_date` || `delivery.delivery_date` || Датум на доставата. ||
|| `d_status_name` || `delivery_status.d_status_name` || Статус на доставата. ||
|| `driver_user_id` || `delivery.driver_user_id` || Идентификатор на доставувачот. ||
|| `driver_first_name` || `api_user.user_first_name` || Име на доставувачот. ||
|| `driver_last_name` || `api_user.user_last_name` || Презиме на доставувачот. ||
|| `driver_phone` || `api_user.user_phone_no` || Телефон на доставувачот. ||
|| `meals` || `COALESCE(order_meals.meals, '')` || Подредена листа со називи на нарачаните јадења. ||
|| `drinks` || `COALESCE(order_drinks.drinks, '')` || Подредена листа со називи на нарачаните пијалоци. ||

== SQL дефиниција ==

{{{
#!sql
CREATE OR REPLACE VIEW kbnteam.v_orders_full AS
WITH order_meals AS (
    SELECT
        om.order_id,
        string_agg(DISTINCT m.meal_name, ', ' ORDER BY m.meal_name) AS meals
    FROM kbnteam.order_meal om
    JOIN kbnteam.meal m ON m.meal_id = om.meal_id
    GROUP BY om.order_id
),
order_drinks AS (
    SELECT
        od.order_id,
        string_agg(DISTINCT d.drink_name, ', ' ORDER BY d.drink_name) AS drinks
    FROM kbnteam.order_drink od
    JOIN kbnteam.drink d ON d.drink_id = od.drink_id
    GROUP BY od.order_id
)
SELECT
    o.order_id,
    o.order_datetime,
    o.order_total,
    os.o_status_name,
    cu.user_id AS customer_user_id,
    cu.company_id AS customer_company_id,
    au.user_first_name AS customer_first_name,
    au.user_last_name AS customer_last_name,
    au.user_email AS customer_email,
    co.comp_order_id,
    co.company_id AS order_company_id,
    cmp.company_name,
    d.delivery_id,
    d.delivery_date,
    ds.d_status_name,
    d.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,
    COALESCE(om.meals, '') AS meals,
    COALESCE(od.drinks, '') AS drinks
FROM kbnteam.customer_order o
JOIN kbnteam.order_status os ON os.o_status_id = o.o_status_id
JOIN kbnteam.customer cu ON cu.user_id = o.customer_user_id
JOIN kbnteam.api_user au ON au.user_id = cu.user_id
JOIN kbnteam.company_order co ON co.comp_order_id = o.comp_order_id
JOIN kbnteam.company cmp ON cmp.company_id = co.company_id
LEFT JOIN kbnteam.delivery d ON d.delivery_id = co.delivery_id
LEFT JOIN kbnteam.delivery_status ds ON ds.d_status_id = d.d_status_id
LEFT JOIN kbnteam.api_user du ON du.user_id = d.driver_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;
}}}

== Индексна поддршка ==

Дополнителното индексирање е поставено врз изворните табели на погледот.

||= Индекс ||= Табела и колони ||= Намена ||
|| `idx_company_order_company_id` || `company_order(company_id)` || Пронаоѓање компаниски нарачки по компанија. ||
|| `idx_customer_order_comp_order_id` || `customer_order(comp_order_id)` || Пронаоѓање клиентски нарачки по компаниска нарачка. ||
|| `idx_order_meal_order_id_meal_id` || `order_meal(order_id, meal_id)` || Поврзување на нарачката со јадењата и групирање по order_id. ||
|| `idx_order_drink_order_id_drink_id` || `order_drink(order_id, drink_id)` || Поврзување на нарачката со пијалоците и групирање по order_id. ||
|| `idx_delivery_driver_user_id_delivery_date` || `delivery(driver_user_id, delivery_date)` || Пребарување достави по доставувач и датум. ||

Дефинициите се наведени во [wiki:OrdersFullIndex v_orders_full_index]. За поврзаните табели се користат и индексите опишани во [wiki:DriverDeliveriesIndex v_driver_deliveries_index].

== Тестирање на перформанси ==

=== SELECT ===

Мерењата се евидентирани во DBeaver. Времињата се во милисекунди (ms).

{{{
#!sql
SELECT * FROM kbnteam.v_orders_full
WHERE customer_user_id = 1202947 AND order_total >= 40;
}}}

||= Метрика ||= Пред индексирање ||= По индексирање ||
|| Клиентско време (ms) || 2598 || 2591 ||
|| Вратени редови || 1 || 1 ||

Разликата е 7 ms, односно 0,3% пократко време. Во ова мерење нема значајна промена.

=== INSERT и UPDATE ===

Тестирани се по еден INSERT и еден UPDATE врз `kbnteam.customer_order`, главната табела на погледот. Се тестира додавање нарачка и поместување на времето на нарачката.

||= Операција ||= Execute (ms) ||= Fetch (ms) ||= Вратени редови ||
|| INSERT || 16 || 14 || 1 ||
|| UPDATE || 18 || 16 || 1 ||

Execute е времето на извршување прикажано во DBeaver. Fetch вредностите се преземени од дополнетата евиденција на тестирањето. Ова се клиентски времиња, изразени во милисекунди.

Двете операции се успешни и враќаат по еден ред преку RETURNING. По мерењето промените се вратени со ROLLBACK.

INSERT и UPDATE се извршуваат со прифатлива брзина. Овие мерења ја опишуваат тестираната состојба на базата и не се споредба пред и по индексирање.