= Преглед: v_orders_full =

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

== Опис ==

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

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

Еден ред за секоја клиентска нарачка. Недостасувачките податоци за достава се 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;
}}}

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

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

=== Тест прашалници ===

{{{
#!sql
BEGIN READ ONLY;
SET LOCAL statement_timeout = '60s';

-- Тест 1: по клиент и датум
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_orders_full
WHERE customer_user_id = 1
  AND order_datetime >= DATE '2026-09-01'
  AND order_datetime < DATE '2026-10-01';

-- Тест 2: по компаниска нарачка
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_orders_full
WHERE comp_order_id = 1;

-- Тест 3: по компанија
EXPLAIN (ANALYZE, BUFFERS, VERBOSE)
SELECT * FROM kbnteam.v_orders_full
WHERE order_company_id = 1;

ROLLBACK;
}}}

Индексот по клиент и датум е наменет за пристап во рамки на конкретен клиент. Самостоен услов по датум нема ист начин на пристап како услов што ја задава и водечката колона customer_user_id.

=== Резултати пред индексирање ===

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

||= Метрика ||= Тест 1 (по клиент и датум) ||= Тест 2 (по компаниска нарачка) ||= Тест 3 (по компанија) ||
|| Planning Time || ___ ms || ___ ms || ___ ms ||
|| Execution Time || ___ ms || ___ ms || ___ ms ||
|| Rows Returned || ___ || ___ || ___ ||
|| Начин на читање по табела || ___ || ___ || ___ ||
|| Shared Hit Blocks || ___ || ___ || ___ ||
|| Shared Read Blocks || ___ || ___ || ___ ||

{{{
-- Планови и резултати пред дополнителното индексирање:

}}}

=== Дополнителни и заеднички индекси ===

Примарните клучеви ги покриваат идентификаторите, а `company_order(delivery_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)` || Пронаоѓање достави по доставувач; во прегледите за нарачки и достави и по датум. ||
|| `idx_customer_order_customer_user_id_order_datetime` || `customer_order(customer_user_id, order_datetime DESC)` || Пронаоѓање нарачки по клиент; поддршка за пристап по датум во рамки на клиентот. ||
|| `idx_customer_company_id` || `customer(company_id)` || Пронаоѓање клиенти по компанијата на која припаѓаат. ||

{{{
#!sql
CREATE INDEX IF NOT EXISTS idx_company_order_company_id
ON kbnteam.company_order (company_id);

CREATE INDEX IF NOT EXISTS idx_customer_order_comp_order_id
ON kbnteam.customer_order (comp_order_id);

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_delivery_driver_user_id_delivery_date
ON kbnteam.delivery (driver_user_id, delivery_date);

CREATE INDEX IF NOT EXISTS idx_customer_order_customer_user_id_order_datetime
ON kbnteam.customer_order (customer_user_id, order_datetime DESC);

CREATE INDEX IF NOT EXISTS idx_customer_company_id
ON kbnteam.customer (company_id);
}}}

=== Проверка на индексите ===

{{{
#!sql
SELECT tablename, indexname, indexdef
FROM pg_indexes
WHERE schemaname = 'kbnteam'
  AND indexname IN (
    'idx_company_order_company_id',
    'idx_customer_order_comp_order_id',
    'idx_order_meal_order_id_meal_id',
    'idx_order_drink_order_id_drink_id',
    'idx_delivery_driver_user_id_delivery_date',
    'idx_customer_order_customer_user_id_order_datetime',
    'idx_customer_company_id'
)
ORDER BY tablename, indexname;
}}}

=== Резултати по индексирање ===

Мерењето ги користи истите тест прашалници и услови како почетното мерење.

||= Метрика ||= Тест 1 (по клиент и датум) ||= Тест 2 (по компаниска нарачка) ||= Тест 3 (по компанија) ||
|| Planning Time || ___ ms || ___ ms || ___ ms ||
|| Execution Time || ___ ms || ___ ms || ___ ms ||
|| Rows Returned || ___ || ___ || ___ ||
|| Начин на читање по табела || ___ || ___ || ___ ||
|| Shared Hit Blocks || ___ || ___ || ___ ||
|| Shared Read Blocks || ___ || ___ || ___ ||

{{{
-- Планови и резултати по дополнителното индексирање:

}}}

=== Анализа на подобрување ===

||= Метрика ||= Пред ||= По ||= Промена (%) ||
|| Execution Time (Тест 1) || ___ ms || ___ ms || ___ % ||
|| Execution Time (Тест 2) || ___ ms || ___ ms || ___ % ||
|| Execution Time (Тест 3) || ___ ms || ___ ms || ___ % ||

Промената се пресметува како 100 × (време пред − време по) / време пред, кога почетното време е поголемо од нула. Негативна вредност означува побавно извршување.

Изборот меѓу секвенцијално читање, индексно читање и други планови зависи од обемот на податоците, селективноста на филтрите и статистиките. Индексите не гарантираат забрзување или отстранување на сортирањата и спојувањата. Плановите и времињата се утврдуваат со мерење.