How suriya1230/suriya-3d-portfolio works
Suriya AI Animated Portfolio is a visitor-facing portfolio with manual and 3D agentic experiences, visitor logging, feedback, and an admin CMS with analytics. The main journey begins at the home page, captures or reuses visitor details, records visits, then selects a portfolio experience. Admins authenticate separately before using content-management and analytics screens. Source excerpts show the active app using Firebase Realtime Database; the README also documents Firestore, so that documented data capability is represented separately. Some unsampled subsystem links are omitted where their wiring is not evidenced.
Main entry points: ManualPortfolio.js Manual portfolio · app/page.js Entry flow · rtdb.js Realtime DB helpers · admin-dashboard/page.js Admin dashboard
Components 31
Visitor entry
- Entry flow
app/page.js - Visit form
components/ui/VisitPopup.js - Mode selector
components/ui/ModeSelector.js - Feedback widget
components/ui/FeedbackWidget.js
Portfolio experiences
- Manual portfolio
components/portfolio/ManualPortfolio.js - Portfolio navigation
components/portfolio/Navbar.js - Hero section
components/portfolio/HeroSection.js - About section
components/portfolio/AboutSection.js - Education section
components/portfolio/EducationSection.js - Projects section
components/portfolio/ProjectsSection.js - Certificates section
components/portfolio/CertificatesSection.js - Skills section
components/portfolio/SkillsSection.js - Achievements section
components/portfolio/AchievementsSection.js - Contact section
components/portfolio/ContactSection.js - Agentic route
app/agentic/page.js - 3D scene
components/agentic/AgenticScene.js - Scene HUD
components/agentic/AgentHUD.js - Voice narration
hooks/useVoice.js
Admin tools
- Admin login
app/admin-login/page.js - Admin auth
lib/auth.js - Admin dashboard
app/admin-dashboard/page.js - Content editor
components/admin/CRUDPanel.js - Visit analytics
components/admin/AnalyticsDashboard.js - Admin navigation
components/admin/AdminSidebar.js
Firebase data
- Realtime DB helpers
lib/rtdb.js - Realtime Database
- Firestore data hook
hooks/usePortfolioData.js - Firestore
- Firebase setup
lib/firebase.js
Other components
- Visitor
- Administrator
Connections 38
- Visitor → Entry flow: opens
README.md - Entry flow → Visit form: shows
app/page.js - Visit form → Entry flow: submits details
app/page.js - Entry flow → Mode selector: shows
app/page.js - Entry flow → Realtime DB helpers: logs visits
app/page.js - Entry flow → Manual portfolio: renders manual mode
app/page.js - Entry flow → Agentic route: routes agentic mode
app/page.js - Mode selector → Entry flow: selects mode
app/page.js - Entry flow → Feedback widget: renders feedback
app/page.js - Manual portfolio → Portfolio navigation: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Hero section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → About section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Education section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Projects section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Certificates section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Skills section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Achievements section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Contact section: renders
components/portfolio/ManualPortfolio.js - Manual portfolio → Realtime DB helpers: fetches portfolio data
components/portfolio/ManualPortfolio.js - Agentic route → 3D scene: loads scene
app/agentic/page.js - 3D scene → Realtime DB helpers: fetches section data
components/agentic/AgenticScene.js - 3D scene → Scene HUD: renders
components/agentic/AgenticScene.js - 3D scene → Voice narration: uses narration
components/agentic/AgenticScene.js - Feedback widget → Realtime DB helpers: reads and writes reviews
components/ui/FeedbackWidget.js - Administrator → Admin login: opens
README.md - Admin login → Admin auth: authenticates
app/admin-login/page.js - Admin auth → Firebase setup: uses auth setup
lib/auth.js - Administrator → Admin dashboard: opens
README.md - Admin dashboard → Admin auth: checks session
app/admin-dashboard/page.js - Admin dashboard → Admin navigation: renders
app/admin-dashboard/page.js - Admin dashboard → Content editor: renders
app/admin-dashboard/page.js - Admin dashboard → Visit analytics: renders
app/admin-dashboard/page.js - Content editor → Realtime DB helpers: manages records
components/admin/CRUDPanel.js - Visit analytics → Realtime DB helpers: reads visit data
components/admin/AnalyticsDashboard.js - Realtime DB helpers → Firebase setup: uses database setup
lib/rtdb.js - Realtime DB helpers → Realtime Database: reads and writes
lib/rtdb.js - Firestore data hook → Firestore: fetches collections
hooks/usePortfolioData.js - Firestore data hook → Firebase setup: uses Firestore helpers