How prosofproest/lablens works
LabLens AI turns laboratory equipment faults into tracked maintenance tickets: users authenticate, submit structured reports with optional photos and AI-assisted triage, and follow status; administrators review institutional metrics, assign technicians, override triage, and audit changes. The graph separates intake, operations, AI, and shared platform services. Sampled source confirms key route-handler calls; several UI and data subsystems are represented from README claims and the source index, so their undocumented wiring is not asserted.
Main entry points: reports.ts Report persistence · page.tsx Admin operations hub · ReportFaultForm.tsx Fault report intake · route.ts Report analysis endpoint
Components 26
Reporting and access
- Sign-in and registration
src/app/(auth)/login/page.tsx - Fault report intake
src/components/reports/ReportFaultForm.tsx
Maintenance operations
- User ticket dashboard
src/app/(dashboard)/dashboard/page.tsx - Admin operations hub
src/app/(dashboard)/admin/page.tsx - Administrative triage
src/components/admin/AdminTriageModal.tsx - Isolated demo state
src/context/DemoContext.tsx
AI assistance
- Report analysis endpoint
src/app/api/reports/analyze/route.ts - AI fault triage
src/lib/groq/triage.ts - Groq inference client
src/lib/groq/client.ts - Floating AI assistant
src/components/chat/FloatingChatbot.tsx - Chat endpoint
src/app/api/chat/route.ts
Identity and persistence
- Authentication context
src/context/AuthContext.tsx - Report persistence
src/lib/firebase/reports.ts - Administrative audit trail
src/lib/firebase/audit.ts - Firebase client services
src/lib/firebase/client.ts - Server token verification
src/lib/firebase/serverAuth.ts - Distributed rate limiting
src/lib/groq/rateLimit.ts
Media uploads
- Photo attachment UI
src/components/reports/ImageUpload.tsx - Validated upload endpoint
src/app/api/upload/route.ts - Image signature validation
src/lib/security/imageSignature.ts - Cloudinary media storage
src/lib/cloudinary/server.ts
Other components
- Visitor or user
- Groq AI service
- Cloudinary service
- Firebase Authentication
- Cloud Firestore
Connections 31
- Visitor or user → Sign-in and registration: signs in
src/app/(auth)/login/page.tsx - Sign-in and registration → Authentication context: uses auth
src/app/(auth)/login/page.tsx - Authentication context → Firebase client services: reads client services
src/context/AuthContext.tsx - Authentication context → Firebase Authentication: authenticates
src/context/AuthContext.tsx - Visitor or user → Fault report intake: reports fault
README.md - Fault report intake → Report analysis endpoint: requests analysis
README.md - Report analysis endpoint → Server token verification: verifies token
src/app/api/reports/analyze/route.ts - Report analysis endpoint → Distributed rate limiting: checks limit
src/app/api/reports/analyze/route.ts - Report analysis endpoint → AI fault triage: analyzes fault
src/app/api/reports/analyze/route.ts - AI fault triage → Groq inference client: uses inference
- Groq inference client → Groq AI service: sends inference
README.md - Fault report intake → Report persistence: creates report
src/components/reports/ReportFaultForm.tsx - Fault report intake → Photo attachment UI: offers attachment
src/components/reports/ReportFaultForm.tsx - Photo attachment UI → Validated upload endpoint: uploads image
- Validated upload endpoint → Server token verification: verifies token
src/app/api/upload/route.ts - Validated upload endpoint → Image signature validation: validates bytes
src/app/api/upload/route.ts - Validated upload endpoint → Cloudinary media storage: uploads buffer
src/app/api/upload/route.ts - Cloudinary media storage → Cloudinary service: stores image
src/lib/cloudinary/server.ts - User ticket dashboard → Report persistence: subscribes reports
src/app/(dashboard)/dashboard/page.tsx - Admin operations hub → Report persistence: updates triage
src/app/(dashboard)/admin/page.tsx - Admin operations hub → Administrative triage: opens triage
src/app/(dashboard)/admin/page.tsx - Admin operations hub → Administrative audit trail: views audit trail
README.md - Admin operations hub → Isolated demo state: uses simulated data
src/app/(dashboard)/admin/page.tsx - Isolated demo state → Report persistence: avoids live writes
README.md - Floating AI assistant → Chat endpoint: sends messages
README.md - Chat endpoint → Server token verification: verifies token
src/app/api/chat/route.ts - Chat endpoint → Distributed rate limiting: checks limit
src/app/api/chat/route.ts - Chat endpoint → Groq inference client: requests completion
src/app/api/chat/route.ts - Report persistence → Cloud Firestore: stores reports
README.md - Administrative audit trail → Cloud Firestore: appends audit records
README.md - Server token verification → Firebase Authentication: verifies ID tokens
src/lib/firebase/serverAuth.ts