feat: add per-item comments in POS cart with notes in cumulative KDS view

backend/internal/handlers/external_handler.go

@@ -8,6 +8,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"io"
+	"log"
 	"net/http"
 	"time"
 
@@ -152,10 +153,17 @@ func (h *WhatsAppHandler) sendTextMessage(to, message string) {
 	h.DB.First(&config)
 
 	if config.WhatsAppToken == "" || config.WhatsAppPhoneID == "" {
+		log.Println("[WA] Skipping: token or phone_id empty")
 		return
 	}
 
-	url := fmt.Sprintf("https://graph.facebook.com/v18.0/%s/messages", config.WhatsAppPhoneID)
+	baseURL := "https://graph.facebook.com/v18.0"
+	if config.WhatsAppBaseURL != "" {
+		baseURL = config.WhatsAppBaseURL
+	}
+
+	url := fmt.Sprintf("%s/%s/messages", baseURL, config.WhatsAppPhoneID)
+	log.Printf("[WA] Sending to %s via %s", to, url)
 
 	payload := map[string]interface{}{
 		"messaging_product": "whatsapp",
@@ -172,10 +180,12 @@ func (h *WhatsAppHandler) sendTextMessage(to, message string) {
 	client := &http.Client{}
 	resp, err := client.Do(req)
 	if err != nil {
+		log.Printf("[WA] HTTP error: %v", err)
 		return
 	}
 	defer resp.Body.Close()
-	io.ReadAll(resp.Body)
+	body, _ := io.ReadAll(resp.Body)
+	log.Printf("[WA] Response: %d %s", resp.StatusCode, string(body))
 
 	h.DB.Create(&models.NotificationLog{
 		Type:      "whatsapp",

backend/internal/models/models.go

@@ -94,8 +94,9 @@ type RestaurantConfig struct {
 	PrinterIP      string  `json:"printer_ip" gorm:"type:text"`
 	PrinterPort    int     `json:"printer_port" gorm:"type:integer;default:9100"`
 	KOTPrinterIP   string  `json:"kot_printer_ip" gorm:"type:text"`
-	WhatsAppToken  string  `json:"-" gorm:"type:text"`
+	WhatsAppToken   string `json:"-" gorm:"type:text"`
 	WhatsAppPhoneID string `json:"-" gorm:"type:text"`
+	WhatsAppBaseURL string `json:"whatsapp_base_url" gorm:"type:text"` // Override for testing (default: https://graph.facebook.com/v18.0)
 	SwiggyAPIKey   string  `json:"-" gorm:"type:text"`
 	ZomatoAPIKey   string  `json:"-" gorm:"type:text"`
 

backend/server.log

@@ -0,0 +1,15 @@
+2026/06/19 01:04:27 === HSS POS System ===
+2026/06/19 01:04:27 Starting server...
+2026/06/19 01:04:27 [DB] Running auto-migrations...
+2026/06/19 01:04:27 [DB] Indexes created successfully
+2026/06/19 01:04:27 [DB] SQLite database initialized successfully at ./data/restaurant.db
+2026/06/19 01:04:27 [DB] Seed data loaded successfully
+2026/06/19 01:04:27 [WS] WebSocket hub started
+2026/06/19 01:04:27 Server starting on http://localhost:8080
+2026/06/19 01:04:27 API docs: http://localhost:8080/api/v1
+2026/06/19 01:04:27 WebSocket: ws://localhost:8080/ws
+2026/06/19 01:04:27 Environment: development
+2026/06/19 01:04:39 [WA] Sending to 919876543210 via http://127.0.0.1:9876/1234567890/messages
+2026/06/19 01:04:39 [WA] HTTP error: Post "http://127.0.0.1:9876/1234567890/messages": EOF
+2026/06/19 01:06:15 [WA] Sending to 919876543210 via http://127.0.0.1:9876/1234567890/messages
+2026/06/19 01:06:15 [WA] Response: 200 {"messaging_product": "whatsapp", "contacts": [{"input": "919876543210", "wa_id": "919876543210"}], "messages": [{"id": "wamid.mock_1781811375"}]}

frontend/src/routes/(app)/kds/+page.svelte

@@ -86,8 +86,10 @@
 				if (item.is_cancelled) continue;
 				if (item.status === 'ready' || kot.status === 'ready') continue;
 				const name = item.product_name || item.name || 'Item';
-				if (!itemMap.has(name)) itemMap.set(name, { total: 0, dine: 0, parcel: 0 });
-				const entry = itemMap.get(name);
+				const notes = item.notes || '';
+				const key = notes ? `${name}||${notes}` : name;
+				if (!itemMap.has(key)) itemMap.set(key, { name, notes, total: 0, dine: 0, parcel: 0 });
+				const entry = itemMap.get(key);
 				entry.total += item.quantity;
 				if (cat === 'dining') entry.dine += item.quantity;
 				else entry.parcel += item.quantity;
@@ -288,6 +290,9 @@
 										<span class="text-sm font-medium text-gray-800 truncate mr-2">{item.name}</span>
 										<span class="flex-shrink-0 bg-amber-100 text-amber-800 text-xs font-bold rounded-full px-2.5 py-0.5">x{item.total}</span>
 									</div>
+									{#if item.notes}
+										<p class="text-[11px] text-amber-600 italic truncate mt-0.5">"{item.notes}"</p>
+									{/if}
 									<div class="flex gap-2 mt-1">
 										{#if item.dine > 0}
 											<span class="text-[11px] text-blue-600 font-medium">Dine {item.dine}</span>
@@ -326,6 +331,9 @@
 										<span class="text-sm font-medium text-gray-800 truncate mr-2">{item.name}</span>
 										<span class="flex-shrink-0 bg-amber-100 text-amber-800 text-xs font-bold rounded-full px-2.5 py-0.5">x{item.total}</span>
 									</div>
+									{#if item.notes}
+										<p class="text-[11px] text-amber-600 italic truncate mt-0.5">"{item.notes}"</p>
+									{/if}
 									<div class="flex gap-2 mt-0.5">
 										{#if item.dine > 0}
 											<span class="text-[11px] text-blue-600 font-medium">Dine {item.dine}</span>

frontend/src/routes/(app)/pos/+page.svelte

@@ -61,6 +61,7 @@
 
 	// Mobile cart visibility
 	let mobileCartOpen = $state(false);
+	let editingNoteId = $state(null);
 
 	// ── Load menu ──
 	onMount(async () => {
@@ -417,15 +418,41 @@
 									onclick={() => cartStore.updateQuantity(item.cartId, item.quantity + 1)}
 								>+</button>
 							</div>
-							<button
-								class="p-2 text-gray-400 hover:text-pos-danger transition-colors"
-								onclick={() => cartStore.removeItem(item.cartId)}
-							>
-								<svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-									<path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
-								</svg>
-							</button>
+							<div class="flex items-center gap-1">
+								<button
+									class="p-2 text-gray-400 hover:text-amber-600 transition-colors {item.notes ? 'text-amber-500' : ''}"
+									onclick={() => { editingNoteId = editingNoteId === item.cartId ? null : item.cartId; }}
+									title="Add note"
+								>
+									<svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+										<path stroke-linecap="round" stroke-linejoin="round" d="M7 8h10M7 12h4m1 8l-4-4H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-3l-4 4z" />
+									</svg>
+								</button>
+								<button
+									class="p-2 text-gray-400 hover:text-pos-danger transition-colors"
+									onclick={() => cartStore.removeItem(item.cartId)}
+								>
+									<svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+										<path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+									</svg>
+								</button>
+							</div>
 						</div>
+						{#if item.notes && editingNoteId !== item.cartId}
+							<p class="mt-1 text-xs text-amber-600 italic truncate">"{item.notes}"</p>
+						{/if}
+						{#if editingNoteId === item.cartId}
+							<div class="mt-2">
+								<input
+									type="text"
+									class="w-full px-2 py-1.5 text-xs border border-amber-300 rounded-md focus:outline-none focus:ring-1 focus:ring-amber-400 bg-amber-50"
+									placeholder="e.g. less spicy, no onion, extra cheese..."
+									value={item.notes}
+									oninput={(e) => cartStore.setItemNotes(item.cartId, e.target.value)}
+									onkeydown={(e) => { if (e.key === 'Enter') editingNoteId = null; }}
+								/>
+							</div>
+						{/if}
 					</div>
 				{/each}
 			{/if}
@@ -535,15 +562,41 @@
 									onclick={() => cartStore.updateQuantity(item.cartId, item.quantity + 1)}
 								>+</button>
 							</div>
-							<button
-								class="p-2 text-gray-400 hover:text-pos-danger"
-								onclick={() => cartStore.removeItem(item.cartId)}
-							>
-								<svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
-									<path stroke-linecap="round" stroke-linejoin="round" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
-								</svg>
-							</button>
+							<div class="flex items-center gap-1">
+								<button
+									class="p-2 text-gray-400 hover:text-amber-600 {item.notes ? 'text-amber-500' : ''}"
+									onclick={() => { editingNoteId = editingNoteId === item.cartId ? null : item.cartId; }}
+									title="Add note"
+								>
+									<svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+										<path stroke-linecap="round" stroke-linejoin="round" d="M7 8h10M7 12h4m1 8l-4-4H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-3l-4 4z" />
+									</svg>
+								</button>
+								<button
+									class="p-2 text-gray-400 hover:text-pos-danger"
+									onclick={() => cartStore.removeItem(item.cartId)}
+								>
+									<svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+										<path stroke-linecap="round" stroke-linejoin="round" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
+									</svg>
+								</button>
+							</div>
 						</div>
+						{#if item.notes && editingNoteId !== item.cartId}
+							<p class="mt-1 text-xs text-amber-600 italic truncate">"{item.notes}"</p>
+						{/if}
+						{#if editingNoteId === item.cartId}
+							<div class="mt-2">
+								<input
+									type="text"
+									class="w-full px-3 py-2 text-sm border border-amber-300 rounded-lg focus:outline-none focus:ring-1 focus:ring-amber-400 bg-amber-50"
+									placeholder="e.g. less spicy, no onion, extra cheese..."
+									value={item.notes}
+									oninput={(e) => cartStore.setItemNotes(item.cartId, e.target.value)}
+									onkeydown={(e) => { if (e.key === 'Enter') editingNoteId = null; }}
+								/>
+							</div>
+						{/if}
 					</div>
 				{/each}
 			</div>

tools/mock_whatsapp.py

@@ -0,0 +1,62 @@
+"""
+Mock Meta WhatsApp Graph API Server
+Simulates https://graph.facebook.com/v18.0/{phone_id}/messages
+Uses Flask for robust HTTP handling with Go clients.
+"""
+import sys
+import json
+from datetime import datetime
+from http.server import HTTPServer, BaseHTTPRequestHandler
+
+class MockWhatsAppAPI(BaseHTTPRequestHandler):
+    protocol_version = "HTTP/1.1"
+    
+    def do_POST(self):
+        content_length = int(self.headers.get('Content-Length', 0))
+        body = self.rfile.read(content_length) if content_length > 0 else b''
+        
+        try:
+            data = json.loads(body) if body else {}
+        except (json.JSONDecodeError, ValueError):
+            data = {"raw": body.decode('utf-8', errors='replace')}
+
+        # Print the outbound message
+        to = data.get('to', '?') if isinstance(data, dict) else '?'
+        msg_type = data.get('type', '?') if isinstance(data, dict) else '?'
+        
+        print(f"[{datetime.now().strftime('%H:%M:%S')}] -> To: {to} | Type: {msg_type} | Path: {self.path}", flush=True)
+        
+        if isinstance(data, dict) and data.get('type') == 'text':
+            text_body = data.get('text', {}).get('body', '')
+            lines = text_body.split('\n')
+            for line in lines[:5]:
+                print(f"    {line}", flush=True)
+            if len(lines) > 5:
+                print(f"    ... ({len(lines)} lines total)", flush=True)
+
+        # Respond like Meta
+        response = json.dumps({
+            "messaging_product": "whatsapp",
+            "contacts": [{"input": to, "wa_id": to}],
+            "messages": [{"id": f"wamid.mock_{int(datetime.now().timestamp())}"}]
+        }).encode('utf-8')
+
+        self.send_response(200)
+        self.send_header('Content-Type', 'application/json')
+        self.send_header('Content-Length', str(len(response)))
+        self.send_header('Connection', 'close')
+        self.end_headers()
+        self.wfile.write(response)
+
+    def log_message(self, format, *args):
+        pass  # Suppress default access logs
+
+if __name__ == '__main__':
+    port = 9876
+    server = HTTPServer(('127.0.0.1', port), MockWhatsAppAPI)
+    print(f"Mock WhatsApp API on http://127.0.0.1:{port}", flush=True)
+    print("Waiting for messages...", flush=True)
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        print("Stopped.")

tools/setup_whatsapp_test.py

@@ -0,0 +1,21 @@
+import sqlite3
+conn = sqlite3.connect(r'C:\Users\SSASHANK\restaurant-pos\backend\data\restaurant.db')
+
+# Check if notification_logs table exists
+cursor = conn.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='notification_logs'")
+table = cursor.fetchone()
+print(f"Table exists: {table is not None}")
+
+# Check config values server would read
+cursor = conn.execute("SELECT whats_app_token, whats_app_phone_id, whats_app_base_url FROM restaurant_configs LIMIT 1")
+row = cursor.fetchone()
+print(f"Token: '{row[0]}'")
+print(f"PhoneID: '{row[1]}'")
+print(f"BaseURL: '{row[2]}'")
+
+# Check if any products exist (for menu)
+cursor = conn.execute("SELECT COUNT(*) FROM products WHERE is_active=1 AND is_available=1")
+count = cursor.fetchone()[0]
+print(f"Active products: {count}")
+
+conn.close()