feat: Add comprehensive sandbox mode, public API system, and platform support

This commit adds major features for sandbox isolation, public API access, and platform support ticketing.

## Sandbox Mode
- Add sandbox mode toggle for businesses to test features without affecting live data
- Implement schema-based isolation for tenant data (appointments, resources, services)
- Add is_sandbox field filtering for shared models (customers, staff, tickets)
- Create sandbox middleware to detect and set sandbox mode from cookies
- Add sandbox context and hooks for React frontend
- Display sandbox banner when in test mode
- Auto-reload page when switching between live/test modes
- Prevent platform support tickets from being created in sandbox mode

## Public API System
- Full REST API for external integrations with businesses
- API token management with sandbox/live token separation
- Test tokens (ss_test_*) show full plaintext for easy testing
- Live tokens (ss_live_*) are hashed and secure
- Security validation prevents live token plaintext storage
- Comprehensive test suite for token security
- Rate limiting and throttling per token
- Webhook support for real-time event notifications
- Scoped permissions system (read/write per resource type)
- API documentation page with interactive examples
- Token revocation with confirmation modal

## Platform Support
- Dedicated support page for businesses to contact SmoothSchedule
- View all platform support tickets in one place
- Create new support tickets with simplified interface
- Reply to existing tickets with conversation history
- Platform tickets have no admin controls (no priority/category/assignee/status)
- Internal notes hidden for platform tickets (business can't see them)
- Quick help section with links to guides and API docs
- Sandbox warning prevents ticket creation in test mode
- Business ticketing retains full admin controls (priority, assignment, internal notes)

## UI/UX Improvements
- Add notification dropdown with real-time updates
- Staff permissions UI for ticket access control
- Help dropdown in sidebar with Platform Guide, Ticketing Help, API Docs, and Support
- Update sidebar "Contact Support" to "Support" with message icon
- Fix navigation links to use React Router instead of anchor tags
- Remove unused language translations (Japanese, Portuguese, Chinese)

## Technical Details
- Sandbox middleware sets request.sandbox_mode from cookies
- ViewSets filter data by is_sandbox field
- API authentication via custom token auth class
- WebSocket support for real-time ticket updates
- Migration for sandbox fields on User, Tenant, and Ticket models
- Comprehensive documentation in SANDBOX_MODE_IMPLEMENTATION.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
poduck
2025-11-28 16:44:06 -05:00
parent 4acea4f876
commit a9719a5fd2
77 changed files with 11407 additions and 2694 deletions

View File

@@ -0,0 +1,229 @@
import React, { useState, useRef, useEffect } from 'react';
import { useTranslation } from 'react-i18next';
import { useNavigate } from 'react-router-dom';
import { Bell, Check, CheckCheck, Trash2, X, Ticket, Calendar, MessageSquare } from 'lucide-react';
import {
useNotifications,
useUnreadNotificationCount,
useMarkNotificationRead,
useMarkAllNotificationsRead,
useClearAllNotifications,
} from '../hooks/useNotifications';
import { Notification } from '../api/notifications';
interface NotificationDropdownProps {
variant?: 'light' | 'dark';
onTicketClick?: (ticketId: string) => void;
}
const NotificationDropdown: React.FC<NotificationDropdownProps> = ({ variant = 'dark', onTicketClick }) => {
const { t } = useTranslation();
const navigate = useNavigate();
const [isOpen, setIsOpen] = useState(false);
const dropdownRef = useRef<HTMLDivElement>(null);
const { data: notifications = [], isLoading } = useNotifications({ limit: 20 });
const { data: unreadCount = 0 } = useUnreadNotificationCount();
const markReadMutation = useMarkNotificationRead();
const markAllReadMutation = useMarkAllNotificationsRead();
const clearAllMutation = useClearAllNotifications();
// Close dropdown when clicking outside
useEffect(() => {
const handleClickOutside = (event: MouseEvent) => {
if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
setIsOpen(false);
}
};
document.addEventListener('mousedown', handleClickOutside);
return () => document.removeEventListener('mousedown', handleClickOutside);
}, []);
const handleNotificationClick = (notification: Notification) => {
// Mark as read
if (!notification.read) {
markReadMutation.mutate(notification.id);
}
// Handle ticket notifications specially - open modal instead of navigating
if (notification.target_type === 'ticket' && onTicketClick) {
const ticketId = notification.data?.ticket_id;
if (ticketId) {
onTicketClick(String(ticketId));
setIsOpen(false);
return;
}
}
// Navigate to target if available
if (notification.target_url) {
navigate(notification.target_url);
setIsOpen(false);
}
};
const handleMarkAllRead = () => {
markAllReadMutation.mutate();
};
const handleClearAll = () => {
clearAllMutation.mutate();
};
const getNotificationIcon = (targetType: string | null) => {
switch (targetType) {
case 'ticket':
return <Ticket size={16} className="text-blue-500" />;
case 'event':
case 'appointment':
return <Calendar size={16} className="text-green-500" />;
default:
return <MessageSquare size={16} className="text-gray-500" />;
}
};
const formatTimestamp = (timestamp: string) => {
const date = new Date(timestamp);
const now = new Date();
const diffMs = now.getTime() - date.getTime();
const diffMins = Math.floor(diffMs / 60000);
const diffHours = Math.floor(diffMs / 3600000);
const diffDays = Math.floor(diffMs / 86400000);
if (diffMins < 1) return t('notifications.justNow', 'Just now');
if (diffMins < 60) return t('notifications.minutesAgo', '{{count}}m ago', { count: diffMins });
if (diffHours < 24) return t('notifications.hoursAgo', '{{count}}h ago', { count: diffHours });
if (diffDays < 7) return t('notifications.daysAgo', '{{count}}d ago', { count: diffDays });
return date.toLocaleDateString();
};
const buttonClasses = variant === 'light'
? 'p-2 rounded-md text-white/80 hover:text-white hover:bg-white/10 transition-colors'
: 'relative p-2 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 transition-colors rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700';
return (
<div className="relative" ref={dropdownRef}>
{/* Bell Button */}
<button
onClick={() => setIsOpen(!isOpen)}
className={buttonClasses}
aria-label={t('notifications.openNotifications', 'Open notifications')}
>
<Bell size={20} />
{unreadCount > 0 && (
<span className="absolute top-1 right-1 flex items-center justify-center min-w-[18px] h-[18px] px-1 text-[10px] font-bold text-white bg-red-500 rounded-full">
{unreadCount > 99 ? '99+' : unreadCount}
</span>
)}
</button>
{/* Dropdown */}
{isOpen && (
<div className="absolute right-0 mt-2 w-80 sm:w-96 bg-white dark:bg-gray-800 rounded-xl shadow-xl border border-gray-200 dark:border-gray-700 z-50 overflow-hidden">
{/* Header */}
<div className="px-4 py-3 border-b border-gray-200 dark:border-gray-700 flex items-center justify-between">
<h3 className="text-sm font-semibold text-gray-900 dark:text-white">
{t('notifications.title', 'Notifications')}
</h3>
<div className="flex items-center gap-2">
{unreadCount > 0 && (
<button
onClick={handleMarkAllRead}
disabled={markAllReadMutation.isPending}
className="p-1.5 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
title={t('notifications.markAllRead', 'Mark all as read')}
>
<CheckCheck size={16} />
</button>
)}
<button
onClick={() => setIsOpen(false)}
className="p-1.5 text-gray-400 hover:text-gray-600 dark:hover:text-gray-200 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors"
>
<X size={16} />
</button>
</div>
</div>
{/* Notification List */}
<div className="max-h-96 overflow-y-auto">
{isLoading ? (
<div className="px-4 py-8 text-center text-gray-500 dark:text-gray-400">
{t('common.loading')}
</div>
) : notifications.length === 0 ? (
<div className="px-4 py-8 text-center">
<Bell size={32} className="mx-auto text-gray-300 dark:text-gray-600 mb-2" />
<p className="text-sm text-gray-500 dark:text-gray-400">
{t('notifications.noNotifications', 'No notifications yet')}
</p>
</div>
) : (
<div className="divide-y divide-gray-100 dark:divide-gray-700">
{notifications.map((notification) => (
<button
key={notification.id}
onClick={() => handleNotificationClick(notification)}
className={`w-full px-4 py-3 text-left hover:bg-gray-50 dark:hover:bg-gray-700/50 transition-colors ${
!notification.read ? 'bg-blue-50/50 dark:bg-blue-900/10' : ''
}`}
>
<div className="flex items-start gap-3">
<div className="mt-0.5">
{getNotificationIcon(notification.target_type)}
</div>
<div className="flex-1 min-w-0">
<p className={`text-sm ${!notification.read ? 'font-medium' : ''} text-gray-900 dark:text-white`}>
<span className="font-medium">{notification.actor_display || 'System'}</span>
{' '}
{notification.verb}
</p>
{notification.target_display && (
<p className="text-sm text-gray-500 dark:text-gray-400 truncate mt-0.5">
{notification.target_display}
</p>
)}
<p className="text-xs text-gray-400 dark:text-gray-500 mt-1">
{formatTimestamp(notification.timestamp)}
</p>
</div>
{!notification.read && (
<span className="w-2 h-2 bg-blue-500 rounded-full flex-shrink-0 mt-2"></span>
)}
</div>
</button>
))}
</div>
)}
</div>
{/* Footer */}
{notifications.length > 0 && (
<div className="px-4 py-3 border-t border-gray-200 dark:border-gray-700 flex items-center justify-between">
<button
onClick={handleClearAll}
disabled={clearAllMutation.isPending}
className="text-xs text-gray-500 hover:text-gray-700 dark:text-gray-400 dark:hover:text-gray-200 flex items-center gap-1"
>
<Trash2 size={12} />
{t('notifications.clearRead', 'Clear read')}
</button>
<button
onClick={() => {
navigate('/notifications');
setIsOpen(false);
}}
className="text-xs text-brand-600 hover:text-brand-700 dark:text-brand-400 font-medium"
>
{t('notifications.viewAll', 'View all')}
</button>
</div>
)}
</div>
)}
</div>
);
};
export default NotificationDropdown;