How omar-khecharem/portfolio works
This is a full-stack portfolio: visitors browse profile, projects, and contact content; admins sign in to manage portfolio content and configuration, while the site records visits and offers an AI assistant. The React app calls an Express API backed by MongoDB, with Cloudflare Workers AI documented for chatbot inference. The graph preserves public, administration, analytics, and chatbot capabilities. Some route/controller wiring and frontend calls are unsampled, so those links are omitted or marked unverified rather than inferred.
Main entry points: db.js MongoDB · App.jsx SPA router and layout · api.js HTTP API client · AdminDashboard.jsx Dashboard page
Components 24
Public portfolio
- SPA router and layout
frontend/src/App.jsx - Profile and certifications
frontend/src/pages/About.jsx - Project browsing
frontend/src/pages/Projects.jsx - Chat interface
frontend/src/components/sections/ChatBot.jsx - Visit tracking
frontend/src/components/ui/VisitTracker.jsx - Theme state
frontend/src/contexts/ThemeContext.jsx
Admin dashboard
- Dashboard page
frontend/src/pages/AdminDashboard.jsx - Project management
frontend/src/components/admin/ProjectsPanel.jsx - Analytics panels
frontend/src/components/admin/AnalyticsPanel.jsx
API and persistence
- HTTP API client
frontend/src/services/api.js - Express API server
backend/src/server.js - Authentication routes
backend/src/routes/auth.js - Authentication logic
backend/src/controllers/authController.js - Token protection
backend/src/middleware/auth.js - Profile operations
backend/src/controllers/profileController.js - Project operations
backend/src/controllers/projectController.js - Contact messages
backend/src/controllers/messageController.js - Visitor analytics
backend/src/controllers/visitorController.js - MongoDB
backend/src/config/db.js
AI assistant
- Chat orchestration
backend/src/controllers/chatbotController.js - AI worker
chatbot-worker/src/index.js
Other components
- Site visitor
- Administrator
- Cloudflare Workers AI
Connections 26
- Site visitor → SPA router and layout: browses
README.md - Administrator → Dashboard page: manages content
README.md - SPA router and layout → Profile and certifications: routes to
frontend/src/App.jsx - SPA router and layout → Project browsing: routes to
frontend/src/App.jsx - SPA router and layout → Chat interface: renders
frontend/src/App.jsx - SPA router and layout → Visit tracking: renders
frontend/src/App.jsx - Dashboard page → Project management: manages projects
- Dashboard page → Analytics panels: shows analytics
- Profile and certifications → HTTP API client: fetches profile data
frontend/src/pages/About.jsx - Project browsing → HTTP API client: fetches projects
frontend/src/pages/Projects.jsx - Chat interface → HTTP API client: sends chat requests
frontend/src/components/sections/ChatBot.jsx - Theme state → HTTP API client: loads and updates themes
frontend/src/contexts/ThemeContext.jsx - HTTP API client → Express API server: calls REST API
README.md - Express API server → Authentication routes: mounts routes
backend/src/server.js - Express API server → MongoDB: connects
backend/src/server.js - Authentication routes → Authentication logic: dispatches login
backend/src/routes/auth.js - Authentication routes → Token protection: protects identity route
backend/src/routes/auth.js - Authentication logic → MongoDB: reads user
backend/src/controllers/authController.js - Token protection → MongoDB: loads user
backend/src/middleware/auth.js - Profile operations → MongoDB: reads and writes profile
backend/src/controllers/profileController.js - Project operations → MongoDB: reads and writes projects
backend/src/controllers/projectController.js - Contact messages → MongoDB: stores messages
backend/src/controllers/messageController.js - Visitor analytics → MongoDB: records and aggregates visits
backend/src/controllers/visitorController.js - Chat orchestration → MongoDB: loads portfolio context
backend/src/controllers/chatbotController.js - Chat orchestration → Cloudflare Workers AI: requests inference
backend/src/controllers/chatbotController.js - AI worker → Cloudflare Workers AI: runs model inference