How soulrx-ai/campus-lost-found-safety works
This is a campus lost-and-found and safety-reporting application, with account, staff-review, and administrator workflows. Users can report lost or found items, search listings, pursue claims, and submit safety reports; staff review operational records and admins manage users, items, categories, notifications, and system policy. The sampled search handler applies multilingual and metadata filters to published items; the admin item manager fetches item data and uses category APIs. Other feature areas are represented from the route tree; their detailed runtime wiring was not sampled.
Main entry points: categories/route.ts Category API · admin.ts Supabase admin client · search/route.ts Search API · system-settings/route.ts System settings API
Components 22
Public user workflows
- Item search
app/search/page.tsx - Search API
app/api/search/route.ts - Lost report
app/lost/report/page.tsx - Found report
app/found/report/page.tsx - Potential matches
app/matching/[id]/page.tsx
Claims and safety
- Claim workflow
app/claims/new/page.tsx - Support tickets
app/tickets/new/page.tsx - Safety reports
app/safety/report/page.tsx
Staff and admin
- Staff review
app/staff/claims/page.tsx - Safety review
app/staff/safety/page.tsx - Item management
components/admin/AdminItemManager.tsx - Admin item API
app/api/admin/items/route.ts - Category API
app/api/categories/route.ts - User administration
app/admin/users/page.tsx - Notifications
app/admin/notifications/page.tsx - System settings API
app/api/admin/system-settings/route.ts - Retention cleanup
app/api/cron/cleanup-returned-items/route.ts
Data and services
- Semantic filters
lib/semanticSearch.ts - Supabase server client
lib/supabase/server.ts - Supabase admin client
lib/supabase/admin.ts - Supabase data and storage
Other components
- Campus user
Connections 21
- Campus user → Item search: searches listings
- Campus user → Lost report: reports lost item
- Campus user → Found report: reports found item
- Campus user → Claim workflow: submits claim
- Campus user → Support tickets: requests support
- Campus user → Safety reports: reports concern
- Search API → Semantic filters: applies query filters
- Search API → Supabase server client: creates client
- Search API → Supabase data and storage: fetches published items
- Item management → Admin item API: loads items
- Item management → Category API: loads categories
- Admin item API → Supabase admin client: creates client
- Admin item API → Supabase data and storage: reads items
- Category API → Supabase server client: checks session
- Category API → Supabase admin client: admin writes
- Category API → Supabase data and storage: reads and updates categories
- System settings API → Supabase server client: checks session
- System settings API → Supabase admin client: creates client
- System settings API → Supabase data and storage: reads and saves settings
- Retention cleanup → Supabase admin client: creates client
- Retention cleanup → Supabase data and storage: queries and deletes expired records