How taheem-a/personal-university-planner works
This is a production university-planning application: users manage academic data and availability, then use planning capabilities to organize upcoming work. The visible API routes delegate to application services; the README identifies the deterministic planner, domain contracts, integrations, assistant, and analytics packages as major product capabilities. Source excerpts confirm selected route-to-service calls and database construction, but not the internal service-to-repository or planner wiring, so those links are omitted. The UI and several product subsystems are represented from the repository map rather than sampled implementation.
Main entry points: transport.ts HTTP transport · terms/route.ts Terms API · tasks/route.ts Tasks API · availability/route.ts Availability API
Components 22
Web application
- Web application
apps/web/src/app/page.tsx - Authentication route
apps/web/src/app/api/auth/[...nextauth]/route.ts - Account status API
apps/web/src/app/api/account/status/route.ts - Terms API
apps/web/src/app/api/v1/terms/route.ts - Tasks API
apps/web/src/app/api/v1/tasks/route.ts - Availability API
apps/web/src/app/api/v1/availability/route.ts - Courses API
apps/web/src/app/api/v1/courses/route.ts - Account export API
apps/web/src/app/api/v1/account/export/route.ts
Application services
- HTTP transport
apps/web/src/server/transport.ts - Academic services
apps/web/src/server/application/academic.ts - Schedule services
apps/web/src/server/application/schedule.ts - Account lifecycle
apps/web/src/server/application/lifecycle.ts - Authentication
apps/web/src/server/auth.ts
Planning capabilities
- Planning engine
packages/planner-core/src/index.ts - Domain vocabulary
packages/domain/src/index.ts - Assistant intents
packages/assistant/src/index.ts - Provider contracts
packages/integrations/src/index.ts - Estimate learning
packages/analytics/src/index.ts
Persistence
- Database boundary
packages/database/src/client.ts - Data repositories
packages/database/src/repositories/index.ts
Other components
- Planner user
- PostgreSQL
Connections 19
- Planner user → Web application: uses
- Planner user → Terms API: manages terms
- Planner user → Tasks API: manages tasks
- Planner user → Availability API: sets availability
- Planner user → Courses API: views courses
- Planner user → Authentication route: authenticates
- Planner user → Account export API: requests export
- Terms API → Academic services: calls
- Terms API → HTTP transport: formats response
- Tasks API → Academic services: calls
- Tasks API → HTTP transport: formats response
- Availability API → Schedule services: calls
- Availability API → HTTP transport: formats response
- Account export API → Account lifecycle: calls
- Account export API → HTTP transport: formats response
- Account status API → Authentication: checks actor
- Authentication route → Authentication: loads options
- Database boundary → Data repositories: creates
- Database boundary → PostgreSQL: connects