How ifpr-projeto-de-extensao/v2-achados-e-perdidos works
Localiza+ is an institutional lost-and-found platform. Users register lost or found items, search listings, verify ownership, and record returns; administrators manage accounts, occurrences, reporting, and audit activity. The graph combines README-documented capabilities with route dispatch and selected implementation evidence. Several subsystem links are documented at product level because their source was not sampled.
Main entry points: App.tsx Application shell · AdminView.tsx Admin dashboard · AppContext.tsx App context · ObjectsView.tsx Search occurrences
Components 22
User experience
- Application shell
src/App.tsx - Route state
src/context/RouterContext.tsx - App context
src/context/AppContext.tsx - Sign-in and verification
src/components/AuthModal.tsx
Occurrence lifecycle
- Register occurrence
src/components/RegisterItemView.tsx - Search occurrences
src/components/ObjectsView.tsx - AI matching
src/components/AIMatchModal.tsx - Verify possession
src/hooks/usePossessionVerification.ts - Record return
src/components/ItemDetailModal.tsx - My occurrences
src/components/MyItemsView.tsx
Administration
- Admin dashboard
src/components/AdminView.tsx - Audit trail
src/components/AuditTrailManagerView.tsx - PDF reports
src/lib/foundItemsReportPdfGenerator.ts - Test batteries
src/components/TestBatteryManagerView.tsx
Backend and services
- Cloud Firestore
- Firebase Authentication
- Server API
server.ts - AI suggestions
server.ts - Notification functions
functions/src/index.ts - Support feedback
src/lib/supportFeedbackService.ts
Other components
- Students and staff
- Discord
Connections 23
- Students and staff → Application shell: use
- Application shell → Route state: reads route
- Application shell → Register occurrence: dispatches view
- Application shell → Search occurrences: dispatches view
- Application shell → Admin dashboard: dispatches view
- Application shell → App context: uses state
- App context → Sign-in and verification: opens sign-in
- Register occurrence → Cloud Firestore: stores occurrence
- Search occurrences → Cloud Firestore: queries listings
- Search occurrences → AI matching: offers matching
- AI matching → AI suggestions: requests suggestions
- Verify possession → Record return: verifies before return
- Record return → Cloud Firestore: updates occurrence
- My occurrences → Cloud Firestore: reads own items
- App context → Firebase Authentication: authenticates
- Admin dashboard → Cloud Firestore: manages records
- Admin dashboard → Audit trail: opens audit
- Admin dashboard → PDF reports: generates reports
- Admin dashboard → Test batteries: manages tests
- Server API → Cloud Firestore: serves backend operations
- Server API → AI suggestions: handles AI route
- Notification functions → Discord: sends event notices
- Support feedback → Server API: submits feedback