How dwell-official/dwell works
Dwell helps renters compare housing against a full-cost, infrastructure-aware plan, then verify listings through visit-gated reviews; agents publish listings and build a reputation. The graph includes the documented AI advice and summaries, market statistics, civic exports, plan sharing, and rewards. Backend route mounting and sampled review/reward calls support the shown wiring; unsampled feature internals and database relationships are not inferred.
Main entry points: index.ts REST API · App.tsx Web application · rewardService.ts Rewards wallet · reviews.ts Review handling
Components 23
Rental discovery
- Plan builder
frontend/src/pages/PlanBuilder.tsx - Listing discovery
frontend/src/pages/Listings.tsx - Listing details
frontend/src/pages/ListingDetail.tsx - Match scoring
backend/src/services/matchScore.ts - Market statistics
backend/src/services/marketStats.ts - Visit scheduling
frontend/src/pages/Visits.tsx - AI budget advice
backend/src/services/aiBudgetAdvisor.ts - Plan sharing
backend/src/routes/share.ts
Trust and accountability
- Visit review
frontend/src/pages/ReviewForm.tsx - Tenancy review
frontend/src/pages/TenancyReviewForm.tsx - Review handling
backend/src/routes/reviews.ts - Infrastructure scores
backend/src/services/healthScore.ts - Civic reporting
backend/src/routes/civicExport.ts - Review summaries
backend/src/services/aiSummary.ts
Marketplace operations
- Agent listings
frontend/src/pages/AgentDashboard.tsx - Rewards wallet
backend/src/services/rewardService.ts
Application platform
- Web application
frontend/src/App.tsx - REST API
backend/src/index.ts - Application database
- Notifications
backend/src/routes/notifications.ts - VTU provider
backend/src/providers/vtu-factory.ts
Other components
- Renter
- Agent
Connections 25
- Renter → Web application: uses
- Agent → Web application: uses
- Web application → Plan builder: routes to
- Web application → Listing discovery: routes to
- Web application → Listing details: routes to
- Web application → Visit scheduling: routes to
- Web application → Visit review: routes to
- Web application → Tenancy review: routes to
- Web application → Agent listings: routes to
- Plan builder → REST API: requests
- Listing discovery → REST API: requests
- Listing details → REST API: requests
- Visit scheduling → REST API: requests
- Visit review → REST API: submits review
- Tenancy review → REST API: submits review
- REST API → Review handling: dispatches
- REST API → Application database: serves data
- Review handling → Application database: reads and writes
- Review handling → Rewards wallet: triggers reward
- Rewards wallet → Application database: reads and writes
- Rewards wallet → Notifications: creates notification
- Rewards wallet → VTU provider: fulfills claim
- REST API → Civic reporting: dispatches
- REST API → Plan sharing: dispatches
- Agent listings → REST API: requests