How raminsajjad/ai-university-planner works
AI University Planner is an authenticated academic-management app: students enter courses, assignments, and exams, then can request an AI-generated daily and weekly study plan grounded in that data. The main workflow runs from authenticated pages through feature clients and server actions to Prisma-backed persistence; the planner action also invokes the Groq-backed generator. Dashboard, analytics, notifications, profile, and settings provide supporting capabilities. Edges reflect the supplied excerpts, SOURCE INDEX references, or README; some implementation details, including unsampled pages and actions, are therefore shown only at subsystem level.
Main entry points: prisma.ts Prisma data access · auth.ts Authentication · page.tsx Academic pages · app-shell.tsx App shell
Components 27
App entry and shell
- Academic pages
app/assignments/page.tsx - Planner page
app/planner/page.tsx - Dashboard page
app/dashboard/page.tsx - Analytics page
app/analytics/page.tsx - Notifications page
app/notifications/page.tsx - App shell
components/layout/app-shell.tsx
Academic records
- Course management
components/courses/courses-client.tsx - Assignment management
components/assignments/assignments-client.tsx - Exam management
components/exams/exams-client.tsx - Course actions
actions/courses.ts - Assignment actions
actions/assignments.ts - Exam actions
actions/exams.ts - Notification actions
actions/notifications.ts - Notification interface
components/notifications/notifications-client.tsx
Planning and insights
- Planner form and result
components/planner/planner-client.tsx - Plan generation action
actions/planner.ts - Study plan generator
lib/ai.ts - Dashboard metrics
actions/dashboard.ts - Analytics charts
components/analytics/analytics-charts.tsx
Identity and profile
- Authentication
lib/auth.ts - Registration
actions/auth.ts - Student profile
actions/profile.ts - Account settings
app/settings/page.tsx
Persistence and services
- Prisma data access
lib/prisma.ts - PostgreSQL
- Groq AI service
Other components
- Student
Connections 40
- Student → Academic pages: manages records
- Student → Planner page: requests plan
- Student → Dashboard page: views progress
- Student → Analytics page: views analytics
- Student → Notifications page: checks alerts
- Academic pages → Course management: renders
- Academic pages → Assignment management: renders
app/assignments/page.tsx - Academic pages → Exam management: renders
- Academic pages → App shell: uses shell
app/assignments/page.tsx - Planner page → Planner form and result: renders
app/planner/page.tsx - Planner page → App shell: uses shell
app/planner/page.tsx - Dashboard page → Dashboard metrics: loads metrics
app/dashboard/page.tsx - Dashboard page → App shell: uses shell
app/dashboard/page.tsx - Analytics page → Analytics charts: renders charts
app/analytics/page.tsx - Analytics page → App shell: uses shell
app/analytics/page.tsx - Notifications page → Notification interface: renders
app/notifications/page.tsx - Notifications page → App shell: uses shell
app/notifications/page.tsx - Course management → Course actions: calls
components/courses/courses-client.tsx - Assignment management → Assignment actions: calls
components/assignments/assignments-client.tsx - Exam management → Exam actions: calls
components/exams/exams-client.tsx - Planner form and result → Plan generation action: submits
components/planner/planner-client.tsx - Notification interface → Notification actions: calls
components/notifications/notifications-client.tsx - Plan generation action → Study plan generator: generates plan
actions/planner.ts - Study plan generator → Groq AI service: requests completion
lib/ai.ts - Course actions → Authentication: checks session
actions/courses.ts - Assignment actions → Authentication: checks session
actions/assignments.ts - Exam actions → Authentication: checks session
actions/exams.ts - Plan generation action → Authentication: checks session
actions/planner.ts - Notification actions → Authentication: checks session
actions/notifications.ts - Registration → Prisma data access: accesses data
actions/auth.ts - Authentication → Prisma data access: queries users
lib/auth.ts - Course actions → Prisma data access: reads and writes
actions/courses.ts - Assignment actions → Prisma data access: reads and writes
actions/assignments.ts - Exam actions → Prisma data access: reads and writes
actions/exams.ts - Plan generation action → Prisma data access: loads and saves
actions/planner.ts - Notification actions → Prisma data access: reads and writes
actions/notifications.ts - Dashboard metrics → Prisma data access: loads metrics
- Student profile → Prisma data access: accesses profile data
- Prisma data access → PostgreSQL: persists records
- Student → Account settings: manages account