How mahimap1/lumen works
Lumen is a student study and career-planning application. Users explore degree plans, alumni pathways, and career data, or create a course-, skill-, or career-focused chat session; the chat can return interactive learning widgets, while separate visualization tools include HTML and Manim-based outputs. The frontend also keeps view, session, and widget state locally. The README provides no product detail, and several source excerpts are partial, so the graph omits uncertain backend wiring and includes only relations supported by the tree or sampled code.
Main entry points: App.jsx App navigation · main.py FastAPI routes · backboard_service.py Study assistant · sqlite_service.py Read-only SQL
Components 21
Student interface
- App navigation
frontend/src/App.jsx - Session setup
frontend/src/components/NewSessionModal.jsx - Study chat
frontend/src/components/chat/ChatSessionView.jsx - Four-year plan
frontend/src/components/FourYearPlanView.jsx - Alumni pathways
frontend/src/components/AlumniPathwaysView.jsx - Career dashboard
frontend/src/components/CareerDashboard.jsx
Study and visualization
- Visual archive
frontend/src/components/VisualArchive.jsx - Curated ML widgets
frontend/src/data/mlWidgets.js - Animation service
backend/services/manim_service.py
Career insights
- Career mappings
backend/services/career_service.py - Career queries
backend/services/career_db.py
Backend services
- Frontend API
frontend/src/services/api.js - FastAPI routes
backend/main.py - Study assistant
backend/services/backboard_service.py - Gemini capabilities
backend/services/gemini_service.py
Data and integrations
- Read-only SQL
backend/services/sqlite_service.py - Campus database
- Browser storage
Other components
- Student
- Backboard service
- Google Gemini
Connections 23
- Student → App navigation: uses
- App navigation → Four-year plan: shows
- App navigation → Alumni pathways: shows
- App navigation → Career dashboard: shows
- App navigation → Visual archive: shows
- App navigation → Study chat: shows
- App navigation → Session setup: opens
- App navigation → Frontend API: creates sessions
- App navigation → Browser storage: saves view and widgets
- Study chat → Frontend API: sends messages
- Visual archive → Curated ML widgets: uses curated content
- Frontend API → FastAPI routes: requests
- FastAPI routes → Study assistant: delegates study chat
- Study assistant → Backboard service: manages threads
- Study assistant → Google Gemini: generates fallback replies
- Study assistant → Read-only SQL: queries campus data
- FastAPI routes → Gemini capabilities: generates HTML widgets
- FastAPI routes → Career queries: loads career data
- FastAPI routes → Career mappings: uses career mappings
- FastAPI routes → Read-only SQL: runs dashboard and profile queries
- FastAPI routes → Animation service: requests animations
- Career queries → Read-only SQL: queries campus data
- Read-only SQL → Campus database: reads