= Развој на апликација (App Development) =

На оваа страна докажуваме дека апликацијата ги користи DB можностите (погледи, транскации, складирани функции, индекси) преку HTTP рути, со JWT автентикација.

== Важни рути ==

=== 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" }
}}}
или:
{{{
{ "success": false, "code": "CLASS_FULL" }
}}}

=== Извештаи од погледи (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

=== EXPLAIN/ANALYZE преку апликацијата ===
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.

== Како се тестира ==

Стартуваме backend:
{{{
cd backend
node index.js
}}}

Примери за тест:

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