How compsci-adl/mycoursereviews works
MyCourseReviews is a course-review website for Adelaide University Computer Science Club students. The main workflow is browsing the course catalog, opening a course, and submitting a review; users can also discuss reviews and manage their contributions. Separate branches support course-update voting and administrator moderation. The source index and excerpts show the main route, action, authentication, and persistence boundaries; unsampled components are included only where the index identifies their role, and edges are limited to documented or indexed references.
Main entry points: reviews.ts Review and comment actions · auth.ts Authentication · index.ts Database connection · CourseDetailClient.tsx Course detail
Components 28
Course discovery
- Course browse route
src/app/courses/page.tsx - Browse courses
src/components/browse/BrowseCoursesClient.tsx - Course card
src/components/browse/CourseCard.tsx - Course catalog access
src/lib/courses-db.ts - Course data store
- Course information API
- Course detail route
src/app/courses/[code]/page.tsx - Course detail
src/components/course/CourseDetailClient.tsx
Reviews and discussion
- Review submission
src/components/course/ReviewModal.tsx - Review and comment actions
src/app/actions/reviews.ts - Review discussion feed
src/components/course/ReviewFeedCard.tsx - Comment thread
src/components/course/CommentThread.tsx - My reviews route
src/app/my-reviews/page.tsx - My contributions
src/components/dashboard/MyReviewsClient.tsx - Edit review
src/components/dashboard/EditReviewModal.tsx - Review content checks
src/lib/spam.ts - Profanity checks
src/lib/profanity.ts
Identity and persistence
- Authentication
src/auth.ts - Auth route
src/app/api/auth/[...nextauth]/route.ts - Keycloak
- Database connection
src/db/index.ts - Application data schema
src/db/schema.ts - PostgreSQL
Course updates and moderation
- Course update voting
src/app/actions/courseUpdates.ts - Vote logic
src/lib/course-update-voting.ts - Admin route
src/app/admin/page.tsx - Admin dashboard
src/components/admin/AdminDashboardClient.tsx
Other components
- Student
Connections 35
- Student → Course browse route: browses courses
src/app/courses/page.tsx - Course browse route → Course catalog access: loads courses
src/app/courses/page.tsx - Course catalog access → Course data store: reads catalog
src/lib/courses-db.ts - Course catalog access → Course information API: enriches courses
src/lib/courses-db.ts - Course browse route → Browse courses: renders
src/app/courses/page.tsx - Browse courses → Course card: renders cards
src/components/browse/BrowseCoursesClient.tsx - Student → Course detail route: opens course
src/app/courses/[code]/page.tsx - Course detail route → Course catalog access: loads course
src/app/courses/[code]/page.tsx - Course detail route → Course detail: renders detail
src/app/courses/[code]/page.tsx - Course detail → Review submission: opens submission
src/components/course/CourseDetailClient.tsx - Review submission → Review and comment actions: submits review
src/components/course/ReviewModal.tsx - Review and comment actions → Authentication: checks session
src/app/actions/reviews.ts - Review and comment actions → Database connection: reads and writes
src/app/actions/reviews.ts - Database connection → Application data schema: uses schema
src/db/index.ts - Database connection → PostgreSQL: connects
src/db/index.ts - Auth route → Authentication: uses handlers
src/app/api/auth/[...nextauth]/route.ts - Authentication → Keycloak: authenticates with
src/auth.ts - Authentication → Database connection: upserts identities
src/auth.ts - Review and comment actions → Review content checks: checks spam
src/app/actions/reviews.ts - Review and comment actions → Profanity checks: checks profanity
src/app/actions/reviews.ts - Course detail → Review discussion feed: renders reviews
src/components/course/CourseDetailClient.tsx - Review discussion feed → Comment thread: renders thread
src/components/course/ReviewFeedCard.tsx - Student → My reviews route: manages contributions
src/app/my-reviews/page.tsx - My reviews route → My contributions: renders dashboard
src/app/my-reviews/page.tsx - My contributions → Review and comment actions: updates contributions
src/components/dashboard/MyReviewsClient.tsx - My contributions → Edit review: opens editor
src/components/dashboard/MyReviewsClient.tsx - Course detail → Course update voting: submits vote
src/components/course/CourseDetailClient.tsx - Course update voting → Authentication: checks session
src/app/actions/courseUpdates.ts - Course update voting → Database connection: reads and writes
src/app/actions/courseUpdates.ts - Course update voting → Vote logic: uses vote logic
src/app/actions/courseUpdates.ts - Student → Admin route: opens moderation
src/app/admin/page.tsx - Admin route → Authentication: checks access
src/app/admin/page.tsx - Admin route → Database connection: loads moderation data
src/app/admin/page.tsx - Admin route → Admin dashboard: renders dashboard
src/app/admin/page.tsx - Admin dashboard → Review and comment actions: deletes comments
src/components/admin/AdminDashboardClient.tsx