How munawarjamil/realestate_ai works
PropChat is a multi-tenant real-estate AI platform. Visitors use an embeddable widget to chat with an assistant grounded in agency documents; the platform also supports property search, mortgage estimates, viewing bookings, lead qualification, and broker takeover. Agency staff manage conversations and CRM data in a dashboard, while platform administrators manage tenants and system operations. The README documents the broad product flow; sampled source confirms selected routes and module references, but unsampled implementations are not assumed to call one another.
Main entry points: service.py Conversation Service · graph_runtime.py LangGraph Agent · client.ts Dashboard API Client · socketio_server.py Broker Handoff
Components 23
User Experiences
- Website Widget
widget/src/main.ts - Admin Dashboard
dashboard/src/router.tsx - Dashboard API Client
dashboard/src/api/client.ts
API and Identity
- Authentication
src/app/modules/auth/router.py - Tenant Management
src/app/modules/tenants - Widget Sessions
src/app/modules/widget/router.py - Chat API
src/app/modules/chat/router.py
Conversation AI
- Conversation Service
src/app/modules/chat/service.py - LangGraph Agent
src/app/modules/chat/graph_runtime.py - Broker Handoff
src/app/modules/chat/socketio_server.py - Document RAG
src/app/modules/knowledge/retrieval.py - Document Ingestion
src/app/modules/knowledge/ingestion_runner.py
Agency Operations
- Property Search
src/app/modules/properties/service.py - Mortgage Calculator
src/app/modules/calculator/engine.py - Viewing Bookings
src/app/modules/bookings/service.py - CRM Leads
src/app/modules/leads/service.py
State and Integrations
- PostgreSQL
src/app/db/session.py - Qdrant Vectors
src/app/integrations/qdrant/client.py - LLM Provider
src/app/integrations/llm/client.py - Redis Pub/Sub
src/app/modules/chat/redis_pubsub.py
Other components
- Visitors
- Agency Brokers
- Platform Admins
Connections 26
- Visitors → Website Widget: chat through
README.md - Website Widget → Widget Sessions: opens session
README.md - Widget Sessions → Conversation Service: uses chat service
src/app/modules/widget/router.py - Conversation Service → Document RAG: retrieves context
src/app/modules/chat/service.py - Conversation Service → LangGraph Agent: runs agent
- LangGraph Agent → LLM Provider: calls model
- LangGraph Agent → Property Search: searches listings
README.md - LangGraph Agent → Mortgage Calculator: calculates mortgage
README.md - LangGraph Agent → Viewing Bookings: books viewings
README.md - Document Ingestion → Qdrant Vectors: indexes vectors
- Agency Brokers → Admin Dashboard: manage conversations
README.md - Admin Dashboard → Dashboard API Client: requests data
dashboard/src/router.tsx - Dashboard API Client → Chat API: streams chat
dashboard/src/api/client.ts - Dashboard API Client → Authentication: authenticates
dashboard/src/api/client.ts - Dashboard API Client → Tenant Management: manages tenants
dashboard/src/api/client.ts - Dashboard API Client → CRM Leads: manages leads
- Chat API → Conversation Service: delegates requests
- Conversation Service → CRM Leads: qualifies visitors
- Agency Brokers → Broker Handoff: takes over chats
README.md - Broker Handoff → Redis Pub/Sub: publishes events
README.md - Broker Handoff → LangGraph Agent: dispatches chat
src/app/modules/chat/socketio_server.py - Platform Admins → Admin Dashboard: administers platform
README.md - Conversation Service → PostgreSQL: stores conversations
src/app/modules/chat/service.py - Document Ingestion → Document RAG: feeds retrieval
- Viewing Bookings → PostgreSQL: persists bookings
- CRM Leads → PostgreSQL: persists leads