-
Verification Dashboard
-
- Review and verify reference submissions from the community
-
+
+
+
Verification Dashboard
+
+ Review and verify reference submissions from the community
+
+
+
+
+
+ {isConnected ? 'Live' : 'Offline'}
+
+
+
{/* Stats */}
diff --git a/frontend/src/pages/ApiDocumentation.tsx b/frontend/src/pages/ApiDocumentation.tsx
new file mode 100644
index 0000000..0de912a
--- /dev/null
+++ b/frontend/src/pages/ApiDocumentation.tsx
@@ -0,0 +1,362 @@
+import { useState } from 'react';
+import { ExternalLink, BookOpen, Code, FileJson, Zap, Shield, Users, Globe, BarChart3, Settings } from 'lucide-react';
+import { Button } from '../components/ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '../components/ui/card';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '../components/ui/tabs';
+import { Badge } from '../components/ui/badge';
+
+const API_BASE_URL = import.meta.env.VITE_API_URL?.replace('/api', '') || 'http://localhost:5000';
+const SWAGGER_UI_URL = `${API_BASE_URL}/api/docs`;
+const SWAGGER_JSON_URL = `${API_BASE_URL}/api/docs.json`;
+
+export const ApiDocumentation: React.FC = () => {
+ const [iframeLoaded, setIframeLoaded] = useState(false);
+
+ const apiSections = [
+ {
+ name: 'Authentication',
+ description: 'User registration, login, logout, and token management',
+ icon: Shield,
+ endpoints: ['POST /api/auth/register', 'POST /api/auth/login', 'GET /api/auth/me'],
+ color: 'bg-blue-500'
+ },
+ {
+ name: 'Submissions',
+ description: 'Create, read, update, and verify Wikipedia source submissions',
+ icon: BookOpen,
+ endpoints: ['GET /api/submissions', 'POST /api/submissions', 'PUT /api/submissions/:id/verify'],
+ color: 'bg-green-500'
+ },
+ {
+ name: 'Users',
+ description: 'User profiles, leaderboard, badges, and role management',
+ icon: Users,
+ endpoints: ['GET /api/users', 'GET /api/users/leaderboard', 'PUT /api/users/:id/role'],
+ color: 'bg-purple-500'
+ },
+ {
+ name: 'Admin',
+ description: 'Administrative operations and dashboard analytics',
+ icon: Settings,
+ endpoints: ['GET /api/admin/dashboard', 'GET /api/admin/analytics', 'PUT /api/admin/users/:id'],
+ color: 'bg-red-500'
+ },
+ {
+ name: 'Countries',
+ description: 'Country statistics and verifier management',
+ icon: Globe,
+ endpoints: ['GET /api/countries', 'GET /api/countries/:code/stats', 'POST /api/countries/:code/assign-verifier'],
+ color: 'bg-yellow-500'
+ },
+ {
+ name: 'Reports',
+ description: 'Analytics and reporting for admins and verifiers',
+ icon: BarChart3,
+ endpoints: ['GET /api/reports/overview', 'GET /api/reports/country/:country', 'GET /api/reports/user/:userId'],
+ color: 'bg-indigo-500'
+ }
+ ];
+
+ return (
+
+
+ {/* Header */}
+
+
+
+
+
+
API Documentation
+
+ Interactive API documentation powered by Swagger/OpenAPI
+
+
+
+
+
+ OpenAPI 3.0.0
+
+
+ REST API
+
+
+ JWT Authentication
+
+
+
+
+
+
+
+
+ Interactive Docs
+
+
+
+ API Overview
+
+
+
+
+ Swagger UI
+
+ Interactive API documentation with live testing capabilities
+
+
+
+
+ {!iframeLoaded && (
+
+
+
+
Loading Swagger UI...
+
+
+ )}
+