Changes between Version 4 and Version 5 of ApplicationDevelopment

Timestamp:

09/30/25 23:12:33 (4 weeks ago)

Author:

223075

Comment:

--

ApplicationDevelopment

@@ -1 +1 @@
 = Развој на апликација (App Development) =
 
-Овде докажуваме дека апликацијата ги користи DB можностите (погледи, транскации, складирани функции, индекси) преку HTTP рути.
+На оваа страна докажуваме дека апликацијата ги користи DB можностите (погледи, транскации, складирани функции, индекси) преку HTTP рути, со JWT автентикација.
 
 == Важни рути ==
 
-=== Транскација + функција ===
-**POST** `/api/book-class`
-- Body (JWT или userId во body): `{"classId":7}` или `{"userId":12,"classId":7}`
-- Користи `BEGIN/COMMIT` и `SELECT book_class($1,$2)`.
-
-Пример очекуван одговор:
+=== Login (JWT) ===
+POST /api/login
+Body: {"type":"user","email":"...","password":"..."}
+
+Враќа token (JWT) кој потоа се праќа во Authorization: Bearer <token>.
+
+=== Транскација + складирана функција ===
+POST /api/book-class
+
+Body (со JWT или со userId во body): {"classId":7} или {"userId":12,"classId":7}
+
+Користи BEGIN/COMMIT и SELECT book_class($1,$2); тригери блокираат преполнување и одржуваат seats_available.
+
+Пример одговори:
 {{{
 { "success": true, "code": "OK" }
@@ -20 +28 @@
 
 === Извештаи од погледи (Views) ===
-**GET** `/api/reports/top-spenders`  → vw_user_spend  
-**GET** `/api/reports/class-utilization` → vw_class_utilization  
-**GET** `/api/reports/training-pop-monthly` → vw_training_pop_monthly
-
+GET /api/reports/top-spenders → vw_user_spend
+GET /api/reports/class-utilization → vw_class_utilization
+GET /api/reports/training-pop-monthly → vw_training_pop_monthly
 
 === EXPLAIN/ANALYZE преку апликацијата ===
-**GET** `/api/debug/explain-events`  
-**GET** `/api/debug/explain-class-join`
-
+GET /api/debug/explain-events
+GET /api/debug/explain-class-join
+(Со мал сет, planner понекогаш избира Seq Scan; за принуден Index Scan може да се види на страната „Напредни извештаи“.)
+
+== Докази ==
+
+=== 1) JWT Login → добиваме токен ===
+Команда:
+{{{
+curl -X POST http://localhost:5000/api/login
+ ^
+-H "Content-Type: application/json" ^
+-d "{"type":"user","email":"newstudent@gmail.com
+","password":"Newstudent!15"}"
+}}}
+Одговор:
+{{{
+{ "success": true,
+"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....(скратено)...",
+"role": "user",
+"userId": "17"
+}
+}}}
+
+=== 2) Транскација + функција: book_class (со JWT) ===
+Команда:
+{{{
+curl -X POST http://localhost:5000/api/book-class
+ ^
+-H "Content-Type: application/json" ^
+-H "Authorization: Bearer eyJhbGciOi...X3E" ^
+-d "{"classId":7}"
+}}}
+Одговор:
+{{{
+{ "success": true, "code": "OK" }
+}}}
+
+=== 3) book_class без JWT (одбиено од апликацијата) ===
+Команда:
+{{{
+curl -X POST http://localhost:5000/api/book-class
+ ^
+-H "Content-Type: application/json" ^
+-d "{"classId":7}"
+}}}
+Одговор:
+{{{
+{ "success": false, "error": "Missing user identity" }
+}}}
+
+(Овие два излези заедно докажуваат: JWT заштита на критична рута и транскација + тригери во базата.)
+
+=== 4) Views → извештаи ===
+
+GET /api/reports/top-spenders:
+{{{
+[{"user_id":"8","username":"mikiYoga","email":"miki@example.com
+","spend_packages":"45.00","spend_merch":"12.00","total_spend":"57.00","spend_rank":"1"},
+{"user_id":"13","username":"bojan","email":"bojan@example.com
+","spend_packages":"0","spend_merch":"30.00","total_spend":"30.00","spend_rank":"2"},
+{"user_id":"12","username":"ana","email":"ana@example.com
+","spend_packages":"25.00","spend_merch":"0","total_spend":"25.00","spend_rank":"3"},
+{"user_id":"9","username":"davidG","email":"david@example.com
+","spend_packages":"0","spend_merch":"0","total_spend":"0","spend_rank":"4"},
+{"user_id":"10","username":"proba1","email":"proba1@gmail.com
+","spend_packages":"0","spend_merch":"0","total_spend":"0","spend_rank":"4"},
+{"user_id":"14","username":"ciro","email":"ciro@example.com
+","spend_packages":"0","spend_merch":"0","total_spend":"0","spend_rank":"4"},
+{"user_id":"16","username":"proba2","email":"proba2@gmail.com
+","spend_packages":"0","spend_merch":"0","total_spend":"0","spend_rank":"4"},
+{"user_id":"17","username":"newstudent","email":"newstudent@gmail.com
+","spend_packages":"0","spend_merch":"0","total_spend":"0","spend_rank":"4"}]
+}}}
+
+GET /api/reports/class-utilization:
+{{{
+[{"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"},
+{"class_id":"6","date":"2025-06-09T22:00:00.000Z","start_time":"09:30:00","end_time":"10:30:00","location":"Studio B","capacity":15","booked":"1","utilization_pct":"6.67","instructor_id":"6","daily_rank":"1"},
+{"class_id":"7","date":"2025-09-26T22:00:00.000Z","start_time":"18:00:00","end_time":"19:00:00","location":"Studio A","capacity":2,"booked":"2","utilization_pct":"100.00","instructor_id":"7","daily_rank":"1"}]
+}}}
+
+GET /api/reports/training-pop-monthly:
+{{{
+[{"training_id":"7","training_name":"Vinyasa","month":"2025-08-31T22:00:00.000Z","num_bookings":"2","rank_in_month":"1"},
+{"training_id":"8","training_name":"Yin","month":"2025-08-31T22:00:00.000Z","num_bookings":"2","rank_in_month":"1"},
+{"training_id":"6","training_name":"Hatha Basics","month":"2025-05-31T22:00:00.000Z","num_bookings":"1","rank_in_month":"1"},
+{"training_id":"5","training_name":"Vinyasa Flow","month":"2025-05-31T22:00:00.000Z","num_bookings":"1","rank_in_month":"1"}]
+}}}
+
+=== 5) EXPLAIN/ANALYZE преку апликацијата ===
+
+GET /api/debug/explain-events (мал сет → Seq Scan во оваа снимка)
+Извадок:
+{{{
+[{"Plan":{"Node Type":"Limit", "Plans":[
+{"Node Type":"Sort", "Plans":[
+{"Node Type":"Seq Scan", "Relation Name":"Event", "Filter":"(date >= CURRENT_DATE)"}
+]}
+]},"Planning Time":0.701,"Execution Time":0.108}]
+}}}
+
+GET /api/debug/explain-class-join (мал сет → Seq Scans во оваа снимка)
+Извадок:
+{{{
+[{"Plan":{"Node Type":"Limit","Plans":[
+{"Node Type":"Sort","Plans":[
+{"Node Type":"Aggregate","Plans":[
+{"Node Type":"Sort","Plans":[
+{"Node Type":"Nested Loop","Plans":[
+{"Node Type":"Seq Scan","Relation Name":"Class","Filter":"(date >= CURRENT_DATE)"},
+{"Node Type":"Seq Scan","Relation Name":"User_Booked_Class"}
+] } ] } ] } ] } ] },"Planning Time":1.033,"Execution Time":0.303}]
+}}}
+
+Забелешка: Овде planner не мора секогаш да избере индекс поради мал број редови. На страната „Напредни извештаи“ имаме EXPLAIN (FORCED) JSON каде се гледа "Index Scan" со имињата idx_event_date_time, idx_class_date_time, idx_ubc_class.
 
 == Како тестираме ==
-1. Стартуваме backend:
+
+Стартуваме backend:
 {{{
 cd backend
 node index.js
 }}}
-2. Потоа отвораме во прелистувач / Postman:
-- http://localhost:5000/api/reports/top-spenders
-- http://localhost:5000/api/debug/explain-events
-- POST http://localhost:5000/api/book-class 
+
+Примери за тест:
+
+Login (JWT):
+{{{
+curl -X POST http://localhost:5000/api/login
+ ^
+-H "Content-Type: application/json" ^
+-d "{"type":"user","email":"newstudent@gmail.com
+","password":"Newstudent!15"}"
+}}}
+
+Book class (со JWT):
+{{{
+curl -X POST http://localhost:5000/api/book-class
+ ^
+-H "Content-Type: application/json" ^
+-H "Authorization: Bearer <JWT>" ^
+-d "{"classId":7}"
+}}}
+
+Book class (без JWT):
+{{{
+curl -X POST http://localhost:5000/api/book-class
+ ^
+-H "Content-Type: application/json" ^
+-d "{"classId":7}"
+}}}
+
+Reports (во прелистувач):
+
+http://localhost:5000/api/reports/top-spenders
+
+http://localhost:5000/api/reports/class-utilization
+
+http://localhost:5000/api/reports/training-pop-monthly
+
+EXPLAIN (во прелистувач):
+
+http://localhost:5000/api/debug/explain-events
+
+http://localhost:5000/api/debug/explain-class-join
+