How wangjacks/career-explorer works
Career Explorer is a three-role student career-interest product: students activate accounts, select tags and build a profile through a multi-step form, while teachers and admins manage classes and review data. Admin capabilities also include statistics, exports, audit, settings and media/storage administration. The graph connects only relationships visible in sampled source or README; unsampled feature routes are grouped at their exact existing directories, and unsupported internal call paths are omitted.
Main entry points: db.ts Database adapter · storage.ts Storage abstraction · auth Login and activation · route.ts Data exports
Components 29
User experience
- Pages and dashboards
src/app
Identity and setup
- Login and activation
src/app/api/auth - Session tokens
src/lib/token.ts - Account verification
src/lib/auth.ts - Installation setup
src/app/api/setup
Profiles and discovery
- Profile workflow
src/app/form/create-profile - Draft persistence
src/hooks/useProfileDraft.ts - Profile submissions
src/app/api/shared/profile - Tag and word cloud
src/components/WordCloudCanvas.tsx - Shared profile API
src/app/api/shared/profile
Administration
- Role dashboards
src/app/dashboard - Class and people management
src/app/api/manage/classes - Tag administration
src/app/api/manage/tags - Statistics and overview
src/app/api/manage/stats - Data exports
src/app/api/manage/export/route.ts - Audit logging
src/lib/audit.ts - Settings and profile config
src/app/api/manage/settings - Media operations
src/app/api/manage/media - Storage management
src/app/api/manage/storage/route.ts
Data and media
- Database adapter
src/lib/db.ts - MySQL and SQLite
src/lib/db-mysql.ts - Storage abstraction
src/lib/storage.ts - Local files
src/lib/storage-local.ts - S3 object storage
src/lib/storage-s3.ts - Image upload API
src/app/api/upload/route.ts - Storage-aware images
src/components/StorageImage.tsx
Other components
- Students
- Teachers
- Administrators
Connections 32
- Students → Pages and dashboards: use
- Teachers → Pages and dashboards: use
- Administrators → Pages and dashboards: use
- Pages and dashboards → Login and activation: authenticate
- Login and activation → Account verification: verify password
src/app/api/auth/route.ts - Login and activation → Session tokens: sign and verify
src/app/api/auth/route.ts - Login and activation → Database adapter: look up users
src/app/api/auth/route.ts - Installation setup → Database adapter: configure adapter
src/app/api/setup/route.ts - Students → Profile workflow: complete
- Profile workflow → Draft persistence: save draft
src/hooks/useProfileDraft.ts - Profile workflow → Profile submissions: submit profile
- Students → Tag and word cloud: explore interests
- Shared profile API → Database adapter: read and write profiles
src/app/api/shared/profile/route.ts - Role dashboards → Statistics and overview: view statistics
- Administrators → Class and people management: manage classes
- Teachers → Class and people management: manage class data
- Administrators → Tag administration: manage tags
- Administrators → Data exports: export data
- Data exports → Database adapter: read records
src/app/api/manage/export/route.ts - Data exports → Storage abstraction: read and sign images
src/app/api/manage/export/route.ts - Data exports → Audit logging: record actions
src/app/api/manage/export/route.ts - Administrators → Audit logging: review activity
- Administrators → Settings and profile config: configure system
- Administrators → Media operations: manage media
- Administrators → Storage management: configure backends
- Storage management → Database adapter: manage backend records
src/app/api/manage/storage/route.ts - Database adapter → MySQL and SQLite: select adapter
src/lib/db.ts - Image upload API → Database adapter: read storage config
src/app/api/upload/route.ts - Image upload API → Storage abstraction: store uploaded files
src/app/api/upload/route.ts - Storage abstraction → Local files: create local adapter
src/lib/storage.ts - Storage abstraction → S3 object storage: create S3 adapter
src/lib/storage.ts - Storage-aware images → Storage abstraction: resolve file URL
src/components/StorageImage.tsx