How amherryyy/roomscouter works
RoomScouter helps students find and compare boarding houses near one university, while owners maintain listings and administrators moderate content. The main student journey is search and filter, browse results, inspect a listing and its location, then optionally save it, review it, or report it. Owners create and edit listings for review; administrators approve listings and handle reports and reviews. The graph includes authentication and the Supabase data boundary. Some subsystem connections rely on README documentation or SOURCE INDEX references; unsampled implementation details are not asserted.
Main entry points: server.ts Server data client · [id]/page.tsx Listing details · admin/page.tsx Admin portal · app/page.tsx Search and browse
Components 24
Student discovery
- Search and browse
app/page.tsx - Search filters
src/features/discovery/model.ts - Discovery queries
src/features/discovery/queries.ts - Listing details
app/listings/[id]/page.tsx - University location
src/features/discovery/university.ts - Map view
app/map/page.tsx
Accounts and students
- Login and registration
src/components/auth-page.tsx - Authentication actions
src/features/auth/actions.ts - Account page
app/account/page.tsx - Saved listings
src/features/favorites/actions.ts - Student reviews
src/features/reviews/review-section.tsx
Owner listings
- Owner portal
app/owner/page.tsx - Listing editor
src/features/listings/listing-form.tsx - Listing operations
src/features/listings/actions.ts
Administration and trust
- Content reports
src/features/reports/actions.ts - Admin portal
app/admin/page.tsx - Moderation operations
src/features/moderation/actions.ts - Report moderation
src/features/moderation/report-actions.ts - Review moderation
src/features/moderation/review-actions.ts
Other components
- Student
- Owner
- Administrator
- Server data client
src/lib/supabase/server.ts - Supabase
Connections 32
- Student → Search and browse: searches
README.md - Search and browse → Search filters: parses filters
app/page.tsx - Search and browse → Discovery queries: loads results
app/page.tsx - Discovery queries → Server data client: queries data
src/features/discovery/queries.ts - Discovery queries → Search filters: uses filters
src/features/discovery/queries.ts - Student → Listing details: opens listing
README.md - Listing details → Server data client: loads listing
app/listings/[id]/page.tsx - Listing details → University location: calculates distance
app/listings/[id]/page.tsx - Student → Map view: views map
README.md - Map view → University location: uses location
app/map/page.tsx - Student → Login and registration: registers or logs in
README.md - Login and registration → Authentication actions: submits credentials
app/login/page.tsx - Authentication actions → Server data client: authenticates
src/features/auth/actions.ts - Authentication actions → Account page: redirects after login
src/features/auth/actions.ts - Student → Saved listings: saves listing
README.md - Listing details → Saved listings: offers save action
app/listings/[id]/page.tsx - Student → Student reviews: writes review
README.md - Listing details → Student reviews: renders reviews
app/listings/[id]/page.tsx - Student → Content reports: reports content
README.md - Listing details → Content reports: offers report action
app/listings/[id]/page.tsx - Owner → Owner portal: maintains listings
README.md - Owner portal → Listing editor: opens editor
- Listing editor → Listing operations: submits listing
app/owner/listings/new/page.tsx - Listing operations → Server data client: writes listing
src/features/listings/actions.ts - Administrator → Admin portal: reviews content
README.md - Admin portal → Moderation operations: moderates listings
README.md - Admin portal → Report moderation: handles reports
- Admin portal → Review moderation: moderates reviews
- Moderation operations → Server data client: updates listings
- Report moderation → Server data client: resolves reports
- Review moderation → Server data client: updates reviews
src/features/moderation/review-actions.ts - Server data client → Supabase: connects
src/lib/supabase/server.ts