How maharikha/campus-lost-found works
Campus Lost & Found lets students report lost or found items, find explained matches, answer a targeted disambiguation question, and prove ownership before pickup; desk staff record handovers. The frontend routes users through reporting, match review, claims, and the desk, while a FastAPI backend enriches reports, ranks candidates, verifies claims, and persists state. The README documents alerts and email plus rule-based fallbacks for optional AI. Backend wiring is only partly excerpted, so links based on the source index are limited to named dependencies; unsampled feature details are not inferred.
Main entry points: App.jsx App routing · app.py HTTP workflows · api.js API client · Home.jsx Browse items
Components 20
Web experience
- App routing
frontend/src/App.jsx - Browse items
frontend/src/pages/Home.jsx - Report item
frontend/src/pages/ReportForm.jsx - Match results
frontend/src/pages/ReportPage.jsx - Claim verification
frontend/src/pages/ClaimPage.jsx - Staff desk
frontend/src/pages/Desk.jsx - API client
frontend/src/api.js - Item cards
frontend/src/components/TagCard.jsx - Display formatting
frontend/src/lib/format.js - Report reminders
frontend/src/lib/store.js
Report and claim
- HTTP workflows
backend/app.py - Ownership proof
backend/verify.py
Matching services
- Report enrichment
backend/enrich.py - Candidate ranking
backend/matcher.py - Optional language model
backend/llm.py
Persistence and alerts
- SQLite records
backend/db.py - Owner alerts
backend/notify.py
Other components
- Student or finder
- Desk staff
- Brevo SMTP
Connections 25
- Student or finder → App routing: uses
frontend/src/App.jsx - Desk staff → App routing: uses
frontend/src/App.jsx - App routing → Browse items: routes to
frontend/src/App.jsx - App routing → Report item: routes to
frontend/src/App.jsx - App routing → Match results: routes to
frontend/src/App.jsx - App routing → Claim verification: routes to
frontend/src/App.jsx - App routing → Staff desk: routes to
frontend/src/App.jsx - Browse items → API client: requests data
frontend/src/pages/Home.jsx - Report item → API client: submits report
frontend/src/pages/ReportForm.jsx - Report item → Report reminders: remembers report
frontend/src/pages/ReportForm.jsx - Match results → API client: loads matches
frontend/src/pages/ReportPage.jsx - Claim verification → API client: verifies claim
frontend/src/pages/ClaimPage.jsx - Staff desk → API client: requests desk data
frontend/src/pages/Desk.jsx - Browse items → Item cards: renders items
frontend/src/pages/Home.jsx - Match results → Item cards: renders matches
frontend/src/pages/ReportPage.jsx - Item cards → Display formatting: formats details
frontend/src/components/TagCard.jsx - API client → HTTP workflows: HTTP requests
frontend/src/api.js - HTTP workflows → Report enrichment: enriches reports
backend/app.py - HTTP workflows → Candidate ranking: ranks candidates
backend/app.py - HTTP workflows → Ownership proof: checks ownership
backend/app.py - HTTP workflows → SQLite records: reads and writes
backend/app.py - HTTP workflows → Owner alerts: alerts owners
backend/app.py - Report enrichment → Optional language model: requests extraction
backend/enrich.py - Owner alerts → Brevo SMTP: sends email
README.md - Student or finder → HTTP workflows: answers question