Update Bsb

Bsb

@@ -541,4 +541,236 @@ backButton.addEventListener("click", async function(event){
     console.error('Error checking eligibility:', error);
     window.location.href = `/notebook/?effort_id=${effortId}&user_id=${userId}`;
   }
-}); ---> in this why my  'bootstrapFeedbackModal.show();'  is not working? Can you please give possible reasons and solution. 
+}); ---> in this why my  'bootstrapFeedbackModal.show();'  
+
+
+---------------------------
+
+Feedback Modal Feature – Technical Design
+ 
+ 
+---
+ 
+1. Overview
+ 
+This feature enables contextual user feedback collection in the “Document Chat & Summarization” UI.
+Feedback (rating/comment) is requested only if the user selects a configuration (zone), engages in chat or summarization, and then attempts to leave the page via the back button.
+ 
+ 
+---
+ 
+2. Technical Architecture
+ 
+Frontend
+ 
+Stack: JavaScript (Vanilla), Bootstrap 5 (modal)
+ 
+Session State:
+ 
+Tracks currentZoneId (active configuration) and hasChatted (true if user has sent a message or summarized)
+ 
+ 
+Eligibility Check:
+ 
+On back button click, modal is triggered only if both currentZoneId is set and hasChatted is true.
+ 
+ 
+API Integration:
+ 
+AJAX/fetch to /user_feedback_eligibility endpoint for final eligibility confirmation and feedback prefill.
+ 
+POST to /submit_feedback endpoint for feedback persistence.
+ 
+ 
+ 
+Backend
+ 
+Stack: Flask (UI Gateway), FastAPI (microservices), PostgreSQL
+ 
+Security: All feedback endpoints protected via Flask’s @login_required decorator.
+ 
+Eligibility Endpoint:
+/user_feedback_eligibility returns:
+ 
+eligible_for_feedback (True if chat exists for notebook/zone)
+ 
+has_feedback (True if prior feedback exists)
+ 
+rating, comment (prefill values if present)
+ 
+ 
+Submission Endpoint:
+/submit_feedback creates or updates feedback in DB.
+ 
+ 
+Data Model
+ 
+feedback (
+    id SERIAL PRIMARY KEY,
+    user_id VARCHAR,
+    notebook_id INT,
+    effort_id INT,
+    zone_id INT,
+    rating INT,
+    comment TEXT,
+    created_at TIMESTAMP DEFAULT NOW(),
+    UNIQUE(user_id, notebook_id, effort_id, zone_id)
+)
+ 
+ 
+---
+ 
+3. Flow Sequence (with Tech Detail)
+ 
+1. Zone selection:
+User selects a configuration from the dropdown; currentZoneId is set.
+ 
+ 
+2. Chat/Summarize interaction:
+On any message or summary, hasChatted = true; in JS.
+ 
+ 
+3. Back button event:
+On click, JS checks:
+ 
+If no zone or hasChatted == false, navigates away with no modal.
+ 
+If both present, calls /user_feedback_eligibility.
+ 
+ 
+ 
+4. Eligibility check (backend):
+Flask endpoint verifies chat history via FastAPI; returns feedback eligibility and prefill values.
+ 
+ 
+5. Modal Display:
+ 
+If eligible, Bootstrap modal is shown. Prefilled if feedback exists.
+ 
+ 
+ 
+6. Feedback submission:
+ 
+On modal submit, JS POSTs feedback to /submit_feedback.
+ 
+FastAPI microservice creates or updates DB row.
+ 
+ 
+ 
+ 
+ 
+---
+ 
+4. API Reference
+ 
+Eligibility Request (GET):
+ 
+/user_feedback_eligibility?user_id=...&notebook_id=...&zone_id=...
+ 
+Returns:
+ 
+ 
+{
+  "eligible_for_feedback": true,
+  "has_feedback": true,
+  "rating": 4,
+  "comment": "Nice"
+}
+ 
+Feedback Submission (POST):
+ 
+/submit_feedback
+Payload:
+{
+  "user_id": "PI0001",
+  "notebook_id": 2,
+  "effort_id": 1,
+  "zone_id": 36,
+  "rating": 4,
+  "comment": "Nice"
+}
+ 
+ 
+---
+ 
+5. Edge Cases & Error Handling
+ 
+Session loss:
+If the user refreshes, hasChatted resets. Modal will not pop up unless the user interacts again.
+ 
+API failure:
+ 
+Eligibility API failure: User is redirected back.
+ 
+Submission API failure: User sees an error alert.
+ 
+ 
+Feedback updates:
+Existing feedback is prefilled and updatable via the modal.
+ 
+Security:
+All endpoints require authentication (@login_required).
+ 
+ 
+ 
+---
+ 
+6. Pseudocode (Frontend Eligibility Logic)
+ 
+let hasChatted = false;
+function sendMessage() { ... hasChatted = true; }
+function summarize() { ... hasChatted = true; }
+ 
+backButton.addEventListener("click", async function(event) {
+    if (!currentZoneId) { goBack(); return; }
+    if (!hasChatted) { goBack(); return; }
+    // Call backend for eligibility check and show modal if eligible
+});
+ 
+ 
+---
+ 
+7. Sequence Diagram (Textual)
+ 
+User
+↓
+[Select Zone] --(sets currentZoneId)-->
+↓
+[Chat/Summarize] --(sets hasChatted)-->
+↓
+[Click Back]
+↓
+[JS: If both set, call API]
+↓
+[Flask: /user_feedback_eligibility]
+↓
+[FastAPI: Checks chat history]
+↓
+[Return eligible? Prefill values?]
+↓
+[If eligible: Show modal]
+↓
+[User submits feedback]
+↓
+[JS: POST to /submit_feedback]
+↓
+[FastAPI: Store/update feedback in DB]
+ 
+ 
+---
+ 
+8. Security & Robustness Notes
+ 
+State variables (hasChatted, currentZoneId) are session-only and do not persist on page reload.
+ 
+Server-side check guarantees modal is shown only after real chat/summarize event.
+ 
+No feedback collection for passive/idle sessions.
+ 
+ 
+ 
+---
+ 
+Summary
+ 
+This design guarantees that feedback is solicited only after meaningful user interaction in the correct context, prevents duplicate feedback, and provides seamless update flows. All actions are secured, API-driven, and fail-safe against common errors.