Changes between Version 8 and Version 9 of ReportsProcedures

Timestamp:

09/26/25 18:44:12 (3 weeks ago)

Author:

223075

Comment:

--

ReportsProcedures

@@ +1 @@
+= Напредни извештаи од базата (PostgreSQL) =
+----
+Оваа страна прикажува 3 покомплексни извештаи. 
 
-== Напредни извештаи од базата (PostgreSQL)
+== 0) Извршени се SQL надградбите (views, triggers, function, indexes) преку Node:==
+{{{
+cd backend
+npm run db:apply
+}}}
+{{{
+["Enhancements applied (views, triggers, function, indexes)."]
+}}}
+
+Потоа внесовме мал демо-сет:
+{{{
+npm run db:seed
+}}}
+{{{
+[Seed done. User IDs: { ana: '12', bojan: '13', ciro: '14', classId: '7' }]
+}}}
+
+----
+
+== 1) Топ потрошувачи (пакети + мерч) со рангирање ==
+**Цел:** По корисник, колку потрошил (сума пакет + мерч) и кој му е рангот според вкупниот трошок.
+
+**Користен поглед:** `vw_user_spend`
+
+**SQL:**
+{{{
+SELECT user_id, username, email,
+       spend_packages, spend_merch, total_spend,
+       RANK() OVER (ORDER BY total_spend DESC) AS spend_rank
+FROM vw_user_spend
+ORDER BY total_spend DESC, user_id;
+}}}
+
+**Релациска алгебра (неформално):**
+{{{
+Π_{user_id,username,email,spend_packages,spend_merch,total_spend}
+ ( User ⟕ (γ_{user_id; SUM(price)→spend_packages}(User_Purchased_Package ⋈ Package))
+        ⟕ (γ_{user_id; SUM(price)→spend_merch}(User_Purchased_Merch ⋈ Merch_Items)) )
+}}}
+
+**Извршување:**
+{{{
+npm run db:reports
+}}}
+{{{
+[
+  {
+    "user_id": "8",
+    "username": "mikiYoga",
+    "email": "miki@example.com",
+    "spend_packages": "45.00",
+    "spend_merch": "12.00",
+    "total_spend": "57.00",
+    "spend_rank": "1"
+  },...
+]
+}}}
+
+----
+
+== 2) Исполнетост на часови со дневно рангирање ==
+**Цел:** За секој клас: booked/capacity (во %) и ранг во истиот ден.
+
+**Користен поглед:** `vw_class_utilization`
+
+**SQL:**
+{{{
+SELECT *,
+       DENSE_RANK() OVER (PARTITION BY date ORDER BY utilization_pct DESC NULLS LAST) AS daily_rank
+FROM vw_class_utilization
+ORDER BY date, start_time, class_id;
+}}}
+
+**Релациска алгебра:**
+{{{
+γ_{class_id; COUNT(user_id)→booked}(Class ⟕ User_Booked_Class)
++ калкулација utilization_pct = booked / capacity
+}}}
+
+{{{
+ [
+  {
+    "class_id": "5",
+    "date": "2025-06-09T22:00:00.000Z",
+    "start_time": "08:00:00",
+    "end_time": "09:00:00",
+    "location": "Studio A",
+    "capacity": 20,
+    "booked": "1",
+    "utilization_pct": "5.00",
+    "instructor_id": "5",
+    "daily_rank": "2"
+  },...
+]
+}}}
+
+----
+
+== 3) Популарност на тренинзи по месец ==
+**Цел:** По месец, броиме уникатни корисници кои букирале часови што содржат даден тренинг; даваме месечен ранг.
+
+**Користен поглед:** `vw_training_pop_monthly`
+
+**SQL:**
+{{{
+SELECT training_id, training_name, month, num_bookings,
+       RANK() OVER (PARTITION BY month ORDER BY num_bookings DESC NULLS LAST) AS rank_in_month
+FROM vw_training_pop_monthly
+ORDER BY month DESC, rank_in_month, training_name;
+}}}
+
+**Релациска алгебра:**
+{{{
+γ_{training_id,month; COUNT(DISTINCT user_id)→num_bookings}
+ ( Training ⋈ Class_Includes_Training ⋈ Class ⟕ User_Booked_Class )
+}}}
+
+{{{
+[
+  {
+    "training_id": "7",
+    "training_name": "Vinyasa",
+    "month": "2025-08-31T22:00:00.000Z",
+    "num_bookings": "1",
+    "rank_in_month": "1"
+  },...
+] 
+}}}
+
+----
+
+== 4) EXPLAIN/ANALYZE (за индекси) ==
+Генерираме JSON планови:
+{{{
+npm run db:explain
+}}}
+**A)** За листање на настани, очекуваме користење на составниот индекс `(date,time)`:
+- Датотека: `backend/proofs/events_explain.json`
+- Конзолата печати „Index Scan / Bitmap“ јазли ако ги има.
+
+**B)** За броење резервации по час, очекуваме `idx_class_date_time` и `idx_ubc_class`:
+- Датотека: `backend/proofs/class_bookings_explain.json`
 
 
-
-
-== 1) Популарност и приход: Пакети ==
-Пакети – број на купувања и бруто приход:
 {{{
-#!sql
-SELECT
-p.package_name,
-COUNT(*) AS num_purchases,
-SUM(p.price) AS gross_revenue
-FROM "User_Purchased_Package" upp
-JOIN "Package" p ON p.package_id = upp.package_id
-GROUP BY p.package_name
-ORDER BY gross_revenue DESC, num_purchases DESC;
+{
+  "Plan": {
+    "Node Type": "Index Scan",
+    "Parallel Aware": false,
+    "Async Capable": false,
+    "Scan Direction": "Forward",
+    "Index Name": "idx_event_date_time",
+  ...
+}
 }}}
-
-== 2) Популарност и приход: Merch ==
-Мерч – број на продажби и бруто приход:
-
 {{{
-#!sql
-SELECT
-m.item_name,
-COUNT(*) AS num_sales,
-SUM(m.price) AS gross_revenue
-FROM "User_Purchased_Merch" upm
-JOIN "Merch_Items" m ON m.merch_id = upm.merch_id
-GROUP BY m.item_name
-ORDER BY gross_revenue DESC, num_sales DESC;
+{
+    "Node Type": "Index Scan",
+    "Parent Relationship": "Outer",
+    "Parallel Aware": false,
+    "Async Capable": false,
+    "Scan Direction": "Forward",
+    "Index Name": "idx_class_date_time",
+  ...
+}
 }}}
-
-