How antorghsd/lostfound-uni works
The University Lost & Found Platform lets students and staff report and find items, pursue claims and handovers, and receive match notifications; administrators moderate users, items, categories, reports, and locations. The main flow runs from web or admin clients through the API to application use cases and persisted data, with matching and email workers supporting recovery. The README documents real-time behavior, but the socket implementation was not sampled, so its runtime links are shown as unverified. Frontend-to-API calls and several unsampled feature internals are likewise not asserted.
Main entry points: server.ts HTTP API Server · prisma.ts Application Database · index.ts API Route Registry · App.tsx Web App
Components 24
User Applications
- Web App
apps/web/src/App.tsx - Item & Claim Pages
apps/web/src/features - Admin Panel
apps/admin/src/App.tsx - Admin Operations
apps/admin/src/features
API Interface
- HTTP API Server
apps/api/src/server.ts - API Route Registry
apps/api/src/interface/http/routes/index.ts - Auth Routes
apps/api/src/interface/http/routes/auth.routes.ts - Auth Controller
apps/api/src/interface/http/controllers/auth.controller.ts - Admin Routes
apps/api/src/interface/http/routes/admin.routes.ts - Item Routes
apps/api/src/interface/http/routes/item.routes.ts - Claim Routes
apps/api/src/interface/http/routes/claim.routes.ts
Recovery Workflows
- Authentication
apps/api/src/application/use-cases/auth.service.ts - Item Management
apps/api/src/application/use-cases/item.service.ts - Claims & Handovers
apps/api/src/application/use-cases/claim.service.ts - Match Scoring
apps/api/src/application/use-cases/match.service.ts
Platform Services
- Matching Worker
apps/api/src/infrastructure/queue/matching.queue.ts - Email Worker
apps/api/src/infrastructure/queue/email.queue.ts - Email Delivery
apps/api/src/infrastructure/email/email.service.ts - Realtime Socket
apps/api/src/interface/socket/index.ts - Image Storage
apps/api/src/infrastructure/storage/cloudinary.service.ts - Application Database
apps/api/src/infrastructure/database/prisma.ts - Shared Types
packages/types/src/index.ts - Shared Validators
packages/validators/src/index.ts
Other components
- Students & Staff
Connections 26
- HTTP API Server → API Route Registry: mounts routes
apps/api/src/server.ts - HTTP API Server → Matching Worker: starts worker
apps/api/src/server.ts - HTTP API Server → Email Worker: starts worker
apps/api/src/server.ts - HTTP API Server → Email Delivery: verifies SMTP
apps/api/src/server.ts - HTTP API Server → Realtime Socket: initializes socket
apps/api/src/server.ts - API Route Registry → Auth Routes: registers
apps/api/src/interface/http/routes/index.ts - API Route Registry → Item Routes: registers
apps/api/src/interface/http/routes/index.ts - API Route Registry → Claim Routes: registers
apps/api/src/interface/http/routes/index.ts - API Route Registry → Admin Routes: registers
apps/api/src/interface/http/routes/index.ts - Auth Routes → Auth Controller: routes requests
apps/api/src/interface/http/routes/auth.routes.ts - Auth Controller → Authentication: calls
apps/api/src/interface/http/controllers/auth.controller.ts - Auth Controller → Application Database: reads profile
apps/api/src/interface/http/controllers/auth.controller.ts - Authentication → Application Database: reads and writes
apps/api/src/application/use-cases/auth.service.ts - Admin Routes → Application Database: reads and writes
apps/api/src/interface/http/routes/admin.routes.ts - Item Management → Application Database: reads and writes
apps/api/src/application/use-cases/item.service.ts - Claims & Handovers → Application Database: reads and writes
apps/api/src/application/use-cases/claim.service.ts - Matching Worker → Match Scoring: dispatches work
apps/api/src/infrastructure/queue/matching.queue.ts - Email Worker → Email Delivery: sends email
apps/api/src/infrastructure/queue/email.queue.ts - Email Worker → Application Database: reads queued data
apps/api/src/infrastructure/queue/email.queue.ts - Students & Staff → Web App: uses
- Web App → HTTP API Server: calls API
- Admin Panel → HTTP API Server: calls API
- Web App → Item & Claim Pages: presents
- Admin Panel → Admin Operations: presents
- Web App → Realtime Socket: realtime updates
- Item & Claim Pages → Image Storage: uploads images