How niteshwarnikku/localfix works
LocalFix is a local-services marketplace: needers discover providers, book work, track its status, and communicate; providers manage requests, profiles, earnings, and feedback. The map also preserves authentication, reviews, and optional AI assistance. The README documents real-time messaging, Redis caching, and AI/RAG capabilities; source excerpts confirm several API and persistence paths, but do not expose all frontend-to-backend or socket wiring, so only documented connections are shown and optional integrations are dashed.
Main entry points: User.js User records · ChatBox.jsx Chat interfaces · nearby/route.js Nearby discovery · feedback/route.js Provider feedback
Components 31
Marketplace experience
- Browse services
app/services/page.js - Nearby discovery
app/api/ServiceProviders/nearby/route.js
Identity and profiles
- Provider profiles
app/api/ServiceProviders/[id]/route.js - Sign-in pages
app/auth/login/page.jsx - Registration
app/api/auth/signup/route.js - Login
app/api/auth/login/route.js - Session lookup
app/api/me/route.js - User records
lib/models/User.js
Bookings and feedback
- Booking creation
app/api/bookings/create/route.js - Booking tracking
app/api/bookings/[id]/status/route.js - Provider requests
app/api/ServiceProviders/me/request.js/route.js - Booking records
lib/models/Booking.js - Provider feedback
app/api/ServiceProviders/[id]/feedback/route.js - Review records
lib/models/Review.js
Communication
- Chat interfaces
components/ChatBox.jsx - Message history
app/api/messages/[roomId]/route.js - Provider conversations
app/api/conversations/provider/[providerId]/route.js - Message records
lib/models/Message.js - Socket server
server.js
Optional AI assistance
- AI assistant UI
components/ChatBot.jsx - AI service adapter
app/api/services/aiSerrvices.js - AI and RAG API
ai-services/app/main.py - Knowledge retrieval
ai-services/app/rag/retriever.py - Text embeddings
ai-services/app/rag/embeddings.py - Groq client
ai-services/app/llm/groq_client.py
Other components
- Service needer
- Service provider
- Groq API
- MongoDB
lib/config/db.js - OpenCage geocoder
- Redis cache
lib/redis.js
Connections 44
- Service needer → Browse services: browses
- Browse services → Nearby discovery: finds nearby
- Nearby discovery → User records: queries providers
- Nearby discovery → MongoDB: queries
- Nearby discovery → Redis cache: may cache
- Service needer → Sign-in pages: signs in
- Service provider → Sign-in pages: signs in
- Sign-in pages → Login: submits credentials
- Login → User records: checks account
- Login → MongoDB: reads
- Sign-in pages → Registration: registers
- Registration → OpenCage geocoder: geocodes address
- Registration → User records: creates account
- Session lookup → User records: loads user
- Session lookup → MongoDB: reads
- Browse services → Provider profiles: opens profile
- Provider profiles → User records: loads provider
- Service needer → Booking creation: requests service
- Booking creation → User records: checks provider
- Booking creation → Booking records: creates booking
- Service provider → Provider requests: reviews requests
- Provider requests → Booking records: reads requests
- Booking tracking → Booking records: updates status
- Service needer → Booking tracking: tracks booking
- Service provider → Booking tracking: updates booking
- Service needer → Provider feedback: rates provider
- Provider feedback → Booking records: checks completion
- Provider feedback → Review records: creates or reads
- Provider feedback → User records: checks provider
- Service needer → Chat interfaces: messages provider
- Service provider → Chat interfaces: messages client
- Chat interfaces → Message history: loads history
- Message history → Message records: reads messages
- Chat interfaces → Socket server: communicates live
- Chat interfaces → Message records: sends via API
- Provider conversations → Message records: reads conversations
- Provider conversations → User records: loads participants
- Service needer → AI assistant UI: asks for help
- AI assistant UI → AI service adapter: sends query
- AI service adapter → AI and RAG API: forwards query
- AI and RAG API → Knowledge retrieval: retrieves context
- Knowledge retrieval → Text embeddings: embeds query
- AI and RAG API → Groq client: requests answer
- Groq client → Groq API: calls model