How alfintg/careerx works
CareerX turns a student’s year, skills, and interests into three personalized career trajectories, then presents fit scores, skill gaps, milestones, projects, and a first-month plan. The main flow runs from the profile form through the simulation API and its AI-or-fallback generation paths to the results and detail views. The README documents this workflow; source excerpts show the API routing, AI processing, and frontend request, but not every UI interaction or runtime detail.
Main entry points: route.ts Simulation endpoint · simulate.ts AI simulation · schema.ts Request and result schemas · page.tsx Profile form
Components 12
Student experience
- Profile form
app/page.tsx - Trajectory results
app/page.tsx - Path details
app/page.tsx
Simulation API
- Simulation endpoint
app/api/simulate/route.ts
Career generation
- AI simulation
lib/ai/simulate.ts - Prompt builder
lib/ai/prompt.ts - JSON normalizer
lib/ai/normalize.ts - Fallback results
lib/fallback/result.ts - Mock results
lib/mock/simulate.json
Data contracts
- Request and result schemas
lib/schema.ts
Other components
- Student
- Anthropic Claude
Connections 14
- Student → Profile form: enters profile
README.md - Profile form → Simulation endpoint: submits profile
app/page.tsx - Simulation endpoint → Request and result schemas: validates request
app/api/simulate/route.ts - Simulation endpoint → Request and result schemas: validates mock
app/api/simulate/route.ts - Simulation endpoint → AI simulation: calls simulation
app/api/simulate/route.ts - Simulation endpoint → Mock results: reads mock data
app/api/simulate/route.ts - Simulation endpoint → Fallback results: serves fallback
app/api/simulate/route.ts - AI simulation → Prompt builder: builds prompts
lib/ai/simulate.ts - AI simulation → Anthropic Claude: requests generation
lib/ai/simulate.ts - AI simulation → JSON normalizer: parses output
lib/ai/simulate.ts - AI simulation → Request and result schemas: validates result
lib/ai/simulate.ts - AI simulation → Fallback results: returns fallback
lib/ai/simulate.ts - Simulation endpoint → Trajectory results: returns paths
README.md - Trajectory results → Path details: opens selected path
app/page.tsx